Avnet MicroZed 7010 User manual

Page 1
Copyright © 2016 Avnet, Inc. AVNET, “Reach 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
Document 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
Contents
Getting Started with the MicroZed IIoT Starter Kit ................................................4
What’s Inside the Box? .........................................................................................5
MicroZed IIoT Starter Kit ..........................................................................................................5
What’s on the Web? .............................................................................................6
Official Documentation: ............................................................................................................6
Tutorials and Reference Designs:............................................................................................6
Trainings and Videos:...............................................................................................................6
MicroZed Documentation: ........................................................................................................6
Cloud Solutions: .......................................................................................................................7
Application Source Code:.........................................................................................................7
Wind River Pulsar Linux:..........................................................................................................7
Available through Avnet FAE: ..................................................................................................7
MicroZed IIoT Key Features .................................................................................8
MicroZed IIoT Starter Kit Basic 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
Avnet Support.........................................................................................................................22
Xilinx Support .........................................................................................................................23
Appendix I –Create Your Bluemix Service.........................................................24
Create a Starter Cloud Application.........................................................................................24
Create a Cloud Service ..........................................................................................................27
Register a Device ...................................................................................................................29
Complete the Bluemix Application..........................................................................................34
Clean up .................................................................................................................................38

Page 4
Getting Started with the MicroZed IIoT Starter Kit
The Avnet MicroZed IIoT Starter Kit enables hardware and software developers to create and
evaluate Zynq™-7000 All Programmable SoC designs, using on-board sensors to gather
information from the immediate surroundings and transmit the data to a Cloud environment.
Cloud services can be used for real-time data analysis and decision-making, data storage, post-
analysis, real-time or historical display and an ever-growing list of domain-specific functions.
The kit includes a standalone MicroZed System-on-Module (SoM) containing a hard-wired Zynq
Processing System (PS) with peripherals as well as enabling the Zynq Programmable Logic
(PL) fabric. This PS system includes DDR3 memory, Flash memory, gigabit Ethernet, USB 2.0
Host, and a UART.
The MicroZed SoM is attached to an ArduinoTM Carrier Card. The carrier brings both Shield
expansion and Peripheral Module (2x6 pin connectors) expansion to the MicroZed System-On-
Module. 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
o3-axis accelerometer + 3-axis gyroscope
o3-axis magnetometer
oHumidity and temperature
oPressure
Maxim Integrated thermocouple-to-digital peripheral module
oConnects to 2x6 peripheral module
oSPI-based interface
oMeasures temperatures from -270°C to +1800°C
oIncludes K-type thermocouple
This Getting Started Guide outlines the steps to set up the hardware, load a sample hardware
design, and execute Linux applications running on the ARM® dual-core Cortex™-A9 MPCore™
Processing System. Readings are taken from the on-board sensors and transmitted to an IBM
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

Page 5
What’s Inside the Box?
MicroZed IIoT Starter Kit
MicroZed 7010 SoM
Arduino Carrier Card +
(4) stand-offs and screws
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
oMZ IIoT Kit Quick Start Card
oWind River Pulsar Quick Start Card

Page 6
What’s on the Web?
MicroZed IIoT is a community-oriented kit, with all materials being made available through the
www.microzed.org community website. Documentation specific to the Arduino carrier can be
found here:
http://microzed.org/product/arduino-cc
Official Documentation:
Schematics (MicroZed 7010 and Arduino Carrier Card)
Bill of materials
Layout
Hardware manual
Board definition files
Tutorials and Reference Designs:
http://microzed.org/support/design/13591/
MicroZed 7010 SPI and I2C Vivado Design 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 River Pulsar Linux for Avnet Designed SoMs
MicroZed Documentation:
http://microzed.org/support/documentation/1519
MicroZed Getting Started Guide
Getting Started with Pulsar Linux on Avnet Zynq Boards
Wind River Pulsar Linux Overview
http://microzed.org/support/documentation/9031
MZCC_ARD Getting Started Guide

Page 7
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 8
MicroZed IIoT Key Features
MicroZed 7010 SoM
Zynq™-7000 AP SoC XC7Z010-CLG400-1 Processor
Memory
o1 GB DDR3
o128 Mb Quad-SPI Flash
o4 GB microSD card
Communication
o10/100/1000 Ethernet
oUSB Host 2.0 and USB-UART
Expansion connectors
o2 Micro-Header connectors (108 single-ended, 48 differential pairs, Agile Mixed
Signaling (AMS))
oDigilent Pmod™ Compatible header (8 MIO)
Clocking
o33.33333 MHz clock source for PS
Configuration and Debug
oXilinx Platform Cable JTAG connector
General Purpose I/O
o1 user LED
o1 push button
Arduino Carrier Card
Full 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 IP
o3-axis accelerometer and 3-axis gyroscope
o3-axis magnetometer
oHumidity and temperature
oPressure
General Purpose I/O
1 user LED
Maxim Integrated thermocouple-to-digital peripheral module
Connects 2x6 peripheral module via SPI AXI soft IP
Dual temperatures from on-board sensor and thermocouple sensor
oThermocouple temperature range -270°C to +1800°C

Page 9
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. The image also contains the following pre-built
applications:
1. HTS221 Temperature and Humidity sense example
2. Maxim 31855 Dual Temperature sense example
3. Cloud-connectivity example using IBM Watson IoT and Bluemix services
Wind River Pulsar Linux is an application-ready development and production platform, allowing
for on-target compilation and remote upgrade through the Smart Package Manager. The
platform 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/operating-systems/pulsar/
MicroZed SOM Boot Mode
Before assembling the kit items, please take a moment to locate the key components on the
MicroZed SoM and ensure it is in the microSD boot configuration. MicroZed SoMs are available
standalone, and have the Boot MODE jumpers configured at the factory to boot from QSPI
flash. In QSPI flash mode, a memory-resident Linux kernel and file system will boot but will not
provide the software/hardware elements necessary to complete the procedures in this guide.

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).
MicroZed SoM microSD Boot Mode Jumper Settings

Page 11
Install Silicon Labs CP210x USB-to-UART Drivers on a PC
The USB-to-UART port on the MicroZed SoM is required to display serial output generated on the
target to a console on a host PC. To use a standard USB port on a host PC as a serial device,
you must first install drivers from Silicon Labs. The drivers will allow the USB connection to be
enumerated as a serial port, which can then be used to communicate with the target via a serial
communications program such as 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.
2. Plug the thermocouple into the Maxim 31855 Pmod and attach the assembly to 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 IoT Bluemix service via Ethernet, the kit must be able to obtain a
LAN IP address from a DHCP server, and a gateway address that allows unfettered Internet
access.
6. Connect one microUSB cable between the AC/DC power supply and Arduino power port
(J7). The blue DONE LED adjacent to SW2 on the MicroZed SoM will illuminate as the
board boots Wind River Pulsar Linux.
Connect the USB-UART port on the MicroZed SoM (J2) to a free USB port on your PC. Use the
PC Device Manager to determine the COM port and set the console parameters to
115200,n,8,1. Optionally, reset the processor by pressing and releasing the RST button on the
MicroZed SoM (SW2) to view the entire boot.

Page 12
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. On completion of the boot, the 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 automatically contact the Wind River public repository to
compare the contents on the microSD card with the current packages available. If necessary,
newer packages will be downloaded and installed automatically.

Page 13
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
Pmod On-board Temperature Sensor Location
The 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 inserted into the Pmod, or the application will detect an open
circuit and exit without displaying temperature values.
Internal
Temperature
Sensor
Insert
Thermocouple
here

Page 14
Run the I2C Application
The I2C application reads temperature and humidity data from the ST Microelectronics HTS221
sensor, located on the Arduino Shield.
HTS221 Sensor Location
The sample application reads data values from the sensor 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 console.
HTS221
Temperature/Humidity
Sensor (U3)

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/

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.
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 abc123 –help

Page 17

Page 18
Run the IIoT Bluemix Demonstration
This demonstration builds on the Quickstart application, adding these features:
Published data requires security credentials to connect to a Bluemix application
The Bluemix application processes published data and communicates analytic results
back to the IIoT Kit through a callback registration mechanism
Incoming results from Bluemix are received by the application and the User LED on the
MicroZed is accessed to convey status information
Your IIoT kit must be connected to the Internet for this demonstration to operate correctly, and
you 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 first time operation, see Appendix I for step-by-
step instructions.
1. Ensure that your Cloud (Bluemix) application is running, as described in Appendix I.
2. To run the IIoT Bluemix demonstration, at the command prompt for the IIoT Kit enter:
./IIot_Bluemix_Demo
The application will read temperature and humidity values from the HTS221 sensor on the
Shield and transmit data to your Bluemix service.

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
Wind River Helix App Cloud
Pulsar Linux provides an application-ready development environment on the MicroZed SoM,
allowing you to create and build programs in the command line environment directly on the
target. 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. Application source can be uploaded and downloaded easily from a
host system to the Cloud, 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 connected to the Internet and at the Pulsar command prompt enter:
registerTarget –n <RandomCode>
2. You will receive a Registration Key valid for approximately 20 minutes. Direct your host-
based browser to: https://app.cloud.windriver.com/
3. Sign in with your Wind River Support credentials
1
and click the New Device button.
1
If you do not already have a Wind River Account, you may create one by clicking the Register Now
button on this site.