How to Configure your Intel Galileo Gen 2 Board

Transcription

1 Intel Galileo Gen 2 Board

2 Revision # Date ThingWorx Revision Changes Owner current Used you instead of we, added copyright and page cover, modified footer Modified Cover Page font, footer, review table and copyright paragraph position in the document at Andy s suggestion Replaced the OS image on the Galileo to provide sketch persistancy. Added Wireless tutorial Veronica MIHAI Veronica MIHAI Veronica MIHAI Veronica MIHAI Contents What is Intel Galileo?... 3 Required Materials... 3 Install a SD-Card Linux Image... 4 Download the Arduino IDE for Galileo to your PC... 7 Install USB Driver for Intel Galileo board on your PC... 9 Update the Firmware and set up Galileo Boot from the SD Card Upload the Blink Program Set up the HTU21D Temperature and Humidity sensor Connect your board to Thingworx using a Wifi Connection Physical Setup Network Configuration from Intel Galileo s command line Intel Galileo Gen 2 Board PTC Inc. 2

3 What is Intel Galileo? An Intel Galileo is a microprocessor hardware-, software-, and pin-compatible with a wide range of Arduino Uno* R3 shields. It comes with a preinstalled Linux-like operating system and can also boot from a customized Linux version installed on a micro-sd card. With Intel Galileo you can use either the Arduino IDE and upload sketches 1 to the board or you can enable ssh and use the command line to run programs in a programming language of your choice, like for example Python or C. A notable difference between Intel Galileo Gen 2 and Gen 1 is the power supply that it needs. The Intel Galileo Gen 2 works with a 12 V power supply whereas the Intel Galileo Gen 1 needs only a 5 V power supply. You can find an overview of Intel Galileo Gen 2 board here. To build the Temperature and Humidity App in Thingworx using Intel Galileo you will need the following hardware: Required Materials Item Intel Galileo Gen 2 1 Solderless breadboard 1 Ethernet Cable (Alternative to wifi setup) 1 Wi-Fi setup (Alternative to Ethernet Connection) : - Half Mini Wi-Fi Card - Half to Full Height Wi-Fi Card Adapter - Wi- Fi Antenna Quantity pair 8 G microsd card with an SD Adapter 1 The 12 V DC power supply that came with 1 your Intel Galileo or equivalent battery pack Temperature and Humidity sensor HTU21D 1 Male to male jumper wires 4 Soldering iron (Optional, if you don t have 1 the pins of the HTU21D sensor already soldered) USB A to micro B cable 1 1 A sketch is a program written in a C-like language specific to Arduino microprocessors. The program is stored in an.ino file. Intel Galileo Gen 2 Board PTC Inc. 3

4 Install a SD-Card Linux Image Intel Galileo already has a preinstalled Linux like operating system, but its functionalities are quite limited due to its tiny size, only 8 MB stored on the build-in flash memory of the Intel Galileo board. To enable your IoT project you will need to use a more powerful Linux image. Some advantages for booting from a SD Card image are extended file storage and the possibility to install Wi-Fi Dongles drivers to enable Wi-Fi connectivity for example. Linux images for Intel Galileo are custom-built using Yocto, i.e. you can use Yocto to choose what Linux modules you would like to have installed on your Intel Galileo, like i2c-dev. Nevertheless the process of building a customized Linux image is quite tedious, so in this tutorial you will use an image that Intel has customized for IoT projects. To install this Linux image on your micro-sd card follow the next steps: - Download the SD-Card Linux Image archive file from here. - Insert your micro-sd card into your SD card adapter and then plug it into your PC SD card reader. You should be prompted by your PC that your SD card has been plugged in and you will be able to locate it in your Computer directory as shown below : Note the name of the drive on which the micro-sd card is on. In my case, it is H. - Open a command prompt as an Administrator: Go to Start, type cmd in the search field. Right click the found cmd.exe program an select Run as Administrator : Intel Galileo Gen 2 Board PTC Inc. 4

5 - Type diskpart.exe in the command prompt that opened. This program will allow you to create a boot partition on your micro-sd card so that the C programs (sketches) that you upload on your Intel Galileo will be persistent. - In the DISKPART command line that you now have available type the following commands : select vol h (Select the Drive on which your micro-sd card is on. In my case it is H ) clean create part primary active format quick label= BOOTIME exit Intel Galileo Gen 2 Board PTC Inc. 5

6 - Next, locate the archive you previously downloaded. Open it by double-clicking it. Enter the image-full-galileo folder and, from here, right-click in the window showing the files and choose to extract its content on your micro-sd card. This can take up to 3 minutes. At the end, you should be able to see the following content when opening your micro-sd card directory: Note: Make sure you are seeing these files directly in the root of your micro-sd card (i.e. you don t have them in the intel-galileo-full image directory but directly in the SD card s root), otherwise, the Linux image won t be recognized when booting. After this you can safely eject the micro SD card. Intel Galileo Gen 2 Board PTC Inc. 6

7 You will use the SD card in a later step to boot from it. You will next install the Arduino IDE for Galileo which will allows you to upload programs (called sketches) to your board using an USB A to micro B cable Download the Arduino IDE for Galileo to your PC The Intel Galileo Board needs a specialized version of the Arduino IDE. Download the Arduino IDE zip file corresponding to your PC operating system from this site. After the download is completed extract the files to your C drive and make sure there is no space in the path to the IDE files. You can also change the arduino-windows folder name to Galileo_Arduino to avoid confusing it with other Arduino IDEs for Arduino. To launch the IDE double-click the Arduino icon. This is how the Arduino Environment looks like. Intel Galileo Gen 2 Board PTC Inc. 7

8 You can also right click the application icon and choose to pin it to your Start Menu to locate it easier. Intel Galileo Gen 2 Board PTC Inc. 8

9 Note: To install the Arduino IDE on Mac OS or Linux check this tutorial. To be able to boot from your micro SD card you need to first install an USB driver for the board and then upload the firmware on the Intel Galileo. This will ensure that your micro SD card will be recognized. Install USB Driver for Intel Galileo board on your PC To be able to upload sketches on the board from the Arduino IDE, you have to connect your Intel Galileo board to your PC using a USB A to micro B cable. Windows install 1. Make sure your micro SD card is not plugged into your Intel Galileo board 2. First Connect the 12 V power supply that came with your Intel Galileo Gen 2 board. 3. Wait a few seconds for your USB led to light up. See picture below. 4. Then connect the micro USB end of your USB cable on your Galileo s USB Client port and the USB end to an available USB socket on your PC. On Windows, when connecting the Board to your PC, after a few seconds while Windows will try to install the driver, you will see a message telling you that Windows failed to install the driver for it. You will therefore need to install it manually. 5. Open up the Device Manager. (Either Start > Run > devmgmt.msc, or go to the Control Panel, select System and click Device Manager.) 6. Locate the Gadget Serial v2.4 device, under the Other devices tree. Right-click that and select Update Driver Software. Intel Galileo Gen 2 Board PTC Inc. 9

10 7. In the following window choose Browse my computer for driver software. On the next page select Browse and navigate to the hardware\arduino\x86\tools folder within your Arduino Galileo folder that you extracted from the Arduino IDE archive in a previous step. Then click Next. Intel Galileo Gen 2 Board PTC Inc. 10

11 8. Next click Install. Wait for the installation to complete and to be prompted with a Windows has successfully updated your driver software message. 9. Go back to the Device Manager window and check the Ports tree. There should be an entry for Galileo (COM #). Note on which COM # your Galileo is on. You will use this port when uploading sketches and in the next step, updating firmware. Intel Galileo Gen 2 Board PTC Inc. 11

12 Note: If you are using a Linux or Mac OS system, check this tutorial for information on how to install the driver. Notice that it is meant for an Intel Galileo Gen 1 board, therefore it tells you to connect a 5 V power supply. If you are using an Intel Galileo Gen 2 board as recommended in this tutorial, you will need a 12 V power supply. Make sure you don t confuse them because this could lead to serious damage of your board. Update the Firmware and set up Galileo To update the Firmware follow the next steps: 1. Make sure your micro SD card is not plugged in on your Intel Galileo board 2. First connect the 12 V power supply that came with your Intel Galileo Gen 2 board. 3. Wait a few seconds for your USB led to light up. 4. Then connect the micro USB end of your USB cable on your Galileo s USB Client port and the USB end to an available USB socket on your PC. 5. Open the Arduino IDE and Select Intel Galileo Gen 2 from Tools Board and the COM number on which your Intel Galileo is on from Tools Ports 6. Then go to Help Galileo Firmware Update. 7. You will be prompted by the following message. Click ok. You may be prompted by another message asking you if you want to rewrite the existing firmware. Click ok. You will be brought to this window. Intel Galileo Gen 2 Board PTC Inc. 12

13 Wait for the Update to finish. You can now proceed to boot from the SD Card. Boot from the SD Card To boot from the SD Card, follow the next steps: 1. Plug in your micro SD Card. Intel Galileo Gen 2 Board PTC Inc. 13

14 2. Plug in the power supply. 3. Wait for the USB led to light up. You should also be able to see the SD led next to the ON led blinking to signal SD card is currently being read. 4. Plug in also the USB cable as before and connect the board to your computer. Upload the Blink Program After booting from the micro SD card in the previously step, you now need to verify that everything is working correctly and that programs can be successfully uploaded to the Galileo board through the Arduino IDE. Follow the next steps to upload a sketch that will make the led labeled L on your board blink: 1. Use the Intel Galileo Board setup described in the previous step for how to boot from an SD card. 2. Open the Arduino IDE 3. In the Tools Board menu select Intel Galileo Gen 2 Intel Galileo Gen 2 Board PTC Inc. 14

15 4. In the Tools Serial Port select the COM number on which your Intel Galileo Board appeared connected in your Device Manager Ports Section (In my case: COM3) Intel Galileo Gen 2 Board PTC Inc. 15

16 5. Go to File Examples Basic Blink This will open a program that makes the little LED next to the ON led on your board blink. Intel Galileo Gen 2 Board PTC Inc. 16

17 And wait for the Transfer to be completed. Next you should see the LED on your board starting to blink. Note: Programs running on the Intel Galileo cannot be stopped. The Blink program will run continously until you replace it with a different one. Note that the sketch is stored on the board s memory and will start running even after cutting the power supply and then connecting it again. One way of stopping all activity on the Intel Galileo is to upload an empty program like the one you see when pressing File New in the Arduino IDE. Intel Galileo Gen 2 Board PTC Inc. 17

18 You can run into a permission denied error when you try to upload a sketch on your board while another sketch is already being uploaded. This can happen if you don t wait for the upload process to finish before pressing the upload button again. I have found that a solution to this problem is to restart your PC and try to upload the file again. Set up the HTU21D Temperature and Humidity sensor First unplug the USB cable and then the power supply and proceed to connecting the HTU21D sensor. The HTU21D Temperature and Humidity sensor has 4 pins, Ground, 3.3 V Voltage, SDA (Serial Data Line), SCL (Serial Clock Line), that need to be connected to the Intel Galileo. I bought my sensor with already attached male pins, but you may need to solder them manually to the sensor circuit. Place the HTU21D sensor on the solderless breadboard with the description of the pins towards you like shown below. Next connect one male to male jumper wire on each of the 4 columns corresponding to the sensors pins like shown below. Intel Galileo Gen 2 Board PTC Inc. 18

19 Note : Solderless breadboard columns share the same voltage. You can read more about breadboards here. Sparkfun breadboard Picture Connect the 3.3 V pin of the sensor to the 3.3 V pin on the Intel Galileo. The Ground Pin of the sensor to the Ground pin of the Intel Galileo and the SDA and SCL pins of the sensors to the corresponding pins on the Intel Galileo as shown below. Intel Galileo Gen 2 Board PTC Inc. 19

20 Now our temperature and humidity sensor is set up. Next : 1. Plug the micro SD card in your Intel Galileo micro SD card slot. 2. Connect the Ethernet cable. See the section below to learn how to use a Wi-Fi connection instead of an Ethernet cable. 3. Connect the power supply. 4. Wait for a few seconds so that the USB LED lights up and the board has booted from the SD card. 5. Connect the USB cable between your board and your PC. Your board is now ready. You can proceed to uploading a sketch that will read values from the Temperature and Humidity sensor and send them to the Thingworx Server. Follow the instructions detailed in How to read Temperature and Humidity from HTU21D sensor using Thingworx C SKD for Intel Galileo tutorial to learn how to do this. Optional, you can follow the tutorial below for connecting your board to a Wi-Fi network. Connect your board to Thingworx using a Wifi Connection Physical Setup If you have your Intel Galileo Board powered up, proceed to unplug it, first the micro USB and then the power supply. Next you will set up the mini Wi-Fi card with the Half to Full Adapter and the pair of Anntenas on your Intel Galileo. This tutorial is done for a N6235 Intel Centrino Wi-Fi Card Half Mini PCI which also provides Bluetooth conectivity. Other choices of Wi-Fi card are possible. You can see a list of Wi-Fi card supported by the Linux Kernel by visiting this link. Intel Galileo Gen 2 Board PTC Inc. 20

21 First, slide the Half to Full Adapter under the Wi-Fi Card and insert the two screws. Turn the Intel Galileo over and Insert this assemble into to PCI Connector slot. Next connect also the pair of anntenas. Be careful to connect the main and aux antenna to the corresponding main and aux slots on the Wi-Fi card. Now our Physical Wi-Fi setup is complete. To make your Intel Galileo entirely portable you can use also a Battery Pack like the one indicated in the Marials listed for this tutorial. Intel Galileo Gen 2 Board PTC Inc. 21

22 Network Configuration from Intel Galileo s command line In this section you will learn how to modify the network/interfaces and wpa_supplicant.conf files on your Intel Galileo to configure the SSID and password of the wireless network you want to connect to. The first step you need to do is installing the driver for your Wi-Fi card. In this tutorial. Intel Centrino N6235 card is used. Download the driver corresponding to your Wi-Fi card from here. Next, copy the archive you downloaded (for N6235 Wi-Fi card it is iwlwifi-6000g2b-ucode tgz file) on your micro-sd card. To do this, unplugg your micro-sd card from your Intel Galileo board, then use the SD adapter to put it into your PC. Afterwards, simply copy and paste the archive with the Wi-Fi driver directly into your micro-sd root directory. Next unplug it and put it back into your Intel Galileo board. To install the driver you will need to first connect remotely to your board using a SSH Client like Putty. You can download Putty from here. To find out your Intel Galileo board IP follow the next steps: Keep the Wi-Fi card that you previously set up and power up your board. Plug in also the Ethernet cable so that your board will be assigned an IP address on your Ethernet interface, eth0. Connect it through USB to your computer so that you can upload a sketch which will print your eth0 IP address to the Serial Monitor. Open the Arduino IDE for Intel Galileo and copy the following lines of code into the loop function : Intel Galileo Gen 2 Board PTC Inc. 22

23 system("ifconfig > /dev/ttygs0"); sleep(10); Before pressing on the upload button, make sure you have Intel Galileo Gen 2 selected under Tools Board and the port number on which your board is connected under Tools Serial Port. After you uploaded the sketch go to Tool Serial Monitor. Uncheck the Autoscroll checkbox and copy your eth0 IP. Intel Galileo Gen 2 Board PTC Inc. 23

24 Next open Putty and enter this IP address. Next click Open : You can also name this configuration and Save it so that you can Load it at a later time. Intel Galileo Gen 2 Board PTC Inc. 24

25 You will be asked if you are sure you want to proceed with the connection. Click yes. Enter root as username. No password is required. Next copy and paste the following commands : cd /tmp tar xzvf /media/mmcblk0p1/iwlwifi-6000g2b-ucode tgz cp iwlwifi-6000g2b-ucode /iwlwifi-6000g2b-6.ucode /lib/firmware/ Intel Galileo Gen 2 Board PTC Inc. 25

26 If necessary, replace iwlwifi-6000g2b-ucode tgz with the name of the archive containing your Wi-Fi driver that you copied on your micro-sd card. Next run the following command to configure the connexion to your Wireless Network. This command will write in the /etc/wpa_supplicant.conf file. Replace MyWifi with the name of your Wireless Network (for example PTC_Wifi) : wpa_passphrase MyWiFi << EOF > /etc/wpa_supplicant.conf Type your password Type EOF to close the file Next enter the following command to open your network/interfaces file in edit mode : vi /etc/network/interfaces You can use the following commands to edit a file using vi editor : r R i a A O replace character under cursor with next character typed keep replacing character until [esc] is hit insert before cursor append after cursor append at end of line open line above cursor and enter append mode Intel Galileo Gen 2 Board PTC Inc. 26

27 Place your cursor under the line #Wireless interfaces. Next type i and press enter so you can edit before the cursor position. Press the up arrow and type auto wlan0 above this line : iface wlan0 inet dhcp. Press Esc on your keyboard to enter the command mode of the vi editor and type ZZ, this will save the changes and close the file. 2 Congratulation! You have completed this tutorial on connecting your board to a Wi-Fi network. You can proceed to the next tutorial : How to read Temperature and Humidity from HTU21D sensor using Thingworx C SKD for Intel Galileo tutorial. 2 To learn more about the vi editor available on your Intel Galileo check this site. Intel Galileo Gen 2 Board PTC Inc. 27

28 2015 PTC Inc. The information contained herein is provided for informational use and is subject to change without notice. The only warranties for PTC products and services are set forth in the express warranty statements accompanying such products and services and nothing herein should be construed as constituting an additional warranty. PTC shall not be liable for technical or editorial errors or omissions contained herein. Important Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright notice, of your PTC software Intel Galileo Gen 2 Board PTC Inc. 28