Public Channel / User Guides

OpenMote User Guide

Share on Social Networks

Share Link

Use permanent link to share in social media

Share with a friend

Please login to send this document by email!

Embed in your website

Select page to start with

Average

0

There are no comments for now.

Details

1 stars
0% Remove selection
2 stars
0% Remove selection
3 stars
0% Remove selection
4 stars
0% Remove selection
5 stars
0% Remove selection


17. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 17

21. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 21

24. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 24

25. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 25

26. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 26

27. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 27

28. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 28

32. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 32

12. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 12

16. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 16 Once downloaded execute the installer and follow the steps depicted in the next Figures. It is important that you install Python for all users and also that you add the directory to the system PATH.

20. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 20 Once downloaded execute the installer and follow the steps depicted in t he next Figures. It is important that you add the install directory in the path environment.

23. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 23 6.2.3 GCC Compiler for ARM Embedded Processors https://git - scm.com/download/win

14. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 14 Dimensions In mm

31. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 31 Once the initializations are made you can compile a project by the next command : scons compiler=gcc board=openmote - b project=freertos - cc2538 versbose=0

22. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 22 Once it is installed in your system you should be able to execute it by running the arm - none - eabi - gcc.exe -- version command from a command line, i.e. Windows PowerShell. If the installation was successful you should see a terminal like the next image.

13. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 13 CC2538 Datasheet ( http://www.ti.com/lit/gpn/cc2538 ) CC2538 User Manual ( http://www.ti.com/lit/pdf/swru319 ) CC2538 Errata ( http://www.ti.com/lit/pdf/swrz045 )

2. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 2

18. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 18 Once Python 3.x is installed in your system yo u should be able to execute it by running the python command from a command line, i.e. Windows PowerShell. If the installation was successful you should see a terminal like the next image. Once Python 3.x is installed you need to install the additional p ackages that are required to compile, load and debug code. As mentioned earlier, these packages are SCons, PySerial and IntelHex and they can be installed using pip, as shown in the next images. • Pip install scons • Pip install pyserial • Pip install intelhex

36. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 36

1. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 1 OPEN MOTE B Open Mote B User Guide:

33. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 33 6.4.2 GNU/Linux The first step is to clone the OpenMote firmware repository from BitBucket using the following command: git clone https://peretuset@bitbucket.org/openmote/openmote - fw.git cd openmote - fw git submodule update -- init -- recursive

3. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 3 Open Mote B User Guide Revis ion August 2019

35. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 35 If the process is correct the build system will display a successful message and will show the space occupied by the generated binary image, as depicted in the next figure. Once the binary image has been generated, we can upload it to the OpenMote - B board using the bootloader and the cc2538 - bsl Python script. To upload the firmware, issue the following command: sudo scons board=openmote - b project=freertos - cc2 538 compiler=gcc verbose=0 bootload=/dev/ttyUSB1 Notice that the command must be prepended with “sudo”, as accessing the serial port in Linux requires super - user permissions. If the process is successful, the build system will display a success message, a s depicted in the next image, and the OpenMote - B should start working: the green LED should blink briefly (100 ms) every second (1000 ms) and the user button should toggle the red LED.

30. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 30 6.4 OpenMote The next sub - sections will show how to compile and execute the default OpenMote firmware projects step - by - step with Windows 10 and Ubuntu 18.04 LTS. 6.4.1 Windows 10 The first step is to clone the OpenMote repository using git. To do so, ty pe the following command: After the OpenMote repository has been cloned, you need to initialize the repository submodules by executing the following command: Git submodule update – init – recursive If the command is successful you should see a screen simil ar to the next one.

37. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 37 Revision Table Revision Number Date Changes 0 22/08 /2019 First implementation

19. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 19 6.2.2 GCC Compiler for ARM Embedded Processors To install the GCC Compiler for ARM Embedded Processors go to the official website and download the latest version: 7 - 2017 - q4 - major 2 . 2 https://developer.arm.com/open - source/gnu - toolchain/gnu - rm/downloads/7 - 2017 - q4 - major - 1 - 1

34. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 34 cd ti/cc2538/gcc make After generating the driverlib for the Texas Instruments CC2538 micro - controller, you can return to the root directory using the ‘cd – ‘ command. 6.4.3 Blinking LED example To test the build environment and the boards we will use the freertos - cc2538 project, which demonstrates using the FreeRTOS real - time operating system with the Texas Instruments CC2538 micro - controller on the OpenMote - B board. The code will be compiled with the gc c - arm - embedded toolchain. To compile the code issue the following command: scons board=openmote - b project=freertos - cc2538 compiler=gcc verbose=0 The compile process for all the project modules will start, as displayed in the next figure.

6. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 6 Disclaimers Weights and Dimensions Dimensions and weights are nominal and they are not used for manufacturing purposes, even when tolerances are shown. Performance Data The performance data given in this manual is provided as a guide for the user in determining suitability and does not constitute a warranty. It may represent the result of INDUSTRIAL SHIELDS’s test conditions, a nd the users most correlate it to actual application requirements. Actual performance is subject to the INDUSTRIAL SHIELDS Warranty and Limitations of Liability. Change in Specifications Product specifications and accessories may be changed at any time based on improvements and other reasons. It is our practice to change model numbers when features are changed, or published ratings or when significant construction changes are made. However, some specifications of the products may be changed without any notice. When in doubt, special numbers may be assigned to fix or stablish key specifications for your application on your request. Please consult with your INDUSTRIAL SHIELDS representative at any time to confirm actual specifications of purchased prod ucts. Errors and Omissions The information in this document has been carefully checked and is believed to be accurate; however, no responsibility is assumed for clerical, typographical, or proofreading errors, or omissions.

7. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 7 Warranty and Limitations of Liability Warranty Industrial Shields’s exclusive warranty is that the products are free from defects in materials and workmanship for a period of one year (or other period if specified) from date of sale by Industrial Shields. INDUSTRIAL SH IELDS MAKES NO REPRESENTATION OR WARRANTY, EXPRESSED OR IMPLIED, REGARDING MERCHANABILITY, NON - INFRINGEMENT, OR FITNESS FOR PARTICULAR PURPOSE OF THE PRODUCTS. ANY BUYER OR USER ACKNOWLEDGES THAT THE BUYER OR USER ALONE HAS DETERMINED THAT THE PRODUCTS WIL L SUITABLY MEET THE REQUIREMENTS OF THEIR INTENDED USE. INDUSTRIAL SHIELDS DISCLAIMS ALL OTHER WARRANTIES, EXPRESS OR IMPLIED Limitations of Liability INDUSTRIAL SHIELDS SHALL NOT BE RESPONSIBLE FOR SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES, LOSS OF PRO FITS OR COMERCIAL LOSS IN ANY WAY CONNECTED WITH THE PRODUCTS, WHETHER SUCH CLAIM IS BASED ON CONTRACT, WARRANTY, NEGLIGENCE, OR STRICT LIABILITY. IN NO EVENT SHALL INDUSTRIAL SHIELDS BE RESPONISBLE FOR WARRANTY, REPAIR OR OTHER CLAIMS REGARDING THE PRODUC TS UNLESS INDUSTRIAL SHIELDS’S ANALYSIS CONFIRMS THAT THE PRODUCTS WERE PROPERLY HANDLED, STORED, INSTALLED, AND MAINTAINED AND NOT SUBJECT TO CONTAMINATION, ABUSE, MISUSE, OR INAPPROPIATE MODIFICATION OR REPAIR.

29. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 29 6.3 GNU/Linux The first step is installing the toolchain to compile C/C++ code for the ARM Cortex - M3 processor that is used in the Texas Instruments CC2538 micro - controller. sudo add - apt - repository ppa:team - gcc - arm - embedded/ppa sudo apt - get install gcc - arm - embedded Once the toolchain is installed, we will also need some additional tools to be able to work with the source code. sudo apt - get install build - essential git scons python - pip Finally, we will also need to install some Python modules that will be needed sudo pip install intelhex pyserial Once all the software has been properly installed in the system we can proceed to program the Open Mote B module.

5. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 5 Application Considerations and Warranty Read and Understand this Manual Please read and understand this manual before using the product. Please consult your comments or questions to Industrial Shields before using the product. Application Consideration THE PRODUCTS CONTAINED IN THIS DOCUMENT ARE NOT SAFETY RATED. THEY SHOULD NOT BE RELIED UPON AS A SAFETY COMPONENT OR PROTECTIVE DEVICE FOR ENSURING SAFETY OF PERSONS, AS THEY ARE NOT RATED OR DESSIGNED FOR SUCH PURPOSES. Please know and observe all prohi bitions of use applicable to the products. FOR AN APPLICATION INVOLVING SERIOUS RISK TO LIFE OR PROPERTY WITHOUT ENSURING THAT THE SYSTEM AS A WHOLE HAS BEEN DESSIGNED TO ADDRESS THE RISKS, NEVER USE THE INDUSTRIAL SHIELDS PRODUCTS. NEVER USE THE INDUSTR IAL SHIELDS PRODUCTS BEFORE THEY ARE PROPERLY RATED AND INSTALLED FOR THE INTENDED USE WITHIN THE OVERALL EQUIPMENT OR SYSTEM. Industrial Shields shall not be responsible for conformity with any codes, regulations or standards that apply to the combinatio n of products in the customer’s application or use of the product. The following are some examples of applications for which particular attention must be given. This is not intended to be an exhaustive list of all possible uses of the products, nor is it i ntended to imply that the uses may be suitable for the products: • Systems, machines, and equipment that could present a risk to life or property. • Nuclear energy control systems, combustion systems, railroad systems, aviation systems, medical equipment, amus ement machines, vehicles, safety equipment, and installation subject to separate industry or government regulations. • Outdoor use, uses involving potential chemical contamination or electrical interference, or conditions or uses not described in this docume nt. At the customer’s request, INDUSTRIAL SHIELDS will provide applicable third party certification documents identifying ratings and limitations of use that apply to the products. This information by itself is not sufficient for a complete determination of the suitability of the products in combination with the system, machine, end product, or other application or use.

38. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 38 About Industrial Shield s: Address : Fàbrica del Pont, 1 - 11 Sant Fruitós de Bages , 082 72 (Barcelona) Spain Telephone: ( +34 ) 938 760 191 / (+34) 635 693 611 Mail: in fo @industrialshields.com

15. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 15 Software This section is aimed at providing a starting point to run the main open - source software projects on the OpenMote - B hardware. 6.1 Prelim in a r i e s To program the OpenMote - B boards with the various open source software projects it is necessary to have a working environment to build, upload, and debug the code for the ARM Cortex - M3 processor. It is possible to create a working environment with either Windows or Linux, as described next. Macintosh is known to work, but the former operating systems are preferred as they have been thoroughly tested. Hence, the following steps show how to install the tools required to compile, run and debug embedded software on the OpenMote - B boards using either Windows 10 or Ubuntu 18.04 LTS. The process assumes that the user has a working installation of either operating system, either natively on thei r computer or in a virtual environment (i.e. VMWare Workstation or VirtualBox). The tools that are required are: • Python 3 with the SCons, PySerial and IntelHex packages • GCC compiler for ARM Embedded Processors 6.2 Windows 10 6.2.1 Python 3.x To install Python 3.x go to the official website and download the latest version 1 . 1 https://www.python.org/downloads/windows/

4. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 4 Preface This User Guide is been implemented by Boot & Work, S.L. working unde r the name Industrial Shields. Purpose of the manual The information contained in this manual can be used as a reference to operating, to functions, and to the technical data of the signal modules, power supply modules and interface modules. Intended Audience This User Guide is intended for the following audience: • Persons in charge of introducing automation devices. • Persons who design automation systems. • Persons who install or connect automation devices. • Persons who manage working automation installation. Warnings: • Unused pins should not be connected. Ignoring the directive may damage the controller. • Improper use of this product may severely damage the controller. • Refer to the controller’s User Guide regarding wiring considerat ions. • Before using this product, it is the responsibility of the user to read the product’s User Guide and all accompanying documentation. Advertisements : • Les broches non utilisées ne doivent pas être connectées . Ignorer la directive peut endommager le contrôleur. • Une utilisation incorrecte de ce produit peut endommager gravement le contrôleur. • Reportez - vous au Guide de l’utilisateur du contrôleur pour les considérations de câblage. • Avant d’utiliser ce produit, i l incombe à l’utilisateur de lire le Guide de l’utilisateur du produit et la documentation qui l’accompagne.

11. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 11 • Antenna connectors: The main board includes two SMA antenna connectors for the Sub - GHz and 2.4 GHz antennas. The Sub - GHz antenna connector is directly connected to the Sub - GHz radio on the AT86RF215. The 2.4 GHz antenna is multiplexed using an RF switch to the CC2558 and the AT86RF215 radio transceivers. The direction of the RF switch can be controlled using two CC2538 pins. • Power : The main board can be powered from a USB port (5V) through an A male plug connector, or from two AA batteries (3V) located on the back of the board. The board features an auto - switching mechanism that selects the USB source whenever it is available and seamlessly transitions to the AA batteries when disconnected. Finally, the board includes an on/off button to disconnect the two AA batteries when not used. • Current sensing: The main board includes two ports (3 pins with 2.54 mm spacing) to measure current consumption of the whole system during operation. The first port measures the current consumption of the CC2538 chip, whereas the second po rt measures the current consumption of the AT86RF215 chip. • JTAG port: The main board includes a 10 - pin ARM connector that allows to load and debug code using an external JTAG probe. The interface is compatible with the main toolchains: Code Composer Stud io, IAR Embedded Workbench and ARM. System overview 4.1 Texas Instruments CC2538 The Texas Instruments CC2538 is a wireless micro - controller SoC (System on Chip) targeted at high - performance applications. It combines a powerful ARM Cortex - M3 running at 32 MH z, with 32 Kbytes of RAM and 512 Kbytes of Flash, with a robust 2.4 GHz radio transceiver compatible with the IEEE 802.15.4 standard. In addition, the CC2538 includes various peripherals to interface the processor with other systems: 2x SPI, 2x UART, 1x I2 C.

10. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 10 2.2 Transceiver 1 (Texas Instruments , CC2538) • Operates in the 2.4 GHz ISM band with support for IEEE 802.15.4 - 2006 o Modulation: OQPSK with DSSS o Data rate: 250 kbps o Receiver sensitivity: - 97 dBm o Transmit power: 7 dBm o Transmit current: 24 mA at 0 dBm o Receive current: 20 mA 2.3 Transceiver 2 (ATMEL, AT86RF215) • Operates in the 868/915MHz and 2.4 GHz ISM bands with support for IEEE 802.15.4g - 2012 o Modulation: MR - FSK/OFDM/O - QPSK o Data rate: 6.25 kbps to 2400 kbps o Receiver sensitivity: - 123 dBm o Transmit power: 14.5dBm o Transmit current: 62 mA at 14 dBm o Receive current: 28 mA Platform Characteristics • Human interfacing : The main board includes 4 LEDs (Green, Yellow, Orange and Red) and a user button which are intended for debugging purposes. In addition, the main board also includes a reset button that allows to perform a hardwa re reset. • Serial communications: The main board can communicate with a computer using a UART port on the CC2538. The solution is based on the FTDI FT2232H chip, a Serial - to - USB converter that allows to communicate with a computer using a standard UART por t. In addition, the FTDI chip allows to program the CC2538 directly using the internal bootloader and the cc2538 - bsl Python script. • Board expansion : The main OpenMote - B board includes an expansion port (8 pins with 2.54 mm spacing) that can be used for d ebugging or to connect daughter boards, i.e., the OpenMote - B sensors board. The expansion board includes a VCC (2.5V) and a GND pin, as well as six configurable pins. • Extended security : The main OpenMote - B board includes hardware - accelerated support for cryptographic functions using SHA2, AES - 128/256, ECC - 128/256 and RSA algorithms.

9. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 9 General Description Open Mote B product 1.1 Industrial Internet of Things development platform The OpenMote B is the ultimate hardware development and prototyping platform for the Industrial Internet of Things (IIoT), specifically to researchers and developers working towards next - generation long - range and low - power wireless field area networks based on the IPv6 stack. I t is built around the well - supported Texas Instruments CC2538 ARM - Cortex - M3 micro - controller, and it features simultaneous multi - band operation in the 2.4 GHz and 868/915MHz ISM bands with complete support for the latest IEEE 802.15.4 standards, including the MR - OFDM modulations of IEEE 802.15.4g - 2012. Technical Specifications 2.1 Micro - Controller (Texas Instruments, CC2538) • ARM Cortex - M3 with code pre - fetch o Running at 16 MHz or 32 MHz o 32 Kbytes RAM o 512 Kbytes FLASH • On - chip peripherals: o 4x general purpose, 1x sleep timer o 1x 12 bit ADC with 8 channels o 2x SPI, 2x UART, 1x I2C • Security hardware acceleration: o AES - 128/256/SHA2 encryption o ECC - 128/256 secure key exchange • Low - power operation: o Active mode: 7/13mA (16/32 MHz) o LPM1: 600uA (full retention, 4us wake - up) o LPM2: 1.3 uA (16 Kbyte RAM retention, 128us wake - up, wake - up from RTC) o LPM3: 0.4 uA (16 Kbyte RAM retention, 128us wake - up, wake - up from GPIO)

8. SKU: IS.OMB - 001 Rev. 0: 22 - 08 - 2019 8 Table of Contents General Description Open Mote B product ................................ ................................ 9 1.1 Industrial Internet of Thing s development platform ................................ ...................... 9 Technical Specifications ................................ ................................ .............................. 9 2.1 Micro - Controller (Texas Instruments, CC2538) ................................ ................................ 9 2.2 Transceiver 1 (Texas Instruments, CC2538) ................................ ................................ ... 10 2.3 Transceiver 2 (ATMEL, AT86RF215) ................................ ................................ ............... 10 Platform Characterístics ................................ ................................ ............................ 10 System overview ................................ ................................ ................................ ....... 11 4.1 Texas Instru ments CC2538 ................................ ................................ .............................. 11 Dimensions ................................ ................................ ................................ ................ 14 Software ................................ ................................ ................................ .................... 15 6.1 Preelimaries ................................ ................................ ......... Error! Bookmark not defined. 6.2 Windows 10 ................................ ................................ ................................ ..................... 15 6.2.1 Python 3.x ................................ ................................ ................................ ............ 15 6.2.2 GCC Compiler for ARM Embedded Processors ................................ ................... 19 6.2.3 GCC Compiler for ARM Embedded Processors ................................ ................... 23 6.3 GNU/Linux ................................ ................................ ................................ ....................... 29 6.4 OpenMote ................................ ................................ ................................ ....................... 30 6.4.1 Windows 10 ................................ ................................ ................................ ......... 30 6.4.2 GNU/Linux ................................ ................................ ................................ ........... 33 6.4.3 Blinking LED example ................................ ................................ .......................... 34 Revi sion Table ................................ ................................ ................................ ........... 37

Views

  • 95 Total Views
  • 69 Website Views
  • 26 Embeded Views

Actions

  • 0 Social Shares
  • 0 Likes
  • 0 Dislikes
  • 0 Comments

Share count

  • 0 Facebook
  • 0 Twitter
  • 0 LinkedIn
  • 0 Google+