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.

-11- v2.9
Notes
6º - At any time you can Activate / Deactivate the sinchronization of the information being sent to your
Cloud Account by just pressing the Cloud icon on the top right corner.
7º - How can I see values older than one month in my Cloud account? MySignals Cloud Web Service (section 5.2)
allows currently to see the complete historical data of any of the users.
If you want to access to this data, you can also use the Cloud API to get the sensor values of a member (see section
9.1.1).
If you have any doubt just write a post in the MySignals forum.
8º - In the “Detail view” only information coming from that specic sensor is received and sent to the Cloud. If you
want to receive and store information coming from many sensors at the same time you should use the “General
view” screen.
Figure: General view Figure: Detail view

-12- v2.9
Notes
9º - In February 2017 we have released new Firmware, Apps and Cloud versions that allow to record continuous
waves and send them to the Cloud (in Server Mode). You can record up to 30 seconds of the data measured in
detail mode of ECG, EMG, Snore and Airow.
10º - In the General view the update time to the Cloud is 10s. In the Detail view 5s.
11º - In order to make the MySignals App send to the Cloud you need:
•Have one Department created.
•Have one user created and linked to one.
•Department In the App to to Users, click on one and press “Select this user”.
•Make sure the “Cloud” icon is active (upper right corner of the App).12º - Connect the ECG Electrodes to the
ECG sensor cables before placing them in the user body.

-13- v2.9
Notes
12º - Connect the ECG Electrodes to the ECG sensor cables before placing them in the user body.
13º - The ECG signals need to be measured with the user lained back on the bed or stretcher.
14º - In order to keep the MySignals enclosure clean and without any mark we recommend to place it inside the
plastic bag and put the chamois cloth provided or any other protector desired on top of it before closing the bag.
15º - In case you placed MySignals into the kit without the protection and got it maked in black use a common nail-
varnish remover (with no acetone on it) along with a rag to clean it.

-14- v2.9
Notes
3.2. FAQ
- Can MySignals HW work against the Libelium Cloud server?
Yes. You can use it always sending the data via the Android / iOS App. Web server connection mode is not yet
implemented.
- Can MySignals work against our own cloud or a third party server?
Yes. You can send the information coming from MySignals to a third party Cloud server by three ways:
1º - Migrating the information stored in the Libelium Cloud to a third party Cloud server easily using the API
Cloud provided.
2º - Using directly the WiFi radio (HTTP, TCP/IP, etc). This last option just for MySignals HW.
- Can I use all the sensors at the same time?
In the case of MySignals SW, yes you can. In the case of MySignals HW the Arduino processor is limited, so you
can not manage all the sensors, wireless communication and others features at the same time. You should
select a correct combination of the options available. Check the documentation for that.

-15- v2.9
Notes
- Can I use my own sensors?
In the case of MySignals HW we provide the sensor pinout. You can use it to integrate your own sensors. WiFi,
BLE, and BT2.0 connectivity is available too in order to integrate new wireless sensors.

-16- v2.9
Hardware
4. Hardware
Figure: Top view of MySignals Software
Included on MySignals device:
•Micro-Controller Circuit
•Power Supply Circuit
•Sensor Circuits
•Bluetooth Low Energy module
•WiFi module
•Jack Sensor Connectors
In order to keep the MySignals enclosure clean and without any mark we recommend to place it into the plastic bag
and add on top the chamois cloth provided before closing the bag.

-17- v2.9
Hardware
4.1. Electrical Data
The MySignals Software can be powered by an external power supply.
General power supply
Operating Current 2 A
Operating Voltage 5V
Input Voltage (recommended) 7-9 V
Input Voltage (limit) 7-12 V
Specic power supply
DC Current per I/O Pin 20 mA
[Max]
DC Current for 3.3V 1 A [Max]
DC Current for 5V 1 A [Max]
Input Voltage (limit) 7-12 V
Plug in /out the power supply adapter included with MySignals to turn ON or OFF the device. Make sure that the
power adapter is placed indoors
Figure: MySignals Software powered
Plug it into the corresponding power supply connector. Power supply unit is included with Mysignals. Do not use
any third party power supply with it.

-18- v2.9
Hardware
You can see all the information about the power supply in the label included in MySignals device.
Figure: Certication MySignals label
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.

-19- v2.9
Hardware
4.2. USB Data Transfer
This connector is used to update code into MySignals with a male USB to male Mini USB cable provided by Libelium.
Just connect one side of the cable to this connector, removing protection cap from MySignals and connect the
other side to a PC to update a code.
Figure: MySignals Software USB connector
MySignals include a protective cap for this connector. When uploading processes are nished, do not forget to use
again protection cap to keep the connector clean from dust.
Figure: MySignals Software with protective cap

-20- v2.9
Hardware
4.3. Data Interface
Data can be visualized by 3 dierent modes:
•Standalone mode: using the basic graphic TFT Integrated in the device.
•Mobile APP'S: using the native Android / iOS connectivity to send all the data to the smartphone.
•Web Server: you can also access to the history of the information gathered by connecting to the Cloud through
a web browser or using the native iOS / Android App's.
Figure: MySignals Software Development Platform standalone with APP and Server
MySignals includes a stick to navigate through the menu options of the touchscreen. Please use it for a correct
function of the device interface.