STMicroelectronics STEVAL-MKI109V3 User Manual

) e.g.: LIS3DH e.g.: V1.5.2

e.g.: RAAhDDh e.g.: GRAAhDDh e.g.: MRAAhDDh e.g.: PRAAhDDh e.g.: HRAAhDDh e.g.: TRAAhDDh

(see

The commands listed in Table 3 work regardless of whether an adapter is physically inserted in the DIL24 socket

) e.g.: 087V1 089V1 092V1 105V1...

e.g.: LIS331DL LIS331DLH LIS331HH… e.g.: RAAhDDh st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS

UM2116 - Rev 8 page 12/41

UM2116 - Rev 8

UM2116

Supported commands

Command

*fifodstr

*gfiforst

*gfifomde

*gfifostr

*gfifostf

*gfifobtf

*gfifobts

*gfifodstr

*pfiforst

*pfifomde

*pfifostr

*pfifostf

*pfifobtf

*pfifobts

*pfifodstr

*rmAA

…

*hrmAA

*mutli-rAA

…

*grmAA

*multi-grAA

…

*mrmAA

…

*prmAA

*multi-prAA

*trmAA

*multi-mrAA

*multi-hrAA

…

Description

Accelerometer “Dynamic stream” enable

Gyroscope “Reset mode” enable

Gyroscope “FIFO mode” enable

Gyroscope “FIFO stream” enable

Gyroscope “Stream to FIFO” enable

Gyroscope “Bypass to FIFO” enable

Gyroscope “Bypass to stream” enable

Gyroscope “Dynamic stream” enable

Pressure sensor “Reset mode” enable

Pressure sensor “FIFO mode” enable

Pressure sensor “FIFO stream” enable

Pressure sensor “Stream to FIFO” enable

Pressure sensor “Bypass to FIFO” enable

Pressure sensor “Bypass to stream” enable

Pressure sensor “Dynamic stream” enable

Multiple read of NN Accelerometer successive registers

Accelerometer registers multiple read

Multiple read of NN Gyroscope successive registers

Gyroscope registers multiple read

Multiple read of NN Magnetometer successive registers

Magnetometer registers multiple read

Multiple read of NN Pressure sensor successive registers

Pressure sensor registers multiple read

Multiple read of NN Humidity sensor successive registers

Humidity sensor registers multiple read

Multiple read of NN Temperature sensor successive registers

*multi-trAA

…

*odr [param]

Temperature sensor registers multiple read

Sets ODR speed

Returned value

(1)

st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS st XH XL YH YL ZH ZL IR FC FS

RMAA

GRMAA

PRMAA

HRMAA

TRMAA hNNhDD

MULTI-RAA

MRMAA

MULTI-PRAA

MULTI-HRAA

1 hDD

1 hDD hNNhDD

MULTI-GRAA

1 hDD

1 h AA

2 hNNhDD

MULTI-MRAA

1 hDD hNNhDD

1 hDD

1 hNNhDD hNNhDD

MULTI-TRAA

1 hDD

2 h AA hDD

1 hDD

...DD

hDD

2 hDD

2 h AA

1 h AA hDD h AA

...DD

hDD

2 hDD

...DD

hDD

...DD

hDD

...DD

hDD

1 h AA

...DD

2 h h…. AAnDDnh

NN h…. AAnDDnh

NN hDD

2 h h…. AAnDDnh h h…. AAnDDnh h h h…. AAnDDnh h h…. AA n

1. RP: Reference pressure XLSB.MSB, IR: interrupt byte; FC: FIFO control register; FS: FIFO source register

DD n h page 13/41

UM2116

Supported commands

4.2.1

4.2.2

Command

*power_on

*power_off

*setvddaX.Y

*setvddioX.Y

*adc_single

Table 3. List of supported commands for power supply control and I/V measurement

*get_i [param]

*get_v [param]

Description

Turns on VDD and VDDIO power supply

Turns off VDD and VDDIO power supply

Sets VDD voltage value “X.Y” Volts. e.g.: 1.8

Sets VDDIO voltage value “X.Y” Volts. e.g.: 1.8

Measures VDD, VDDIO, IDD, IDDIO and another values sent in binary form

Measures IDD, IDDIO with automatic / semiautomatic current ranges toggling and measurement method selection. Output values format selected by parameters [F / B / A] [S] [C] [L]

Returned value adc:D1D2D3…D20 e.g. param = A ida Idd = 152 µA IddIO =

0.092 µA e.g. param = A vda Vdd = 1.807 V VddIO =

1.806 V

*ranges_auto

*ranges_man

*range_ma [param]

*range_mb [param]

Measures VDD, VDDIO

Output values format selected by parameters [F/B/A]

Turns on automatic IDD/IDDIO ranges selection (default)

Turns off automatic IDD/IDDIO ranges selection (manual IDD/IDDIO ranges selection possible)

Selects current range for IDD

Selects current range for IDDIO

*adc_uni_stop Stops all measurements

or not, and also whether the STEVAL-MKIxxxxx of the adapter is selected or not (using the *Setdb command).

*setdbXXXVY

This command selects the part of the firmware able to handle the adapter board sensor connected to the board.

For example, *setdb105V1 selects the firmware for the LIS3DH.

The D3 LED (yellow) switches on automatically.

*start

This command initiates continuous data acquisition. When sent, the device returns a string of bytes (plus carriage return and line feed) like st OUT1 OUT2 OUT3 IR STP BT .

The first two bytes are always the ASCII char s and t which correspond to the hexadecimal values {73h 74h}.

OUT1 , OUT2 , and OUT3 contain the values measured at device outputs; if the output data is represented in more than 8 bits, OUT1 , OUT2 , and OUT3 are split into high byte (e.g., XH ) and low byte (e.g., XL ). In case of 24-bit resolution for some sensors, there is also an extra-low byte (e.g., pressure data: PXL PL PH ).

IR (INT1 INT2) contains the interrupt bytes and BT SW1|SW2 contains the bytes that describe the state of the buttons integrated on the board.

Specifically, bit#0 of the SW1|SW2 data corresponds to the status of the SW1 button on the demonstration kit board: it is set to 1 when the SW1 is pressed (otherwise 0). Bit#1 has the same behavior but is dedicated to the

SW2.

STP (STPL STPH) contains the step counter bytes for the internal device step counter value.

The string is ended with the carriage return ( \r ) and line feed ( \n ) bytes.

Before sending the *start command, the device must be out of 3-state (high impedance) and some registers must be configured according to user needs. Therefore, *start must be preceded by a * zoff and some

UM2116 - Rev 8 page 14/41

UM2116 - Rev 8

UM2116

Supported commands

As data is continuously acquired, LED D1 (green) blinks according to sensor data rate selected.

Table 4. Returned values for *start command shows the format of the string returned for each device when a

*start command is sent. Similar byte strings are returned for groups of commands related to FIFO, as is shown

in Table 5. Digital output accelerometers: supported commands list ,

Table 6. Digital output gyroscopes: supported commands list

Table 7. Digital output magnetometer: supported commands list ,

Table 8. Digital output pressure sensor: supported commands list ,

Table 9. Digital output humidity sensor: supported commands list

Table 10. Digital output temperature sensor: supported commands list and

Table 11. Analog output temperature sensor: supported commands list .

STEVAL # (Device)

STEVAL-MKI089V1 (LIS331DLH)

STEVAL-MKI092V1 (LIS331HH)

STEVAL-MKI105V1 (LIS3DH)

STEVAL-MKI110V1 (AIS328DQ)

STEVAL-MKI125V1 (A3G4250D)

STEVAL-MKI134V1 (LIS3DSH)

STEVAL-MKI135V1 (LIS2DH)

STEVAL-MKI136V1 (L3GD20H)

STEVAL-MKI151V1 (LIS2DH12)

STEVAL-MKI158V1 (AIS3624DQ)

STEVAL-MKI164V1 (LIS2HH12)

STEVAL-MKI168V1 (IIS2DH)

STEVAL-MKI170V1 (IIS328DQ)

STEVAL-MKI179V1 (LIS2DW12)

STEVAL-MKI180V1 (LIS3DHH)

STEVAL-MKI186V1 (IIS3DHHC)

STEVAL-MKI191V1 (IIS2DLPC)

STEVAL-MKI206V1 (AIS2DW12)

STEVAL-MKI087V1 (LIS331DL)

STEVAL-MKI175V1 (LIS2DE12)

STEVAL-MKI166V1 (H3LIS100DL)

STEVAL-MKI167V1 (H3LIS200DL)

STEVAL-MKI208V1K (IIS3DWB)

STEVAL-MKI174V1 (LIS2DS12)

STEVAL-MKI176V1 (LSM6DS3H)

STEVAL-MKI137V1 (LIS3MDL)

STEVAL-MKI181V1 (LIS2MDL)

STEVAL-MKI185V1 (IIS2MDC)

STEVAL-MKI107V1 (L3G4200D)

STEVAL-MKI107V2 (L3GD20)

STEVAL-MKI169V2 (I3G4250D)

STEVAL-MKI188V1 (L20G20IS)

Table 4. Returned values for *start command

s t XH XL YH YL ZH ZL int1 int2 sw1|sw2 \r \n s t X Y Z int1 int2 sw1|sw2 \r \n s t X 0 Y 0 Z 0 int1 int2 sw1|sw2 \r \n s t XH XL YH YL ZH ZL int1 sw1|sw2 \r \n s t XH XL YH YL ZH ZL int1 int2 stpL stpH 0 sw1|sw2 \r \n s t M_XH M_XL M_YH M_YL M_ZH M_ZL int1 sw1|sw2 \r \n s t G_XH G_XL G_YH G_YL G_ZH G_ZL

G_int1 G_int2 sw1|sw2 \r \n

STEVAL-MKI122V1 (LSM330DLC) s t A_XH A_XL A_YH A_YL A_ZH A_ZL G_XH G_XL G_YH G_YL G_ZH G_ZL

A_int1 A_int2 G_int1 G_int2 sw1|sw2 \r \n page 15/41

UM2116

Supported commands

UM2116 - Rev 8

STEVAL # (Device)

STEVAL-MKI106V1(LSM303DLHC)

STEVAL-MKI108V2 (9AXIS MODULE)

STEVAL-MKI159V1 (LSM9DS1)

STEVAL-MKI154V1 (LSM9DS0)

STEVAL-MKI159V1 (LSM9DS1)

s t A_XH A_XL A_YH A_YL A_ZH A_ZL M_XH M_XL M_YH M_YL M_ZH M_ZL

A_int1 A_int2 sw1|sw2 \r \n s t A_XH A_XL A_YH A_YL A_ZH A_ZL G_XH G_XL G_YH G_YL G_ZH G_ZL

M_XH M_XL M_YH M_YL M_ZH M_ZL

A_int1 G_int2 G_int3 0 sw1|sw2 \r \n s t A_XH A_XL A_YH A_YL A_ZH A_ZL G_XH G_XL G_YH G_YL G_ZH G_ZL

M_XH M_XL M_YH M_YL M_ZH M_ZL

A_int1 A_int2 sw1|sw2 \r \n s t A_XH A_XL A_YH A_YL A_ZH A_ZL G_XH G_XL G_YH G_YL G_ZH G_ZL

M_XH M_XL M_YH M_YL M_ZH M_ZL

A_int1 A_int2 G_int3 0 sw1|sw2 \r \n s t A_XH A_XL A_YH A_YL A_ZH A_ZL G_XH G_XL G_YH G_YL G_ZH G_ZL

Int1 Int2 sw1|sw2 \r \n

STEVAL-MKI161V1 (LSM6DS0)

STEVAL-MKI160V1 (LSM6DS3)

STEVAL-MKI178V1 (LSM6DSL)

STEVAL-MKI178V2 (LSM6DSL)

STEVAL-MKI182V1 (ISM330DLC)

STEVAL-MKI189V1 (LSM6DSM) s t A_XH A_XL A_YH A_YL A_ZH A_ZL G_XH G_XL G_YH G_YL G_ZH G_ZL

Int1 Int2 StpL StpH 0 sw1|sw2 \r \n

STEVAL-MKI163V1 (LSM303C)

STEVAL-MKI172V1 (LSM303AGR) s t A_XH A_XL A_YH A_YL A_ZH A_ZL M_XH M_XL M_YH M_YL M_ZH M_ZL

A_int G_int sw1|sw2 \r \n s t A_XH A_XL A_YH A_YL A_ZH A_ZL M_XH M_XL M_YH M_YL M_ZH M_ZL

A_int1 Aint2 G_int sw1|sw2 \r \n s t A_XH A_XL A_YH A_YL A_ZH A_ZL M_XH M_XL M_YH M_YL M_ZH M_ZL

A_int1 A_int2 M_int StpL StpH sw1|sw2 \r \n s t PXL PL PH TL TH REF_PXL REF_PL REF_PH

P_int1 sw1|sw2 \r \n

STEVAL-MKI173V1 (LSM303AH)

STEVAL-MKI184V1 (ISM303DAC)

STEVAL-MKI142V1 (LPS25H)

STEVAL-MKI165V1 (LPS25HB)

STEVAL-MET001V1 (LPS22HB)

STEVAL-MKI177V1 (LPS35HW)

STEVAL-MKI183V1 (LPS33HW)

STEVAL-MKI192V1 (LPS22HH)

STEVAL-MKI205V1 (LPS33W)

STEVAL-MKI213V1 (LPS27HHW)

STEVAL-MKI214V1 (LPS33K)

STEVAL-MKI141V1 (HTS221)

STEVAL-MKI190 (LIS2DTW12)

STEVAL-MKI193 (ASM300LHH)

STEVAL-MKI198V1K (STTS751)

STEVAL-MKI199V1K (STLM20)

STEVAL-MKI200V1K (STTS22H)

STEVAL-MKI201V1K (STTS75)

STEVAL-MKI202V1K (STDS75)

STEVAL-MKI203V1K (STCN75)

STEVAL-MKI204V1K (STLM75)

STEVAL-MKI194V1 (LSM6DSR)

STEVAL-MKI196V1 (LSM6DSO)

STEVAL-MKI215V1 (LSM6DSO32) s t PXL PL PH TL TH REF_PXL REF_PL REF_PH

Int1 Int2 FSMLC_INT FSM1 FSM2 StpL StpH TL TH sw1|sw2 \r \n page 16/41

UM2116

Supported commands

4.2.6

4.2.7

4.2.8

4.2.3

4.2.4

4.2.5

4.2.8.1

STEVAL # (Device)

STEVAL-MKI211V1K (LIS25BA)

STEVAL-MKI195V1 (LSM6DSRX)

STEVAL-MKI197V1 (LSM6DSOX)

STEVAL-MKI207V1 (ISM330DHCX)

STEVAL-MKI210V1K (ISM330DHCX)

Section Revision historySection Revision history

s t XH XL YH YL ZH ZL sw1|sw2 \r \n s t A_XH A_XL A_YH A_YL A_ZH A_ZL G_XH G_XL G_YH G_YL G_ZH G_ZL

Int1 Int2 FSMLC_INT FSM1 FSM2 StpL StpH MLC0 MLC1 MLC2 MLC3 MLC4 MLC5

MLC6 MLC7 TL TH sw1|sw2 \r \n

STEVAL-MKI209V1 (IIS2ICLX) s t A_XH A_XL A_YH A_YL Int1 Int2 FSMLC_INT FSM1 FSM2 StpL StpH MLC0

MLC1 MLC2 MLC3 MLC4 MLC5 MLC6 MLC7 TL TH sw1|sw2 \r \n

1. XH: X-axis output high byte (same for Y axis, Z axis, G gyroscope, M Magnetometer, P pressure, H humidity, T temperature,

Stp step counter). XL: X-axis output low byte (same for Y axis, Z axis, G gyroscope, M Magnetometer, P pressure, H humidity, T temperature, Stp step counter) . FSMx: Finite state machine bytes. MLCx:Machine Learning core source registers bytes

*debug

This command starts continuous data acquisition in debug mode. When sent to the board, it returns the output values measured by the device formatted in a readable text format.

*stop

This command interrupts any acquisition session that has been started with either the *start or *debug commands.

Zon and Zoff

These commands put the STM32F401VE microcontroller on the demonstration kit in 3-state (high impedance).

They allow the isolation of the sensor from the microprocessor and let the user interact with the sensor in a purely analog fashion.

When the kit is first turned on, the lines are in 3-state (high impedance) mode and you must send the * Zoff command to allow communication between the sensor and the microcontroller.

After this command has been executed, LED D2 (Red) is turned on. If the * Zoff command has not been launched, the firmware ignores any other command sent to sensor.

*dev

This command retrieves the name of the adapter connected to the demonstration kit; e.g., LIS3DH .

*ver

This command returns the version of the firmware loaded in the microprocessor; e.g., V1.5.2

*rAA

This command reads the contents of the accelerometer registers in the demonstration kit board. The hexadecimal value AA written in upper case represents the address of the register to be read.

Once the read command is issued, the board returns RAAhDDh , where AA is the address sent by the user and DD is the data present in the register.

For example, to read the register at address 0x20, the user issues the command *r20 , which would return a result like R20hC7h .

*rmAA1NN

This command allows the contents of multiple accelerometer registers in the demonstration kit board to be read in single data block. Once this command is issued, the board returns a set of NN values starting with

RMAA

1 hNNhDD

1 hDD

2 h… DD

NN h where AA register and so on for next registers.

1 is the starting address set by user and DD

1 is the data present in this

For example, *rm2006 reads six registers starting from 0x20, which would return a result like

RM20h06h27h00h00h00hA0h0Bh .

UM2116 - Rev 8 page 17/41

UM2116

Supported commands

4.2.8.2

4.2.9

4.2.10

4.2.10.1

4.2.10.2

4.2.11

4.2.12

4.2.12.1

*multi-rAA1AA2AA3...AAN

This command reads multiple accelerometer registers in the demonstration kit board in a single data block. Once this command is issued, the board returns set of N values starting RAA

1 h… AA

N hDDNh where AA

1 is the starting address set by user and DD

1 hDD is the data present in this register.

For example, *multi-r202425292B2D reads six register starting from 0x20, which would return a result like

MULTI-R20h27h24hA0h25h0Bh29hE0h2Bh3Fh2Dh90h .

*wAADD

This command writes the contents of the accelerometer registers in the demonstration kit board. The hexadecimal upper case values AA and DD represent the address of the register and the data to be written, respectively.

For example, *w20C7 writes 0xC7 to the register at address 0x20

*grAA

This command allows the contents of the gyroscope registers in the demonstration kit board to be read. The hexadecimal, upper case AA represents the address of the register to be read.

Once the read command is issued, the board returns GRAAhDDh , where AA is the address sent by the user and

DD is the data present in the register.

For example, *gr20 reads the register at address 0x20, which would return a result like GR20hC7h .

*grmAA1NN

This command allows the contents of multiple gyroscope registers in the demonstration kit board to be read in single data block. Once this command is issued, the board returns set of NN values starting with

GRMAA

1 hNNhDD

1 hDD register and so on.

2 h… DD

NN h where AA

1 is the starting address set by user and DD

1 is the data present in this

For example, *grm2006 reads six registers starting from 0x20, which would return a result like

GRM20h06h27h00h00h00hA0h0Bh .

*multi-grAA1AA2AA3...AAN

This command reads multiple gyroscope registers in the demonstration kit board in a single data block. Once this command is issued, the board returns set of N values starting with is the starting address set by user and DD

MULTI-GRAA

1 hDD

1 h… is the data present in this register and so on.

N hDDNh where AA

For example, *multi-gr202425292B2D reads six registers starting from 0x20, which would return a result like

MULTI-GR20h27h24hA0h25h0Bh29hE0h2Bh3Fh2Dh90h .

*gwAADD

This command writes the contents of the gyroscope registers in the demonstration kit board. The hexadecimal, upper case. AA and DD represent the address of the register and the data to be written, respectively.

For example, *gw20C7 writes 0xC7 to the register at address 0x20.

*mrAA

This command allows the contents of the magnetometer registers in the demonstration kit board to be read. The hexadecimal, upper case AA represents the address of the register to be read.

Once the read command is issued, the board returns MRAAhDDh , where AA is the address sent by the user and

DD is the data present in the register.

For example, *mr00 reads the register at address 0x00, which would return a result like MR00h10h .

*mrmAA1NN

This command readss the contents of multiple magnetometer registers in the demonstration kit board in a single data block. Once this command is issued, the board returns set of NN values starting with RMAA hDD

2 h…

NN h where AA

1 is the starting address set by user and DD

1 is the data present in this register.

hNNhDD

For example, *mrm2006 reads six register starting from 0x20, which would return a result like

MRM20h06h27h00h00h00hA0h0Bh .

UM2116 - Rev 8 page 18/41

UM2116

Supported commands

4.2.12.2

4.2.13

4.2.14

4.2.14.1

4.2.14.2

4.2.15

4.2.16

4.2.16.1

*multi-mrAA1AA2AA3...AAN

This command reads multiple magnetometer registers in the demonstration kit board in a single data block. Once this command is issued, the board returns set of N values starting with MULTI-MRAA

1 is the starting address set by user and DD

1 hDD

1 h… AA is the data present in this register, and so on.

N hDDNh , where

For example, *multi-mr202425292B2D reads six registers starting from 0x20, which would return a result like

MULTI-MR20h27h24hA0h25h0Bh29hE0h2Bh3Fh2Dh90h .

*mwAADD

This command writes the contents of the magnetometer registers in the demonstration kit board. Hexadecimal, upper case AA and DD represent the address of the register and the data to be written, respectively.

For example, *mw0120 writes 0x20 to the register at address 0x01.

*prAA

This command reads the contents of the pressure sensor registers in the demonstration kit board. The hexadecimal, upper case AA represents the address of the register to be read.

Once the read command is issued, the board returns PRAAhDDh , where AA is the address sent by the user and

DD is the data present in the register.

For example, *pr20 reads the register at address 0x20, which would return a value like PR20h10h .

*prmAA1NN

This command reads the contents of multiple pressure sensor registers in the demonstration kit in a single data block. Once this command is issued, the board returns set of NN values starting with PRMAA hDD

2 h…

NN h where AA

1 is the starting address set by user and DD

1 hNNhDD

1 is the data present in this register, and so on…

For example, *prm2006 reads six registers starting from 0x20, which would return a value like

PRM20h06h27h00h00h00hA0h0Bh .

*multi-prAA1AA2AA3...AAN

This command reads multiple pressure sensor registers in the demonstration kit board in a single data block.

Once this command is issued, the board returns set of N values starting with MULTI-PRAA where AA

1 is the starting address set by user and DD

1 hDD

1 h… AA is the data present in this register, and so on.

N hDDNh

For example, *multi-pr202425292B2D reads six registers starting from 0x20, which would return a result like

MULTI-PR20h27h24hA0h25h0Bh29hE0h2Bh3Fh2Dh90h .

*pwAADD

This command writes the contents of the pressure sensor registers in the demonstration kit board. The hexadecimal, upper case AA and DD represent the address of the register and the data to be written, respectively.

For example, *pw20C7 writes 0xC7 to the register at address 0x20.

*hrAA

This command reads the contents of the humidity sensor registers in the demonstration kit board. The hexadecimal, upper case AA represents the address of the register to be read.

Once the read command is issued, the board returns HRAAhDDh , where AA is the address sent by the user and

DD is the data present in the register.

For example, *hr20 reads the register at address 0x20, which would return a result like HR20h10h .

*hrmAA1NN

This command reads the contents of multiple humidity sensor registers in the demonstration kit board in a single data block. Once this command is issued, the board returns set of NN values starting with

HRMAA

1 hNNhDD

1 hDD register, and so on.

2 h… DD

NN h where AA

1 is the starting address set by user and DD

1 is the data present in this

For example, *hrm2006 reads six registers starting from 0x20, which would return a result like

HRM20h06h27h00h00h00hA0h0Bh .

UM2116 - Rev 8 page 19/41

UM2116

Supported commands

4.2.21

4.2.22

4.2.23

4.2.24

4.2.16.2

4.2.17

4.2.18

4.2.18.1

4.2.18.2

4.2.19

4.2.20

4.2.25

*multi-hrAA1AA2AA3...AAN

This command reads multiple humidity sensor registers in the demonstration kit board in a single data block.

Once this command is issued, the board returns set of N values starting with MULTI-HRAA where AA

1 is the starting address set by user and DD

1 hDD

1 h… AA is the data present in this register, and so on.

N hDDNh

For example, *multi-hr202425292B2D reads six registers starting from 0x20, which would return a result like

MULTI-HR20h27h24hA0h25h0Bh29hE0h2Bh3Fh2Dh90h .

*hwAADD

This command writes the contents of the humidity sensor registers in the demonstration kit board. The hexadecimal, upper case AA and DD represent the address of the register and the data to be written, respectively.

For example *hw20C7 writes 0xC7 to the register at address 0x20.

*trAA

This command reads the contents of the temperature sensor registers in the demonstration kit board. The hexadecimal, upper case AA represents the address of the register to be read. Once the read command is issued, the board returns TRAAhDDh , where AA is the address sent by the user and DD is the data present in the register.

For example, *tr20 reads the register at address 0x20, which would return a result like TR20h10h .

*trmAA1NN

This command reads the contents of multiple temperature sensor registers in the demonstration kit board in a single data block. Once this command is issued, the board returns set of NN values starting with

TRMAA

1 hNNhDD

1 hDD

2 h… DD

NN h where AA

is the starting address set by user and DD

is the data present in this register, and so on. For example, *trm2006 reads six registers starting from 0x20, which would return a result like TRM20h06h27h00h00h00hA0h0Bh .

*multi-trAA1AA2AA3...AAN

This command reads multiple temperature sensor registers in the demonstration kit board in a single data block.

Once this command is issued, the board returns set of where AA

is the starting address set by user and DD

N values starting with MULTI-TRAA

1 hDD

1 h… AANhDDNh

is the data present in this register, and so on. For example,

*multi-tr202425292B2D reads six registers starting from 0x20, which would return a result like MULTI-

TR20h27h24hA0h25h0Bh29hE0h2Bh3Fh2Dh90h .

*twAADD

This command writes the contents of the temperature sensor registers in the demonstration kit board. The hexadecimal, upper case AA and DD represent the address of the register and the data to be written, respectively.

For example *tw20C7 writes 0xC7 to the register at address 0x20.

*single

This command may be used to read just one set of data. It returns the read values of one data sample if the sensor is configured properly.

*sindebug

This command returns a single point data acquisition in readable text ASCII format.

*list

The command returns the list of MKI adapters supported by the firmware in ASCII format.

*listdev

This command returns the list of devices supported by the firmware in ASCII format.

*echoon

This command is used to activate the write command verbose mode so that the firmware automatically reads the contents of a register that has just been written to check if the write was successful.

For example, * echoon launched after *w2027 returns R2027 .

*echooff

This command stops the write command verbose mode.

UM2116 - Rev 8 page 20/41

UM2116

Supported commands

4.2.36

4.2.37

4.2.38

4.2.39

4.2.40

4.2.41

4.2.30

4.2.31

4.2.32

4.2.33

4.2.34

4.2.35

4.2.42

4.2.43

4.2.26

4.2.27

4.2.28

4.2.29

*fiforst

This command enables the accelerometer FIFO reset mode. For more details see application note AN3308 on www.st.com.

*fifomde

This command enables the accelerometer FIFO mode. For more details see application note AN3308 on www.st.com.

*fifostr

This command enables the accelerometer FIFO stream mode. For more details see application note AN3308 on www.st.com.

*fifostf

This command enables the accelerometer Stream-to-FIFO mode. For more details see application note AN3308 on www.st.com.

*fifobtf

This command enables the accelerometer Bypass-to-FIFO mode.

*fifobts

This command enables the accelerometer Bypass-to-Stream mode.

*fifodstr

This command enables the accelerometer Dynamic Stream mode.

*gfiforst

This command enables the gyroscope FIFO reset mode.

*gfifomde

This command enables the gyroscope FIFO mode.

*gfifostr

This command enables the gyroscope FIFO stream mode.

*gfifostf

This command enables the gyroscope Stream-to-FIFO mode.

*gfifobtf

This command enables the gyroscope Bypass-to-FIFO mode.

*gfifobts

This command enables the gyroscope Bypass-to-Stream mode.

*gfifodstr

This command enables the gyroscope Dynamic Stream mode.

*pfiforst

This command enables the pressure sensor FIFO reset mode.

*pfifomde

This command enables the pressure sensor FIFO mode.

*pfifostr

This command enables the pressure sensor FIFO stream mode.

*pfifostf

This command enables the pressure sensor Stream-to-FIFO mode.

UM2116 - Rev 8 page 21/41

UM2116

Supported commands

4.2.44

4.2.45

4.2.46

4.2.47

4.2.48

4.2.49

4.2.50

4.2.51

4.2.52

*pfifobtf

This command is used to enable the pressure sensor Bypass-to-FIFO mode.

*pfifobts

This command is used to enable the pressure sensor Bypass-to-Stream mode.

*pfifodstr

This command enables the pressure sensor Dynamic Stream mode.

setvddaX.Y and setvddioX.Y

These commands set the power supply VDD and VDDIO voltage values of device adapter.

For example, *setvdda3.6

sets 3.6V on VDDA. Note that both voltages VDD and VDDIO for modules are independent. If * setvdda and * setvddio have not been sent before the * power_on command, the setting is the default voltage defined in the device datasheet selected during the * setdb initialization. Please refer to device datasheet regarding specified VDD and VDDIO values and their relationship (i.e., which of these can be higher, etc.).

As the maximum voltages are defined also by the * setdb command, you cannot set values above these limits.

power_on and power_off

These commands are used to switch on and to switch off the VDD and VDDIO power supplies of the device adapter together. The proper power-on sequence of both voltages is handled internally by firmware.

*adc_single

This command is used to get a one-shot set of measured values of VDD and VDDIO voltages; IDD and IDDIO currents, etc.

*odr [p1]

•

This command is used to set ODR speed when data acquisition is driven by TIMER (analog sensors).

P1 ODR in mHz: 1 to 2000000

*get_i [p1] [p2] [p3] [p4]

•

This command is used to get average IDD and IDDIO during set/calculated time interval. Current ranges toggling and measurement method selection is done automatically as default setup.

P1 form of output data:

– F or f - floating-point (1 µA base)

– B or b - fixed-point (1 nA base)

– A or a - ASCII (readable text)

P2 status bits:

– S or s - Two bytes containing information (overflow, underflow, current range index) will be added at the end of the IDD, IDDIO data

P3 continuous (repetitive) measurement:

– C or c - firmware will send measured values periodically

P4 Long Time Enable:

– L or l firmware will wait for waveform edges or Drdy pulses until it appears or until another *get_i or

*adc_uni_stop command interrupts it

*get_v [p1]

•

This command is used to get average VDD and VDDIO VddIO (precise measurement with calibrations).

P1 form of output data:

– F or f - floating-point (1 V base)

– B or b - fixed-point (1 mV base)

– A or a - ASCII (readable text)

UM2116 - Rev 8 page 22/41

UM2116

Supported commands

4.2.53

4.2.54

4.2.55

4.2.56

ranges_auto and ranges_man

These commands are used to toggle between automatic and manual current ranges selection. The default command is *ranges_auto.

range_ma [p1] and range_mb [p1]

•

These commands are used to select current ranges manually.

*range_ ma … IDD, *range_ mb … IDDIO

P1 current range: 5, 10, 25, 50, 100, 200, 500, 1000, 2500, 5000, 10000, 20000, 50000, 100000

Full scale of the selected range = 300000 / P1 [µA]

*adc_run_time [p1]

•

This command is used to set the time interval during which ADC samples the measured current waveforms.

P1 time in milliseconds: 1 to 50000 (default is 500 ms)

*adc_uni_stop

This command is used to stop all measurements.

UM2116 - Rev 8 page 23/41

4.3

UM2116

Digital output accelerometers: supported commands

Table 5. Digital output accelerometers: supported commands list

Command Description

*list

*listdev

*echoon

*echooff

*fiforst

*fifomde

*fifostr

*fifostf

*fifobtf

*setdbXXXVY

*start

*debug

*stop

*Zon

*Zoff

*dev

*ver

*rAA

*rmAA

*multi-rAA

.. AA

*wAADD

*single

*sindebug

Selects firmware according to the adapter connected

Starts continuous data acquisition

Returns the output data in readable text format

Stops data acquisition

Forces High impedance state. Turns off VDD and

VDDIO power supply

Exits from High impedance state. Turns on VDD and

VDDIO power supply

Device name

Firmware version

Accelerometer register read

Multiple accelerometer registers read

Accelerometer register write

It gets a single point data acquisition

It gets a single point data acquisition in readable text format

Prints the list of MKIs supported

Prints the list of devices supported

Activates the write verbose mode

Deactivates the write verbose mode

Accelerometer “Reset mode” enable

Accelerometer “FIFO mode” enable

Accelerometer “FIFO stream” enable

Accelerometer “Stream-to-FIFO” enable

Accelerometer “Bypass-to-FIFO” enable

Accelerometer “Bypass-to-Stream” enable

Accelerometer “Dynamic Stream” enable

1. IR: interrupt bytes; FC: FIFO control register; FS: FIFO source register

2. Available only for devices with embedded FIFO

Returned value

(1)

(See

) e.g.: LIS3DH e.g.: V1.5.2

e.g.: RAAhDDh e.g.: RMAA

1 hNNhDD

1 h…DD

NN h e.g.:MULTI-RAA

1 hDD

1 h…AA

N hDDNh

(See

) e.g.: 087V1 089V1 092V1 105V1...

e.g.: LIS331DL LIS331DLH LIS331HH… e.g.: RAAhDDh st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n

UM2116 - Rev 8 page 24/41

4.4

UM2116

Digital output gyroscopes: supported commands

The table below lists the commands supported by the devices/demonstration boards including a digital output gyroscope.

Table 6. Digital output gyroscopes: supported commands list

Command Description

*setdbXXXVY

*start

*debug

*stop

*Zon

*Zoff

*dev

*ver

*grAA

*grmAA

*multi-grAA

.. AA

*gwAADD

*single

*sindebug

*list

*listdev

*echoon

*echooff

*gfiforst

*gfifostf

Selects FW according to the adapter connected

Starts continuous data acquisition

Returns the output data in readable text format

Stops data acquisition

Forces High impedance state. Turns off VDD and

VDDIO power supply

Exits from High impedance state. Turns on VDD and

VDDIO power supply.

Device name

Firmware version

Gyroscope register read

Multiple gyroscope registers read

Gyroscope register write

It gets a single point data acquisition

It gets a single point data acquisition in readable text format

Prints the list of MKIs supported

Prints the list of devices supported

Activates the write verbose mode

Deactivates the write verbose mode

Gyroscope “Reset mode” enable

Gyroscope “FIFO mode” enable

Gyroscope “FIFO stream” enable

Gyroscope “Stream to FIFO” enable

Gyroscope “Bypass to FIFO” enable

*gfifobts

*gfifodstr

Gyroscope “Bypass to stream” enable

Gyroscope “Dynamic stream” enable

Returned value

(1)

(See

) e.g.: L3GD20H e.g.: V1.5.2

e.g.: GRAAhDDh e.g.: GRMAA

1 hNNhDD

1 h…DD

NN h e.g.:MULTI-GRAA

1 hDD

1 h…AA

N hDDNh

(See

) e.g.: 087V1 089V1 092V1 105V1...

e.g.: LIS331DL LIS331DLH LIS331HH… e.g.: GRAAhDDh st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n st XH XL YH YL ZH ZL IR FC FS \r \n

1. IR: interrupt bytes; FC: FIFO control register; FS: FIFO source register

2. Available only for devices with embedded FIFO

UM2116 - Rev 8 page 25/41

4.5

UM2116

Digital output magnetometers: supported commands

Command

*setdbXXXVY

*start

Table 7. Digital output magnetometer: supported commands list

Description

Selects firmware according to the adapter connected

(See Table 4. Returned values for *start command

Starts continuous data acquisition

)

*debug

*stop

*Zon

*Zoff

*dev

*ver

*mrAA

*mrmAA

*multi-mrAA

...AA

*mwAADD

Returns the output data in readable text format

Stops data acquisition

Forces High impedance state. Turns off VDD and VDDIO power supply.

Exits from High impedance state. Turns on VDD and VDDIO power supply.

Device name

Firmware version

Magnetometer register read

Multiple magnetometer registers read

Magnetometer register write e.g.: LIS2MDL e.g.: V1.5.2

e.g.: MRAAhDDh e.g.: MRMAA

1 hNNhDD

1 h…DD

NN h e.g.:MULTI-MRAA

1 hDD

1 h…AA

N hDDNh

*single It gets a single point data acquisition

(See Table 4. Returned values for *start command

)

*sindebug

*list

It gets a single point data acquisition in readable text format

Prints the list of MKIs supported

*listdev Prints the list of devices supported e.g.: 087V1 089V1 092V1 105V1...

e.g.: LIS331DL LIS331DLH

LIS331HH… e.g.: MRAAhDDh *echoon

*echooff

Activates the write verbose mode

Deactivates the write verbose mode

1. IR: interrupt bytes; FC: FIFO control register; FS: FIFO source register

UM2116 - Rev 8 page 26/41

4.6

UM2116

Digital output pressure sensor: supported commands

Table 8. Digital output pressure sensor: supported commands list

Command Description Returned value

(1)

*setdbXXXVY

*start

*debug

*stop

*Zon

*Zoff

*dev

*ver

*prAA

*prmAA

*multi-prAA

.. AA

*pwAADD

*single

*sindebug

*list

*listdev

*echoon

*echooff

*pfiforst

*pfifostf

Selects firmware according to the adapter connected

Starts continuous data acquisition

Returns the output data in readable text format

Stops data acquisition

Forces High impedance state. Turns off VDD and

VDDIO power supply.

Exits from High impedance state. Turns on VDD and

VDDIO power supply

Device name

Firmware version

Pressure sensor register read

Multiple pressure sensor registers read

Pressure sensor register write

It gets a single point data acquisition

It gets a single point data acquisition in readable text format

Prints the list of MKIs supported

Prints the list of devices supported

Activates the write verbose mode

Deactivates the write verbose mode

Pressure sensor “Reset mode” enable

Pressure sensor “FIFO mode” enable

Pressure sensor “FIFO stream” enable

Pressure sensor “Stream to FIFO” enable

Pressure sensor “Bypass to FIFO” enable

*pfifobts

*pfifodstr

Pressure sensor “Bypass to stream” enable

Pressure sensor “Dynamic stream” enable

(See

) e.g.: LPS22HH e.g.: V1.5.2

e.g.: PRAAhDDh e.g.: PRMAA

1 hNNhDD

1 h…DD

NN h e.g.:MULTI-PRAA

1 hDD

1 h…AA

N hDDNh

(See