STMicroelectronics STEVAL-MKI109V2 User Manual
Реклама
Реклама
UM0979
User manual
STEVAL-MKI109V2: eMotion motherboard for MEMS adapter boards
Introduction
The STEVAL-MKI109V2 (eMotion) is a motherboard designed to provide the user with a complete ready-to-use platform for the demonstration of MEMS devices mounted on adapter boards.
The STEVAL-MKI109V2 uses an STM32F103RET6 microcontroller which functions as a bridge between the sensor on the adapter board and the PC on which it is possible to use the Unico graphical user interface (GUI) downloadable from the ST website or dedicated software routines for customized applications.
This user manual describes the hardware included with the demonstration kit and provides the information required to install the demonstration board and how to upgrade the firmware of the microcontroller.
For details regarding the features of each sensor, please refer to the datasheet available for each individual device.
UM0979 - Rev 6 - February 2018
For further information contact your local STMicroelectronics sales office.
www.st.com/
1
UM0979
Demonstration kit description
Demonstration kit description
The eMotion is a complete demonstration kit that allows demonstration of both digital and analog MEMS sensors.
Thanks to its DIL 24 connector, a wide range of MEMS adapter boards can be used.
The block diagram of the demonstration kit is shown in Figure 1. Demonstration board block diagram
.
Figure 1. Demonstration board block diagram
Control Switches
(reset, left, right)
Analog
Controls
(ST,PD,FS)
MEMS device
DIL 24
Connector
SPI/I C/
Analog
(ADC)
STM32F103RET6
µC
U.S.B.
USB
Connector
With DFU
Feature
Power On LED
Interrupt LEDs
General Purpose LEDs
As shown in the
Figure 1. Demonstration board block diagram , the eMotion demonstration kit is based on the
STM32F103RET6 microcontroller and can be connected to the PC through the USB bus. Data coming from the
MEMS sensor connected to the board can be read through the PC GUI provided with the kit.
The eMotion also implements the DFU (device firmware upgrade) feature, therefore, in the case of a new firmware release, it can be reprogrammed without the need to use a programmer. See www.st.com/mems for new firmware releases.
The eMotion also integrates three general-purpose LEDs, two LEDs connected directly to the interrupt pins of digital adapters and the power/USB LED. Moreover, the eMotion integrates three buttons: two are available to the user on a dedicated GPIO of the microcontroller, while the other is used as reset for the microcontroller.
All the MEMS adapter pins are available on two connectors placed on the board (
Figure 2. Top silkscreen of the eMotion kit
JP2 and JP3).
The top silkscreen view and image of the full board are shown in
Figure 2. Top silkscreen of the eMotion kit and
respectively.
UM0979 - Rev 6 page 2/39
Figure 2. Top silkscreen of the eMotion kit
UM0979
Demonstration kit description
UM0979 - Rev 6 page 3/39
Figure 3. Board top view
UM0979
Demonstration kit description
UM0979 - Rev 6
In order to use the eMotion demonstration kit, installation of a dedicated driver is required, which is included in the installation pack, together with a GUI interface which allows simple interaction with the sensor. The steps required for driver and software installation are described in the following sections.
In
some main components placed on the top layer of the eMotion kit are highlighted.
• Jumpers JP9 and JP10 (
When the eMotion is used together with MEMS adapters, JP9 and JP10 must be fitted (see STM32 datasheet for more information).
, ref 10, ref 11) are used to select the STM32 boot mode.
•
•
•
Jumper J2 (
, ref 7) can be used to directly supply the board (from 3.5 V to 6 V) instead of using the USB connector.
Jumper JP1 allows the user to measure the sensor current consumption by connecting a multimeter in
series with its terminals ( Figure 3. Board top view , ref 9).
Jumpers JP4, JP5, and JP6 (
Figure 3. Board top view , ref 8) are used to manually set some features which
(PD), self test (ST), and high-pass filter reset (HP)
for more details). JP4 is used to set the self-test feature,
JP5 to handle the power-down pin, and JP6 to reset the MEMS high-pass filter. When they are fitted on pins
2-3, these functions are handled by the firmware itself.
page 4/39
UM0979 - Rev 6
UM0979
Demonstration kit description
JP4
ST
JP5
PD
JP6
HP
Table 1. Jumper configuration for power-down (PD), self test (ST), and high-pass filter reset (HP)
Jumper on 1-2 position logic level 1: self-test ON logic level 1: power-down mode
Jumper on 2-3 position
Self-test is handled by the firmware
Power-down is handled by the firmware logic level 1: external high-pass filter reset High-pass filter reset is handled by the firmware
Jumper unfitted logic level 0: self-test OFF, default logic level 0: normal mode, default logic level 0: normal mode, default
•
•
•
code through the JTAG or SWD protocols.
Jumper JP7 (
, ref 4) is used to select either JTAG (JP7 unfitted) or SWD (JP7 fitted) mode.
eMotion also integrates six LEDs and three buttons:
–
LED D1 ( Figure 3. Board top view
, ref 6) is switched on when the board is power supplied.
–
LEDs D2 and D3 ( Figure 3. Board top view
, ref 13) are directly connected to the interrupt pins of the
MEMS digital adapters (if available on the sensor mounted on the adapter board).
– LEDs D4, D5, and D6 (
Figure 3. Board top view , ref 12) are general-purpose LEDs and are used to
indicate firmware states. For example, LED D6 is switched on when a specific firmware is selected from those available. LED D5 on indicates that the microcontroller is well configured for communication with the sensor. Finally the LED D4 blinks according to the sensor data rate selected.
– Button SW3 (
, ref 1) is used to reset the STM32.
–
Button SW1 and SW2 ( Figure 3. Board top view
, ref 2 and ref 5) are connected to STM32 GPIOs and are available to the user.
DIL24 adapter board on the STEVAL-MKI109V2 board.
page 5/39
UM0979
Demonstration kit description
Figure 4. How to connect the DIL24 adapter board to the STEVAL-MKI109V2
UM0979 - Rev 6 page 6/39
2
2.1
UM0979 eMotion board installation
eMotion board installation
The software package can be downloaded from the st.com website and includes the following directory structure:
• DRIVER: it contains the installation package for the USB drivers needed to connect the eMotion board to the
PC. No driver is needed on Linux and Mac OS platforms, so this directory is included in the Windows installation package only.
•
•
DFU: it contains the .dfu files and the installation package for the software needed to upgrade the firmware of the eMotion board.
FIRMWARE: it contains the source code of the firmware of the eMotion board together with the corresponding binary file that can be flashed to the board using the DFU software.
The section below describes the procedure to install the driver for the eMotion board (needed on Windows platforms only) and the DFU software.
Hardware installation (Windows platforms)
No driver installation is needed on Linux and Mac OS platforms.
To install the STM32 virtual COM port driver on Windows platforms, launch the “VCPDriver_V1.4.0_Setup.exe” included in the Windows installation package under the “DRIVER” folder and follow the instructions on the screen.
Once the driver is installed, insert the demonstration kit board into a free USB port. A notification message should appear, as in
Figure 5. Notification message
.
Figure 5. Notification message
Now the eMotion should be recognized by the PC as a virtual COM. In order to confirm which COM port has been assigned to the board, right click on “My Computer” and select “Manage”, select “Device Manager” and scroll
) the
COM11 has been assigned to the board.
UM0979 - Rev 6 page 7/39
Figure 6. Virtual COM port assignment
UM0979
DFU
2.2
2.2.1
DFU
The MEMS STEVAL-MKI109V2 demonstration board is capable of reprogramming an application through the
USB, in accordance with the DFU class specification defined by the USB Implementers Forum. This capability is useful because it allows reprogramming the microcontroller directly in the field and is particularly well-suited to
USB applications where the same USB connector can be used both for the standard operating mode and for the reprogramming process.
In order to configure the eMotion board in DFU mode button SW2 must be pressed before supplying the board and released when the LEDs D1, D4, D5, and D6 light up.
If the firmware version in use is lower than V3.0.0, it’s mandatory to patch the DFU feature using the
“DFU_Patcher_V1.0.2.dfu” file available under the “DFU” folder before proceeding with the upgrade of the firmware with a version equal to or higher than V3.0.0. The procedure to patch the DFU feature corresponds to the one used during a standard firmware upgrade with the DFU tool. At the end of this procedure, if the green
LED D4 is on, it indicates that the procedure is successfully completed; if the red LED D5 is on, the procedure failed and has to be repeated. Before proceeding with the new firmware upgrade the board must be reset using the SW3 button.
DFU on Windows
To install the DFU software, launch the “DfuSe_Demo_V3.0.5_Setup.exe” included in the software package under the “DFU” folder and follow the instructions on the screen. To launch the software, select “Start >
STMicroelectronics > DfuSe > DfuSe Demonstration”.
In the ‘Upgrade or Verify Action’ section of the Dfuse Demo tool click on the ‘Choose...’ button and select the target .dfu file; then click the ‘Upgrade’ button to start the firmware upgrade.
For more details regarding DFU and the microcontroller ST GUI, see the related user manual located under “Start
> STMicroelectronics > DfuSe > Docs > DfuSe Getting Started”.
UM0979 - Rev 6 page 8/39
UM0979
DFU
2.2.2
2.2.3
DFU on Linux
The DFU program used for Linux operating systems is ‘dfu-util’.
The procedure for Ubuntu Linux operating systems is described below.
To install this program, open a terminal and write the following command (with sudo to ensure having the correct permissions): sudo apt-get install dfu-util
Create a udev rules file: sudo gedit /etc/udev/49-emotion.rules
and fill it with the following content:
# 0483:5740 - STM32F4 in USB Serial Mode (CN5) ATTRS{idVendor}=="0483", ATTRS{idProduct}=="5740",
ENV{ID_MM_DEVICE_IGNORE}="1"
ATTRS{idVendor}=="0483", ATTRS{idProduct}=="5740", ENV{MTP_NO_PROBE}="1"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="5740", MODE:="0666"
KERNEL=="ttyACM*", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="5740", MODE:="0666"
# 0483:df11 - STM32F4 in DFU mode (CN5) SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483",
ATTRS{idProduct}=="df11", MODE:="0666"
Tell udev to reload its rules: sudo udevadm control --reload-rules
You should now be able to program the board. So, connect the eMotion board in DFU mode, and run the following command: sudo dfu-util -a 0 -D dfu_path/file.dfu -d 0483:df11 where dfu_path and file.dfu
are the path to the dfu file and the dfu file name respectively
(example: sudo dfu-util -a 0 -D Desktop/eMotionV2_REL_4_0.dfu -d 0483:df11).
To use the board with the upgraded firmware you need to disconnect and reconnect it, in order to exit DFU mode.
DFU on Mac OS
The DFU program used for Mac operating systems is ‘dfu-util’. Before installing it, you need to install Homebrew.
To do that, you need to open a terminal and run the following command: ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
Once Homebrew is installed on your Mac, you can install dfu-utils with the following command: brew install dfu-util
You should now be able to program the board. So, connect the eMotion board in DFU mode, and run the following command: dfu-util -a 0 -D dfu_path/file.dfu -d 0483:df11 where dfu_path and file.dfu
are the path to the dfu file and the dfu file name respectively
(example: dfu-util -a 0 -D Desktop/eMotionV2_REL_4_0.dfu -d 0483:df11).
To use the board with the upgraded firmware you need to disconnect and reconnect it, in order to exit DFU mode.
UM0979 - Rev 6 page 9/39
3
UM0979
Supported MEMS adapter boards
Supported MEMS adapter boards
Adapter board
STEVAL-MKI009V1
STEVAL-MKI013V1
STEVAL-MKI015V1
STEVAL-MKI075V1
STEVAL-MKI084V1
STEVAL-MKI087V1
STEVAL-MKI089V1
STEVAL-MKI092V1
STEVAL-MKI097V1
STEVAL-MKI098V1
STEVAL-MKI105V1
STEVAL-MKI106V1
STEVAL-MKI107V2
STEVAL-MKI108V2
STEVAL-MKI110V1
STEVAL-MKI113V1
STEVAL-MKI114V1
STEVAL-MKI120V1
STEVAL-MKI122V1
STEVAL-MKI123V1
STEVAL-MKI124V1
STEVAL-MKI125V1
STEVAL-MKI133V1
STEVAL-MKI134V1
STEVAL-MKI135V1
STEVAL-MKI136V1
STEVAL-MKI137V1
STEVAL-MKI141V2
STEVAL-MKI142V1
STEVAL-MKI151V1
STEVAL-MKI152V1
STEVAL-MKI153V1
STEVAL-MKI154V1
STEVAL-MKI158V1
STEVAL-MKI159V1
Table 2. List of supported MEMS adapter boards
below provides the complete list of supported adapter boards.
Table 2. List of supported MEMS adapter boards
Device
LIS3LV02DL
LIS302DL
LIS344ALH
LY3100ALH
LPY430AL
LIS331DL
LIS331DLH
LIS331HH
LPR430AL
LPR410AL
LIS3DH
LSM303DLHC
L3GD20
9AXISMODULE v2 [LSM303DLHC + L3GD20]
AIS328DQ
LSM303DLM
MAG PROBE (based on LSM303DLHC)
LPS331AP
LSM330DLC
LSM330D
10AXISMODULE [LSM303DLHC + L3GD20+ LPS331AP]
A3G4250D
LSM303D
LIS3DSH
LIS2DH
L3GD20H
LIS3MDL
HTS221
LPS25H
LIS2DH12
LIS2DM
H3LIS331DL
LSM9DS0
AIS3624DQ
LSM9DS1
UM0979 - Rev 6 page 10/39
UM0979 - Rev 6
Adapter board
STEVAL-MKI160V1
STEVAL-MKI161V1
STEVAL-MKI163V1
STEVAL-MKI164V1
STEVAL-MKI165V1
STEVAL-MKI166V1
STEVAL-MKI167V1
STEVAL-MKI168V1
STEVAL-MKI169V1
STEVAL-MKI170V1
STEVAL-MKI172V1
STEVAL-MKI175V1
STEVAL-MKI176V1
STEVAL-MKI177V1
STEVAL-MKI178V1
STEVAL-MKI179V1
STEVAL-MKI180V1
STEVAL-MKI181V1
STEVAL-MKI182V1
STEVAL-MKI183V1
STEVAL-MKI185V1
STEVAL-MKI186V1
STEVAL-MET001V1
Device
LSM6DS3
LSM6DS0
LSM303C
LIS2HH12
LPS25HB
H3LIS100DL
H3LIS200DL
IIS2DH
I3G4250D
IIS328DQ
LSM303AGR
LIS2DE12
LSM6DS3H
LPS35HW
LSM6DSL
LIS2DW12
LIS3DHH
LIS2MDL
ISM330DLC
LPS33HW
IIS2MDC
IIS3DHHC
LPS22HB
UM0979
Supported MEMS adapter boards page 11/39
4
4.1
UM0979
Supported commands
Supported commands
The microcontroller mounted on the eMotion board is equipped with dedicated firmware that supports a set of commands which allow to control either the digital or the analog output MEMS sensor and permits the acquisition of the measured data. The firmware also handles the communication between the board and the PC through the
USB bus. These features allow the user to easily write their own applications to exploit the capabilities of the sensor chosen.
This section describes the commands that are supported by the firmware for the microcontroller of the eMotion demonstration kit.
Getting started
Before using the commands supported by the firmware, the following procedure must be performed:
1.
Connect the eMotion to the USB port
2.
Launch an application which allows to send commands through the virtual serial port. The remainder of this document assumes the use of “Microsoft © HyperTerminal” program available with the Windows XP operating system
3.
Create a new connection, enter a name (e.g. “STEVAL-MKI109V2”), and click “OK”
4.
In the “Connect Using” field, select the virtual COM port to which the USB port has been mapped, and click
“OK”
5.
In port settings, set bits per second to 115200, data bits to 8, parity to none, stop bits to 1, and flow control to none. Click “OK”
6.
In the “HyperTerminal” application window choose “files” > “properties” > “settings”, then click on the “ASCII
Setup” button
7.
Select “Send line ends with line feeds” and “Echo typed characters locally”
8.
Click the “OK” button to close the “ASCII Setup” window
9.
Click the “OK” button to close the “Properties” window.
Once this procedure has been completed, the user can utilize the commands described in the following sections by typing them in the “HyperTerminal” window.
UM0979 - Rev 6 page 12/39
UM0979
Supported commands
4.2 Supported commands
The firmware supports a wide range of MEMS adapters; the next section provides the complete list of supported commands (see
Table 3. Supported commands list ) and their description.
Then, split into sections, the list of commands available for each sensor supported by the eMotion firmware is provided.
4.2.1
Command
*grAA
*gwAADD
*mrAA
*mwAADD
*prAA
*pwAADD
*hrAA
*hwAADD
*single
*list
*setdbXXXVY
*start
*debug
*stop
*Zon
*Zoff
*dev
*ver
*rAA
*wAADD
*listdev
*echoon
*echooff
*fiforst
*fifomde
*fifostr
*fifostf
*fifobtf
*fifobts
*fifodstr
*gfiforst
*gfifomde
Commands list and description
Table 3. Supported commands list
Description
Selects firmware according to the adapter connected
Starts continuous data acquisition
Returns the output data in readable text format
Stops data acquisition
Forces 3-state
Exits from 3-state
Device name
Firmware version
Accelerometer register read
Accelerometer register write
Gyroscope register read
Gyroscope register write
Magnetometer register read
Magnetometer register write
Pressure sensor register read
Pressure sensor register write
Humidity sensor register read
Humidity sensor register write
It gets a single X, Y, and Z data acquisition
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
Gyroscope “Reset mode” enable
Gyroscope “FIFO mode” enable
Returned value
(see Table 4. Returned values for *start command )
(see Table 5. Returned values for *debug command )
e.g.: LIS3DH e.g.: V1.0
e.g.: RAAhDDh e.g.: GRAAhDDh e.g.: MRAAhDDh e.g.: PRAAhDDh e.g.: HRAAhDDh
(see Table 5. Returned values for *debug command )
e.g.: MKI105V1 e.g.: LIS3DH e.g.: RAAhDDh st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS
UM0979 - Rev 6 page 13/39
UM0979
Supported commands
*pfiforst
*pfifomde
*pfifostr
*pfifostf
*pfifobtf
*pfifobts
*pfifodstr
*PDON
*PDOFF
*STON
*STOFF
*HPON
*HPOFF
*FSON
*FSOFF
Command
*gfifostr
*gfifostf
*gfifobtf
*gfifobts
*gfifodstr
*mfiforst
*mfifomde
*mfifostr
*mfifostf
*mfifobtf
*mfifobts
*mfifodstr
Description
Gyroscope “FIFO Stream” enable
Gyroscope “Stream-to-FIFO” enable
Gyroscope “Bypass-to-FIFO” enable
Gyroscope “Bypass-to-Stream” enable
Gyroscope “Dynamic Stream” enable
Magnetometer “Reset mode” enable
Magnetometer “FIFO mode” enable
Magnetometer “FIFO Stream” enable
Magnetometer “Stream-to-FIFO” enable
Magnetometer “Bypass-to-FIFO” enable
Magnetometer “Bypass-to-Stream” enable
Magnetometer “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
Sets power-down pin
Clears power-down pin
Sets self-test pin
Clears self-test pin
Sets high-pass filter pin
Clears high-pass filter pin
Sets full-scale pin
Clears full-scale pin
Returned value st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS
Note: IR: interrupt byte; FC: FIFO control register; FS: FIFO source register.
Set demonstration board
The command *setdbxxxvy selects the part of the firmware able to handle the adapter board sensor connected to the board. e.g., in order to select the firmware for the LIS3DH the command must be: *setdb105V1. The D6 LED
(green) is automatically switched on.
Start command
The *start command initiates the continuous data acquisition. When this command is sent to the device, it returns a string of bytes (plus carriage return and line feed) similar to “st OUT1 OUT2 OUT3 IR 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 are the bytes that contain the values measured at device outputs; if the output data is represented on more than 8 bits, OUT1, OUT2, and OUT3 are split into two bytes: high byte (e.g.: “XH”) and low byte (e.g.: “XL”).
IR contains the interrupt bytes and BT contains the bytes that describe the state of the buttons integrated on the board.
UM0979 - Rev 6 page 14/39
UM0979 - Rev 6
UM0979
Supported commands
Specifically, bit#0 of the “BT” 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.
Before sending the *start command, the device must be out from 3-state and some registers must be configured according to user needs, therefore, *start must be preceded by a *zoff and some “Register Write” commands.
command is sent.
STEVAL # (Device)
STEVAL-MKI009V1 (LIS3LV02DL)
STEVAL-MKI089V1 (LIS331DLH
STEVAL-MKI092V1 (LIS331HH)
STEVAL-MKI105V1 (LIS3DH)
STEVAL-MKI107V2 (L3GD20)
STEVAL-MKI110V1 (AIS328DQ)
STEVAL-MKI125V1 (A3G4250D)
STEVAL-MKI134V1 (LIS3DSH)
STEVAL-MKI135V1 (LIS2DH)
STEVAL-MKI136V1 (L3GD20H)
STEVAL-MKI151V1 (LIS2DH12)
STEVAL-MKI153V1 (H3LIS331DL)
STEVAL-MKI158V1 (AIS3624DQ)
STEVAL-MKI164V1 (LIS2HH12)
STEVAL-MKI166V1 (H3LIS100DL)
STEVAL-MKI167V1 (H3LIS200DL)
STEVAL-MKI168V1 (IIS2DH)
STEVAL-MKI169V1 (I3G4250D)
STEVAL-MKI170V1 (IIS328DQ)
STEVAL-MKI179V1 (LIS2DW12)
STEVAL-MKI180V1 (LIS3DHH)
STEVAL-MKI186V1 (IIS3DHHC)
STEVAL-MKI013V1 (LIS302DL)
STEVAL-MKI087V1 (LIS331DL)
STEVAL-MKI152V1 (LIS2DM)
STEVAL-MKI175V1 (LIS2DE12)
STEVAL-MKI176V1 (LSM6DS3H)
STEVAL-MKI178V1 (LSM6DSL)
STEVAL-MKI182V1 (ISM330DLC)
STEVAL-MKI015V1 (LIS344ALH)
STEVAL-MKI114V1 (MAG PROBE)
STEVAL-MKI137V1 (LIS3MDL)
STEVAL-MKI181V1 (LIS2MDL)
STEVAL-MKI185V1 (IIS2MDC)
Table 4. Returned values for *start command
Returned value 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 A_XH A_XL A_YH A_YL A_ZH A_ZL G_XH G_XL G_YH G_YL
G_ZH G_ZL STEP_L STEP_H int1_int2 sw1|sw2 \\r \\n s t XH XL YH YL ZH ZL sw1|sw2 \\r \\n s t XH XL YH YL ZH ZL int1 sw1|sw2 \\r \\n page 15/39
UM0979 - Rev 6
UM0979
Supported commands
STEVAL # (Device)
STEVAL-MKI075V1 (LY3100ALH)
STEVAL-MKI084V1 (LPY430AL)
STEVAL-MKI097V1 (LPR430AL)
STEVAL-MKI098V1 (LPR410AL)
STEVAL-MKI106V1 (LSM303DLHC)
STEVAL-MKI113V1 (LSM303DLM)
STEVAL-MKI133V1 (LMS303D)
STEVAL-MKI108V2 (9AXISMODULEv2)
STEVAL-MKI154V1 (LSM9DS0)
STEVAL-MKI159V1 (LSM9DS1)
STEVAL-MKI120V1 (LPS331AP)
STEVAL-MKI122V1 (LSM330DLC)
STEVAL-MKI123V1 (LSM330D)
STEVAL-MKI124V1 (10AXISMODULE)
STEVAL-MKI141V2 (HTS221)
STEVAL-MKI142V1 (LPS25H)
STEVAL-MKI165V1 (LPS25HB)
STEVAL-MKI177V1 (LPS35HW)
STEVAL-MKI183V1 (LPS33HW)
STEVAL-MET001V1 (LPS22HB)
STEVAL-MKI160V1 (LSM6DS3)
STEVAL-MKI161V1 (LSM6DS0)
STEVAL-MKI172V1 (LSM303AGR)
Returned value s t vrefH vrefL o1H o1L out1H out1L out4H out4L o2H o2L out2H out2L out5H out5L o3H o3L out3H out3L out6H out6L 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 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
M_int3 sw1|sw2 \\r \\n s t PXL PL PH TL TH REF_PXL REF_PL REF_PH REF_TL REF_TH int1 int 2 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 A_int1 A_int2 G_int1 G_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 PXL PL PH TL TH
REF_PXL REF_PL REF_PH REF_TL REF_TH A_int1 A_int2 sw1|sw2 \
\r \\n s t HL HH TL TH int1 sw1|sw2 \\r \\n s t PXL PL PH TL TH REF_PXL REF_PL REF_PH int1 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 STEP_L STEP_H TEMP_L TEMP_H int1_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 int1_int2_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_int3 sw1|sw2 \\r \\n
Note: XH: X-axis output high byte (same for Y-axis, Z-axis, P pressure, H humidity, and TEMP temperature)
XL: X-axis output low byte (same for Y-axis, Z-axis, P pressure, H humidity, and TEMP temperature)
Debug command
The *debug command starts the continuous data acquisition in debug mode. When this command is sent to the board, it returns the output values measured by the device formatted in a readable text format. The values shown on the screen correspond to the LSB data shown as a decimal number.
Table 5. Returned values for *debug command
shows the format of the string returned for each device when a
*debug command is sent.
page 16/39
UM0979 - Rev 6
UM0979
Supported commands
Table 5. Returned values for *debug command
STEVAL # (Device)
STEVAL-MKI009V1 (LIS3LV02DL)
STEVAL-MKI013V1 (LIS302DL)
STEVAL-MKI015V1 (LIS344ALH)
STEVAL-MKI087V1 (LIS331DL)
STEVAL-MKI089V1 (LIS331DLH)
STEVAL-MKI092V1 (LIS331HH)
STEVAL-MKI105V1 (LIS3DH)
STEVAL-MKI110V1 (AIS328DQ)
STEVAL-MKI134V1 (LIS3DSH)
STEVAL-MKI135V1 (LIS2DH)
STEVAL-MKI151V1 (LIS2DH12)
STEVAL-MKI152V1 (LIS2DM)
STEVAL-MKI153V1 (H3LIS331DL)
STEVAL-MKI158V1 (AIS3624DQ)
STEVAL-MKI164V1 (LIS2HH12)
STEVAL-MKI166V1 (H3LIS100DL)
STEVAL-MKI167V1 (H3LIS200DL)
STEVAL-MKI168V1 (IIS2DH)
STEVAL-MKI170V1 (IIS328DQ)
STEVAL-MKI175V1 (LIS2DE12)
STEVAL-MKI084V1 (LPY430AL)
STEVAL-MKI097V1 (LPR430AL)
STEVAL-MKI098V1 (LPR410AL)
STEVAL-MKI075V1 (LY3100ALH)
STEVAL-MKI106V1 (LSM303DLHC)
STEVAL-MKI113V1 (LSM303DLM)
STEVAL-MKI133V1 (LSM303D)
STEVAL-MKI163V1 (LSM303C)
STEVAL-MKI172V1 (LSM303AGR)
STEVAL-MKI114V1 (MAG PROBE)
STEVAL-MKI137V1 (LIS3MDL)
STEVAL-MKI107V2 (L3GD20)
STEVAL-MKI125V1 (A3G4250D)
STEVAL-MKI136V1 (L3GD20H)
STEVAL-MKI169V1 (I3G4250D)
STEVAL-MKI108V2 (9AXISMODULEV2)
STEVAL-MKI154V1 (LSM9DS0)
STEVAL-MKI159V1 (LSM9DS1)
Returned value
X=XXXXX Y=YYYYY Z=ZZZZZ
VREF=VVVVV OUT1=XXXXX 4OUT1=XXXXX OUT3=YYYYY
OUT6=YYYYY
VREF=VVVVV OUT1=XXXXX 4OUT1=XXXXX
AX=XXXXX AY=YYYYY AZ=ZZZZZ MX=XXXXX MY=YYYYY
MZ=ZZZZZ
MX=XXXXX MY=YYYYY MZ=ZZZZZ
P=PPPPP R=RRRRR Y=YYYYY
AX=XXXXX AY=YYYYY AZ=ZZZZZ MX=XXXXX MY=YYYYY
MZ=ZZZZZ GX=XXXXX GY=YYYYY GZ=ZZZZZ page 17/39
UM0979 - Rev 6
UM0979
Supported commands
STEVAL # (Device)
STEVAL-MKI120V1 (LPS331AP)
STEVAL-MKI142V1 (LPS25H)
STEVAL-MKI165V1 (LPS25HB)
STEVAL-MKI177V1 (LPS35HW)
STEVAL-MET001V1 (LPS22HB)
STEVAL-MKI122V1 (LSM330DLC)
STEVAL-MKI123V1 (LSM330D)
STEVAL-MKI160V1 (LSM6DS3)
STEVAL-MKI161V1 (LSM6DS0)
STEVAL-MKI176V1 (LSM6DS3H)
STEVAL-MKI178V1 (LSM6DSL)
STEVAL-MKI124V1 (10AXISMODULE)
STEVAL-MKI141V2 (HTS221)
Returned value
P=PPPPP T=TTTTT
AX=XXXXX AY=YYYYY AZ=ZZZZZ GX=XXXXX GY=YYYYY
GZ=ZZZZZ
AX=XXXXX AY=YYYYY AZ=ZZZZZ MX=XXXXX MY=YYYYY
MZ=ZZZZZ GX=XXXXX GY=YYYYY GZ=ZZZZZ P=PPPPP T=TTTTT
H=HHHHH T=TTTTT
Stop command
The *stop command interrupts any acquisition session that has been started with either the *start or *debug commands.
Zon and Zoff
The *Zon and *Zoff commands are employed, respectively, to put into 3-state the STM32F103RET6 microcontroller mounted on the demonstration kit. These commands allow the isolation of the sensor from the microprocessor and let the user interact with the sensor in a pure analog way.
By default, when the kit is first turned on, the lines are in 3-state mode and the user is required to send the *Zoff command to allow communication between the sensor and the microcontroller. If Zoff has not been launched, the firmware ignores any other command.
Device name
The *dev command retrieves the name of the adapter connected to the demonstration kit. The returned value is, for example, “LIS3DH”.
Firmware version
The *ver command queries the demonstration kit and returns the version of the firmware loaded in the microprocessor, for example, “V1.0”.
Accelerometer register read
The *rAA command allows the contents of the accelerometer registers in the demonstration kit board to be read.
AA, expressed as a hexadecimal value and 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 returns, e.g.,
R20hC7h.
Accelerometer register write
The *wAADD command allows writing to the contents of the accelerometer registers in the demonstration kit board. AA and DD, expressed as hexadecimal values and written in upper case, represent, respectively, the page 18/39
UM0979 - Rev 6
UM0979
Supported commands address of the register and the data to be written. For example, to write 0xC7 to the register at address 0x20, the user issues the command *w20C7.
Gyroscope register read
The *grAA command allows the contents of the gyroscope registers in the demonstration kit board to be read. AA, expressed as hexadecimal value and written in upper case, 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, to read the register at address 0x20, the user issues the command *gr20, which returns, e.g.,
GR20hC7h.
Gyroscope register write
The *gwAADD command allows writing to the contents of the gyroscope registers in the demonstration kit board.
AA and DD, expressed as hexadecimal values and written in upper case, represent, respectively, the address of the register and the data to be written. To write 0xC7 to the register at address 0x20, for example, the user issues the command *gw20C7.
Magnetometer register read
The *mrAA command allows the contents of the magnetometer registers in the demonstration kit board to be read. AA, expressed as a hexadecimal value and written in upper case, 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, to read the register at address 0x00, the user issues the command *mr00, which returns, e.g.,
MR00h10h.
Magnetometer register write
The *mwAADD command allows writing to the contents of the magnetometer registers in the demonstration kit board. AA and DD, expressed as hexadecimal values and written in upper case, represent, respectively, the address of the register and the data to be written. To write 0x20 to the register at address 0x01, for example, the user issues the command *mw0120.
Pressure sensor register read
The *prAA command allows the contents of the pressure sensor registers in the demonstration kit board to be read. AA, expressed as a hexadecimal value and written in upper case, 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, to read the register at address 0x20, the user issues the command *pr20, which returns, e.g.,
PR20h10h.
Pressure sensor register write
The *pwAADD command allows writing to the contents of the pressure sensor registers in the demonstration kit board. AA and DD, expressed as hexadecimal values and written in upper case, represent, respectively, the address of the register and the data to be written. To write 0xC7 to the register at address 0x20, for example, the user issues the command *pw20C7.
Humidity sensor register read
The *hrAA command allows the contents of the humidity sensor registers in the demonstration kit board to be read. AA, expressed as a hexadecimal value and written in upper case, 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.
page 19/39
UM0979 - Rev 6
UM0979
Supported commands
For example, to read the register at address 0x20, the user issues the command *hr20, which returns, e.g.,
HR20h10h.
Humidity sensor register write
The *hwAADD command allows writing to the contents of the humidity sensor registers in the demonstration kit board. AA and DD, expressed as hexadecimal values and written in upper case, represent, respectively, the address of the register and the data to be written. To write 0xC7 to the register at address 0x20, for example, the user issues the command *hw20C7.
Single acquisition
The *single command may be used to read just one set of data. It requires the sensor to be well configured and once invoked, returns the read values of one data sample.
The format of the returned value is exactly the same as the *debug command (
*single command returns just one set of data.
List
The *list command returns the list of MKI adapters supported by the firmware, printed in ASCII format.
Listdev
The *listdev command returns the list of devices supported by the firmware, printed in ASCII format.
Echo on
The *echoon command is used to activate the write command verbose mode. Once this command is launched, after every write command the firmware automatically performs also a read of the register just written. This function is useful to check if the write has succeeded. For instance, if the *echoon command is launched, after a
*w2027 it results R2027.
Echo off
The *echooff command stops the write command verbose mode.
Accelerometer FIFO reset enable
The *fiforst command enables the accelerometer FIFO reset mode. For more details see the AN3308 application note.
Accelerometer FIFO mode enable
The *fifomde command is used to enable the accelerometer FIFO mode. For more details see the AN3308 application note.
Accelerometer FIFO Stream mode enable
The *fifostr command is used to enable the accelerometer FIFO stream mode. For more details see the AN3308 application note.
Accelerometer Stream-to-FIFO mode enable
The *fifostf command enables the accelerometer Stream-to-FIFO mode. For more details see the AN3308 application note.
Accelerometer Bypass-to-FIFO mode enable
The *fifobtf command is used to enable the accelerometer Bypass-to-FIFO mode.
Accelerometer Bypass-to-Stream mode enable
The *fifobts command is used to enable the accelerometer Bypass-to-Stream mode.
page 20/39
UM0979 - Rev 6
Accelerometer Dynamic Stream mode enable
The *fifodstr command enables the accelerometer Dynamic Stream mode.
Gyroscope FIFO reset enable
The *gfiforst command enables the gyroscope FIFO reset mode.
Gyroscope FIFO mode enable
The *gfifomde command is used to enable the gyroscope FIFO mode.
Gyroscope FIFO Stream mode enable
The *gfifostr command is used to enable the gyroscope FIFO stream mode.
Gyroscope Stream-to-FIFO mode enable
The *gfifostf command enables the gyroscope Stream-to-FIFO mode.
Gyroscope Bypass-to-FIFO mode enable
The *gfifobtf command is used to enable the gyroscope Bypass-to-FIFO mode.
Gyroscope Bypass-to-Stream mode enable
The *gfifobts command is used to enable the gyroscope Bypass-to-Stream mode.
Gyroscope Dynamic Stream mode enable
The *gfifodstr command enables the gyroscope Dynamic Stream mode.
Magnetometer FIFO reset enable
The *mfiforst command enables the magnetometer FIFO reset mode.
Magnetometer FIFO mode enable
The *mfifomde command is used to enable the magnetometer FIFO mode.
Magnetometer FIFO Stream mode enable
The *mfifostr command is used to enable the magnetometer FIFO stream mode.
Magnetometer Stream-to-FIFO mode enable
The *mfifostf command enables the magnetometer Stream-to-FIFO mode.
Magnetometer Bypass-to-FIFO mode enable
The *mfifobtf command is used to enable the magnetometer Bypass-to-FIFO mode.
Magnetometer Bypass-to-Stream mode enable
The *mfifobts command is used to enable the magnetometer Bypass-to-Stream mode.
Magnetometer Dynamic Stream mode enable
The *mfifodstr command enables the magnetometer Dynamic Stream mode.
Pressure sensor FIFO reset enable
The *pfiforst command enables the pressure sensor FIFO reset mode.
UM0979
Supported commands page 21/39
UM0979 - Rev 6
UM0979
Supported commands
Pressure sensor FIFO mode enable
The *pfifomde command is used to enable the pressure sensor FIFO mode.
Pressure sensor FIFO Stream mode enable
The *pfifostr command is used to enable the pressure sensor FIFO stream mode.
Pressure sensor Stream-to-FIFO mode enable
The *pfifostf command enables the pressure sensor Stream-to-FIFO mode.
Pressure sensor Bypass-to-FIFO mode enable
The *pfifobtf command is used to enable the pressure sensor Bypass-to-FIFO mode.
Pressure sensor Bypass-to-Stream mode enable
The *pfifobts command is used to enable the pressure sensor Bypass-to-Stream mode.
Pressure sensor Dynamic Stream mode enable
The *pfifodstr command enables the pressure sensor Dynamic Stream mode.
PDON and PDOFF
The *PDON and *PDOFF commands are employed respectively to set to 1, and to clear to 0, the “power-down” pin in analog devices.
STON and STOFF
The *STON and *STOFF commands are employed respectively to set to 1, and to clear to 0, the “self test” pin in analog devices.
HPON and HPOFF
The *HPON and *HPOFF commands are employed respectively to set to 1, and to clear to 0, the “high-pass filter” pin in analog devices.
FSON and FSOFF
The *FSON and *FSOFF commands are employed respectively to set to 1 and to clear to 0 the “full scale” pin in analog devices.
page 22/39
UM0979
Supported commands
4.2.2
Digital output accelerometers: supported commands
Table 6. Digital output accelerometers: supported commands list
below lists the commands supported by the devices/demonstration boards including a digital output accelerometer.
Table 6. Digital output accelerometers: supported commands list
Returned value Command
*single
*list
*listdev
*echoon
*echooff
*fiforst
*fifomde (1)
*fifostr (1)
*fifostf (1)
*fifobtf (1)
*fifobts (1)
*fifodstr (1)
*setdbXXXVY
*start
*debug
*stop
*Zon
*Zoff
*dev
*ver
*rAA
*wAADD
Description
Selects firmware according to the adapter connected
Starts continuous data acquisition
Returns the output data in readable text format
Stops data acquisition
Forces 3-state
Exits from 3-state
Device name
Firmware version
Accelerometer register read
Accelerometer register write
It gets a single X, Y, and Z data acquisition
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. Available only for devices with embedded FIFO.
(see Table 4. Returned values for *start command )
(see Table 5. Returned values for *debug command )
e.g.: LIS3DH e.g.: V1.0
e.g.: RAAhDDh
(see Table 5. Returned values for *debug command )
e.g.: MKI105V1 e.g.: LIS3DH e.g.: RAAhDDh st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS
Note: IR: interrupt byte; FC: FIFO control register; FS: FIFO source register.
UM0979 - Rev 6 page 23/39
UM0979
Supported commands
4.2.3
Command
*listdev
*echoon
*echooff
*PDON
*PDOFF
*STON
*STOFF
*FSON
*FSOFF
*setdbXXXVY
*start
*debug
*stop
*Zon
*Zoff
*dev
*ver
*single
*list
Analog output accelerometers: supported commands
devices/demonstration boards including an analog output accelerometer.
Table 7. Analog output accelerometers: supported commands list
Returned value Description
Selects firmware according to the adapter connected
Starts continuous data acquisition
Returns the output data in readable text format
Stops data acquisition
Forces 3-state
Exits from 3-state
Device name
Firmware version
It gets a single X, Y, and Z data acquisition
Prints the list of MKIs supported
Prints the list of devices supported
Activates the write verbose mode
Deactivates the write verbose mode
Sets power-down pin
Clears power-down pin
Sets self-test pin
Clears self-test pin
Sets full-scale pin
Clears full-scale pin
(see Table 4. Returned values for *start command )
(see Table 5. Returned values for *debug command )
e.g.: LIS3DH e.g.: V1.0
(see Table 5. Returned values for *debug command )
e.g.: MKI105V1 e.g.: LIS3DH e.g.: RAAhDDh
UM0979 - Rev 6 page 24/39
UM0979
Supported commands
4.2.4
Digital output gyroscopes: supported commands
Table 8. Digital output gyroscopes: supported commands list
below lists the commands supported by the devices/ demonstration boards including a digital output gyroscope.
Table 8. Digital output gyroscopes: supported commands list
Returned value Command
*setdbXXXVY
*start
*debug
*stop
*Zon
*Zoff
*dev
*ver
*grAA
*gwAADD
*single
*list
*listdev
*echoon
*echooff
*gfiforst
*gfifomde (1)
*gfifostr (1)
*gfifostf (1)
*gfifobtf (1)
*gfifobts (1)
*gfifodstr (1)
Description
Selects firmware according to the adapter connected
Starts continuous data acquisition
Returns the output data in readable text format
Stops data acquisition
Forces 3-state
Exits from 3-state
Device name
Firmware version
Gyroscope register read
Gyroscope register write
It gets a single X, Y, and Z data acquisition
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
Gyroscope “Bypass-to-Stream” enable
Gyroscope “Dynamic Stream” enable
1. Available only for devices with embedded FIFO.
(see Table 4. Returned values for *start command )
(see Table 5. Returned values for *debug command )
e.g.: LIS3DH e.g.: V1.0
e.g.: GRAAhDDh
(see Table 5. Returned values for *debug command )
e.g.: MKI105V1 e.g.: LIS3DH e.g.: RAAhDDh st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS
Note: IR: interrupt byte; FC: FIFO control register; FS: FIFO source register.
UM0979 - Rev 6 page 25/39
UM0979
Supported commands
4.2.5
Command
*listdev
*echoon
*echooff
*PDON
*PDOFF
*STON
*STOFF
*HPON
*HPOFF
*setdbXXXVY
*start
*debug
*stop
*Zon
*Zoff
*dev
*ver
*single
*list
Analog output gyroscopes: supported commands
Table 9. Analog output gyroscopes: supported commands list below lists the commands supported by the
devices/demonstration boards including an analog output gyroscope.
Table 9. Analog output gyroscopes: supported commands list
Returned value Description
Selects firmware according to the adapter connected
Starts continuous data acquisition
Returns the output data in readable text format
Stops data acquisition
Forces 3-state
Exits from 3-state
Device name
Firmware version
It gets a single X, Y, and Z data acquisition
Prints the list of MKIs supported
Prints the list of devices supported
Activates the write verbose mode
Deactivates the write verbose mode
Sets power-down pin
Clears power-down pin
Sets self-test pin
Clears self-test pin
Sets high-pass filter pin
Clears high-pass filter pin
(see Table 4. Returned values for *start command )
(see Table 5. Returned values for *debug command )
e.g.: LIS3DH e.g.: V1.0
(see Table 5. Returned values for *debug command )
e.g.: MKI105V1 e.g.: LIS3DH e.g.: RAAhDDh
UM0979 - Rev 6 page 26/39
UM0979
Supported commands
4.2.6
Digital output magnetometers: supported commands
Table 10. Digital output magnetometers: supported commands list
below lists the commands supported by the devices/demonstration boards including a digital output magnetometer.
Table 10. Digital output magnetometers: supported commands list
Returned value Command
*setdbXXXVY
*start
*debug
*stop
*Zon
*Zoff
*dev
*ver
*mrAA
*mwAADD
*single
*list
*listdev
*echoon
*echooff
*mfiforst
*mfifomde (1)
*mfifostr (1)
*mfifostf (1)
*mfifobtf (1)
*mfifobts (1)
*mfifodstr (1)
Description
Selects firmware according to the adapter connected
Starts continuous data acquisition
Returns the output data in readable text format
Stops data acquisition
Forces 3-state
Exits from 3-state
Device name
Firmware version
Magnetometer register read
Magnetometer register write
It gets a single X, Y, and Z data acquisition
Prints the list of MKIs supported
Prints the list of devices supported
Activates the write verbose mode
Deactivates the write verbose mode
Magnetometer “Reset mode” enable
Magnetometer “FIFO mode” enable
Magnetometer “FIFO Stream” enable
Magnetometer “Stream-to-FIFO” enable
Magnetometer “Bypass-to-FIFO” enable
Magnetometer “Bypass-to-Stream” enable
Magnetometer “Dynamic Stream” enable
1. Available only for devices with embedded FIFO.
(see Table 4. Returned values for *start command )
(see Table 5. Returned values for *debug command )
e.g.: LIS3DH e.g.: V1.0
e.g.: MRAAhDDh
(see Table 5. Returned values for *debug command )
e.g.: MKI105V1 e.g.: LIS3DH e.g.: MRAAhDDh st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS
UM0979 - Rev 6 page 27/39
UM0979
Supported commands
4.2.7
Digital output pressure sensors: supported commands
Table 11. Digital output pressure sensors: supported commands list
below lists the commands supported by the devices/demonstration boards including a digital output pressure sensor.
Table 11. Digital output pressure sensors: supported commands list
Returned value Command
*setdbXXXVY
*start
*debug
*stop
*Zon
*Zoff
*dev
*ver
*prAA
*pwAADD
*single
*list
*listdev
*echoon
*echooff
*pfiforst
*pfifomde (1)
*pfifostr (1)
*pfifostf (1)
*pfifobtf (1)
*pfifobts (1)
*pfifodstr (1)
Description
Selects firmware according to the adapter connected
Starts continuous data acquisition
Returns the output data in readable text format
Stops data acquisition
Forces 3-state
Exits from 3-state
Device name
Firmware version
Pressure sensor register read
Pressure sensor register write
It gets a single X, Y, and Z data acquisition
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
Pressure sensor “Bypass-to -Stream” enable
Pressure sensor “Dynamic Stream” enable
1. Available only for devices with embedded FIFO.
(see Table 4. Returned values for *start command )
(see Table 5. Returned values for *debug command )
e.g.: LIS3DH e.g.: V1.0
e.g.: PRAAhDDh
(see Table 5. Returned values for *debug command )
e.g.: MKI105V1 e.g.: LIS3DH e.g.: PRAAhDDh st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS st 0 0 0 0 0 0 IR FC FS
UM0979 - Rev 6 page 28/39
UM0979
Quick start
4.2.8
Command
*setdbXXXVY
*start
*debug
*stop
*Zon
*Zoff
*dev
*ver
*hrAA
*hwAADD
*single
*list
*listdev
*echoon
*echooff
Digital output humidity sensors: supported commands
Table 11. Digital output pressure sensors: supported commands list
below lists the commands supported by the devices/demonstration boards including a digital output humidity sensor.
Table 12. Digital output humidity sensors: supported commands list
Description
Selects firmware according to the adapter connected
Starts continuous data acquisition
Returns the output data in readable text format
Stops data acquisition
Forces 3-state
Exits from 3-state
Device name
Firmware version
Humidity sensor register read
Humidity sensor register write
It gets a single X, Y, and Z data acquisition
Prints the list of MKIs supported
Prints the list of devices supported
Activates the write verbose mode
Deactivates the write verbose mode
Returned value
(see Table 4. Returned values for *start command )
(see Table 5. Returned values for *debug command )
e.g.: LIS3DH e.g.: V1.0
e.g.: HRAAhDDh
(see Table 5. Returned values for *debug command )
e.g.: MKI105V1 e.g.: LIS3DH e.g.: PRAAhDDh
4.3 Quick start
This section shows the basic sequence of commands, based on the LIS3DH accelerometer, to start a data communication session and to retrieve the X, Y, and Z acceleration data from the demonstration kit:
1.
Connect the eMotion to the USB port
2.
Start “Microsoft ©
HyperTerminal” and configure it as described in Section 4.1 Getting started
3.
Inside the “HyperTerminal” window, enter the command *setdb105v1 (supposing the LIS3DH adapter board is used, for other adapters see the relevant datasheets to check the register configuration), enter the command *Zoff to enable the control of the device by the STM32F103RET6 microcontroller, and *w2047 to switch on the LIS3DH and to set the data rate to 50 Hz
4.
Send the *debug command to get the X, Y, and Z data measured by the sensor
5.
Send *stop to end the continuous acquisition and visualization.
UM0979 - Rev 6 page 29/39
5
UM0979
Schematic diagrams
Schematic diagrams
The schematic diagrams of the eMotion demonstration kit are shown in
Figure 7. eMotion board (power supply and USB)
and Figure 8. STEVAL-MKI109V2 eMotion board (STM32F103RET6 and connectors)
.
Figure 7. eMotion board (power supply and USB)
2
1
1 2
UM0979 - Rev 6 page 30/39
UM0979 - Rev 6
UM0979
Schematic diagrams
Figure 8. STEVAL-MKI109V2 eMotion board (STM32F103RET6 and connectors)
1 2 3 4 5 6 7 8 9 10 11 12
1 2 3 4 5 6 7 8
24 2 22 21 20 19 18 17 16 1
5 14 13
1 2 3 4 5 6 7 8 9 1
0 11 12
1 2 3 4 5 6 7 8 9 10 11 12
+ + -
3
2
1
2 3
JTCK_SWCLK
JTDI
Gled
Rled
ST_u
PD_u
JTDO
JNTRST
GP_led
BOOT0
SW1
SW2
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
PA14/JTCK/SWCLK
PA15/JTDI
PC10
PC11
PC12
PD2
PB3/JTDO
PB4/JNTRST
PB5
PB6/I2C_SCL
PB7/I2C_SDA
BOOT0
PB8
PB9
Vss3
Vdd3
Vdd1
Vss1
PB11
PB10
PB2/BOOT1
PB1/ADC9
PB0/ADC8
PC5/ADC15
PC4/ADC14
PA7/MOSI/ADC7
PA6/MISO/ADC6
PA5/SCK/ADC5
PA4/NSS/ADC4
Vdd4
Vss4
PA3/ADC3
32
31
30
29
28
27
26
25
24
23
22
21
20
19
18
17
CS_RF
IRQ_RF
BOOT1
OUT2_u
OUT1_u
OUT6_u
O2_u
MOSI_RF
MISO_RF
SCK_RF
O1_u
OUT4_u
+
+ + + + -
1 2
+ + + + -
1 3 5 7 9 page 31/39
UM0979
Bill of materials
6 Bill of materials
C13
C14
C17
C26
Cosc1
Cosc2
D1
D2
D3
D4
Designator
C1
C2
C3
C4
C5
C6
C7
C8
C9
C10
C11
C12
J2
J3
J4
J5
JP1
JP2
D5
D6
J1
JP3
JP4
JP5
JP6
Table 13. Bill of materials for STEVAL-MKI109V2
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
SMD LED
SMD LED
SMD LED
SMD LED
Description
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
Capacitor
SMD LED
SMD LED
Header_HE10_5X2
CON2
USB_mini_B
Header 12
Header 12
CON2
Header 12
Header 12
Header 3
Header 3
Header 3
10 µF
33 nF
10 nF
100 nF
18 pF
18 pF
Blue LED
Green LED
Orange LED
Green LED
Comment
10 µF
100 nF
100 nF
100 nF
100 nF
100 nF
100 nF
100 nF
100 nF
4.7 µF
1 µF
1 µF
Red LED
Orange LED
JTAG/SWD connector
Power supply
Mini-USB B
Header 12
Header 12
Current_Measure
Header 12X2
Header 12X2
STMicroelectronics
PD
HP
C0805_POL
0805
0805
0805
0805
0805
0805
0805
0805
0805
Footprint
C1206_POL
0805
0805
0805
0805
0805
0805
0805
0805
C0805_POL
0805
C0805_POL
0805
0805
HDR5X2 1.27 mm
Header 1x2 2 mm
USB_mini_B
HDR1X12
JP 1X12
Header 1x2 2 mm
HDR1X12
HDR1X12
Header 1x3 2 mm
Header 1x3 2 mm
Header 1x3 2 mm
UM0979 - Rev 6 page 32/39
R24
R25
R26
R27
R28
R17
R18
R19
R20
R21
R22
R23
R29
R30
R31
R32
R33
R34
R35
Q2
R2
R3
R4
R5
R6
R7
Designator
JP7
JP9
JP10
Osc1
Q1
R8
R9
R10
R11
R12
R13
R14
R15
R16
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Description
CON2
CON2
CON2
Ceramic SMD crystal 3.2X2.5 mm
BC817-25
BC817-25
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
Resistor
UM0979 - Rev 6
Comment
10 kΩ
10 kΩ
10 kΩ
0 Ω
0 Ω
100 Ω
100 Ω
100 Ω
100 Ω
4.7 kΩ
4.7 kΩ
0 Ω
0 Ω
100 Ω
1 kΩ
0 Ω
0 Ω
36 kΩ
180 Ω
16 MHz
BC817
BC817
10 kΩ
10 kΩ
10 kΩ
10 kΩ
10 kΩ
1 MΩ
10 kΩ
0 Ω
0 Ω
10 kΩ
10 kΩ
10 kΩ
10 kΩ
0 Ω
0 Ω
UM0979
Bill of materials
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
Footprint
Header 1x2 2 mm
Header 1x2 2 mm
Header 1x2 2 mm
Ceramic SMD Crystal 3.2x2.5 mm
SOT-23
SOT-23
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805
0805 page 33/39
Designator
R36
R37
R38
R39
SW1
SW2
SW3
U1
U2
U3
U4
U5
U6
Description
Resistor
Resistor
Resistor
Resistor
SMT SWITCH
SMT SWITCH
SMT SWITCH
TS924
Component_1
TS924
TS922
USBLC6-2P6
STM32F103RET6
Comment
1.5 kΩ
22 Ω
22 Ω
47 kΩ
TS924 lds3985xx30
TS924
TS922
USBLC6-2P6
Footprint
0805
0805
0805
0805
UM0979
Bill of materials
TS924
SOT23-5
TS924
SO8_2
SOT-666
LQF64
UM0979 - Rev 6 page 34/39
UM0979
Revision history
Date
02-Mar-2011
18-Apr-2012
09-Sep-2013
03-Nov-2014
20-Oct-2016
05-Feb-2018
Table 14. Document revision history
Revision Changes
1 Initial release
2
3
•
•
•
• Added: STEVAL-MKI109V2
Modified: Bill of materials for STEVAL-MKI109V2
Added new supported demo kits.
Updated Table 2: List of supported MEMS adapter boards, Table 4: Returned values for *start command and Table 5: Returned values for *debug command.
Updated: Section 2.2: DFU, Table 2: List of supported MEMS adapter boards, Table 4:
Returned values for *start command and Table 5: Returned values for *debug command.
4
5
6
Updated: Section 2.1: Hardware installation (Windows platforms), Table 2: List of supported MEMS adapter boards, Table 4: Returned values for *start command, and
Table 5: Returned values for *debug command
Added: Section 2.2.2: DFU on Linux, Section 2.2.3: DFU on Mac OS, and Section 4.2.8:
Digital output humidity sensor: supported commands
Removed: STEVAL-MKI109V1
Added Figure 4: How to connect the DIL24 adapter board to the STEVAL-MKI109V2
Updated version of VCP Driver to V.1.4.0 in Section 2.1: Hardware installation
(Windows platforms)
Updated reference to version of firmware in use to lower than V3.0.0 in Section 2.2:
DFU
Updated version of DFU software to V3.0.5 in Section 2.2.1: DFU on Windows
Updated Table 2: List of supported MEMS adapter boards
Updated Table 4: Returned values for *start command
Updated Table 5: Returned values for *debug command
Updated Table 2. List of supported MEMS adapter boards
Updated Table 4. Returned values for *start command
UM0979 - Rev 6 page 35/39
UM0979
Contents
Contents
UM0979 - Rev 6 page 36/39
UM0979
List of tables
List of tables
UM0979 - Rev 6 page 37/39
UM0979
List of figures
List of figures
UM0979 - Rev 6 page 38/39
UM0979
IMPORTANT NOTICE – PLEASE READ CAREFULLY
STMicroelectronics NV and its subsidiaries (“ST”) reserve the right to make changes, corrections, enhancements, modifications, and improvements to ST products and/or to this document at any time without notice. Purchasers should obtain the latest relevant information on ST products before placing orders. ST products are sold pursuant to ST’s terms and conditions of sale in place at the time of order acknowledgement.
Purchasers are solely responsible for the choice, selection, and use of ST products and ST assumes no liability for application assistance or the design of
Purchasers’ products.
No license, express or implied, to any intellectual property right is granted by ST herein.
Resale of ST products with provisions different from the information set forth herein shall void any warranty granted by ST for such product.
ST and the ST logo are trademarks of ST. All other product or service names are the property of their respective owners.
Information in this document supersedes and replaces information previously supplied in any prior versions of this document.
© 2018 STMicroelectronics – All rights reserved
UM0979 - Rev 6 page 39/39
Завантажити
Реклама