Libelium MySignals SW Quick start guide

MySignals SW
eHealth and Medical IoT Development Platform
(HW rev.0)
Technical Guide

-2- v2.9
Document version: v2.9 - 02/2018
© Libelium Comunicaciones Distribuidas S.L.
Index
INDEX
1. MySignals Software Development Platform......................................................................4
1.1. General and safety information...................................................................................................... 4
1.2. Conditions of use .............................................................................................................................. 5
1.3. Disclaimer .......................................................................................................................................... 5
2. General view..........................................................................................................................6
2.1. Specications..................................................................................................................................... 8
3. Notes ......................................................................................................................................9
3.1. Important notes ................................................................................................................................ 9
3.2. FAQ ................................................................................................................................................... 14
4. Hardware .............................................................................................................................16
4.1. Electrical Data.................................................................................................................................. 17
4.2. USB Data Transfer........................................................................................................................... 19
4.3. Data Interface.................................................................................................................................. 20
4.4. Wireless Communications ............................................................................................................. 21
5. Software............................................................................................................................... 22
5.1. MySignals Firmware........................................................................................................................ 22
5.1.1. Version 1.0.1 – Release Notes............................................................................................22
5.1.2. Version 1.0.2 – Release Notes............................................................................................23
5.1.3. Version 1.0.3 – Release Notes............................................................................................23
5.1.4. Version 1.0.4 – Release Notes............................................................................................24
5.1.5. Version 1.0.5 – Release Notes............................................................................................25
5.1.6. Version 1.0.6 – Release Notes............................................................................................26
5.2. MySignals Mobile APP .................................................................................................................... 27
5.2.1. Register a device with a license .........................................................................................28
6.2. MySignals Mobile APP .................................................................................................................... 29
5.2.2. Encryption and bonding .....................................................................................................31
5.3. Libelium Smart Devices App.......................................................................................................... 32
6. Data Access.......................................................................................................................... 33
6.1. MySignals Standalone Mode ......................................................................................................... 33
6.1.1. Using Standalone Mode .....................................................................................................34
6.2.1. Using Bluetooth Connection Mode...................................................................................41
6.2.2. Installing to an iPhone ........................................................................................................58
6.2.3. Installing to an Android ......................................................................................................58
6.3. MySignals Cloud Application ......................................................................................................... 59
6.3.1. Using Server Connection Mode (WiFi mode) ...................................................................60
6.3.2. Sensor detail interface........................................................................................................72

-3- v2.9
Index
6.3.3. New Admin Dashboard ......................................................................................................74
6.3.4. Plans for Data Storage........................................................................................................75
6.3.5. How to get MySignals Cloud Plans....................................................................................77
6.3.6. Account creation .................................................................................................................77
6.3.7. License activation ................................................................................................................78
6.4. Using a third party Cloud ............................................................................................................... 81
7. Sensors .................................................................................................................................82
7.1. Wired Sensors ................................................................................................................................. 84
7.1.1. Pulse and Oxygen in Blood (SPO2)....................................................................................85
7.1.2. ECG........................................................................................................................................95
7.1.3. Airow................................................................................................................................ 114
7.1.4. Blood Pressure Monitor .................................................................................................. 130
7.1.5. Glucometer ....................................................................................................................... 139
7.1.6. Temperature..................................................................................................................... 151
7.1.7. EMG.................................................................................................................................... 159
7.1.8. Spirometer ........................................................................................................................ 176
7.1.9. GSR..................................................................................................................................... 187
7.1.10. Body Position.................................................................................................................. 195
7.1.11. Snore................................................................................................................................ 202
7.2. Wireless Sensors (BLE) ................................................................................................................ 218
7.2.1. Body Scale (BLE) ............................................................................................................... 220
7.2.2. Pulse and Oxygen in Blood SPO2 (BLE) ......................................................................... 226
7.2.3. Blood Pressure Monitor (BLE)......................................................................................... 232
7.2.4. Glucometer (BLE).............................................................................................................. 239
7.3. Bluetooth sensors on mobile applications ................................................................................ 247
7.3.1. Monitoring sensors .......................................................................................................... 249
7.3.2. Sampling sensors ............................................................................................................. 256
7.3.3. Selecting sensors.............................................................................................................. 257
8. Updating Firmware...........................................................................................................263
8.1. Libelium Smart Devices App........................................................................................................ 263
9. MySignals API's..................................................................................................................267
9.1. Cloud API........................................................................................................................................ 267
9.1.1. Basic conguration........................................................................................................... 267
9.1.2. PHP example..................................................................................................................... 274
10. Documentation Changelog ............................................................................................276
11. Certications...................................................................................................................277
12. Maintenance....................................................................................................................278
13. Disposal and recycling....................................................................................................279

-4- v2.9
MySignals Software Development Platform
MySignals Software Development Platform
1. MySignals Software Development Platform
1.1. General and safety information
The following list shows just some of the actions that produce the most common failures and warranty-voiding cases.
Failure to comply with the recommendations of use will entail the guarantee cancellation.
Software:
•Update rmware version only using Libelium Smart Devices App . If a dierent Software is used, MySignals can
be damaged and can become unresponsive. This use will void the warranty.
•Use only MySignal Web Server Application or MySignals Mobile APP in order to congure and setup your
account and device.
•Do not unplug any connector while uploading code. MySignals can become unresponsive. This use will void
the warranty.
•Do not connect or disconnect any sensor or connector while MySignals is ON. MySignals can become unstable
or unresponsive, and internal parts can be damaged.
UPDATE: In February 2017 we have released new version of MySignals. Using this new version you can connect or
disconnect any sensor while MySignals is ON.
If the ID of your device is 109 of higher you are using the new model with this new feature.
Hardware:
•Do not handle black stickers seals on both sides of the enclosure (Warranty stickers). Their integrity is the
proof that MySignals has not been opened. If they have been handled, damaged or broken, the warranty is
void.
•Do not open MySignals in any case. This will automatically make the warranty void.
•Do not handle the four metallic screws of MySignals.
•Do not submerge MySignals in liquids.
•Do not place nodes on places or equipment where it could be exposed to shocks and/or big vibrations.
•Do not expose MySignals to temperatures below -10ºC or above 50ºC.
•Do not connect any sensor not provided by Libelium.
•Do not power MySignals with other power sources than the original provided by Libelium.
•Connect any sensor not provided by Libelium only under your responsability.
The document “General Conditions of Libelium Sale and Use” can be found at:
www.libelium.com/development/waspmote/technical_service

-5- v2.9
MySignals Software Development Platform
1.2. Conditions of use
General:
•Read the “General and Safety Information” section carefully and keep the manual for future reference.
•Read carefully the “General Conditions of Sale and Use of Libelium”. This document can be found at: www.
libelium.com/development/waspmote/technical_service. As specied in the Warranty document the client has 7
days from the day the order is received to detect any failure and report that to Libelium. Any other failure
reported after these 7 days may not be considered under warranty.
•Use MySignals in accordance with the electrical specications and in the environments described in the
“Electrical Data” section of this manual.
•MySignals and its components and modules are supplied as a nal product. This product has an enclosure to
protect it from dust, humidity and other environmental interactions.
•Do not place MySignals in contact with metallic surfaces; they could cause short-circuits which will permanently
damage it.
Remember that inappropriate use or handling of MySignals will immediately invalidate the warranty.
If you have any doubt you can post your question at: https://www.libelium.com/forum/
Do not connect or disconnect any sensor or connector while MySignals is ON. MySignals can become unstable or
unresponsive, and internal parts can be damaged. Connect all the sensors that you want to use with MySignals and
then turn it ON.
UPDATE: In February 2017 we have released new version of MySignals. Using this new version you can connect or
disconnect any sensor while MySignals is ON.
1.3. Disclaimer
MySignals Products are not medical devices or health-care services, nor are they intended for medical diagnosis,
cure, mitigation, treatment, advice or prevention of disease. MySignals Products are not nished products, so they
are not intended to be purchased by End Users, but by developers, researchers and OEM Customers. Read our
Terms & Conditions before buying for a complete understanding.
Access to the Terms & Conditions at:
https://libelium.com/downloads/MySignals-Terms-and-Conditions.pdf

-6- v2.9
General view
2. General view
MySignals is a development platform for medical devices and eHealth applications. You can use MySignals to
develop your eHealth web applications or even to add your own sensors to build new medical devices.
MySignals allows you to measure more than 20 biometric parameters such as pulse, breath rate, oxygen in
blood, electrocardiogram signals, blood pressure, muscle electromyography signals, glucose levels, galvanic skin
response, lung capacity, snore waves, patient position, airow and body scale parameters (weight, bone mass,
body fat, muscle mass, body water, visceral fat, Basal Metabolic Rate and Body Mass Index). These broad sensing
portfolio makes MySignals the most complete eHealth platform in the market.
Figure: My Signal Software Development Platform
All the data gathered by MySignals is encrypted and sent to the user's private account at Libelium Cloud through
WiFi or Bluetooth. Data can be stored in the Libelium Cloud or being sent to a third party Cloud Server.The data
can be visualized in a tablet or smart phone with Android or iPhone Apps.

-7- v2.9
General view
Libelium oers an API for developers to access the information. The Cloud API allows to access to the user's
private account and get the information previously stored to be visualized in a third party platform.
You can nd all the info at: http://www.my-signals.com
Figure: My Signal Software Development Platform with sensors

-8- v2.9
General view
2.1. Specications
MySignals allows you to measure 20 dierent biometric parameters such as pulse, breath rate, oxygen in blood,
electrocardiogram signals, blood pressure, muscle electromyography signals, glucose levels, galvanic skin
response, lung capacity, snore waves, patient position, airow and body scale parameters (weight, bone mass,
body fat, muscle mass, body water, visceral fat, Basal Metabolic Rate and Body Mass Index). These broad sensing
portfolio makes MySignals the most complete eHealth platform in the market.
Figure: My Signal Software Development Platform
•Monitoring EMG signals.
•Monitoring ECG signals.
•Monitoring Snore signals.
•Airow control of user.
•Body temperature data.
•Galvanic skin response measurements.
•Body position detection.
•Pulse and oxygen functions. Wireless or wired version.
•Blood pressure control device. Wireless or wired version.
•Glucometer monitor. Wireless or wired version.
•Spirometer monitor.
•Body Scale. Wireless version.
This information is used to monitor in real time the state of a user or to get sensitive data in order to be subsequently
analysed for medical diagnosis. Biometric information gathered is wirelessly sent using two connectivity options
available: Wi-Fi or Bluetooth Low Energy 4.0.
Data can be visualized in standalone mode, sent to the Cloud in order to perform permanent storage or visualize
and storaged in real time by sending the data directly to a Smartphone. iPhone and Android applications have
been designed in order to easily manage and storage the user’s information.
With CE / FCC / IC Certications what makes it perfect to be used in any kind of project.
NOTE: MySignals Software Development Platform is a hardware closed device. It is ready to be used as a web and mobile App's
development platform with the sensors distributed by Libelium. If you want to integrate new sensors (wired, BLE, BT) or program
the device with a personal rmware use the MySignals HW model.

-9- v2.9
Notes
3. Notes
3.1. Important notes
1º - As a new product line we are updating the rmware and mobile App’s every week so please:
•Update regularly the MySignals Firmware to the last version. Go to the section “MySignals Firmware” of the guide
for more info.
•Update regularly the version of the Android / iOS App.
2º - IMPORTANT: DO NOT UNPLUG MYSIGNALS WHILE IT IS BEING UPGRADED OR IT MAY BE RENDERED USELESS!
(THIS CASE IS NOT COVERED BY THE WARRANTY).
3º - Do not connect or disconnect any sensor or connector while MySignals is ON. MySignals can become unstable
or unresponsive, and internal parts can be damaged. Connect all the sensors that you want to use with MySignals
and then turn it ON.
UPDATE: In February 2017 we have released new version of MySignals. Using this new version you can connect or
disconnect any sensor while MySignals is ON.
If the ID of your device is 109 of higher you are using the new model with this new feature.

-10- v2.9
Notes
4º - MySignals includes a stick to navigate through the menu options of the touchscreen. Please use it for a correct
function of the device interface.
5º - The Firmware of MySignals SW manages all the sensors at the same time and monitors the response
of the screen andthetouchscreen. For this reason sometimes during the measurement of dierent sensor like
blood pressure or other wireless sensors it will be able to perform one action at the same time, you have to wait
it to nish before being able to navigate or interact with the screen again.