Plux BITalino R-IoT User manual

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

BITalino R-IoT
User Manual
BR 20200207
1 of 42
ATTENTION
Please read this manual before
using your 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.
Please check your kit after receiving and before using it the first time to confirm if it
contains all the ordered sensors, accessories and other components. Contact our support
if there are any variations from your original order.

BITalino R-IoT
User Manual
BR 20200207
2 of 42
PLUX Wireless Biosignals S.A.
email: [email protected]
web: http://www.plux.info
Headquarters
Zona Industrial das Corredouras, Lt. 14 –1°
2630-369 Arruda dos Vinhos
Portugal
tel.: [phone]
Lisbon Office
Av. 5 de Outubro, n° 79 –2°
1050-059 Lisboa
Portugal
tel.: [phone]
Institut de Recherche et Coordination Acoustique/Musique (IRCAM)
Web: https://www.ircam.fr/
1 Place Igor Stravinsky
75004 Paris
France
tel: [phone]

BITalino R-IoT
User Manual
BR 20200207
3 of 42
TABLE OF CONTENTS
1Regulatory & Legal Information .....................................................................................6
1.1 Disclaimer.................................................................................................................... 6
1.2 Guarantee of Quality & Warranty ................................................................................. 6
1.2.1 Warranty Voidance............................................................................................................ 7
1.3 Contact & Support........................................................................................................ 7
2List of Acronyms ...............................................................................................................8
3Introduction.......................................................................................................................9
3.1 Overview ..................................................................................................................... 9
3.1.1 The CC3200 MCU............................................................................................................... 9
3.1.2 The Energia IDE................................................................................................................ 10
3.2 BITalino R-IoT............................................................................................................. 11
4Hardware Description.....................................................................................................12
4.1 Port A ........................................................................................................................ 13
4.2 Port B......................................................................................................................... 14
4.3 Battery Considerations............................................................................................... 14
5R-IoT Configuration & Setup.........................................................................................15
5.1 Module Default Configuration .................................................................................... 15
5.2 Changing the Default Configuration ............................................................................ 15
5.3 Network Connection Details ....................................................................................... 17
5.4 ID when using Multiple Devices .................................................................................. 18
6Wi-Fi and Computer setup .............................................................................................19
6.1 Change Computer IP................................................................................................... 19
6.2 Configure the Wi-Fi Access Point and Router............................................................... 23
6.2.1 How to find the router IP address. .................................................................................. 23
6.2.2 Access the Wi-Fi Access Point for the first time.............................................................. 25
6.3 Local Network Conventions and Standards ................................................................. 26
7The OSC structure...........................................................................................................28
7.1 OSC Syntax................................................................................................................. 28
7.1.1 Atomic Data Types........................................................................................................... 28
7.1.2 OSC Packets ..................................................................................................................... 28
7.1.3 OSC Messages.................................................................................................................. 29

BITalino R-IoT
User Manual
BR 20200207
4 of 42
7.1.4 OSC Bundles..................................................................................................................... 29
8R-IoT Streaming, Sensor Fusion and Analysis..............................................................30
8.1 Sensor Fusion............................................................................................................. 30
8.2 R-IoT Code Repository ................................................................................................ 30
8.3 Receive Sensors Data from the Module....................................................................... 30
8.4 Max Abstractions for the R-IoT Bitalino....................................................................... 32
9Programming the R-IoT..................................................................................................33
9.1 Install the Energia IDE................................................................................................. 33
9.2 Install the USB Serial Port Driver................................................................................. 33
9.3 Customize the IDE ...................................................................................................... 33
9.4 Install the Firmware and Examples ............................................................................. 34
9.5 Use Energia IDE .......................................................................................................... 34
10 Glossary ...........................................................................................................................40
11 Bibliography ....................................................................................................................42

BITalino R-IoT
User Manual
BR 20200207
5 of 42
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 –Port B Pinout detail.............................................................................................................. 14
Figure 3-1 –R-IoT Configuration.............................................................................................................. 15
Figure 3-2 –AP Mode details..................................................................................................................... 15
Figure 3-3 –AP SSID Example. ................................................................................................................. 16
Figure 3-4 –R-IoT Webpage. ..................................................................................................................... 17
Figure 4-1 –Change IP MacOS.................................................................................................................. 19
Figure 4-2 –Change IP (Step1). ................................................................................................................ 20
Figure 4-3 –Change IP (Step 2)................................................................................................................ 20
Figure 4-4 –Change IP (Step 3)................................................................................................................ 21
Figure 4-5 –Change IP (Step 4)................................................................................................................ 21
Figure 4-6 –Finding IP (Step1). ................................................................................................................ 23
Figure 4-7 –Finding IP (Step 2)................................................................................................................ 24
Figure 4-8 –Finding IP (Step 3)................................................................................................................ 24
Figure 4-9 –TP-link MR3020 3G/Wi-Fi router. .................................................................................... 25
Figure 4-10 –AP router Configuration.................................................................................................... 25
Figure 4-11 –AP router Configuration, SSID setup............................................................................. 26
Figure 5-1 –Max/MSP example................................................................................................................ 31
Figure 5-2 –Abstraction analysis-example.maxpat............................................................................ 32
Figure 6-1 –Blink Code example.............................................................................................................. 35
Figure 6-2 –Selection of the Board. ........................................................................................................ 36
Figure 6-3 –Communication Port configuration. ................................................................................ 37
Figure 6-4 –Flashing firmware................................................................................................................. 38

BITalino R-IoT
User Manual
BR 20200207
6 of 42
1Regulatory & Legal Information
1.1 Disclaimer
BITalino R-IoT devices are intended for use in life science education and research
applications only; they are not medical devices, nor medical software solutions, nor are
they intended for medical diagnosis, cure, mitigation, treatment or prevention of disease
and is provided to you “as is”.
We expressly disclaim any liability whatsoever for any direct, indirect, consequential,
incidental or special damages, including, without limitation, lost revenues, lost profits,
losses resulting from business interruption or loss of data, regardless of the form of action
or legal theory under which the liability may be asserted, even if advised of the possibility
of such damages.
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.
If PLUX receives a notification of any such defects within the warranty period, it will
repair or replace with the same unit/model, any products with proven defects at no cost
to the client. During the repair period PLUX promises to provide a temporary replacement
under the same specification. Repairs will be carried out at PLUX’s premises after the
equipment has been received.

BITalino R-IoT
User Manual
BR 20200207
7 of 42
1.2.1 Warranty Voidance
Usage of the device that is not in accordance with the handling instructions indicated in
the manual or use with accessories other than those manufactured by PLUX will
invalidate the warranty of your devices.
Be careful when connecting your BITalino R-IoT devices, sensors and/or accessories to
any third party device including the usage of the third party connection components that
are available for BITalino R-IoT systems as the usage of these components will void the
electrical warranty of your device and sensors and, if not indicated otherwise, the
warranty of the third party system you’re connecting to the device. Check the electrical
specifications of both systems you want to connect to prevent any damage to the user(s)
or the systems.
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.
Please send us an e-mail with precise information about the error occurrence, device
configuration, and, if possible, screenshots of the problem to [e-mail].

BITalino R-IoT
User Manual
BR 20200207
8 of 42
2List 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 –Internet of Things
JTAG –Joint Test Action Group
LAN –Local Area Network
MCU –Microcontroller Unit
OSC - Open Sound Control
SPI –Serial Peripheral Interface
SSID - Service Set Identifier
TCP/IP - Internet Protocol Suite
TI –Texas Instruments
UART - Universal Asynchronous Receiver/Transmitter
UDP - User Datagram Protocol
UPnP –Universal Plug and Play
WAN –Wide Area Network
WISH –Wireless Intelligent Stream Handling
WPS –Wi-Fi Protected Setup

BITalino R-IoT
User Manual
BR 20200207
9 of 42
3Introduction
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.
The BITalino R-IoT embeds a 9-axis digital IMU sensor (LSM9DS1) [1] featuring a 3-axis
accelerometer, a 3-axis gyroscope and a 3-axis magnetometer, allowing for instance the
onboard computation of the absolute orientation of the module in space. The sensor is
attached to the SPI port to sample the 16-bit motion data at high speed.
The core of the BITalino R-IoT module is based upon the CC3200 [2] chip from Texas
Instruments (TI) and it is compatible with Energia [3], a programming tool for TI
processors with the easiness of the Arduino [4] look & feel.
3.1 Overview
3.1.1 The CC3200 MCU
Created for the Internet of Things (IoT), the SimpleLink WiFi CC3200 device is a wireless
MCU that integrates a high-performance ARM®Cortex-M4 MCU allowing developers to
build an entire application with a single IC. With on-chip Wi-Fi, internet and robust
security protocols, no prior Wi-Fi experience is needed for faster development.
Figure 1-1 –Functional Block Diagram.