Plux BITalino R-IoT User Manual Download Page 42

Page: 42 / 43

BITalino R-IoT

User Manual

BR 20200207

41 of 42

OSC

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.
This simple yet powerful protocol provides everything needed for real-time control of

sound and another media processing while remaining flexible and easy to implement.
Features:

•

Open-ended, dynamic, URL-style symbolic naming scheme

•

Symbolic and high-resolution numeric argument data

•

Pattern matching language to specify multiple recipients of a single message

•

High resolution time tags

•

"Bundles" of messages whose effects must occur simultaneously

•

Query system to dynamically find out the capabilities of an OSC server and get

documentation

For further information please visit

http://opensoundcontrol.org/

Summary of Contents for BITalino R-IoT

Page 1: ...Real time Internet of Things Wireless Motion Sensor User Manual V1 2 ...

Page 2: ...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 ...

Page 3: ...ers 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 1050 059 Lisboa Portugal tel 351 211 956 542 Institut de Recherche et Coordination Acoustique Musique IRCAM Web https www ircam fr 1 Place Igor Stravinsky 75004 Paris France tel 33 1 44 78 48 43 ...

Page 4: ... 4 3 Battery Considerations 14 5 R 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 6 Wi 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 fo...

Page 5: ...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 9 Programming 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 ...

Page 6: ...ge 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 Fig...

Page 7: ...n 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...

Page 8: ...age 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 w...

Page 9: ... 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 Intell...

Page 10: ... 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 ...

Page 11: ...MCUs based on the LaunchPad 6 board The Energia IDE is cross platform and supported on Mac OS Windows and Linux The foundation of Energia is the Wiring framework that was developed by Hernando Barragan 3 That was thoughtfully created with designers and artists in mind to encourage a community where both beginners and experts from around the world share ideas knowledge and their collective experien...

Page 12: ... of your BITalino R IoT without any additional intervention needed https plux info accessories 403 wireless route bitalino riot 810121713 html If you prefer to configure a network yourself or change the settings on the device we advise you to read the following chapters The BITalino R IoT exports only some of the available I O s from the CC3200 for matters of size form factor It remains small enou...

Page 13: ...anual BR 20200207 12 of 42 4 Hardware Description Figure 2 1 Top View Figure 2 2 Bottom View Mode Button Flash Button Reset Button RGB LED Tx Rx LED Charger LED Port A Port B Antenna Power Switch USB Data FTDI Charging Port ...

Page 14: ...tion VCC VCC 3 3V General Power Source IN GPIO_13 GPIO_13 Digital Input OUT GPIO_12 GPIO_12 Digital Output GND GND A2 GPIO_05 ADC_CH3 12 bit ADC Input 1 5VMax A1 GPIO_04 ADC_CH2 12 bit ADC Input 1 5VMax Can be selected as a Wake up Source REF VREF 1 65V Isolated Reference AVCC AVCC 3 3V Sensors Power Source GND GND Table 1 Port A Pin Attributes ...

Page 15: ...T RX Data TX GPIO_10 I2C_SCL 1 I2C Clock UART1_TX 2 UART TX Data DVCC DVCC 3 3V Digital Power Source CTS NC Not Connected GND GND 1 Config Mode 7 2 Config Mode 0 Table 2 Port B Pin Attributes 4 3 Battery Considerations Polymer Lithium Ion Battery Weight 10g Size 29 x 36 x 4 75 mm Output 3 7V Capacity 700mAh Connector 2 pin JST should be charged using R IoT via Battery connector on the PCB using th...

Page 16: ...n edit the R IoT configuration in first place By default the module will be sending OSC data The OSC message structure is described in section 7 to the DEST IP destination IP address 192 168 1 100 on port 8888 The remaining data can be seen on Figure 3 4 Figure 3 1 R IoT Configuration 5 2 Changing the Default Configuration To trigger the configuration mode press the Mode button while the R IoT is ...

Page 17: ... AP SSID Example To continue please follow these steps 1 Set your computer as host Chapter 6 and lookup the Wi Fi network proposed by the module 2 Connect to the network no security needed 3 Open your web browser and open the URL http 192 168 1 1 which is the pre configured IP After these steps you should be redirected to the web page hosted by the module like the one on Figure 3 4 where you can c...

Page 18: ...nt see Chapter 6 Most of the default settings should work with your Wi Fi infrastructure We suggest keeping the R IoT in station mode AP is provided by the infrastructure router If some security is absolutely needed WPA 2 can be enabled along with a password or passphrase however security uses more bandwidth and can be delicate to configure for new users If the goal is to prevent unwanted access t...

Page 19: ...used to ease the data routing when identifying the R IoT in the software application We suggest using both a port and ID based routing in order to ensure the proper identification of the data flow source A simple module convention makes it easy to remember For example R IoT module 0 uses port 8000 R IoT module 1 uses port 8001 R IoT module 8 uses port 8008 In the case the software application has ...

Page 20: ...ing data to its DEST IP destination IP address identified in the field of the configuration web page Figure 3 4 which is by default 192 168 1 100 Therefore a local network must be created using the AP router and the proper destination address set on the computer 6 1 Change Computer IP On MacOS go to the system preferences then network preferences Select the Wi Fi connection and connect to Wi Fi ri...

Page 21: ...l BR 20200207 20 of 42 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 Figure 4 3 Change IP Step 2 ...

Page 22: ...rties 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 Figure 4 5 Change IP Step 4 5 After finishing using the R IoT you should change back this setting to Obtain an IP address automatically ...

Page 23: ...anually set IP address MacOS has a profile system in its network preferences On Windows you might have to install a free software to manage the profiles like NetsetMan 1 If you further need to change the destination IP just make sure the R IoT module is also configured to send to the right one The selected IP address must match the network base address 192 168 1 XXX in our case so that the OSC mes...

Page 24: ...efore you configure your router to be an Access Point Disable UPnP Disable DHCP Disable features that depend upon WAN Virtual Server SPI and Firewall Application and Port Forward Rules Access Control and Web Filters Time WISH and WPS Change the IP address of the LAN on your network to an available address The essential information to know provided by the user s manual of the device is its IP addre...

Page 25: ...he Network Connection Details The IP address will be displayed Figure 4 8 Finding IP Step 3 Each brand or manufacturer tend to have its own default configuration Further configuration steps may be specific to each Access Point and thus you should refer to the user manual of the one you own Nonetheless we will explain the procedure for the one we provide in our catalogue ...

Page 26: ...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 The default configuration of the R IoT is to connect to a computer with the IP address 192 168 1 100 This value can be set between 192 168 1 100 up to 192 168 1 199 as shown on the next figure Figure 4 10 AP ro...

Page 27: ...ork If you are using the R IoT defaults use riot as the network name Select a Wi Fi channel that is possibly different than your neighbour Finally go to the security section and disable encryption WPA 2 encryption is supported but not recommended on first use Figure 4 11 AP router Configuration SSID setup Once the router is configured with this 192 168 1 XXX address scheme and DHCP the computer IP...

Page 28: ...ng uses the scheme 10 0 0 XXX or similar The important thing is to understand your 3 devices the R IoT the Wi Fi access point and the computer must be on the same scheme to be able to see each other In addition the R IoT must know to which address it has to send data to the computer IP Ideally you will label your AP with a stiff sticker to remember its IP and find an easy way to remember the ID an...

Page 29: ...itrary binary data followed by 0 3 additional zero bytes to make the total number of bits a multiple of 32 The size of every atomic data type in OSC is a multiple of 32 bits This guarantees that if the beginning of a block of OSC data is 32 bit aligned every number in the OSC data will be 32 bit aligned 7 1 2 OSC Packets The unit of transmission of OSC is an OSC Packet Any application that sends O...

Page 30: ...called an OSC Type Tag and represents the type of the corresponding OSC Argument The requirement for OSC Type Tag Strings to start with a comma makes it easier for the recipient of an OSC Message to determine whether that OSC Message is lacking an OSC Type Tag String 7 1 4 OSC Bundles An OSC Bundle consists of the OSC string bundle followed by an OSC Time Tag followed by zero or more OSC Bundle El...

Page 31: ...d to motion analysis or sensor data streaming Using the additional I Os and analog input and the Wi Fi modem the unit can be turned into an efficient Internet of Things IoT object a miniature web server a car alarm or a plant watering system 8 3 Receive Sensors Data from the Module The OpenSignals software provides an easy way to acquire and visualize data from sensors please refer to OpenSignals ...

Page 32: ...it like the following Sequence number 0 15 4 digital inputs I1 to I4 0 1 6 analog inputs A1 to A6 0 1023 Below an example Max MSP patch shows the easiness of receiving and splitting the data flow A quick way to verify that the data is flowing correctly between the R IoT and your computer is to use the OSC Data Monitor 9 Figure 5 1 Max MSP example ...

Page 33: ...om 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 This abstraction uses the free Max library MuBu available here http forumnet ircam fr product mubu Figure 5 2 Abstraction analysis example maxpat ...

Page 34: ...es 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 On Windows Open the location of your Energia folder such as C Program Files x86 energia 0101E0017 Keep going into hardware cc3200...

Page 35: ...o basic library a small wrapper to ease the communication with the BITalino r evolution https github com Ircam R IoT bitalino energia library Please copy the folder bitalino1 that has the newest version Those libraries must be placed in the Documents Energia libraries folder PC or Mac 9 5 Use Energia IDE Launch Energia A blank sketch appears A sketch is composed of two essential functions setup an...

Page 36: ...BITalino R IoT User Manual BR 20200207 35 of 42 Below an example of blinking endlessly the red LED from RGB_LED of the module GPIO I 0 9 Figure 6 1 Blink Code example ...

Page 37: ...l BR 20200207 36 of 42 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: ...00207 37 of 42 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 Figure 6 3 Communication Port configuration COMPILE ...

Page 39: ...ompiling is over the uploading text will be printed above the console Release the reset switch while keeping the flash switch pressed After a while you ll get a done uploading message with the following log in the console of the IDE Figure 6 4 Flashing firmware The DEBUG write fail messages are normal as the bootloading program tries also to set the chip in debug mode and our platform doesn t have...

Page 40: ...07 39 of 42 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: ...ltimedia developed and maintained by San Francisco based software company Cycling 74 Over its more than thirty year history it has been used by composers performers software designers researchers and artists to create recordings performances and installations 11 The Max program is modular with most routines existing as shared libraries An application programming interface API allows third party de...

Page 42: ...nd documentation This simple yet powerful protocol provides everything needed for real time control of sound and another media processing while remaining flexible and easy to implement Features Open ended dynamic URL style symbolic naming scheme Symbolic and high resolution numeric argument data Pattern matching language to specify multiple recipients of a single message High resolution time tags ...

Page 43: ...ign resources embedded development hardware kits boards html keyMatch LAUNCHPAD tisearch Search EN everything Accessed 06 Feb 2020 7 Open Sound Control Introduction to OSC opensoundcontrol org Online Available http opensoundcontrol org introduction osc Accessed 07 Feb 2020 8 X Technologies Open source IMU and AHRS algorithms 2012 Online Available https x io co uk open source imu and ahrs algorithm...

Search results

Summary of Contents for BITalino R-IoT

Reviews:

Related manuals for BITalino R-IoT

Brands by name

Popular brands

Plux BITalino R-IoT, User Manual

Search results

Summary of Contents for BITalino R-IoT

Reviews:

Related manuals for BITalino R-IoT

Brands by name

Popular brands