Galileo - Revision history

Craigje: /* Resources */

2015-05-15T20:33:28Z

Resources

← Older revision		Revision as of 20:33, 15 May 2015
Line 101:		Line 101:
	* [https://communities.intel.com/docs/DOC-21837 Release Notes (inc. supported software/hardware, bugs)]		* [https://communities.intel.com/docs/DOC-21837 Release Notes (inc. supported software/hardware, bugs)]
	* [https://communities.intel.com/community/makers Intel Maker forums (inc. forum for Galileo)]		* [https://communities.intel.com/community/makers Intel Maker forums (inc. forum for Galileo)]
	* [http://arduino.cc/en/Guide/HomePage Arduino Getting Started		* [http://arduino.cc/en/Guide/HomePage Arduino Getting Started]

	=Downloads=		=Downloads=

Craigje at 20:33, 15 May 2015

2015-05-15T20:33:10Z

← Older revision		Revision as of 20:33, 15 May 2015
Line 1:		Line 1:
	The Galileo is a fusion of a Linux PC running Intel's architecture and an Arduino. The purpose is to provide the benefits of a pc (connectivity, power, storage, ports) with the benefits of an Arduino (an open-platform hardware interface.)		The Galileo is a fusion of a Linux PC running Intel's architecture and an Arduino. The purpose is to provide the benefits of a pc (connectivity, power, storage, ports) with the benefits of an Arduino (an open-platform hardware interface.)

	This page is intended to express what we've learned about the Galileo. There are other resources, and ~~google~~ is ~~very much~~ your friend, but this is ~~what~~ knowledge we ~~as students have~~ learned~~. It is~~ our experience~~. Take it as it is. No promises. Seriously, this is the only disclaimer you get. Stay out of the fire~~.		This page is intended to express what we've learned about the Galileo. There are other resources, and Google is your friend, but this is the knowledge we've learned from our experience here.

	=Getting Started Guide=		=Getting Started Guide=
	==Galileo==		==Galileo==
	To start with, you need three things to use the Galileo board and to run Arduino sketches:		To start with, you need three things to use the Galileo board and to run Arduino sketches:
	# A Galileo Board		# Galileo Board
	# A USB cable to connect ~~the~~ board to ~~your~~ computer		# USB cable to connect board to computer
	# The Galileo development software (~~The~~ special version for Galileo that you can get [https://communities.intel.com/docs/DOC-22226 here])		# The Galileo development software (special version for Galileo that you can get [https://communities.intel.com/docs/DOC-22226 here])



	Follow this tutorial,		Follow this tutorial,
Line 18:		Line 16:
	* Complete steps 7, 8, 9, and 10. They shouldn't take long.		* Complete steps 7, 8, 9, and 10. They shouldn't take long.

	In addition, this ~~might be useful:~~ [https://learn.sparkfun.com/tutorials/galileo-getting-started-guide/all Sparkfun guide.]		In addition, this [https://learn.sparkfun.com/tutorials/galileo-getting-started-guide/all Sparkfun guide] might be useful.

	==Arduino==		==Arduino==



	=Resources & Reference=		=Resources & Reference=
Line 43:		Line 39:
	==Design Philosophy==		==Design Philosophy==
	* When doing research talk to scientists early on. Seriously, it helps.		* When doing research talk to scientists early on. Seriously, it helps.
	* Test after every change. ~~Seriously, this~~ saves a lot of time.		* Test after every change. This saves a lot of time.
	* When success has been reached, do it again. Document it.		* When success has been reached, do it again. Document it.
	* When success has been repeated, have others do it. Spread your success.		* When success has been repeated, have others do it. Spread your success.
Line 49:		Line 45:
	==Troubleshooting Checklist==		==Troubleshooting Checklist==
	# The Galileo is still a beta product and can be finicky. Google is your friend.		# The Galileo is still a beta product and can be finicky. Google is your friend.
	# Be aware that some libraries/shields made for ~~arduino~~ are not compatible with the Galileo at this time.		# Be aware that some libraries/shields made for Arduino are not compatible with the Galileo at this time.
	** Known Issues:		** Known Issues:
	*** The SotwareSerial library does not work.		*** The SotwareSerial library does not work.
Line 99:		Line 95:
	=Resources=		=Resources=

	[[https://communities.intel.com/docs/DOC-22204 Installation Guide]]		* [https://communities.intel.com/docs/DOC-22204 Installation Guide (super useful Galileo start guide)]
	* super useful guide ~~for getting started with the Galileo~~		* [http://arduino.cc/en/ArduinoCertified/IntelGalileo Technical Overview of Galileo (meet Galileo hardware]
			* [http://arduino.cc/en/Reference/HomePage Arduino Reference (meet Arduino software)]
			* [http://playground.arduino.cc/ Arduino Playground (meet Arduino software some more)]
	[[http://arduino.cc/en/ArduinoCertified/IntelGalileo Technical Overview of Galileo]]		* [https://communities.intel.com/docs/DOC-21837 Release Notes (inc. supported software/hardware, bugs)]
	* ~~useful for getting familiar with the Galileo hardware~~		* [https://communities.intel.com/community/makers Intel Maker forums (inc. forum for Galileo)]
			* [http://arduino.cc/en/Guide/HomePage Arduino Getting Started

	[[http://arduino.cc/en/Reference/HomePage Arduino Reference]]
	* ~~useful for getting familiar with the Arduino software~~


	[[http://playground.arduino.cc/ Arduino Playground]]
	* ~~useful for getting familiar with the Arduino software~~


	[[https://communities.intel.com/docs/DOC-21837 Release Notes]]
	* supported software/hardware ~~and~~ bugs


	[[https://communities.intel.com/community/makers Intel Maker forums]]
	* forum for Galileo


	[[http://arduino.cc/en/Guide/HomePage Arduino Getting Started]]
	* Arduino-specific "Getting Started" guide

	=Downloads=		=Downloads=

	[[https://downloadcenter.intel.com/Detail_Desc.aspx?DwnldID=23171 Software Packages]]		* [https://downloadcenter.intel.com/Detail_Desc.aspx?DwnldID=23171 Software Packages]
			* [https://communities.intel.com/docs/DOC-22226 Drivers]
	[[https://communities.intel.com/docs/DOC-22226 Drivers]]


	=Research=		=Research=
	Moved to [[Disaster-Preparedness\|here]].		Moved to [[Disaster-Preparedness\|here]].


	=Code=		=Code=

Dtloring at 16:48, 10 June 2014

2014-06-10T16:48:06Z

← Older revision		Revision as of 16:48, 10 June 2014
Line 237:		Line 237:

	4) To confirm correct version run node -v		4) To confirm correct version run node -v

			=Building Custom Images=
			==Setting up the BSP Build Environment==
			* You will need:
			** Linux (Tested on Debian 7.5 and Debian 7.0, other distros may also work)
			** Up to 30 gb disk space
			** The latest version of the [https://downloadcenter.intel.com/Detail_Desc.aspx?DwnldID=23197 Board Support Package sources] from Intel
			** A copy of the Intel Quark BSP Build Guide, avaliable at the same location, for additional reference
			* Host machine setup:
			** Necessary Packages:
			*** build-essential
			*** gcc-multilib
			*** vim-common
			*** git
			*** diffstat
			*** texinfo
			*** gawk
			*** chrpath
			*** file
			** Apart from installing those packages, no part of this process requires root access.
			* Setting up the working directory (from section 6 of the BSP build guide)
			** Extract the Board Support Package into a convenient working directory
			** Run the following commands:
			<code>tar -xvf meta-clanton*.tar.gz
			cd meta-clanton*
			./setup.sh</code>
			* Patch one source file to account for a changed checksum
			<code>sed -i 's/1cffe9f406cc54f4759fc9eeb85598fb8cae66c7/bfed708c5358a2b4ef65923fb0683cefa9184e6f/' meta-oe/meta-oe/recipes-multimedia/x264/x264_git.bb </code>
			* Set up the build environment variables
			<code>source poky/oe-init-build-env yocto_build</code>
			* Build an image (This step will take several hours and require significant disk space and ram).
			<code>bitbake image-full-galileo</code>
			* The completed images will be found in ./tmp/deploy/images
			** These files must be on the SD card for the Galileo to book correctly:
			*** grub.efi
			*** image-full-galileo-clanton.ext3
			*** core-image-minimal-initramfs-clanton.cpio.gz
			*** bzImage
			*** boot/
			Note that some of these files are symlinks; be careful to copy the file content.
			==Customize the Linux kernel of the image==
			* be in the root build directory (meta-clanton*/)
			cd poky
			source oe-init-build-env
			<code>bitbake linux-yocto -c menuconfig </code>
			* enable the desired kernel components
			* rebuild the kernel
			from the meta-clanton* directory:
			<code>source poky/oe-init-build-env yocto_build
			bitbake image-full-galileo</code>
			== Customize the software added to the image==
			* Make sure that the package you wish to add has a recipe
			[http://layers.openembedded.org/layerindex/branch/master/layers/ List of layers and recipies] each piece of software to be built for the Galileo has a recipie within a layer. Most layers containing applications are found within the meta-oe/ directory.
			* Make sure the layer containing the recipie has been enabled in yocto_build/conf/bblayers.conf
			if it hasn't add the path to the list of BBLAYERS
			* run <code>bitbake <packageName></code>
			be sure you are in the yocto_build directory and have sourced the oe-init-build-env script in that shell
			* add the package to the image build script
			edit the yocto_build/conf/local.conf file to include the line:
			<code>IMAGE_INSTALL_append = " <packageName>" </code>
			note that that leading space is vital (don't blame me, I didn't write this scripting system!)
			* run <code>bitbake image-full-galileo</code> to construct the new image.
			==Integrate support for FTDI USB-serial controllers==
			This is essential to the HERMES project. It also demonstrates how to customize the Galileo with .bbappend files.
			* download the compendium of Galileo recipies from AlexT's github page
			<code>git clone https://github.com/alext-mkrs/meta-alext-galileo</code>
			* remove .disabled from the .bbappend file you wish to use
			for us that's <code>recipes-addfeatures/enable_ftdi_sio/linux-yocto-clanton_3.8.bbappend</code>
			* add the path to the layer directory to the yocto_build/conf/bblayers.conf file
			* run <code>bitbake image-full-galileo</code> again.

	=IotKit Tutorial =		=IotKit Tutorial =

Blyee11: /* System Administration */

2014-06-04T15:53:16Z

System Administration

← Older revision		Revision as of 15:53, 4 June 2014
Line 207:		Line 207:

	=System Administration=		=System Administration=
			''' restarting IoTkit'''

			0) ssh as root: ssh root@galileo-<galileo#>

			1) change directory to iotkit-agent-master: cd iotkit-agent-master

			2) run the shell script start-agent.sh: ./start-agent.sh

			3) if that fails run node agent: node agent

	''' creating a non-root user'''		''' creating a non-root user'''

	For the non-sys admin types use: ~~useradd -m -d /home/eccs eccs~~		For the non-sys admin types use:

	~~this creates~~ the user eccs and a home directory for it.		0) create the user eccs and a home directory for it.: useradd -m -d /home/eccs eccs

	~~then~~ change the password using: passwd		1)change the password using: passwd

	'''Updating Node.js'''		'''Updating Node.js'''
	To update node.js on the Galileo		To update node.js on the Galileo

	1) download [https://communities.intel.com/servlet/JiveServlet/download/221298-75632/nodejs_0.10.25-r0_i586.ipk.zip this package]		0) download [https://communities.intel.com/servlet/JiveServlet/download/221298-75632/nodejs_0.10.25-r0_i586.ipk.zip this package]

	2) unzip the file and scp the file to the board		1) unzip the file and scp the file to the board

	3) move the package to /tmp on the board		2) move the package to /tmp on the board

	4) Run the command opkg install /tmp/nodejs_0.10.25-r0_i586.ipk		3) Run the command opkg install /tmp/nodejs_0.10.25-r0_i586.ipk

	5) To confirm correct version run node -v		4) To confirm correct version run node -v

	=IotKit Tutorial =		=IotKit Tutorial =

Blyee11 at 14:56, 4 June 2014

2014-06-04T14:56:50Z

← Older revision		Revision as of 14:56, 4 June 2014
Line 208:		Line 208:
	=System Administration=		=System Administration=

			''' creating a non-root user'''

			For the non-sys admin types use: useradd -m -d /home/eccs eccs

			this creates the user eccs and a home directory for it.

			then change the password using: passwd

	'''Updating Node.js'''		'''Updating Node.js'''
	To update node.js on the Galileo		To update node.js on the Galileo

Blyee11 at 15:09, 3 June 2014

2014-06-03T15:09:19Z

← Older revision		Revision as of 15:09, 3 June 2014
Line 220:		Line 220:

	5) To confirm correct version run node -v		5) To confirm correct version run node -v

			=IotKit Tutorial =
			[http://cluster.earlham.edu/~blyee11/IoT_test.ino sample code]

	=Info Dump=		=Info Dump=

Dtloring: /* Code */

2014-06-02T19:51:29Z

Code

← Older revision		Revision as of 19:51, 2 June 2014
Line 186:		Line 186:
	# sleep like this,		# sleep like this,
	#* delay(length); where length is in ms		#* delay(length); where length is in ms

			==IoTKit==
			IoTKit allows you to publish data to intel's cloud Internet of Things service. It's an easy way to make your sensor's data remotely readable.

			https://github.com/enableiot/iotkit-samples

	=Hardware Specs=		=Hardware Specs=

Blyee11 at 12:47, 30 May 2014

2014-05-30T12:47:49Z

← Older revision		Revision as of 12:47, 30 May 2014
Line 201:		Line 201:
	[http://wiki.cs.earlham.edu/index.php/Arduino_Sensors click here for documentation]		[http://wiki.cs.earlham.edu/index.php/Arduino_Sensors click here for documentation]

	== System Administration ==		=System Administration=

	'''Updating Node.js'''		'''Updating Node.js'''

Blyee11: /* System Administration */

2014-05-30T12:46:59Z

System Administration

← Older revision		Revision as of 12:46, 30 May 2014
Line 205:		Line 205:
	'''Updating Node.js'''		'''Updating Node.js'''
	To update node.js on the Galileo		To update node.js on the Galileo

	1) download [https://communities.intel.com/servlet/JiveServlet/download/221298-75632/nodejs_0.10.25-r0_i586.ipk.zip this package]		1) download [https://communities.intel.com/servlet/JiveServlet/download/221298-75632/nodejs_0.10.25-r0_i586.ipk.zip this package]

	2) unzip the file and scp the file to the board		2) unzip the file and scp the file to the board

	3) move the package to /tmp on the board		3) move the package to /tmp on the board

	4) Run the command opkg install /tmp/nodejs_0.10.25-r0_i586.ipk		4) Run the command opkg install /tmp/nodejs_0.10.25-r0_i586.ipk
	5) To confirm correct version run node -v
			5) To confirm correct version run node -v

	=Info Dump=		=Info Dump=
	IoTkit handles ethernet transactions. It connects to a host and sends a packet with [string, val] where val is the value you wish to send. You can save information locally and push it to a server later. A watch battery can be used to preserve machine state between power-on's. [validate]		IoTkit handles ethernet transactions. It connects to a host and sends a packet with [string, val] where val is the value you wish to send. You can save information locally and push it to a server later. A watch battery can be used to preserve machine state between power-on's. [validate]

Blyee11 at 12:46, 30 May 2014

2014-05-30T12:46:34Z

← Older revision		Revision as of 12:46, 30 May 2014
Line 201:		Line 201:
	[http://wiki.cs.earlham.edu/index.php/Arduino_Sensors click here for documentation]		[http://wiki.cs.earlham.edu/index.php/Arduino_Sensors click here for documentation]

			== System Administration ==

			'''Updating Node.js'''
			To update node.js on the Galileo
			1) download [https://communities.intel.com/servlet/JiveServlet/download/221298-75632/nodejs_0.10.25-r0_i586.ipk.zip this package]
			2) unzip the file and scp the file to the board
			3) move the package to /tmp on the board
			4) Run the command opkg install /tmp/nodejs_0.10.25-r0_i586.ipk
			5) To confirm correct version run node -v
	=Info Dump=		=Info Dump=
	IoTkit handles ethernet transactions. It connects to a host and sends a packet with [string, val] where val is the value you wish to send. You can save information locally and push it to a server later. A watch battery can be used to preserve machine state between power-on's. [validate]		IoTkit handles ethernet transactions. It connects to a host and sends a packet with [string, val] where val is the value you wish to send. You can save information locally and push it to a server later. A watch battery can be used to preserve machine state between power-on's. [validate]