Description DK/BL STM32 MP15x devices

Identification

This description is valid for Demo-Kits and Boards.

Demo-Kit
A Demo-Kit is a collection of components for a quick start with the product. It often contains connectors, power plugs, housing and display based on a specific board and SoM.

Board
A board is a device without housing and peripherals. Different Demo-Kits may be based on the same board if the housing is different.

Hint

Demo-Kits (DK)

All Demo-Kits are based on specific boards. The following table shows the mapping between Demo-Kit and board.

Demo-Kit Demo-Kit number Board number Description
DK 5" STM32 MP157 512MB/512MB 50099044 rev01 40099 176 Demo-Kit with STM32MP157A 5" Display and capacitive Touch
DK STM32 MP157 512MB/512MB 50099045 rev01 40099 176 Demo-Kit with STM32MP157A, without Display

Boards (BL)

Board Board number SoM number Description
BL STM32 MP157 512MB/512MB 40099 176 40099 167 Board with STM32MP157A
BL STM32 MP153 512MB/512MB 40099 183 40099 180 Board with STM32MP151A
BL STM32 MP151 512MB/512MB 40099 182 40099 180 Board with STM32MP151A

The PCB number can be found on the PCB for identification. For all boards the PCB number is 1 950 1825.

Overview of board components and features

These boards consists of two main units. The SoM which is the more complex component including processor and DDR3-RAM. The second component is actually a baseboard including additional storage and containing all necessary connectors.

The compponents of the baseboard are:

  • SoM soldered on the baseboard
  • 4GB eMMC
  • Micro SD card slot
  • 2 x USB host
  • 1 x USB OTG
  • 1 x USB Ethernet (100 MBit/s)
  • 2 x Ethernet Connector (RJ45)
  • 1 x RS232
  • 1 x RS485
  • 1 x CAN
  • 2 x Debug LEDs
  • 2 x Digital IO
  • 2 x Analog IN
  • 1 x PWM beeper
  • 4 x Configuration switches
  • Display Interfaces: RGB or DSI with HDMI or LVDS converter

Display and Touch (only display variant)

  • 5 inch display with 800x480 resolution
  • capacitive multitouch

Software support

These devices are supported by the Kontron yocto BSP

Name Shortname Devicetree file CubeMX configuration housing Remark
DK/BL STM32 MP157 512MB/512MB t1000-k stm32mp-t1000-k.dts t1000-k.ioc without display
DK 5" STM32 MP157 512MB/512MB t1000-k-50 stm32mp-t1000-k-50.dts t1000-k.ioc -50
DK/BL STM32 MP153 512MB/512MB t1005-k stm32mp-t1005-k.dts (1) (2) without display
DK/BL STM32 MP153 512MB/512MB t1005-k-50 stm32mp-t1005-k.dts (1) -50
DK/BL STM32 MP151 512MB/512MB t1004-k stm32mp-t1004-k.dts (1) (2) without display
DK/BL STM32 MP151 512MB/512MB t1004-k-50 stm32mp-t1004-k.dts (1) -50
  • (1) A dedicated CubeMX configuration is not not available for these boards. These boards are based on t1000-k.ioc, the differences (GPU, CAN) are handled in SoM device tree files directly.
  • (2) With the yocto machine configuration stm32mp-t1000-k-multi a t1000-k bootloader is used. Therefore you have to unset the housing variable and select the appropriate machine in the extlinux menu.

Hint

It is possible to boot the t1000-k-50 configuration on all boards. This configuration is the superset for all boards and the default delivery configuration for all DKs. When booting this configuration on a board variant, some error messages will arise for the hardware components which aren't available (e.g. GPU or CAN).

Important

The housing variable in u-boot has to be set to select the correct kit configuration for the board. See u-boot bootloader for more info.

Notice

The build repository base URL is https://git.kontron-electronics.de/stm32mp. It is recommended to use the init-env script to checkout and populate all yocto layers and to setup the yocto environment for this device. See initializing the yocto build environment for more information

Yocto configurations

The dedicated software configurations for these Boards and Demo-Kits

build repository build-stm32mp
branches thud
machine stm32mp-t1000-multi
init-env command . init-env -t thud build-stm32mp
EULA accept variable ACCEPT_EULA_stm32mp-t1000-multi = "1"
distros dedicated for these kits ktn
images dedicated for these kits image-ktn, image-ktn-qt
available boot devices mmc0 (SD-card), mmc1 (eMMC), ubifs0 (QSPI NAND), pxe (Ethernet1)
latest prebuild binaries https://files.kontron-electronics.de/stm32mp

Licence information

This product contains software components which are licensed as free respectively open-source software under the GNU General Public License, versions 2 or 3, or the GNU Lesser General Public License, versions 2.1 or 3 or any other open-source licence. Everyone can get the source code of this software components from us by download or by storage medium within three years after the delivery of the product or as long as we offer spare parts or support for the product.

To get the source code on a data storage medium (CD-ROM, DVD, USB drive), please send a request to our customer support at the following address

Kontron Electronics GmbH
Kantstrasse 10
72663 Grossbettlingen
Deutschland

Web: www.kontron-electronics.de
E-Mail: support@kontron-electronics.de

Including the statement of the following product data:

  • Product name and product number
  • Date of delivery

We also require a fee of EUR 10,- for the costs of preparation of the medium and shipping to be transferred.

Preventive it should be mentioned here that using the right of installing own versions of the open-source software components, which is guaranteed in the licence contract, will expire all certifications and warranties of the product. The operation of the manipulated product will happen on one's own authority.

If you want to download the source code covered by open-source licenses for this product use these URLs:

Known issues and limitations

  • HDMI and LVDS is limited in functionality. See display interfaces for further information.

Description of board components

The following sections describe the hardware components and, if available, their interface to to linux os.

Power supply

The power supply is located on X101. The nominal supply voltage is 24V. The average current for the board with display is lower than 200mA.

Boot switches

The boot source can be selected by boot switches on the top side of the baseboard.

bootswitches

Some remarks to the boot modes:

  • As long as the STM32MP1 SOC has no USB connection in USB boot mode, LED1 blinks fast.
  • The boards are delivered with SD boot setting.

For Demo-Kits this boot configuration is written in OTP memory:

BOOT_CONFIG3 = 0x22000000

This means the boot priority are as follos:

Boot switch setting Boot source search sequence
USB boot USB OTG port waits for CubeProgrammer to send data
SD boot SD-card, NOR boot, USB boot
NOR boot SD-card, NOR boot, USB boot
Debug Wait for JTAG to load program to M4

So 'SD boot' setting and 'NOR boot' is equivalent and it is not possible to force the device to boot from NOR when a bootable SD card is in the SD card slot.

See ST Wiki for documentation of boot fuses settings.

Serial Interfaces

Also see Using the hardware.

STM32MP1 Used as Linux access Connector Usage
uart4 console /dev/ttySTM0 X202 (MiniUSB)
usart2 RS485 /dev/ttySTM1 X1201
usart3 RS232 /dev/ttySTM2 X1201

Info

You need an additional adapter to translate the 3.3V console UART signals (provided on the Mini-USB port) to USB.

Hint

A termination resistor for the RS485 interface can be found on switch S1201. It is called 'RS485 TERM' and is switch number 6.

CAN Interfaces

Also see Using the hardware.

STM32MP1 Used as Linux access Connector Usage
can1 CAN SocketCAN:can0 X1201

Hint

A termination resistor for the CAN bus interface can be found on switch S1201. It is called 'CAN TERM' and is switch number 5.

Ethernet

Also see Using the hardware.

Name Connector Linux device Remark
Ethernet 1 X1001 eth0 Native SOC interface
Ethernet 2 X1101 eth1 USB ethernet, not available in u-boot bootloader

Config Switches

The baseboard provides four configuration switches called 'CAN ADR 0-3` which are internally connected to the gpio bus expander of the SoM module.

The input signals can be accessed via standard GPIO sysfs interface /sys/class/gpio or by libgpiod (commands gpio*).

Name GPIO number
(sysfs)
Accessible via
(libgpiod)
Switch
CAN ADR0 504 gpiochip8 0 S1201 switch 1
CAN ADR1 505 gpiochip8 1 S1201 switch 2
CAN ADR2 506 gpiochip8 2 S1201 switch 3
CAN ADR3 507 gpiochip8 3 S1201 switch 4

Digital IOs

Also see Using the hardware.

Two digital inputs/outputs (either or) are available. If used as output the state can be read back from the associating input.

The table below shows number and function of available GPIOs. You can access them via the standard GPIO sysfs interface /sys/class/gpio or by libgpiod (commands gpio*).

Name direction GPIO number
(sysfs)
Accessible via
(libgpiod)
Connector
dout1 output 65 gpiochip4 1 X1301_DIO1
din1 input 35 gpiochip2 3 X1301_DIO1
dout2 output 34 gpiochip2 2 X1301_DIO2
din2 input 11 gpiochip0 11 X1301_DIO2

Analog inputs

There are two analog inputs available on the board, connected to the internal ADC

Name Accessible via Connector
AIN1 /sys/bus/iio/devices/iio\:device0/in_voltage5_raw X1301_AIN1
AIN2 /sys/bus/iio/devices/iio\:device0/in_voltage16_raw X1301_AIN2

For voltage calculation in mV from the raw value see STMicroelectronics Wiki The scaling formula for the board is:
Uconnector = Uadc * 11

For simplicity there is a adcread script to read adc values which observes all offsets, and scaling factors. To read out channel 5 on device adc 0 call:

> adcread 0 5
ADC0.5: 16 mV

LEDs

There are 2 debug LEDs available and can be controlled by linux user space or are used by M4 demo program

Name Interface Accessible via Used as
LED1 SOC PORTA 13 M4 demo M4 demo LED
LED2 SOC PORTA 14 /sys/class/leds/LED2 Linux heartbeat

Hint

LED1 (PORT A13) is also used to indicate USB boot mode. When STM32MP1 waits for USB connection, LED1 blinks fast.

I2C busses

On this board there are two i2c busses used:

Name Accessible via Used by
I2C2 i2c-1 GPIO SOM, DSI2HDMI, DSI2LVDS
I2C4 i2c-2 Touch

Important

i2c-1 interface is internally used for GPIO port expander TCA6408A on SoM at address 0x20

Devices on i2c-1

Address Location Komponente
0x20 SOM GPIO port expander TCA6408A
0x2c SOM SN65DSI84 DSI to LVDS converter
0x38 SOM ADV7535 DSI to HDMI converter
0x39 SOM ADV7535 DSI to HDMI converter
0x3c SOM ADV7535 DSI to HDMI converter
0x3f SOM ADV7535 DSI to HDMI converter

Devices on i2c-2

Address Location Komponente
0x14 Housing Goodix touch

USB host

Also see Using the hardware.

Two USB 2.0 host interfaces are available on connector X902.

USB OTG

Also see Using the hardware.

One USB OTG port is available on connector X901. This USB OTG port is required for USB boot mode.

Display Interfaces

Also see Using the hardware.

The display is connected via the 50 pin RGB interface (X509). The touch controller pins are included. With this interface customer specific displays can be connected via a convenient display adapter (bonded on the display).

The board is also equiped with an 40 pin LVDS interface (X801) and i2c bus for a touch controller. This LVDS signal is generated from the DSI output thru the SN65DSI84 DSI to LVDS converter.

There is also a HDMI output on X701. This signal is also generated from the DSI output of the STM32MP1 SOC by ADV7535 DSI to HDMI converter.

When the DSI based video signals on LVDS or HDMI shall be used, the DSI signals have to be routed to the appropriate converter. Use gpiochip3 13 for switching the signal to the appropriate converter. This has to be done in device tree on boot!

DSI converter select for gpiochip3 13:

DSI output select gpiochip3 13 signal
LVDS converter 0
HDMI converter 1

Important

Only one interface (RGB or DSI) can be active at the same time.

Warning

Due to some limitations of the STM32MP1 internal DPI to DSI bridge, it is not trivial to get your LVDS or HDMI configuration to work. Sometimes it's just not possible!

There are already BSP and device tree configurations which support the HDMI/LVDS interfaces in combination with the appropriate displays out of the box. These configurations are supported by the BSP:

HDMI

Set the housing variable in u-boot to an empty value and select stm32mp-t1000-k-nor-emmc or stm32mp-t1000-k-sdcard configuration in the following boot menu. This selects the stm32mp-t1000-k.dts device tree which activates the HDMI output.

A working configuration is this: 7 inch HDMI (see http://www.lcdwiki.com/7inch_HDMI_Display-C).

Unfortunately common HDMI display timings (standard- or established timings) are not working. The 'native' mode timings of the display has to fit! So many HDMI displays won't work!

LVDS

Either set the housing variable in u-boot to the appropriate value or set it to an empty value to get the boot menu.

There are two displays currently supported by the BSP:

Display housing Boot menu Device tree Resolution
Jenson 7 inch (BL-JT60050-01A) -70 stm32mp-t1000-k-70* stm32mp-t1000-k-70.dts 1024x600, goodix multitouch
Jenson 10 inch (BL-JT60180-01A) -101 stm32mp-t1000-k-101* stm32mp-t1000-k-101.dts 1280x800, USB multitouch

When you want to integrate your own LVDS display follow these recommendations to get a better chance to get your display working:

  • Do not set hsync-len < 3
  • Try to provide a hfront-porch as big as possible
  • A hfront-porch at of least 85 is required

Display backlight

Also see Using the hardware.

Display backlight is realized by Timer 4, channel 3. It is accessible thru linux /sys/class/backlight/backlight/brightness interface.

RTC

Also see Using the hardware.

On this board the internal RTC is used.

Appendix

Board Layout

Top view

Board top image

Connector Pinouts

Power (X101)

connector X101

RS485, CAN (X1201)

connector X1201

A termination for RS485 and CAN can be switched on with config switch.

  • Switch 6: RS485 termination
  • Switch 5: CAN termination

Termination is activated when switch is in position 'ON'

RS232 (X1202)

connector X1202

X1202 uses the DTE configuration (TD is output, RD is input)

Console (X202)

connector X202

GPIO (X1301)

connector X1301

JTAG (X201)

connectot X201

Display DPI / RGB family (X501)

connector X501

Display LVDS (X801)

connector X801

FAQ

My board doesn't boot any more

If your board doesn't boot any more check these things:

  • Check if 5V and 3.3V led are lighten green. If none lights up, check your power supply. If only one lights up, your board is damaged!
  • Check the boot switches. If LED1 flashes fast immediately after the power is switched on, it seems, that the device is in USB downloader mode. Either the boot switches are set to USB boot or the boot device doesn't contain a valid tf-a boot loader.
  • Check your serial connection (115200 baud, 8bits, no parity)
  • Try to boot from a fresh written SD card with bootable content