background image

 

 

Page 15 

 

 

 

Run the IIoT Quickstart Demonstration 

This demonstration reads data from selected onboard sensors and publishes (transmits) to the 
Cloud-resident IBM Watson IoT  public Quickstart service.  Incoming values are displayed 
graphically as they arrive.  Your IIoT kit must be connected to the Internet for this demonstration 
to operate correctly, but a Bluemix account is not required. 

 

By default, data is read from the HTS221 temperature sensor on the ST Microelectronics 
Arduino Shield and published to the cloud service.  The application can be executed from the 
command prompt using the format: 

 

./IIoT_QuickStart_Demo <

uniqueID

 

where <

uniqueID

> is any alphanumeric string you choose.  This string is simply used to isolate 

your specific instance from other simultaneous access requests to the site by any number of 
concurrent users.  It is valid only for the duration of the application run, but can be reused or 
changed in each subsequent execution.  In the unlikely event that your <

uniqueID

> is refused, 

simply choose another string that is less likely to be picked by another user. 

 

The example below uses a <

uniqueID

> of 

abc123

 

 

 

Notice that the live data transmission can be seen at the link shown above, in the format: 

https://quickstart.internetofthings.ibmcloud.com/#/device

 

Summary of Contents for MicroZed 7010

Page 1: ...ach Further and the Avnet logo are registered trademarks of Avnet Inc All other brands are the property of their respective owners LIT Z7MB IIOT SK GSG v1 1 MicroZed Industrial Internet of Things Starter Kit Getting Started Guide Version 1 1 ...

Page 2: ...nt Control Document Version 1 1 Document Date 04 February 2018 Prior Version History Version Date Comment 1 0 30 May 2016 Initial MiniZed Hardware User Guide 1 1 04 Feb 2018 Updated to comply with new Avnet branding ...

Page 3: ...sic Setup and Operation 9 MicroZed SOM Boot Mode 9 Install Silicon Labs CP210x USB to UART Drivers on a PC 11 MicroZed IIoT Hardware Setup 11 Pulsar Login and Firmware Upgrade 12 Running the Applications 13 Run the SPI Application 13 Run the I2C Application 14 Run the IIoT Quickstart Demonstration 15 Run the IIoT Bluemix Demonstration 18 Wind River Helix App Cloud 20 Getting Help and Support 22 Av...

Page 4: ...e The carrier card is ideal for building quick prototypes that leverage the large number of Arduino compatible Shields and Pmod compatible expansion boards The following sensors are included with the kit ST Microelectronics motion MEMS and environmental sensor Shield o 3 axis accelerometer 3 axis gyroscope o 3 axis magnetometer o Humidity and temperature o Pressure Maxim Integrated thermocouple to...

Page 5: ...s 2 USB A to microUSB B cables Ethernet cable 8GB microSD card microSD to SD card adapter ST Microelectronics motion MEMS and environmental sensor Shield Maxim Integrated thermocouple to digital peripheral module Wind River Pulsar Linux Documentation o MZ IIoT Kit Quick Start Card o Wind River Pulsar Quick Start Card ...

Page 6: ...gn Example1 MicroZed 7010 SPI Peripheral Application with Wind River Pulsar Linux1 MicroZed 7010 I2C Peripheral Application with Wind River Pulsar Linux1 Trainings and Videos http microzed org support trainings and videos Overview of MicroZed Introduction to Zynq 7000 All Programmable SoC Developing Zynq 7000 All Programmable SoC Software Developing Zynq 7000 All Programmable SoC Hardware Wind Riv...

Page 7: ...om catalog IBM Bluemix Amazon Web Services Application Source Code https github com Avnet software Wind River Pulsar Linux http www windriver com products operating systems pulsar Available through Avnet FAE Altium source database for schematic and layout ...

Page 8: ...l Arduino compatible Shield site with connection to MicroZed PL I O Two 2x6 Pmod compatible peripheral interfaces for MicroZed Supports interface for PL based SDIO SPI Supports interface for I2C UART One 2x6 Pmod compatible peripheral interface to low power MCU connector ST Microelectronics motion MEMS and environmental sensor Shield Six sensor solutions connect on Shield sockets via I2C AXI soft ...

Page 9: ...m also offers a connection to a Cloud based SDK and visual debug environment on the Wind River Helix App Cloud This free service allows development on a remote target from any Web browser You may register here https app cloud windriver com For more details on Wind River Pulsar Linux consult the Wind River Pulsar Quick Start Card included in your kit or visit http www windriver com products operati...

Page 10: ...g Please check the Boot MODE jumpers and ensure they are in the position shown below This will allow the boot to source the image from the supplied microSD card JP1 in the top position JP2 and JP3 in the bottom position MicroZed SoM microSD Boot Mode Jumper Settings ...

Page 11: ...o the connector J3 top row at the end of the Arduino Carrier Card 3 Insert the supplied Pulsar microSD card in the cage beneath the MicroZed SoM 4 Attach the MicroZed SoM to the Arduino Carrier Card FMC connectors Set the boot mode jumpers for microSD boot see MicroZed SoM Boot Mode section 5 Plug a DHCP Server connected Ethernet cable to the MicroZed SoM RJ 45 In order to connect to the Watson Io...

Page 12: ...serial console on the host will display a login prompt as shown here 1 Log in at the command prompt with user pw root incendia 2 To upgrade the device firmware at the command prompt enter the following smart update This procedure is typically done only on the first time boot but it can be repeated as desired to manually check for updated repository contents The Smart Package Manager will automatic...

Page 13: ...e sample application reads data from both sensors and displays the result on the PC host serial console On the target the SPI interface is accessed from the application code using the built in SPIDEV driver in the Pulsar Linux kernel At the command prompt enter the following command maxim31855_sensor The temperatures are reported once on the console as shown below Note The thermocouple must be ins...

Page 14: ...or and outputs the values continuously to the PC host serial console On the target an I2C driver in the Pulsar Linux uses the sysfs virtual file system to export information about the I2C kernel subsystem to user space At the command prompt enter the following hts221_sensor The temperature and humidity values are reported on the console as shown below To end data display enter CTRL C in the consol...

Page 15: ...ication can be executed from the command prompt using the format IIoT_QuickStart_Demo uniqueID where uniqueID is any alphanumeric string you choose This string is simply used to isolate your specific instance from other simultaneous access requests to the site by any number of concurrent users It is valid only for the duration of the application run but can be reused or changed in each subsequent ...

Page 16: ...nto the browser of any Internet connected device HTS221 Temperature Data in IBM Watson IoT QuickStart Type CTRL C in the IIoT Kit console to terminate the application instance You may read data from other sensors by supplying an optional selection parameter following the uniqueID For a list of the sensors currently available from the application at the command prompt type IIoT_Quickstart_Demo abc1...

Page 17: ...Page 17 ...

Page 18: ...must have registered with IBM Watson IoT to set up your own Bluemix account If you have not done so to access your Bluemix trial and obtain a promotional code to access Avnet online training at no charge please visit http artofthepossibility com bluemix free trial Once you have your Bluemix account you will need to configure the Watson IoT broker and bind it to a running Bluemix application For fi...

Page 19: ...Page 19 Additional sensor options for the sample demonstration program can be displayed by requesting help at the command line IIoT_Bluemix_Demo help ...

Page 20: ...loud or between the IIoT Kit and the Cloud The HAC provides a full screen color coded editor and a compatible tool chain for your target as well as complete visual debugger With your IIoT Kit connected to the Internet you can debug applications seamlessly on your target regardless of the proximity of the device to your physical location To access the HAC follow these steps 1 Ensure the IIoT Kit is...

Page 21: ...oT kit is registered you can create a new application project by clicking the Create new project button For further details on getting started developing with the Wind River Helix Application Cloud on the MicroZed IIoT Kit view the online video Developing IIoT Applications on Wind River Helix App Cloud at http zedboard org support trainings and videos ...

Page 22: ... org Web Master webmaster microzed org To access the most current collateral for the MicroZed IIoT Starter Kit visit the community support page www microzed org content support and click one of the icons shown below Documentation Reference Designs Scroll to the Industrial IoT Starter Kit and click the View button Technical questions for the MicroZed IIoT Starter Kit should be directed to the Micro...

Page 23: ...t and Africa eucases xilinx com Asia Pacific including Japan apaccase xilinx com For technical support including the installation and use of the product license file contact Xilinx Online Technical Support at www xilinx com support The following assistance resources are also available on the website Software IP and documentation updates Access to technical support Web tools Searchable answer datab...

Page 24: ...Bluemix site using the credentials you established in the lab pre work The website is https console ng bluemix net 2 From the Bluemix main menu select CATALOG 3 From the Starters list on the left select Boilerplates 4 Click the Internet of Things Platform Starter 5 In the panel on the right enter a unique application name The name must consist entirely of alphanumeric characters and or the dash ch...

Page 25: ...ng message at the top of the page as follows After a few minutes the message changes to indicate the application has started running as shown below Depending on the volume of traffic to the site starting the application can take anywhere from 2 to 10 minutes ...

Page 26: ...ked together to perform a logical circuit In this case information arrives at the left in the blue input node and is interpreted as temperature data In the lower chain the temperature is evaluated based on a threshold and a status message printed This is the Bluemix equivalent to a helloWorld program and could be used with the Quickstart service to create an unsecured application connection from t...

Page 27: ...rvice is created we can bind our application to it so incoming data will be validated and then routed to your application 1 Return to the Dashboard tab in your browser 2 From the Bluemix main menu select CATALOG 3 From the Services map on the left select Internet of Things 4 Click Internet of Things Platform 5 In the rightmost panel select the application to bind to the service from the App drop d...

Page 28: ...by clicking the RESTAGE button when presented Once the application is running you will have a new Bluemix option for authentication which can be used with the IIoT_Bluemx_Demo on the target As before this operation will take a few minutes 2 10 to complete ...

Page 29: ...ld still be in the Dashboard tab in the browser Select it if you are not 2 Click the Back to Dashboard link in the left panel 3 Your application displays a new icon representing the IoT service bound previously Click the IoT icon in your application to display the Internet of Things Platform page 4 In the Connect your Devices column click the Launch Dashboard button ...

Page 30: ...meters to associate with the device type For example the manufacturer Avnet or the serial number which is located on a white sticker on the bottom of the board 7 Click the Create device type button again on the updated browser page 8 Fill in the Name and Description of the new device type You can follow the example below or enter information of your choosing Click the Next button at the bottom rig...

Page 31: ...de of your Bluemix application Note that the Manufacturer field is automatically filled in If you expand the Additional fields you can optionally enter further device information Click the Next button 14 Click the Next button to skip the optional Metadata entry 15 In the Add Device Security panel enter a simple token in the Provide a token optional field This will be easier to remember and enter l...

Page 32: ...temporarily to the desktop 17 To use the new service you need to create update the configuration file with the new authentication information This is done on the target MZ IIoT Kit device a Return to the terminal console or reboot your target and log in and ensure you are still in the root directory b Launch the vi editor on the target to create a new file called device cfg vi device cfg You will ...

Page 33: ...ep 16 your file contents would appear as shown here org 8a8rej type MicroZed id MZ 1402120 7010 auth method token auth token SecurityToken99 e When you have completed entering all the information return to command mode by hitting the ESC key followed by a colon ii The cursor will go to the bottom of the screen f Enter wq for write quit At this point you should be back at the command line 18 List y...

Page 34: ... is more convenient to use a configuration file Complete the Bluemix Application 1 Return to the Node RED editor tab in your host browser and double click the IBM IoT App In node to edit the node a Select the Bluemix Service as the Authentication method b Uncheck the All box to the right of Device Type and enter the value you created in the prior section ie MicroZed c Uncheck the All box to the ri...

Page 35: ...ection using the right bubble on the danger node 4 Double click the temp thresh node Update the values in both boxes to 2500 integer representation of 25 degrees Celsius to two decimal places Click the OK button 5 Double click the danger node Add 10 spaces after critical as shown below This will correct an overwrite issue on the output console when switching between the safe and danger nodes Click...

Page 36: ...ight 8 Return to the IIoT Kit console and run the IIoT_Bluemix_Demo application You can monitor the connection in the debug panel of the Node RED flow editor and you will see new messages on the target console that indicate the Cloud is communicating back to the target In the target console enter IIoT_Bluemix_Demo ...

Page 37: ...ct View Show Sidebar check the box On the IIoT Kit console you will see corresponding transmissions JSON string above each Publishing line and the incoming response from the Bluemix application If you do not see the return messages on your console the local credentials in the device cfg file on your target do not match those entered above in the Bluemix IBMiot output node properties step 6 Also ma...

Page 38: ...the service This will prevent charges from accumulating in the event you are not using a Free service 1 Close the Node Red tab in your browser by clicking the X icon 2 Close the Watson IoT Platform tab by clicking the X icon 3 In the Dashboard IBM Bluemix tab click Back to Dashboard 4 Click the gear icon at the upper right of your running application ...

Page 39: ...on the Log Out link that appears Click the Log Out button in the new dialog to confirm 8 You may now close the browser 9 If you still have the target application running enter CTRL C in the console 10 To ensure a safe power down of the IIoT Kit enter poweroff at the console prompt 11 You may now disconnect the serial microUSB cable from the MicroZed SoM and the power microUSB cable from the Arduin...

Reviews: