boards/st/sensortile_box/doc/index.rst
.. zephyr:board:: sensortile_box
Overview
The STEVAL-MKSBOX1V1 (SensorTile.box) is a ready-to-use box kit for wireless IoT and wearable sensor platforms to help you use and develop apps based on remote motion and environmental sensor data. The SensorTile.box board fits into a small plastic box with a long-life rechargeable battery, and communicates with a standard smartphone through its Bluetooth® interface, providing data coming from the sensors.
More information about the board can be found at the SensorTile.box website_.
Hardware
SensorTile.box provides the following hardware components:
Ultra low-power STM32L4R9ZI System on Chip
LQFP144 package
Core: ARM® 32-bit Cortex®-M4 CPU with FPU, adaptive real-time accelerator (ART Accelerator) allowing 0-wait-state execution from Flash memory, frequency up to 120 MHz, MPU, 150 DMIPS/1.25 DMIPS/MHz (Dhrystone 2.1), and DSP instructions
Clock Sources:
Communication
Internal Buses
micro-SD connector
On board sensors:
HCP602535ZC LI-ion rechargeable battery (3.7V 500mAh)
FTSH107 connector for SWD debugging and UART Tx/Rx
The SensorTile.box provides motion, environmental, and audio sensor data through either the BLE or USB protocols to a host application running on a smartphone/PC to implement applications such as:
.. zephyr:board-supported-hw::
Programming and Debugging_
section)SensorTile.box System Clock could be driven by internal or external oscillator, as well as main PLL clock. By default, the System clock is driven by the PLL clock at 80MHz, driven by the 16MHz external oscillator. The system clock can be boosted to 120MHz. The internal AHB/APB1/APB2 AMBA buses are all clocked at 80MHz.
There are two possible options for Zephyr console output:
Console default settings are 115200 8N1.
SensorTile.box can be connected as a USB device to a PC host through its micro-B connector. The final application may use it to declare SensorTile.box device as belonging to a certain standard or vendor class, e.g. a CDC, a mass storage or a composite device with both functions.
Programming and Debugging
.. zephyr:board-supported-runners::
There are 2 main entry points for flashing STM32FL4Rx SoCs, one using the ROM
bootloader, and another by using the SWD debug port (which requires additional
hardware) on FTSH107 connector.
Flash using the ROM bootloader by powering on the board
while keeping the BOOT0 button pressed.
The ROM bootloader supports flashing via USB (DFU), UART, I2C and SPI.
You can read more about how to enable and use the ROM bootloader by checking
the application note AN2606_ (STM32L4Rx section).
It is recommended to use at least v0.8 of dfu-util. The package available in
Debian and Ubuntu can be quite old, so you might have to build dfu-util from source.
Information about how to get the source code and how to build it can be found
at the DFU-UTIL website_
While pressing the BOOT0 button, connect the micro-USB cable to the USB OTG SensorTile.box port and to your computer. The board should be forced to enter DFU mode.
Confirm that the board is in DFU mode:
.. code-block:: console
$ sudo dfu-util -l dfu-util 0.9
Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc. Copyright 2010-2019 Tormod Volden and Stefan Schmidt This program is Free Software and has ABSOLUTELY NO WARRANTY Please report bugs to http://sourceforge.net/p/dfu-util/tickets/
Found DFU: [0483:df11] ver=2200, devnum=74, cfg=1, intf=0, path="2-2", alt=2, name="@OTP Memory /0x1FFF7000/010001Ke", serial="204A325D574D" Found DFU: [0483:df11] ver=2200, devnum=74, cfg=1, intf=0, path="2-2", alt=1, name="@Option Bytes /0x1FF00000/01040 e/0x1FF01000/01040 e", serial="204A325D574D" Found DFU: [0483:df11] ver=2200, devnum=74, cfg=1, intf=0, path="2-2", alt=0, name="@Internal Flash /0x08000000/5120004Kg", serial="204A325D574D"
You should see following confirmation on your Linux host:
.. code-block:: console
$ dmesg usb 2-2: new full-speed USB device number 74 using xhci_hcd usb 2-2: New USB device found, idVendor=0483, idProduct=df11 usb 2-2: New USB device strings: Mfr=1, Product=2, SerialNumber=3 usb 2-2: Product: STM32 BOOTLOADER usb 2-2: Manufacturer: STMicroelectronics usb 2-2: SerialNumber: 204A325D574D
You can build and flash the provided sample application
(:zephyr:code-sample:sensortile_box_sensors) that reads sensors data and outputs
values on the console.
References
.. target-notes::
.. _SensorTile.box website: https://www.st.com/en/evaluation-tools/steval-mksbox1v1.html
.. _DFU-UTIL website: http://dfu-util.sourceforge.net/