Plux BITalino R-IoT User Manual

Real-time internet of things wireless motion sensor
Table of Contents

Advertisement

Quick Links

Real-time Internet of Things – Wireless Motion Sensor
User Manual V1.2

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BITalino R-IoT and is the answer not in the manual?

Questions and answers

Summary of Contents for Plux BITalino R-IoT

  • Page 1 Real-time Internet of Things – Wireless Motion Sensor User Manual V1.2...
  • Page 2 BITalino R-IoT The information contained in this manual has been carefully checked and we made every effort to ensure its quality. PLUX reserves the right to make changes and improvements to this manual and products referenced at any time without notice.
  • Page 3 BITalino R-IoT BR 20200207 User Manual PLUX Wireless Biosignals S.A. email: plux@plux.info web: http://www.plux.info Headquarters Zona Industrial das Corredouras, Lt. 14 – 1° 2630-369 Arruda dos Vinhos Portugal tel.: +351 263 978 572 Lisbon Office Av. 5 de Outubro, n° 79 – 2°...
  • Page 4: Table Of Contents

    Overview ........................9 3.1.1 The CC3200 MCU ....................... 9 3.1.2 The Energia IDE ........................ 10 BITalino R-IoT ......................11 Hardware Description ..................... 12 Port A ........................13 Port B......................... 14 Battery Considerations ....................14 R-IoT Configuration & Setup ..................15 Module Default Configuration ..................
  • Page 5 BITalino R-IoT BR 20200207 User Manual 7.1.4 OSC Bundles ........................29 R-IoT Streaming, Sensor Fusion and Analysis.............. 30 Sensor Fusion ......................30 R-IoT Code Repository ....................30 Receive Sensors Data from the Module ............... 30 Max Abstractions for the R-IoT Bitalino ............... 32 Programming the R-IoT ....................
  • Page 6 BITalino R-IoT BR 20200207 User Manual LIST OF FIGURES Figure 1-1 – Functional Block Diagram..................... 9 Figure 1-2 – Energia IDE interface......................10 Figure 2-1 – Top View ..........................12 Figure 2-2 – Bottom View ........................... 12 Figure 2-3 – Port A Pinout detail ......................13 Figure 2-4 –...
  • Page 7: Regulatory & Legal Information

    1.2 Guarantee of Quality & Warranty The BITalino R-IoT acquisition system has a two years warranty from the date of purchase. R-IoT sensors have three months warranty from the date of purchase. PLUX guarantees that the system, sensors and accessories will be free from material or manufacturing defects for the mentioned time periods following date of purchase.
  • Page 8: Warranty Voidance

    1.3 Contact & Support Contact us if you’re experiencing any problems that cannot be solved with the information given in the BITalino R-IoT or manual. We’ll get back to you as soon as possible to find the best solution for your problem.
  • Page 9: List Of Acronyms

    BITalino R-IoT BR 20200207 User Manual 2 List of Acronyms AP – Access Point DHCP - Dynamic Host Configuration Protocol I2C - Inter-Integrated Circuit IC - Integrated Circuit IDE - Integrated Development Environment IP – Internet Protocol IMU - Inertial Measurement Unit IoT –...
  • Page 10: Introduction

    BR 20200207 User Manual 3 Introduction The BITalino R-IoT module is the 7th generation of IRCAM's wireless sensor digitizing unit, an essential tool linking motion sensing, gestural recognition and Live Performance Arts. Since 2001, IRCAM aimed to provide a low latency, high data-rate & resolution and stage compatible devices, capable of streaming gestural information to the computer from multiple performers.
  • Page 11: The Energia Ide

    BITalino R-IoT BR 20200207 User Manual 3.1.2 The Energia IDE Energia is an open-source platform for electronics prototyping that bring the Wiring and Arduino framework to the TI MSP430, MSP432x, TM4C, C2000, CC32xx and CC13xx MCUs based on the LaunchPad board.
  • Page 12: Bitalino R-Iot

    BITalino board or to a FTDI USB serial cable (with crossed / null-modem wiring). To ease the reading of this document, we will refer from now to the BITalino R-IoT as R-IoT. 11 of 42...
  • Page 13: Hardware Description

    BITalino R-IoT BR 20200207 User Manual 4 Hardware Description Tx/Rx LED Charger LED Mode Button Flash Button Reset Button RGB LED Figure 2-1 – Top View USB Data (FTDI) / Charging Port Antenna Power Switch Port A Port B Figure 2-2 – Bottom View...
  • Page 14: Port A

    BITalino R-IoT BR 20200207 User Manual 4.1 Port A Figure 2-3 – Port A Pinout detail Signal Name Reference Pin Alias Signal Description (CC3200) 3.3V General Power Source. GPIO_13 GPIO_13 Digital Input. GPIO_12 GPIO_12 Digital Output. GPIO_05 ADC_CH3 12-bit ADC Input (1.5V 12-bit ADC Input (1.5V...
  • Page 15: Port B

    BITalino R-IoT BR 20200207 User Manual Port B Figure 2-4 – Port B Pinout detail Signal Name Reference Pin Alias Signal Description (CC3200) RESET External Reset. I2C_SDA I2C Data. GPIO_11 UART1_RX UART RX Data. I2C_SCL I2C Clock. GPIO_10 UART1_TX UART TX Data.
  • Page 16: Iot Configuration & Setup

    BITalino R-IoT BR 20200207 User Manual 5 R-IoT Configuration & Setup 5.1 Module Default Configuration R-IoT’s default firmware implements a Wi-Fi Access Point (AP mode) and a Web server (Station mode) to configure its wireless parameters such as the Wi-Fi network name (SSID), the Open Sound Control UDP port to send data to the recipient computer IP address.
  • Page 17: Figure 3-3 - Ap Ssid Example

    BITalino R-IoT BR 20200207 User Manual The Wi-Fi network name can be easily identified in the list of available SSID and starts with RIOT (in uppercase) followed by a 4 character aplhanumeric, as demonstrated in figure 3-3. Figure 3-3 – AP SSID Example.
  • Page 18: Network Connection Details

    BITalino R-IoT BR 20200207 User Manual Figure 3-4 – R-IoT Webpage. 5.3 Network Connection Details The R-IoT connects to the network name set in the SSID field above. It should match the network name set in your Wi-Fi access point (see Chapter Most of the default settings should work with your Wi-Fi infrastructure.
  • Page 19: Id When Using Multiple Devices

    BITalino R-IoT BR 20200207 User Manual streaming and collection, it is easier to setup a MAC address filtering in the Access Point itself. In addition, the SSID beaconing can be disabled (also on the Access Point) to prevent finding the name of the network, therefore allowing connection only to parties who know the said SSID name.
  • Page 20: Wi-Fi And Computer Setup

    BITalino R-IoT BR 20200207 User Manual 6 Wi-Fi and Computer setup As explained above, the R-IoT can work as out-of-the-shelf product when it is acquired with our TP-Link Wi-Fi router which have been pre-configured to work together. The R-IoT can operate on both a local network and over the internet if necessary. As...
  • Page 21: Figure 4-2 - Change Ip (Step1)

    BITalino R-IoT BR 20200207 User Manual On Windows, the procedure is as follows: 1. Open the Network and Sharing Center and select Wi-Fi; Figure 4-2 – Change IP (Step1). 2. A window will open. Then you need to select Properties;...
  • Page 22: Figure 4-4 - Change Ip (Step 3)

    BITalino R-IoT BR 20200207 User Manual 3. Another window will show up. Now, select Internet Protocol Version 4 (TCP/IPv4) and go to Properties; Figure 4-4 – Change IP (Step 3). 4. The final step is to fill the final windows as shown in the next figure and click OK (the IP address should be the same as the DEST IP set in the configuration of the R-IoT);...
  • Page 23 BITalino R-IoT BR 20200207 User Manual On both operating systems, you can also use network profiles that allows quick switching between your regular internet configuration (i.e. using DHCP for most use cases) and a dedicated sensor configuration to use the R-IoT over a local network (using a manually set IP address).
  • Page 24: Configure The Wi-Fi Access Point And Router

    BITalino R-IoT BR 20200207 User Manual 6.2 Configure the Wi-Fi Access Point and Router The router to be used as an access point is to be connected to a host router. Many routers have the option to convert it to an access point by selecting just one option.
  • Page 25: Figure 4-7 - Finding Ip (Step 2)

    BITalino R-IoT BR 20200207 User Manual 2. A window will open. Then you need to select Details; Figure 4-7 – Finding IP (Step 2). 3. The recently open window will show al the Network Connection Details. The IP address will be displayed.
  • Page 26: Access The Wi-Fi Access Point For The First Time

    BITalino R-IoT BR 20200207 User Manual 6.2.2 Access the Wi-Fi Access Point for the first time Figure 4-9 – TP-link MR3020 3G/Wi-Fi router. The configuration of the access point can be reached by connecting the computer to it, and then go to tplinkwifi.net. This will prompt you for a login page where you will need to insert the pre-configured password that is on the user’s manual of the Access Point.
  • Page 27: Local Network Conventions And Standards

    BITalino R-IoT BR 20200207 User Manual That will usually require to log in once again after a reboot of the AP. Tune the DHCP settings. Most of the time the DHCP will be active on addresses from 192.168.1.100 to 192.168.1.199. Change this from 192.168.1.110 to 192.168.1.150, anything to avoid having the default destination IP address (192.168.1.100) to be in the...
  • Page 28 BITalino R-IoT BR 20200207 User Manual There's no absolute standard on what to use as your IP address and local network IP scheme. "Our" IRCAM standard using a 192.168.1.100 recipient IP address inherits from the hardware we designed back in 2004 using Linksys Wi-Fi routers which were on 192.168.1.XXX by default.
  • Page 29: The Osc Structure

    BITalino R-IoT BR 20200207 User Manual 7 The OSC structure For a better understanding of the next sections of this manual, it is necessary to dedicate a few lines to the structure of the OSC messages. 7.1 OSC Syntax Open Sound Control (OSC) is an open, transport-independent, message-based protocol developed for communication among computers, sound synthesizers, and other multimedia devices [7].
  • Page 30: Osc Messages

    BITalino R-IoT BR 20200207 User Manual 7.1.3 OSC Messages An OSC message consists of an OSC Address Pattern followed by an OSC Type Tag String followed by zero or more OSC Arguments. • OSC Address Patterns: An OSC Address Pattern is an OSC-string beginning with the character '/' (forward slash).
  • Page 31: Iot Streaming, Sensor Fusion And Analysis

    BITalino R-IoT BR 20200207 User Manual 8 R-IoT Streaming, Sensor Fusion and Analysis 8.1 Sensor Fusion Calibration of the sensors and the data fusion allowing for computing the quaternions and Euler angles are provided. The data fusion is implemented using the open-source code provided by Sebastian Madgwick.
  • Page 32: Figure 5-1 - Max/Msp Example

    BITalino R-IoT BR 20200207 User Manual The BITalino OSC message starts with /<ID>/bitalino followed by a list of 11 integer numbers that split like the following: - Sequence number {0 ; 15} - 4 digital inputs I1 to I4 {0 ; 1} - 6 analog inputs A1 to A6 {0 ;...
  • Page 33: Max Abstractions For The R-Iot Bitalino

    BITalino R-IoT BR 20200207 User Manual 8.4 Max Abstractions for the R-IoT Bitalino Several abstractions (Cycling’74) provided GitHub https://github.com/Ircam-R-IoT. For example, the following abstraction analysis-example.maxpat shows example of various small abstraction that can be used to transform the raw accelerometer and gyroscope in intensity parameters and detecting kicks.
  • Page 34: Programming The R-Iot

    (select standard NULL modem). 9.3 Customize the IDE In order to compile the "full" firmware (currently named BITalino R-IoT 2.041), the default linker file used by the Energia tool chain must be modified as the reserved heap size / stack is too high when compiling big programs.
  • Page 35: Install The Firmware And Examples

    BITalino R-IoT BR 20200207 User Manual Additionally, source file must modified WiFiUdp.cpp (hardware\cc3200\libraries\Wifi), as its function blocks parsePacket() during 10ms. The code has been modified to reduce this timeout to 1ms by changing the default value of , wich is as follows: timeout.tv_usec...
  • Page 36: Figure 6-1 - Blink Code Example

    BITalino R-IoT BR 20200207 User Manual Below an example of blinking endlessly the red LED from of the module (GPIO RGB_LED I/0 #9): Figure 6-1 – Blink Code example. 35 of 42...
  • Page 37: Figure 6-2 - Selection Of The Board

    BITalino R-IoT BR 20200207 User Manual Before compiling, select the proper target in the Tools -> Board menu and select the launchPad w/ CC3200 (80 MHz). Figure 6-2 – Selection of the Board. To compile the program, simply click on the left-most icon (tick).
  • Page 38: Figure 6-3 - Communication Port Configuration

    BITalino R-IoT BR 20200207 User Manual Flashing the Firmware To flash the code on the platform first plug the USB serial cable in a USB port then select the matching COM port in Energia Tool->Serial port menu. COMPILE Figure 6-3 – Communication Port configuration.
  • Page 39: Figure 6-4 - Flashing Firmware

    BITalino R-IoT BR 20200207 User Manual With the module powered on, even already executing the code present in the chip, press both the flash and reset switches and click on the upload icon (right arrow). It will first compile the code. Once compiling is over, the "uploading" text will be printed above the console.
  • Page 40 BITalino R-IoT BR 20200207 User Manual Once there, the module can be reset (cycle the on-off switch or press the reset onboard momentary switch) to leave flashing mode and execute the freshly uploaded code. With the above code, the blue LED should flash once per second.
  • Page 41: Glossary

    BITalino R-IoT BR 20200207 User Manual 10 Glossary Access Point An access point is a device that allows other wireless devices to connect to it by the means of antennas. An inertial measurement unit (IMU) is an electronic device that measures and reports a body's specific force, angular rate, and sometimes the orientation of the body, using a combination of accelerometers, gyroscopes, and sometimes magnetometers.
  • Page 42 BITalino R-IoT BR 20200207 User Manual Open Sound Control (OSC) is a protocol for communication among computers, sound synthesizers, and other multimedia devices that is optimized for modern networking technology. Bringing the benefits of modern networking technology to the world of electronic musical instruments, OSC's advantages include interoperability, accuracy, flexibility, and enhanced organization and documentation.
  • Page 43: Bibliography

    BITalino R-IoT BR 20200207 User Manual 11 Bibliography STMicroelectronics., “LSM9DS1 iNEMO inertial module: 3D accelerometer, 3D gyroscope, 3D magnetometer,” STMicroelectronics.Ginebra, Switz., 2014. Texas Intruments, “CC3200 SimpleLink Wi-Fi® and Internet-of-Things solution, a Single-Chip Wireless TI.com.” [Online]. Available: https://www.ti.com/product/CC3200. [Accessed: 06-Feb-2020]. Energia, “Energia - Home.” [Online]. Available: https://energia.nu/. [Accessed: 06- Feb-2020].

Table of Contents