Document DUSTY Users Guide 13/07/2017 DUSTY Users Guide Model 1: PCB Ant. Model 2: U.FL Conn. All information contained in these materials, including products and product specifications, represents information on the product at the time of publication and is subject to change by IOTEAM S.r.l. without notice. Doc: DUSTY Users Guide, Rev 1.4 1 of 19 Outline Document DUSTY Users Guide 13/07/2017 1. INTRODUCTION ....................................................................................................................................... 4 1.1. DESCRIPTION ....................................................................................................................................... 4 2. SYSTEM OVERVIEW ................................................................................................................................ 5 2.1. SMARTMESH IP TECHNOLOGY OVERVIEW .......................................................................................... 5 2.2. DUSTY IN A SMARTMESH IP NETWORK .............................................................................................. 5 2.3. SMARTMESH IP FEATURES ............................................................................................................... 6 2.4. LTC5800-IPM - SMARTMESH IP WIRELESS 802.15.4E SYSTEM-ON-CHIP.......................................... 6 2.5. BLOCK DIAGRAM .................................................................................................................................. 8 2.6. MODULE SPECIFICATIONS ...................................................................................................................... 8 3. CONNECTORS ......................................................................................................................................... 9 4. USAGE .................................................................................................................................................... 12 4.1. POWER SUPPLY ................................................................................................................................. 12 5. BOARD LAYOUT .................................................................................................................................... 13 5.1. DUSTY PCB-ANT MOUNTING SUGGESTION........................................................................................... 14 6. FIRMWARE UPLOAD ............................................................................................................................. 15 7. SOFTWARE DEVELOPMENT ................................................................................................................ 16 8. REFERENCES AND USEFUL LINKS .................................................................................................... 17 8.1. DATA SHEETS AND DOCUMENTS .......................................................................................................... 17 8.2. TOOLS ............................................................................................................................................... 17 8.3. WEB SITES ........................................................................................................................................ 17 9. FCC STATEMENT: ................................................................................................................................. 18 9.1. RF RADIATION EXPOSURE STATEMENT: .............................................................................................. 18 FCC INFORMATION TO OEM INTEGRATOR ........................................................................................... 19 9.2. 10. CERTIFICATION ................................................................................................................................. 19 Illustrations IMAGE 1 MESH NETWORK ..................................................................................................... 5 IMAGE 2 LTC 5800 IPM ..................................................................................................... 7 IMAGE 3 DUSTY BLOCK DIAGRAM ........................................................................................... 8 IMAGE 4 DUSTY PINOUT TOP VIEW ......................................................................................... 9 IMAGE 5 DUSTY DIMENSIONS .............................................................................................. 13 IMAGE 6 DUSTY MOUNTING SAMPLE ....................................................................................... 14 IMAGE 7 REQUIRED TOOLS TO UPLOAD FIRMWARE ...................................................................... 15 Tables TABLE 1 PINOUT DESCRIPTION ............................................................................................ 10 TABLE 2 SIGNAL SHORT DESCRIPTION.................................................................................... 11 Doc: DUSTY Users Guide, Rev 1.4 2 of 19 Document DUSTY Users Guide 13/07/2017 Revisions REVISION DATE DESCRIPTION STATUS AUTHOR REVISER info@ioteam.it info@ioteam.it SB info@ioteam.it Ver. 1.0 Ver. 1.1 Ver. 1.4 31/01/2017 First release 04/07/2017 FCC 13/07/2017 Certificazioni Final Final Final Disclaimer All rights strictly reserved. Reproduction in any form is not permitted without written authorization from IOTEAM s.r.l. IOTEAM s.r.l. Via Colzani 48 20831 Seregno (Monza Brianza) info@ioteam.it www.ioteam.it Doc: DUSTY Users Guide, Rev 1.4 3 of 19 Document DUSTY Users Guide 13/07/2017 1. Introduction 1.1. Description This document describes the Dusty module. Dusty is a SmartMesh IP PCBA product incorporating the LTC5800-IPM SoC running Dusts embedded SmartMesh IP networking software. The Dusty module comes complete with an onboard PCB antenna or U.FL antenna connector, crystals and modular RF certifications. The Dusty module is produced in two flavors:
Dusty PCB-Ant (On board PCB Antenna) Dusty U.LF Ant Conn (On board U.LF antenna connector) Main features PCBA module with PCB antenna or U.FL connector Integrated 2.4 GHz, IEEE 802.15.4e System-on-Chip, complete with Embedded SmartMesh Networking Software
>99.999% Network Reliability in the Most Challenging RF Environments Sub 50A Routing Nodes Serves as either a Wireless Mote, Embedded Manager, or Access Point Mote in a SmartMesh IP network depending on the loaded firmware Doc: DUSTY Users Guide, Rev 1.4 4 of 19 Document DUSTY Users Guide 13/07/2017 2. System overview 2.1. SmartMesh IP Technology overview Image 1 Mesh network A SmartMesh IP network consists of a highly scalable self-forming multi-hop mesh of wireless nodes, known as motes, and an Access Point mote that connects the motes to the Network Manager, monitoring and managing network performance and security, and acting as a bridge between the host application and the wireless network. Motes are capable of two way communication and they collect and relay data. 2.2. Dusty in a SmartMesh IP network With SmartMesh IP time-synchronized networks, all motes in the network may route, source or terminate data, while providing many years of battery powered operation. SmartMesh IP is a highly flexible network with proven reliability and low power performance in an easy-to-integrate platform. The Dustys behavior in a SmartMesh IP network is determined by the choice of SmartMesh IP network software loaded: Wireless Mote, Embedded Manager, or Access Point Mote. The SmartMesh IP software provided with the Dusty is fully tested and validated, and is readily configured via a software Application Programming Interface. For more information on SmartMesh IPTM visit the following site:
http://www.linear.com/products/smartmesh_ip Doc: DUSTY Users Guide, Rev 1.4 5 of 19 Document DUSTY Users Guide 13/07/2017 2.3. SmartMesh IP Features Ultra low-power network The network can run on batteries, energy harvesting, or line power High network reliability
>99.999% network reliability even in harsh RF environments IPv6 addressability Combines 6LoWPAN with IEEE 802.15.4e Comprehensive security management Allows you to configure NIST-certified AES-128 based security to meet your requirements Flexible configuration Network parameters can be selected to match specific system requirements
(power / latency / bandwidth) Fully tested network stack and manager software Application programming interfaces are used to communicate with and to configure the product - no user networking code necessary. 2.4. LTC5800-IPM - SmartMesh IP Wireless 802.15.4e System-on-Chip The Dusty module is based on Linear Technology Corp.s LTC5800-IPM SmartMesh IP Wireless 802.15.4e System-on-Chip. The LTC5800-IPM provides a highly integrated, low power radio design as well as an ARM Cortex-M3 32-bit microprocessor running SmartMesh IP embedded networking software. For more information on LTC5800-IPM visit the following site:
http://www.linear.com/product/LTC5800-IPM Doc: DUSTY Users Guide, Rev 1.4 6 of 19 Document DUSTY Users Guide 13/07/2017 Image 2 LTC 5800 IPM Doc: DUSTY Users Guide, Rev 1.4 7 of 19 Document DUSTY Users Guide 13/07/2017 2.5. Block diagram An overview of the functions of the DUSTY module is shown in the figure below:
Image 3 Dusty Block diagram 2.6. Module Specifications For a more detailed specification refer to the original LTC5800 datasheet:
SmartMesh IP Node 2.4GHz 802.15.4e Wireless Mote-on-Chip http://cds.linear.com/docs/en/datasheet/5800ipmfa.pdf Doc: DUSTY Users Guide, Rev 1.4 8 of 19 Document DUSTY Users Guide 13/07/2017 3. Connectors The following picture shows the Dusty module pinout. The module is seen from the top (top view) but the two Power Supply pads are on the bottom side of the module. The pins and the pads position is the same for both module types. Image 4 Dusty pinout TOP View Doc: DUSTY Users Guide, Rev 1.4 9 of 19 Document DUSTY Users Guide 13/07/2017 The signals of the pins depend on the firmware loaded on the module. Dusty Pin SoC Pin I/O LTC5800-IPR Embedded Manager Pull LTC5800-IPM Moto on chip Description LTC5800-IPA Access Point Mote 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 15 16 17 18 22 23 24 25 26 27 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 55 66 67 68 69 70 71 72 1 11 13 12 EP 65 AI_0 AI_1 AI_3 AI_2 AI_0 AI_1 AI_3 AI_2 RESETn RESETn TDI TDO TMS TCK DP4 DP3 DP2 SLEEPN DP0 UARTC0_TX / EB_IO_LE0 UARTC0_RX / EB_DATA_1 SPIM_MISO IPCS_MISO SPIM_MOSI IPCS_MOSI SPIM_SCK IPCS_SCK IPCS_SSn SPIM_SS_1n SPIM_SS_0n DP1 PWM0 UARTC1_TX UARTC1_RX EB_IO_WEn EB_IO_OEn FLASH_P_Enn / EB_IO_LE1 UART_RX_RTSn UART_RX_CTSn UART_RX UART_TX_RTSn UART_TX_CTSn UART_TX TIMEn RADIO_INHIBIT LNA_EN RADIO_TXn RADIO_TX GND VSUPPLY TDI TDO TMS TCK DP4 / GPIO23 / TIMER8_EXT DP3 / GPIO22 / TIMER8_EXT DP2/ GPIO21 / LPTIMER_EXT SLEEPn / GPIO14 DP0 / GPIO0 / SPIM_SS_2n UARTC0_TX UARTC0_RX SPIM_MISO / GPIO11 IPCS_MISO / TIMER16_OUT / GPIO6 SPIM_MOSI / GPIO10 IPCS_MOSI / TIMER16_EXT / GPIO5 SPIM_SCK / GPIO9 IPCS_SCK / TIMER8_EXT / GPIO4 IPCS_Ssn / LPTIMER_EXT / GPIO3 SPIM_SS_1n / GPIO13 SPIM_SS_0n / GPIO12 DP1 / GPIO20 / TIMER16_EXT PWM0 / TIMER16_OUT / GPIO16 SPIS_MISO / UARTC1_TX / 1_WIRE SPIS_MOSI / UARTC1_RX / GPIO26 SPIS_SCK / SCL SPIS_Ssn / SDA FLASH_P_ENn UART_RX_RTSn UART_RX_CTSn UART_RX UART_TX_RTSn UART_TX_CTSn UART_TX TIMEn RADIO_INHIBIT LNA_EN / GPIO17 RADIO_Txn / GPIO19 RADIO_TX / GPIO18 GND VSUPPLY Table 1 Pinout Description RESERVED RESERVED RESERVED RESERVED RESETn TDI TDO TMS TCK DP4 RESERVED RESERVED RESERVED RESERVED UARTC0_TX UARTC0_TX SPIM_MISO IPCS_MISO SPIM_MOSI IPCS_MOSI SPIM_SCK IPCS_SCK IPCS_SSn SPIM_SS_1n SPIM_SS_0n RESERVED PWM0 RESERVED RESERVED RESERVED RESERVED FLASH_P_ENn RESERVED RESERVED UART_RX RESERVED RESERVED UART_TX TIMEn RESERVED LNA_EN RADIO_TXn RADIO_TX GND VSUPPLY Doc: DUSTY Users Guide, Rev 1.4 10 of 19 Name AI_n DPn TDI TDO TMS TCK UARTCn_TX UARTCn_RX SPIM_MISO SPIM_MOSI SPIM_SCK SPIM_SS_1n SPIM_SS_0n RESETn SLEEPN IPCS_MISO IPCS_MOSI IPCS_SCK IPCS_SSN SPIS_MISO SPIS_MOSI SPIS_SCK SPIS_SSN UART_RX UART_TX UART_TX_RTSn UART_TX_CTSn UART_RX_RTSn UART_RX_CTSn FLASH_P_ENn I/O I I/O I I I I O I I O O O O I I O I I I O I I I I O O I I O I I/O EB_DATA_n O EB_IO_LE0 O EB_IO_LE1 O EB_IO_LE2 EB_ADDR_x O I EB_IO_CS0n EB_IO_WEn O EB_IO_OEn O GPIO_n PWM0 I/O O I TIMER8_EXT TIMER8_OUT O I TIMER16_EXT TIMER16_OUT O I/O 1_WIRE LPTIMER_EXT TIMEn RADIO_INHIBIT LNA_EN RADIO_TXN RADIO_TX I I I O O O Document DUSTY Users Guide 13/07/2017 Pull Description
-
-
UP
-
UP Analog Input n General Purpose Digital I/O n JTAG Test Data In JTAG Test Data Out JTAG Test Mode Select DOWN JTAG Test Clock
-
CLI UART n Transmit UP CLI UART n Receive
-
-
-
-
-
SPI Master (MISO) Master In Slave Out Port SPI Master (MOSI) Master Out Slave In Port SPI Master (SCK) Serial Clock Port SPI Master Slave Select 1, Active Low SPI Master Slave Select 0, Active Low UP Reset Input, Active Low Deep Sleep, Active Low SPI Flash Emulation (MISO) Master In Slave Out Port SPI Flash Emulation (MOSI) Master Out Slave In Port SPI Flash Emulation (SCK) Serial Clock Port SPI Flash Emulation Slave Select, Active Low SPI Slave (MISO) Master In Slave Out Port SPI Slave (MOSI) Master Out Slave In Port SPI Slave (SCK) Serial Clock Port SPI Slave Select, Active Low UART Receive UART Transmit UART Transmit (RTS) Request to Send, Active Low UART Transmit (CTS) Clear to Send, Active Low UART Receive (RTS) Request to Send, Active Low UART Receive (CTS) Clear to Send, Active Low
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
UP Flash Program Enable, Active Low
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
External Bus Data Bit n External Bus I/O Latch Enable 0 for External Address Bits A[25:18]
External Bus I/O Latch Enable 1 for External Address Bits A[17:10]
External Bus I/O Latch Enable 2 for External Address Bits A[9:2]
External Bus Address Bit x (0 or 1) External Bus Chip Select 0 External Bus Write Enable Strobe External Bus Output Enable Strobe General Purpose Input Output n Pulse Width Modulator 0 External Input to 8-Bit Timer/Counter 8-Bit Timer/Counter Match Output External Input to 16-Bit Timer/Counter 16-Bit Timer/Counter Match Output/PWM Output 1 Wire Master External Input to Low Power Timer/Counter Time Capture Request, Active Low Radio Inhibit External LNA Enable Radio TX Active (External PA Enable/Switch Control), Active Low Radio TX Active (External PA Enable/Switch Control) Table 2 Signal short Description Doc: DUSTY Users Guide, Rev 1.4 11 of 19 Document DUSTY Users Guide 13/07/2017 4. Usage This chapter describes how to connect, configure and interact with the Dusty module. 4.1. Power supply Dusty is powered from a single pin, VSUPPLY, which powers the I/O cells and is also used to generate internal supplies. Eternas two on-chip DC/DC converters minimize energy consumption while the device is awake. To conserve power the DC/DC converters are disabled when the device is in low-power state. Integrated power supply conditioning, including the two integrated DC/DC converters and three integrated low-dropout regulators, provides excellent rejection of supply noise. Eternas operating supply voltage range is high enough to support direct connection to lithium-thionyl chloride (Li-SOCl2) sources and wide enough to support battery operation over a broad temperature range. Doc: DUSTY Users Guide, Rev 1.4 12 of 19 Document DUSTY Users Guide 13/07/2017 5. Board layout The following picture shows the dimensions of the two Dusty types: Dusty PCB-
Ant (integrated PCB Antenna) and Dusty U.FL Ant Conn (integrated U.FL antenna connector) Image 5 Dusty dimensions Doc: DUSTY Users Guide, Rev 1.4 13 of 19 Document DUSTY Users Guide 13/07/2017 5.1. Dusty PCB-Ant mounting suggestion The Dusty PCB-Ant provides an integrated PCB Antenna, therefore it is really important that the module is mounted on the hosting board in the proper way. No other components should be mounted around the antenna. The following picture provides an example of how the module should be mounted on a hosting board. Note how the antenna juts out of the hosting board. Image 6 Dusty mounting sample Doc: DUSTY Users Guide, Rev 1.4 14 of 19 Document DUSTY Users Guide 13/07/2017 6. Firmware Upload Dustys behavior in a SmartMesh IP network is determined by the choice of SmartMesh IP network Firmware loaded:
Wireless Mote Emanager Access Point Mote. By default Dusty will have the Wireless Mote firmware preloaded with some predefined characteristics. If the user wants to change the firmware or change some parameters it is necessary to upload the firmware. The firmware can be downloaded from:
https://www.linear.com/mylinear/login.php In order to download the firmware, the customer must sign in and ask the local sales team the firmware. Theyll post the file to be downloaded from the Mylinear web site and uploaded to Dusty. The firmware upload requires the following tools:
Firmware to be uploaded Eterna DC9010 Serial Programmer Dusty connector used to connect the module to the Eterna Serial Programmer PC running Windows and USB 2.0 or USB 3.02 port ESP software (downloadable from http://www.linear.com/dust_programmer) Image 7 Required tools to upload firmware Doc: DUSTY Users Guide, Rev 1.4 15 of 19 Document DUSTY Users Guide 13/07/2017 For the detailed procedure and more detailed information see the following document:http://www.linear.com/docs/en/software-and-
simulation/Eterna_Serial_Programmer_Guide.pdf 7. Software Development The ARM Cortex-M3 32-bit microprocessor, inside the LTC5800-IPM SoC, normally runs the provided SmartMesh IP network software, but it can be customized and allows the user to develop their own software and add functionality to the module. The On-Chip Software Development Kit (OCSDK) allows you to write applications directly on the LTC5800-IP SoC on top of the SmartMesh IP network protocol stack. The SmartMesh IP stack and the device drivers are provided as pre-compiled libraries. Your mote application links against them, and can then be loaded into the Dusty board. In order to develop a custom firmware to be uploaded to the Dusty module, the following tools are necessary:
A Windows PC IAR Embedded Workbench for ARM. Note that the kickstart addition will not work with the OCSDK On-Chip Software Development Kit (OCSDK) downloadable from Github (https://github.com/dustcloud/onchipsdk) Library files from Linear to be copied into the OCSDK Python installed on the PC Programming and debugging tools (optional) All the details and instructions about the development of custom firmware for the LTC5800-IPM SoC embedded in the Dusty module may be found at the following link: https://dustcloud.atlassian.net/wiki/display/OCSDK/
Doc: DUSTY Users Guide, Rev 1.4 16 of 19 Document DUSTY Users Guide 13/07/2017 8. References and Useful Links 8.1. Data sheets and documents http://www.linear.com/products/smartmesh_ip http://www.linear.com/product/LTC5800-IPM http://cds.linear.com/docs/en/datasheet/5800ipmfa.pdf (Mote on chip) http://cds.linear.com/docs/en/datasheet/5800ipaf.pdf (Access Point Mote) http://cds.linear.com/docs/en/datasheet/5800iprfa.pdf (Embedded Manager on chip) 8.2. Tools http://cds.linear.com/docs/en/software-and-
simulation/Eterna_Serial_Programmer_Guide.pdf https://dustcloud.atlassian.net/wiki/display/OCSDK/
https://www.iar.com/iar-embedded-workbench/arm/
8.3. Web Sites IoTeam www.ioteam.it Linear Technology www.linear.com Doc: DUSTY Users Guide, Rev 1.4 17 of 19 Document DUSTY Users Guide 13/07/2017 9. FCC Statement:
This equipment has been tested and found to comply with the limits for Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:
Reorient or relocate the receiving antenna. Increase the separation between the equipment and receiver. Connect the equipment to an outlet on a circuit different from that to which the receiver is connected. This device complies with part 15 of the FCC rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Note: Modifications to this product will void the users authority to operate this equipment. 9.1. RF Radiation Exposure Statement:
1. This Transmitter must not be colocated or operating in conjunction with any other antenna or transmitter. 2. This equipment complies with FCC RF radiation exposure limits set forth for an uncontrolled environment. This equipment should be installed and operated with a minimum distance of 20 centimeters between the radiator and your body. Doc: DUSTY Users Guide, Rev 1.4 18 of 19 Document DUSTY Users Guide 13/07/2017 9.2. FCC Information to OEM integrator The OEM integrator has to be aware not to provide information to the end user regarding how to install or remove this RF module in the user manual of the end product. The user manual which is provided by OEM integrators for end users must include the following information in a prominent location. 1. To comply with FCC RF exposure compliance requirements, the antenna used for this transmitter must be installed to provide a separation distance of at least 20 cm from all persons and must not be colocated or operating in conjunction with any other antenna or transmitter, except in accordance with FCC multitransmitter product procedures. 2. Only those antennas with same type and lesser gain filed under this FCC ID number can be used with this device. 3. The regulatory label on the final system must include the statement:
Contains FCC ID: 2AL5T - DUSTY or using electronic labeling method as documented in KDB 784748. 4. The final system integrator must ensure there is no instruction provided in the user manual or customer documentation indicating how to install or remove the transmitter module except such device has implemented two ways authentication between module and the host system. 10. Certifications ETSI EN 301 489-1 V2.1.1 (Europe) ETSI EN 301 489-17 V3.1.1 (Europe) EN 61000-3-2:2014 (Europe) EN 61000-3-3:2013 (Europe) ETSI EN 300 328 V2.1.1 (Europe) FCC CFR47 Part 15 (/US) RoHS 2011/65/EU Doc: DUSTY Users Guide, Rev 1.4 19 of 19