Page 2
Document Control Document Version: Document Date: 04 February 2018 Prior Version History Version Date Comment 30 May 2016 Initial MiniZed Hardware User Guide 04 Feb 2018 Updated to comply with new Avnet branding Page 2...
Watson IoT BluemixTM application, where the data is analyzed and resulting commands are sent back to the target. You will need to set up an IBM Watson IoT account to access the Bluemix services. A free trial and free online training is available through Avnet by filling out the registration at: http://artofthepossibility.com/bluemix-free-trial...
Tutorials and Reference Designs: http://microzed.org/support/design/13591/ MicroZed 7010 SPI and I2C Vivado Design Example MicroZed 7010 SPI Peripheral Application with Wind River Pulsar Linux MicroZed 7010 I2C Peripheral Application with Wind River Pulsar Linux Trainings and Videos: http://microzed.org/support/trainings-and-videos ...
Cloud Solutions: https://acm.avnetcloudsolutions.com/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 7...
MicroZed IIoT Key Features MicroZed 7010 SoM Zynq™-7000 AP SoC XC7Z010-CLG400-1 Processor Memory o 1 GB DDR3 o 128 Mb Quad-SPI Flash o 4 GB microSD card Communication o 10/100/1000 Ethernet o USB Host 2.0 and USB-UART ...
MicroZed IIoT Starter Kit Basic Setup and Operation The MicroZed IIoT Starter Kit includes an 8 GB microSD card preloaded with a certified Wind River Pulsar Linux image, augmented with SPI and I2C drivers for the sensor peripherals and a bitstream to provide hardware support.
Page 10
MicroZed SoM Component Locations and Factory Boot Setting 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).
Tera Term Pro. If not previously installed on your host system, visit: http://microzed.org/support/documentation/1519 to download and install the drivers referenced in Avnet’s CP210x USB-to-UART Setup Guide. MicroZed IIoT Hardware Setup 1. Attach the ST Micro X-NUCLEO-IKS01A1 Shield to the Arduino Carrier Card.
Pulsar Login and Firmware Upgrade Once power has been applied to the kit, the boot sequence will initialize the Programmable Logic with the supplied hardware system. Completion of this step is indicated by the illumination of the blue DONE LED on the MicroZed SoM. Once hardware initialization is complete, the Pulsar Linux software will boot from the microSD card.
Running the Applications Run the SPI Application The SPI application reads temperature data from the Maxim 31855 Pmod sensors. There are two sensors on the module, one providing ambient temperature at the module location and the second from the end of the cable attached to the thermocouple. Thermocouple and Cable Internal Insert...
Run the I2C Application The I2C application reads temperature and humidity data from the ST Microelectronics HTS221 sensor, located on the Arduino Shield. HTS221 Temperature/Humidity Sensor (U3) HTS221 Sensor Location The sample application reads data values from the sensor and outputs the values continuously to the PC host serial console.
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.
Page 16
with <uniqueID> appended to the end. You may click the link above to go to the website and enter your <uniqueID> in the text box provided, or copy the link directly from the serial console and paste it into 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.
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...
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 19...
For details on this and other features of your software platform, consult the Wind River Pulsar Quickstart Card included in the kit. However, with Avnet Zynq SoMs you may also access a cloud-based Software Development Kit. Using Wind River Helix App Cloud (HAC) allows development from any Internet-enabled device with a web browser.
Page 21
4. Click on “Register an existing device…” and follow the on-screen prompts to create the cloud-based SDK workspace for your IIoT Kit. 5. Once the IIoT 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:...
Getting Help and Support Avnet Support Technical support is offered online through the MicroZed.org website support forums. MicroZed IIoT Starter Kit users are encouraged to participate in the forums and offer help to others when possible. For questions regarding the MicroZed community website, please direct questions to: MicroZed.org Web Master –...
Xilinx Support For questions regarding products within the Product Entitlement Account, send an email message to the Customer Service Representative in your region: Canada, USA and South America - isscs_cases@xilinx.com Europe, Middle East, 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.
Appendix I – Create Your Bluemix Service Create a Starter Cloud Application These instructions assume you have already registered for an IBM Watson IoT account. 1. From your host computer, log into the Bluemix site, using the credentials you established in the lab pre-work.
Page 25
6. Click the CREATE button. You will see the staging 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
7. Enter the following URL in your browser (or click the link in the app-running message): http://<ApplicationName>.mybluemix.net 8. Click Go to your Node-RED flow editor. This opens a new tab in your browser showing the Node-RED cloud application development SDK. The default application shown below is made up of different types of nodes, each with different operational characteristics, and linked together to perform a logical circuit.
Create a Cloud Service Quickstart is a public service that allows anyone to make an unsecured connection to the sample application. However, now that we have a custom application, we want to provide a more secure access point, through the IBM Watson IoT broker service. Once the service is created, we can bind our application to it, so incoming data will be validated and then routed to your application.
Page 28
6. Accept the offer to restage the application 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 28...
Register a Device Now we have an IoT Cloud application, bound to an IoT Service, and we are ready to establish credentials to register an edge device. 1. You should still be in the Dashboard tab in the browser. Select it if you are not. 2.
Page 30
If you are creating a device type, you will need to enter various parameters 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.
Page 31
10. In the Create Device Type panel, enter the Manufacturer as Avnet. Click the Next button. 11. Click the Create button to skip the optional Metadata entry. 12. In the Add Device – Choose Device Type panel, select the device type you just created and click the Next button.
Page 32
16. In the Add Device – Summary panel, review the information and click the ADD button. The system will display your device credentials. For example: Keep the authentication information handy, as you will need it to configure the edge application so it can connect to the running Bluemix application. TIP: Use the Windows snipping tool to save it temporarily to the desktop.
Page 33
c. Press the i keyboard key to enter Insert mode. d. Use the arrow keys as needed to move around the file Use the backspace key to erase the text you wish to replace. Type in the information you saved for your device credentials, replacing each line as indicated with the true information.
Using the example above, the listing appears as shown here: The IIoT_Bluemix_Demo program automatically looks in its current directory for a configuration file, so when it is launched, it will adopt your configuration credentials. These could be hard- coded in an application, but it is more convenient to use a configuration file. Complete the Bluemix Application 1.
Page 35
2. In the left-hand panel, scroll down to the output nodes and drag and drop the ibmiot node onto Flow 1. Position the node to the right and above the safe node. 3. Click the bubble on the right side of the safe node and with the left mouse button pressed, drag the cursor over to the left bubble on your new IBM IoT node to make a connection between them.
Page 36
Make sure you capitalize JSON in the Format box. Click the OK button. 7. Click the Deploy button at the top right. 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.
Page 37
In the debug tab in your Node-RED application, you will see data start to flow: Note: Clear the debug window by pressing the garbage can icon at the upper right. TIP: If you do not see an Info/Debug tab, click the right hamburger menu icon (three horizontal lines) and select View | Show Sidebar (check the box).
Clean up Once you are finished working with the Bluemix application and Watson IoT services, you should close the Bluemix application and stop the service. This will prevent charges from accumulating in the event you are not using a Free service. 1.
Page 39
5. Select Stop App from the pop-up menu. Click the STOP button in the subsequent dialog to confirm. 6. Once the application has stopped, you may log out from your Bluemix account by clicking on the icon in the upper right of the page. 7.
Need help?
Do you have a question about the MicroZed 7010 and is the answer not in the manual?
Questions and answers