UM0562 User manual SPMB250-A1EVAL demonstration kit user manual and installation guide Introduction The SPMB250-A1 is a ready-to-use wireless acceleration sensor based on a 802.15.4compliant radio transceiver. The integration of two SPMB250-A1 modules together with an 802.15.4 ZigBee(R)-based dongle make the SPMB250-A1EVAL demonstration kit a complete tool for demonstrating the features and functions of the SPMB250-A1 in remote motion monitoring applications. The modules in the kit are pre-programmed with an application based on the EmberZNetTM 3.0.0 ZigBee(R) protocol stack that allows the sending of data captured by the accelerometer to the dongle when plugged into a PC USB slot. The kit also includes a graphical application which provides an example of one of the possible uses of the acceleration data. Figure 1. SPMB250-A1EVAL demonstration kit Remote motion monitoring Motion tracking November 2009 Doc ID 14826 Rev 2 Motion recognition 1/15 www.st.com Contents UM0562 Contents 1 2 3 4 SPMB250-A1EVAL description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1 Demonstration kit contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.2 CD contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3 Related documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.4 PC system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.5 Target applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 SPMB250-A1EVAL kit hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.1 SPMB250-A1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 ZigBee(R) dongle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Installation procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 3.1 Installing the FTDI driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 3.2 Installing the Plane demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Firmware description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 4.1 Dongle firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 4.2 MotionBeeTM firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4.3 Forming a network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 5 Plane demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 6 Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2/15 Doc ID 14826 Rev 2 UM0562 1 SPMB250-A1EVAL description SPMB250-A1EVAL description The SPMB250-A1EVAL (demonstration kit in the rest of the document) is a ready-to-use kit designed as a platform for evaluating the capabilities of the SPMB250-A1 wireless sensor in motion monitoring applications, where two sensor modules communicate with a remote device over an 802.15.4 channel. The kit includes two SPMB250-A1 modules and one ZigBee(R)-based dongle module. This document describes: the modules contained in the demonstration kit the features of the software loaded in the demonstration kit modules the format of the packets at the serial output of the dongle when the software is used The three different classes of demonstration kit users are: 1.1 Demo users - The kit runs the demo using a simple tilt monitoring application. In this case, the document provides guidelines on how to: - network the modules together - install the FTDI driver - install and run the demo Developers of new PC applications - The software loaded in the sensors and dongle is meant to be used without modifications and allows the development of PC applications that can use up to 4 SPMB250-A1 modules together. In this case the document provides guidelines on how to: - network the modules together - install the FTDI driver Developers of new application firmware - The new firmware must be loaded on the modules by means of integrated SIF connectors. Instructions on application development with the EmberZNetTM protocol stack and the use of Ember development tools for the SN250 is beyond the scope of this document. The reader should refer to the Ember documentation for details. Demonstration kit contents 2 SPMB250-A1 acceleration sensor modules 1 ZigBee(R) -based dongle 2 battery holders 8 AA batteries 1 CD Doc ID 14826 Rev 2 3/15 SPMB250-A1EVAL description 1.2 1.3 1.4 UM0562 CD contents SPMB250-A1 datasheet SPMB250-A1EVAL demonstration kit user manual and installation guide (this document) Plane demo software files javacomm20-win32 java3d-1_4_0-windows-i586-1 Related documents SPMB250-A1 datasheet SPZB250 datasheet Ember documentation library LIS3LV02DL datasheet and application note AN2381 PC system requirements Microsoft(R) Windows(R) XP Intel(R) Pentium(R) III or higher 512 MB of RAM 50 MB of available hard disk space An Internet connection to download the Java environment and FTDI driver (download files and follow installation instructions on the relevant web sites) To run the demonstration, the PC requires the installation of the Java SE Runtime Environment (JRE). The demo successfully runs with JRE 6.5, which is available from the Sun Microsystems web site. 1.5 Target applications Accelerometer sensors can be generally used to measure both dynamic and static acceleration data. The SPMB250-A1 provides a small, portable solution with the capability to accommodate various accelerometer applications requiring data transmission over a wireless channel. The radio is 802.15.4 compliant and is integrated with a processor in a single-chip solution for use with the EmberZNetTM ZigBee(R) protocol stacks. The accelerometer is a three-axis digital output linear MEMS sensor. Possible target application are: 4/15 Medical devices Sport equipment Games Environmental monitoring Industrial control Security Doc ID 14826 Rev 2 UM0562 2 SPMB250-A1EVAL kit hardware SPMB250-A1EVAL kit hardware The demonstration kit is ready-to-use and is designed as a platform to evaluate the capabilities of SPMB250-A1 wireless sensor in remote motion monitoring applications. The kit is securely packaged in a padded box, as shown in Figure 2. Figure 2. Demonstration kit box SW CD SPMB250-A1 Dongle Batteries and holders AM00533v1 2.1 SPMB250-A1 The SPMB250-A1 (referred to as MotionBeeTM in the remainder of the document) belongs to the STMicroelectronics MotionBeeTM sensor family and is designed to enable the development of applications for remote motion monitoring. This version of the MotionBeeTM sensor integrates an SPZB250 ZigBee(R) wireless module together with an LIS3LV02DL 3axis MEMS accelerometer and represents a ready-to-use battery-powered wireless sensor. The compact size of the MotionBeeTM makes it ideal for use in many different remote motion monitoring applications. When the EmberZNetTM protocol stack is loaded, MotionBeeTM can play the role of end-device or router in a ZigBee(R) network. The main components integrated in the MotionBeeTM modules are represented in Figure 3. Doc ID 14826 Rev 2 5/15 SPMB250-A1EVAL kit hardware Figure 3. UM0562 SPMB250-A1 MotionBeeTM module Accelerometer sensor Red Led Power Connector SPZB250 Power Switch Commissioning Button Green Led Reset Button SIF Connector AM00534v1 The accelerometer is a 3-axis digital-output linear MEMS sensor that includes a sensing element and an IC interface capable of taking information from the sensing element and providing the measured acceleration signals to external applications through an I2C/SPI serial interface. The LIS3LV02DL has a user-selectable full scale of 2 g, 6 g and is capable of measuring acceleration data over a bandwidth of 640 Hz for all axes. The device bandwidth may be selected according to application requirements. The SPZB250 is a ready-to-use ZigBee(R) module for OEM use. It integrates the SN250 ZigBee(R) system-on-chip (SoC) with an external oscillator, a balun filter and an antenna. The SN250 SoC design integrates a full-featured 802.15.4 radio with a 16-bit processor. It is designed to run the EmberZNet ZigBee(R) protocol stack from Ember Corp., and can be fully reprogrammed to run custom applications. The MotionBeeTM modules also integrate a SIF connector, allowing interfacing with the Ember development kit for firmware loading and debugging. Finally, the module integrates two LEDs, 1 power connector, 1 power switch, a reset button and a commissioning button. 2.2 ZigBee(R) dongle Based on the SPZB250, the ZigBee(R) dongle ("dongle" in the rest of the document) is a module with a USB stick form-factor. It provides a cost-effective method of adding ZigBee(R) wireless connectivity to any device which employs USB. The dongle can be programmed using the SIF connector integrated in the board. When connected, the dongle is powered through the USB and it can be used to transfer data to the connected operator for data analysis, storage and computation. The dongle uses a USB controller from FTDI Ltd. to communicate with the host computer. The main components of the dongle are represented in Figure 4. 6/15 Doc ID 14826 Rev 2 UM0562 SPMB250-A1EVAL kit hardware Figure 4. ZigBee(R)-based dongle module USB connector LEDs green yellow SIF Connector SPZB250 red AM00535v1 Doc ID 14826 Rev 2 7/15 Installation procedures UM0562 3 Installation procedures 3.1 Installing the FTDI driver The dongle integrates a USB controller from FTDI to communicate with the host computer. To communicate with the dongle, the FTDI drivers must be installed on the host. FTDI provides drivers for Windows, Linux, BSD, Macintosh, and Windows CE. Windows users require the virtual COM port (VCP) drivers. If the necessary drivers are not already installed on the PC, they can be downloaded from the driver section of the FTDI Chip web site. After the file has completed downloading to a folder on the PC, unzip the file. Plug the dongle into an available USB slot on the PC. The operating system detects the new hardware and prompts for the location where the driver files can be found. With the browser, select the root of the driver directory that was unzipped previously and follow the on-screen instructions. After installing the driver, the dongle appears as a COM port in the Windows device manager. Multiple dongles may be connected to the USB ports of the same computer simultaneously. In this case each dongle will be assigned a different COM port identifier. The example in Figure 5 shows one dongle connected to the PC and assigned COM27 as its "USB Serial Port". Figure 5. Virtual COM port number Device Manager Window Virtual COM associated to the Dongle AM00536v1 8/15 Doc ID 14826 Rev 2 UM0562 3.2 Installation procedures Installing the Plane demo In order to properly run the Plane demo, the following steps must be carefully followed: 1. Install the Java Runtime Environment (JRE) - the Plane demo has been developed in Java and requires the JRE installation on the PC. The demo has been successfully tested with JRE 6.5. 2. Install the Java3D package - Java 3D is an additional Java package that enables the creation of three-dimensional graphics applications and Internet-based applets. The Java3D install file is included in the demonstration kit CD. To install the package, double-click on the file: java3d-1_4_0-windows-i586-1, and follow the installation wizard. 3. Install the Javacomm package - Javacomm is an additional Java package that provides access to a serial port. It has been developed by Sun Microsystems and can be downloaded from the Sun web site. Javacomm is also included in the demonstration kit CD. To install the package: a) unzip javacomm20-win32.zip b) copy the file commapi/win32com.dll to <your_jdkroot_folder>/<your_jre_folder>/bin c) copy the file commapi/comm.jar to <your_jdkroot_folder>/<your_jre_folder>/lib/ext d) copy the file commapi/javax.comm.properties to <your_jdkroot_folder>/<your_jre_folder>/lib/ 4. Install the Java binary files - Copy "Plane.zip" from the demonstration kit CD into one of your personal folders (<your_folder> in the rest of the document) and unzip it. The folder "Plane" will be created that contains the Java binary files needed to run the demo. 5. Set the virtual COM port - The virtual COM port associated with the dongle (see the previous paragraph to detect this number) must be edited in the following file: <your_folder>/Plane/configfiles/configuration.xml For example, if the virtual COM port is COM27, the content of "configuration" file must become: <?xml version="1.0"?> <config> <port>27</port> <start>i</start> <stop>f</stop> <length>10</length> </config> where the number of the port is specified in line 3. Note: The names of folders contained in the folder path MUST NOT contain blank spaces. Doc ID 14826 Rev 2 9/15 Firmware description 4 UM0562 Firmware description The demonstration kit is released with a simple application already loaded in the MotionBeeTM and dongle modules. This application integrates the functionalities of a ZigBee(R)-based protocol (EmberZNetTM 3.0.0), which allows the networking of the modules in a star configuration, as represented in Figure 6. Specifically: When acting as end device/router, each MotionBeeTM collects data from the integrated accelerometer, encapsulates this data within the payload and transmits the packet over the wireless channel. When acting as network coordinator and sink device, the dongle receives the packets from the MotionBeeTM and transfers their payload to the serial port to make them available on the PC through the COM port. Figure 6. Demonstration kit network configuration AM00537v1 4.1 Dongle firmware The dongle firmware integrates the EmberZNetTM 3.0.0 protocol stack with a simple application that allows the transfer of the data payload to the UART port of the SN250 SoC together with the NodeID of the sender. The main purpose of this is to allow PC access to the accelerometer data through the COM port. The firmware is not compliant with application profiles defined within the ZigBee(R) Alliance and has been written only for demonstration purposes. Figure 7. Packet format at the COM port 102d 105d e idH idL zH z L yH yL xH xL i Vector available through the COM AM00538v1 10/15 Doc ID 14826 Rev 2 UM0562 Firmware description Figure 7 shows the format of the packet as available at the COM port. 4.2 The "i" and "e" bytes are fixed at 105d and 102d respectively and function as a packet delimiter. NodeID corresponds to the network address of the MotionBeeTM modules assigned during the network joining procedure. In an application running on the PC, this field makes it possible to distinguish the sender of each packet. X, Y, Z are the acceleration values as detected by the sensors in each MotionBeeTM. MotionBeeTM firmware The firmware loaded on the MotionBeeTM modules includes the EmberZNetTM 3.0.0 protocol stack together with a simple application that samples the accelerometer with a fixed frequency of 33 Hz. The accelerometer data are composed within the packet payload and then sent to the radio for transmission. On each axis the scale of measured values is set to 2 g. This application has been written only for demonstration purposes and it uses the accelerometer sensor in a specific configuration. Custom firmware can be developed and loaded on the modules through the SIF connector, in order to fully exploit all of the sensor configuration capabilities (please refer to the LIS3LV02DL datasheet and application note AN2381). 4.3 Forming a network The procedure to network the dongle and the MotionBeeTM is described below. The network uses channel 26 and PANID 0x01FF fixed values. 1. Connect the dongle to one of the USB slots on the PC. The dongle is powered through the USB port. Both green and red LEDS turn on. After creating the network, the dongle starts sending advertisement packets. 2. To connect a MotionBeeTM within the network: a) Turn on the power switch. b) Push the commissioning button. The green LED turns on. c) The MotionBeeTM initiates the joining procedure and when the association step is completed, the red LED turns on. d) The MotionBeeTM starts sending packets (every 33 ms) and the green LED blinks at each transmission. e) The dongle collects packets sent by the MotionBeeTM, making them available through the COM port with the format described above. The red LED blinks each time it receives a packet. Up to 4 MotionBeeTM modules can be connected to the same dongle without significant loss of performance. Doc ID 14826 Rev 2 11/15 Plane demo 5 UM0562 Plane demo The demonstration kit includes a demonstration program which provides an example of a possible use of the data on the PC to which the dongle is connected. The program demonstrates the tilt measurement capabilities of accelerometers using a simulated aircraft, referred to as "Plane" throughout this document. By creating a connection with the COM port, several kinds of applications running on the host computer can be used or developed to store, visualize or elaborate sensor data that are available in the format described in Section 4.1: Dongle firmware. The sender of each packet can be recognized thanks to the NodeID field that is assigned to each MotionBeeTM during the process of joining the network. The demonstration kit is equipped with a simple graphical application (Plane) that uses acceleration data to measure the tilt of an object. In order to properly run the demo, the installation procedures described in the Section 3 must be complete. To run the demo: 1. Plug the dongle into an empty USB slot on your PC. 2. Double click on the "Run Plane" batch file in <your_folder>/Plane. The windows shown in Figure 8 appear on the screen. 3. Switch on a MotionBeeTM module and then press the commissioning button. After a few seconds the MotionBeeTM starts to send packets to the dongle. The aircraft object on the screen starts to move by continuously tracking the tilt impressed on the MotionBeeTM. The packets read by the application through the COM port are visualized in the terminal window (See Figure 9). Figure 8. Plane graphic and terminal windows AM00539v1 12/15 Doc ID 14826 Rev 2 UM0562 Plane demo The goal of the application is to show how accelerometers can be used to measure the tilt of an object, where the tilt is a static measurement and where gravity is the acceleration being measured. The force of gravity is used as an input to determine the orientation of an object, calculating its degree of tilt. The x, y, z acceleration values are elaborated on the PC application to evaluate the rotation angles of a graphical object (Plane). The behavior of the demo is intuitive, as the graphical object on the PC monitor moves according to the movements impressed on the MotionBeeTM module. Figure 9. Plane demo while running AM00540v1 Doc ID 14826 Rev 2 13/15 Revision history 6 UM0562 Revision history Table 1. 14/15 Document revision history Date Revision Changes 10-Feb-2009 1 Initial release. 24-Nov-2009 2 Updated Chapter 3.2 on page 9 Doc ID 14826 Rev 2 UM0562 Please Read Carefully: Information in this document is provided solely in connection with ST products. STMicroelectronics NV and its subsidiaries ("ST") reserve the right to make changes, corrections, modifications or improvements, to this document, and the products and services described herein at any time, without notice. All ST products are sold pursuant to ST's terms and conditions of sale. Purchasers are solely responsible for the choice, selection and use of the ST products and services described herein, and ST assumes no liability whatsoever relating to the choice, selection or use of the ST products and services described herein. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted under this document. If any part of this document refers to any third party products or services it shall not be deemed a license grant by ST for the use of such third party products or services, or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such third party products or services or any intellectual property contained therein. UNLESS OTHERWISE SET FORTH IN ST'S TERMS AND CONDITIONS OF SALE ST DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY WITH RESPECT TO THE USE AND/OR SALE OF ST PRODUCTS INCLUDING WITHOUT LIMITATION IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE (AND THEIR EQUIVALENTS UNDER THE LAWS OF ANY JURISDICTION), OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. UNLESS EXPRESSLY APPROVED IN WRITING BY AN AUTHORIZED ST REPRESENTATIVE, ST PRODUCTS ARE NOT RECOMMENDED, AUTHORIZED OR WARRANTED FOR USE IN MILITARY, AIR CRAFT, SPACE, LIFE SAVING, OR LIFE SUSTAINING APPLICATIONS, NOR IN PRODUCTS OR SYSTEMS WHERE FAILURE OR MALFUNCTION MAY RESULT IN PERSONAL INJURY, DEATH, OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE. ST PRODUCTS WHICH ARE NOT SPECIFIED AS "AUTOMOTIVE GRADE" MAY ONLY BE USED IN AUTOMOTIVE APPLICATIONS AT USER'S OWN RISK. Resale of ST products with provisions different from the statements and/or technical features set forth in this document shall immediately void any warranty granted by ST for the ST product or service described herein and shall not create or extend in any manner whatsoever, any liability of ST. ST and the ST logo are trademarks or registered trademarks of ST in various countries. Information in this document supersedes and replaces all information previously supplied. The ST logo is a registered trademark of STMicroelectronics. All other names are the property of their respective owners. (c) 2009 STMicroelectronics - All rights reserved STMicroelectronics group of companies Australia - Belgium - Brazil - Canada - China - Czech Republic - Finland - France - Germany - Hong Kong - India - Israel - Italy - Japan Malaysia - Malta - Morocco - Singapore - Spain - Sweden - Switzerland - United Kingdom - United States of America www.st.com Doc ID 14826 Rev 2 15/15 Mouser Electronics Authorized Distributor Click to View Pricing, Inventory, Delivery & Lifecycle Information: STMicroelectronics: SPMB250-A1EVAL