A custom firmware for Movesense Sensor devices which implements a Bluetooth Low Energy (BLE) GATT electrocardiograph (ECG) voltage and movement measurements.
This Repository is forked from version 2.2.1 of the official Movesense Device Library.
Our custom firmware provides the following GATT Services:
- Heart Rate Service with 16-bit UUID
0x180D
: Provides access to R-R intervals in milliseconds. See the Bluetooth SIG specification for more details. - Activity Data Service with 16-bit UUID
0x1859
: Provides access to the ECG voltage and movement measurements.- ECG Voltage Characteristic with 16-bit UUID
0x2BDD
: Provides NOTIFY access to a relative timestamp and a series of n voltages. Each voltage is encoded as a 16-bit integer where -32768 is interpreted as an invalid value. - ECG Measurement Interval Characteristic with 16-bit UUID
0x2BE3
: Provides READ and WRITE access to the ECG measurement interval in milliseconds. Allowed values: 2 (500 Hz), 4 (250 Hz), 8 (125 Hz), and 10 (100 Hz). - Movement Characteristic with 16-bit UUID
0x2BE2
: Provides NOTIFY access to a relative timestamp and a series of n 3-tuples of 3D vectors of acceleration, gyroscope, and magnetic field values. Each value is encoded as a 16-bit integer where -32768 is interpreted as an invalid value. - Movement Measurement Interval Characteristic with 16-bit UUID
0x2BE4
: Provides READ and WRITE access to the movement measurement interval in milliseconds. Allowed values: 5 (208 Hz), 10 (104 Hz), 20 (52 Hz), 40 (26 Hz).
- ECG Voltage Characteristic with 16-bit UUID
The sensor powers on when either the battery is inserted or the ECG measures activity.
Then the sensor is on and announces Bluetooth connectivity with an interval of 100 milliseconds. While the sensor is on, the red LED blinks with an interval of 5 seconds. After 30 seconds without any Bluetooth connection to a device, the red LED lights up for 3 seconds before it shuts down. When the sensor disconnects from a connected Bluetooth device, this sequence is repeated and the sensor shuts down after 30 + 3 seconds without any connection.
The shutdown can be only prevented within the time window of 30 seconds. As soon as the sensor enters the 3 second shutdown sequence with a lighted LED, the shutdown cannot be prevented anymore.
To use the Movesense ECG devices with the BLE GATT ECG Voltage service, you must flash the firmware on your Movesense sensor with the firmware whose source code is provided in this repository. To get this custom firmware, you have two choices:
To build the firmware from source, first pull the official Docker image:
docker pull movesense/sensor-build-env:latest
Then clone this repository:
git clone https://github.com/JonasPrimbs/movesense-ble-ecg-firmware.git
Then run the Docker image and mount the directory to the image:
Linux or MacOS:
docker run -it --rm -v /path/to/repo/movesense-ble-ecg-firmware:/movesense:delegated movesense/sensor-build-env:2.2
Windows:
docker run -it --rm -v C:\path\to\repo\movesense-ble-ecg-firmware:/movesense:delegated movesense/sensor-build-env:2.2
When the Docker container starts, create the directory /movesense/build
and navigate to it:
mkdir /movesense/build
cd /movesense/build
To prepare for building in debug mode, prompt:
cmake -G Ninja -DMOVESENSE_CORE_LIBRARY=../MovesenseCoreLib/ -DCMAKE_TOOLCHAIN_FILE=../MovesenseCoreLib/toolchain/gcc-nrf52.cmake ../ble-ecg
To prepare for building in production mode, prompt:
cmake -G Ninja -DMOVESENSE_CORE_LIBRARY=../MovesenseCoreLib/ -DCMAKE_TOOLCHAIN_FILE=../MovesenseCoreLib/toolchain/gcc-nrf52.cmake -DCMAKE_BUILD_TYPE=Release ../ble-ecg
To build in prepared mode, prompt:
ninja pkgs
This will build the firmware to /movesense/build
.
The important files to deploy the firmware are:
Movesense_dfu_w_bootloader.zip
: The bootloader required to flash Movesense sensors for the first time.Movesense_dfu.zip
: The actual firmware.
With these files, you can go on with section Install Firmware.
Go to Releases and download the latest versions of the following files:
Movesense_dfu_w_bootloader.zip
Movesense_dfu.zip
Now go on with section Install Firmware.
To flash the firmware, install the Movesense Showcase App for Android or iOS and use its DFU tool as described here.
Warning: We are using Firmware version 2.2.1 as basis! This requires also a Bootloader of version 2.x. Flashing the sensor with this Bootloader requires an updated Showcase App (Android: from 1.9.8, iOS: from 1.0.5)! Otherwise you will consider a file corrupted error.
Hint: If you haven't flashed the firmware since buying your Movesense sensor, you must first flash it with the Movesense_dfu_w_bootloader.zip
file.
After that, you can directly flash the firmware with Movesense_dfu.zip
.