Editing STM32MP157F-DK2

[[Category:Hardware]]
The STM32MP157F-DK2 is a development board starring the STM32MP157F system on a chip and a ton of peripherals.

This board is a newer revision of the STM32MP157C-DK2 and as far as I can tell all STM32MP157C-DK2 hardware documentation applies to the STM32MP157F-DK2.

Almost all you need to know about this board and its chips is available without signing any kind of NDA or jumping through hoops. Very very convenient.

== Specifications ==
Core details:
*32-bit Dual Core Cortex-A7 800MHz main processor
*32-bit Cortex-M4 coprocessor
*512MiB DDR3 RAM
*5V 3A power supplied over Type-C
*ST-LINK/V2-1 debugging

* $109 USD from Mouser (as of 2022-01-29)
Storage:

* microSD card slot

Networking:

*Wi-Fi 802.11b/g/n
*Bluetooth Low Energy

*10/100/1000 Gigabit Ethernet
USB:
*4 USB 2.0 host type-A ports
*Dual-role USB 2.0 host or device type-C port
Video:
*4 inch 480x800 LCD touch screen
*HDMI
Audio:
*Stereo headset jack with microphone input
Other IO:
* Raspberry Pi 40-pin compatible header
* Arduino Uno V3 compatible headers (3.3v only)
*4 user LEDs
*2 user buttons

== Documentation ==
System on chip documentation:

* [https://www.st.com/en/microcontrollers-microprocessors/stm32mp157f.html STM32MP157F web page] is the first resource for documentation on the chip
* [https://www.st.com/resource/en/datasheet/stm32mp157f.pdf STM32MP157F datasheet] gives an exhaustive overview on the chip
* [https://www.st.com/resource/en/reference_manual/rm0436-stm32mp157-advanced-armbased-32bit-mpus-stmicroelectronics.pdf STM32MP157 reference manual] provides information for driver writing
* [https://wiki.st.com/stm32mpu/wiki/Main_Page stm32mpu wiki] has a large amount of documentation for all levels of development
Board documentation:

* [https://www.st.com/en/evaluation-tools/stm32mp157f-dk2.html STM32MP157F-DK2 web page] is again the first resource for board documentation
* [https://www.st.com/resource/en/data_brief/stm32mp157f-dk2.pdf STM32MP157 discovery kits data brief] is a good quick overview
* [https://www.st.com/resource/en/user_manual/um2637-discovery-kits-with-increasedfrequency-800-mhz-stm32mp157-mpus-stmicroelectronics.pdf STM32MP157 discovery kits user manual] has everything you need to know about the board
* [https://wiki.st.com/stm32mpu/wiki/Category:STM32MP15_Discovery_kits stm32mpu wiki Category:STM32MP15 Discovery kits] re-iterates some of user manual in wiki format
*[https://wiki.st.com/stm32mpu/wiki/Getting_started/STM32MP1_boards/STM32MP157x-DK2 stm32mpu wiki STM32MP157x-DK2 Getting started book] is a good guide for getting set up

Hardware files:

* [https://www.st.com/en/evaluation-tools/stm32mp157f-dk2.html#cad-resources STM32MP157F-DK2 CAD resources] has schematics and PCB files
LCD documentation:

* Screen is FRD397B2509 TFT LCD
* Driver is OTM8009A
* Touch controller is FT6236

Chip documentation:

* [https://www.st.com/resource/en/data_brief/stpmic1.pdf STPMIC1 data brief]
* [https://www.st.com/resource/en/datasheet/stpmic1.pdf STPMIC1 datasheet]
* [https://www.cirrus.com/products/cs42l51/ CS42L51 web page]
* [https://statics.cirrus.com/pubs/proDatasheet/CS42L51_F3.pdf CS42L51 datasheet]
* [https://datasheet.lcsc.com/szlcsc/1902141615_Lattice-SiI9024ACNU_C369574.pdf Sil9022 datasheet]
* [https://www.micron.com/products/dram/ddr3-sdram/part-catalog/mt41k256m16tw-107-it MT41K256M16 web page]
* [https://media-www.micron.com/-/media/client/global/documents/products/data-sheet/dram/ddr3/4gb_ddr3l.pdf MT41K256M16 datasheet]
* [https://www.realtek.com/en/products/communications-network-ics/item/rtl8211f-i-cg RTL8211F web page]
* [https://datasheet.lcsc.com/lcsc/1912111437_Realtek-Semicon-RTL8211F-CG_C187932.pdf RTL8211F datasheet] ("confidential")
* [https://www.murata.com/products/connectivitymodule/wi-fi-bluetooth/overview/lineup/type1dx LBEE5KL1DX web page]
* [https://www.murata.com/products/productdata/8813651165214/type1dx.pdf LBEE5KL1DX data sheet]
* [https://www.st.com/en/development-tools/st-link-v2.html ST-LINK/V2 web page]
* [https://www.st.com/resource/en/data_brief/st-link-slsh-v2.pdf ST-LINK/V2 data brief]
*[https://www.orientdisplay.com/pdf/OTM8009A.pdf OTM8009A datasheet] ("confidential")
*[https://focuslcds.com/content/FT6236.pdf FT6236 datasheet] ("confidential")

*

== Software ==
ST's provides [https://www.st.com/content/st_com/en/products/embedded-software/mcu-mpu-embedded-software/stm32-embedded-software/stm32cube-mcu-mpu-packages/stm32cubemp1.html STM32CubeMP1] as this board's support package. It contains:

* [https://github.com/STMicroelectronics/linux ST's Linux fork]
* [https://github.com/STMicroelectronics/u-boot ST's u-boot fork]
* [https://github.com/STMicroelectronics/arm-trusted-firmware ST's ARM Trusted Firmware fork]
* [https://github.com/STMicroelectronics/optee_os ST's OP-TEE fork]
* [https://github.com/STMicroelectronics/STM32CubeMP1 STM32CubeMP1]
Most of this is open source and the forks are being mainlined to the parent projects.

ST-Link can be used by the following software:

* GNU Screen or any terminal emulator for serial connections
* [https://openocd.org/ OpenOCD] for JTAG

* 

== Bugs ==
Bugs we've found when porting the board to Buildroot:

* You need to probe the snd_soc_cs42l51_i2c module manually to get audio running
*The Wi-Fi uses a Broadcom chipset which can be a little buggy sometimes

== Pinouts ==
See the [[STM32MP157F-DK2/40 pin pinout]] page for a textual description of the Pi header.