Android and iOS sample client application. STMicroelectronics BLUEMICROSYSTEM1

UM1863 BLUEMICROSYSTEM1 software description

1.11 Android and iOS sample client application

The BLUEMICROSYSTEM1 software for STM32Cube is compatible with the BlueMS

Android/iOS applications (ver. 2.2.0 or higher) available at the respective Play/iOS stores.

Version 3.0.0 and above is required for Over-The-Air firmware updates (for X-NUCLEO-

IDB05A1 Bluetooth low energy expansion boards only) and to request and enable the

Open.MEMS. Version 3.2.0 and above is required to display Gas Gauge battery information (Battery %, volt, and charge status) for STEVAL-STLKT01V1 board.

We use the Android application in this example.

Following connection, BlueMS starts with the main page shown below, where the values of temperature, pressure and humidity are displayed.

Figure 12: BlueMS (Android version) main page following BLE connection

DocID027485 Rev 6 19/63

BLUEMICROSYSTEM1 software description UM1863

If the osxMotionFX sensor fusion library is enabled, the following page shows a cube that rotates with board movement.

Figure 13: BlueMS (Android version) osxMotionFX sensor fusion page

20/63

On this page, there are two buttons along the bottom:

• the left is for resetting the cube position.

• the right shows the calibration status of the osxMotionFX library (black for not calibrated, green for calibrated). Clicking it forces a magneto calibration.

DocID027485 Rev 6

UM1863 BLUEMICROSYSTEM1 software description

When either button is pressed, the application pops up a window describing how to position the board for correct cube rotation and how to move the board to facilitate calibration (see figure below).

Figure 14: BlueMS (Android version) popup windows

DocID027485 Rev 6 21/63

BLUEMICROSYSTEM1 software description UM1863

On the next page to the left, you can plot any value from the sensor expansion boards.

Figure 15: BlueMS (Android version) accelerometer plot

22/63 DocID027485 Rev 6

UM1863 BLUEMICROSYSTEM1 software description

In the option menu below, you can open:

• Serial or Debug (with stdin) console

• License manager

• Firmware upgrade

Figure 16: BlueMS (Android version) menu selection

DocID027485 Rev 6 23/63

BLUEMICROSYSTEM1 software description

If the Serial console is enabled, stdout/stderr is displayed, as shown below.

Figure 17: BlueMS (Android version) Serial console (stdout/stderr)

UM1863

24/63 DocID027485 Rev 6

UM1863 BLUEMICROSYSTEM1 software description

If the Debug console is enabled, stdin is displayed and any message written in the Debug console triggers a reply with the same message, as shown below.

Figure 18: BlueMS (Android version) Debug console (stdin/stdout/stderr)

There is another page where you can choose which hardware feature to enable (one at the time) and view the events (see following figures) on the same page from:

• LSM6DS3 DIL24 (if present) for STM32 Nucleo expansion boards

• LSM6DSL for X-NUCLEO-ISK01A2 for STM32 Nucleo expansion boards

• LSM6DSM for STEVAL-STLKT01V1

The orientation hardware feature is the default setting.

DocID027485 Rev 6 25/63

BLUEMICROSYSTEM1 software description

Figure 19: BlueMS (Android version) hardware features

UM1863

26/63 DocID027485 Rev 6

UM1863 BLUEMICROSYSTEM1 software description

Figure 20: BlueMS (Android version) hardware feature examples: pedometer, wake up, orientation, double tap

If the osxMotionAR algorithm is enabled, the page shown below is available, signaling one of the following recognized activities:

• Stationary

• Walking

• Fast walking

• Jogging

• Biking

• Driving

DocID027485 Rev 6 27/63

BLUEMICROSYSTEM1 software description

Figure 21: BlueMS (Android version) osxMotionAR activity recognition page

UM1863

28/63

If the osxMotionCP algorithm is enabled, the page shown below is available, with information about how the user is carrying the board, which equates to phone carry positions:

• on desk

• in hand

• near head

• shirt pocket

• trousers pocket

• arm swing

DocID027485 Rev 6

UM1863 BLUEMICROSYSTEM1 software description

Figure 22: BlueMS (Android version) osxMotionCP carry position recognition page

If the osxMotionGR algorithm is the page shown below is available, with gesture recognition information like:

• pick up

• glance

• wake up in hand

DocID027485 Rev 6 29/63

BLUEMICROSYSTEM1 software description

Figure 23: BlueMS (Android version) osxMotionGR gesture recognition page

UM1863

30/63 DocID027485 Rev 6

UM1863 BLUEMICROSYSTEM1 software description

If the osxMotionPM algorithm is the page shown below is available, with pedometer information:

Figure 24: BlueMS (Android version) osxMotionPM pedometer page

The following page shows the LED on/off control.

DocID027485 Rev 6 31/63

BLUEMICROSYSTEM1 software description

Figure 25: BlueMS (Android version) board LED control

UM1863

32/63

The last indicates the RSSI of the Bluetooth signal and, for STEVAL-STLKT01V1 if the battery is connected, the charge percentage, measured voltage and battery status

(charging/discharging/low battery).

DocID027485 Rev 6

UM1863 BLUEMICROSYSTEM1 software description

Figure 26: BlueMS (Android version) Battery and RSSI information

DocID027485 Rev 6 33/63