Avenger96: Difference between revisions

From Wiki-DB
Jump to navigationJump to search
Ageisreiter (talk | contribs)
Ageisreiter (talk | contribs)
 
(178 intermediate revisions by 5 users not shown)
Line 1: Line 1:
'''The Avenger96 board is the official DHCOR STM32MP1 reference design!'''
{|
{|
|
|
Line 10: Line 12:
The AVENGER Board is a 96Boards compliant consumer edition board based on the STM32MP15 series of SoCs. The STM32MP15 series  
The AVENGER Board is a 96Boards compliant consumer edition board based on the STM32MP15 series of SoCs. The STM32MP15 series  
is a highly integrated multi-market applications processor designed to enable secure and portable applications within the Internet of Things.  
is a highly integrated multi-market applications processor designed to enable secure and portable applications within the Internet of Things.  
AVENGER board features Dual-core Arm® Cortex®-A7 processors operating at up to 650 Hz, Single core Arm® Cortex® M4 operating up to  
AVENGER board features Dual-core Arm® Cortex®-A7 processors operating at up to 650 MHz, Single core Arm® Cortex® M4 operating up to  
209 MHz. In addition, an extensive set of interfaces and connectivity peripherals are included to interface to cameras, touch-screen displays,  
209 MHz. In addition, an extensive set of interfaces and connectivity peripherals are included to interface to cameras, touch-screen displays,  
MMC/SD cards and media processor engine. It also fully supports wireless communication, including WLAN and BLE.
MMC/SD cards and media processor engine. It also fully supports wireless communication, including WLAN and BLE.
Line 53: Line 55:
*'''Temperature Range''' 0 - 40 °C
*'''Temperature Range''' 0 - 40 °C
*'''Dimensions ''' 100 x 85 mm
*'''Dimensions ''' 100 x 85 mm
*'''Serial Peripherals'''   
*'''Expansion Connectors'''   
**2 x UART
**2 x UART
**2 x I2C
**2 x I2C
**1 x I2S
**1 x I2S
**1 x SPI
**1 x SPI
**1 x GPIOs
**12 x GPIOs (also useable as 2x CAN, 2x ADC)
**1 x MIPI-CSI2
**1 x MIPI-DSI
|}
|}
== Product Change Notifications (PCN) ==
==== DHCOR STM32MP15====
* [[media:PCN_DHCOR-STM32MP1-001_R01_2022-10-07.pdf|PCN_DHCOR-STM32MP1-001_R01_2022-10-07.pdf (New default bootloader, based on testbench configuration)]]
* [[media:PCN_DHCOR-STM32MP15-002_R01_2024-05-15.pdf|PCN_DHCOR-STM32MP15-002_R01_2024-05-15.pdf (SPI flash write-protect information)]]


== Downloads ==
== Downloads ==
==== Documents ====
* [https://github.com/dh-electronics/kas-dhsom/releases/tag/2023-08-28 DH Mainline based starter image 2023-09-20 (based on 6.1.54 Linux Kernel)]
* [https://www.dropbox.com/s/nl15j510syvtxc7/DOC_Getting-Started-588-100_R06_2019-04-12.pdf?dl=0 Getting-Started]
 
== Documentation ==
* [[media:DOC_Getting-Started-588-200_R05_2024-07-17.pdf|Getting-Started with Avenger96 (R05)]]
* [[media:USM_DHCOR-STM32MP1_R05_2019-12-12.pdf|DHCOR STM32MP1 User Manual R05 <span style="color:#FF0000">'''IMPORTANT: Please have a look at NEW chapter 24. Hardware design checklist'''</span>]]
* More about the STM32 MPU is on the [[Avenger96#Links | Links section]]
 
== Design Files ==
* [https://www.dropbox.com/s/u8nihe1xd6ysk3v/SCH_588-200-HS00008-public_R07_2019-08-01.pdf?dl=0 Avenger96 Schematic]
* [https://www.dropbox.com/s/1gyb53slm50uu80/BOM_588-200-HS00008-public_R07_2019-08-01.xlsx?dl=0 Avenger96 Bill of Material]
* [https://www.dropbox.com/s/78otmzqqbw0fkio/588-200_TOP_ASSEMBLY__R04_2019-04-12.pdf?dl=0 Avenger96 Assembly Top]
* [https://www.dropbox.com/s/su226xkonru494t/588-200_BOTTOM_ASSEMBLY__R04_2019-04-12.pdf?dl=0 Avenger96 Assembly Bottom]
* [https://www.dropbox.com/s/orku1po5d7gywwd/BRD_588-200-with-DHCOR_2020-06-22.STEP?dl=1 Avenger96 3D STEP file]
* [https://www.dropbox.com/s/yjx9l0qj9ja0de8/DHCOR-STM32MP1-Design-Symbols_2019-10-16.zip?dl=0 DHCOR STM32MP1 Allegro/Orcad schematic and layout symbols (release date: 16.10.2019) '''Now with Allegro *.brd file and 3D information''']
* [https://www.dropbox.com/s/s4n5j9wzhhrv6so/DHCOR_STM32MP1_3D_STEP_586-100_R02.zip?dl=0 DHCOR STM32MP1 3D STEP file]
* [[media:Stm32mp15xx-dhcor-avenger96_2023-04-18.zip | Avenger96 CubeMX configuration (release date: 18.04.2023)]]
 
== Software ==
=== DH Mainline based Linux ===
* [https://github.com/dh-electronics/kas-dhsom Build your own Yocto Scarthgap LTS via kas (GitHub)]
* [https://github.com/dh-electronics/meta-dhsom-stm32-bsp Yocto BSP meta layer (Github)]
* [[Default Bootloader "stm32mp15xx-dhcor-testbench" | Default Bootloader "stm32mp15xx-dhcor-testbench" programmed with delivered DHCOR module]]
* [[DHCOR_STM32MP1_Linux| Linux and bootloader documentation]]
:<span style="color:#008000">'''NEW How to start with custom DHCOR design?'''</span>
:The patch below is an example patch which applies on top of u-boot v2021.01 and implements a custom board derived from 3V3 option of DHCOR STM32MP1 SoM. That's pretty much all you have to change to implement the board. But, please tweak the DTs esp. where there are the FIXME comments.
:[https://www.dropbox.com/s/zg6f9h1vms6lxdg/0001-ARM-dts-stm32-Add-DHCOR-based-FOO-board-u-boot-v2021.01.patch?dl=0 '''NEW''' 0001-ARM-dts-stm32-Add-DHCOR-based-FOO-board-u-boot-v2021.01.patch]
* [[Add Yocto SDK with QT5 to QT Creator | Start with Qt]]
* [[Debugging_M4_on_STM32MP15xxxx|STM32MP1: Debugging M4]]
* [https://wiki.dh-electronics.com/index.php/STM32MP1_Browser_Performance STM32MP1 Browser Performance]
* [[DHSOM device tree structure | DHSOM device tree structure]]
 
=== OpenSTLinux ===
: <span style="color:#FF0000"> '''This project is NOT maintained from DH electronics!!! Please use the "DH Mainline based Linux" version for your project. The OpenSTLinux should only be used for testing!!!'''</span>
* '''Info:'''
:- Based on OpenSTLinux v3.0
:- GPU support based on original vivante GPU driver.
:- Based on kernel 5.10.x and Yocto version dunfell
* [https://github.com/dh-electronics/manifest-av96 Yocto meta layer (Github)]
:DH electronics Github contains the meta-av96 layer for ST SDK. Please see readme.txt which describes the build process.
 
* [https://www.dropbox.com/s/5c8s7sxtienyfip/Avenger96_v7.0_2021-10-29.img.zip?dl=0 OpenSTLinux-3.0 based on Yocto Dunfell LTS and Linux 5.10.10 - v7.0 Starter Image] (Supported by Arrow Electronics)
:[[Starter Image Changelog]]
: This Image includes four different bootmodes to support some additional mezzanine boars. [https://wiki.dh-electronics.com/index.php/Starter_Image_Bootmode Click here to learn, how to change them.]
 
:'''X-LINUX-AI OpenSTLinux Expansion Package:''' Description: Expansion Package that targets artificial intelligence for STM32MP1 Series devices.
* [https://wiki.st.com/stm32mpu/wiki/X-LINUX-AI_OpenSTLinux_Expansion_Package '''NEW''' X-LINUX-AI OpenSTLinux Expansion Package]
* [https://wiki.st.com/stm32mpu/wiki/How_to_install_X-LINUX-AI_v2.0.0_on_Avenger96_board '''NEW''' How to install X-LINUX-AI v2.0.0 on Avenger96 board]
 
== Useful instructions ==
==== How to test OV5640 camera ====
To use the D3 mezzanine board with AV96 and the OV5640 camera, one has to apply the correct DTO first:
STM32MP> setenv loaddtos '#conf-stm32mp157a-avenger96.dtb#conf-stm32mp15xx-avenger96-overlay-ov5640-x7.dtbo'; boot


==== DHCOR STM32MP1 schematic and layout symbols ====
Afterward it is possible to stream frames from the camera:
* [https://www.dropbox.com/s/h6r2y61kphw334r/DHCOR-STM32MP1-Design-Symbols_2019-05-02.zip?dl=0 STM32MP1 Allegro/Orcad symbols (release date: 02.05.2019)]
$ XDG_RUNTIME_DIR=/var/run/user/$(id -u weston)/ gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw,width=1280,height=720 ! queue ! waylandsink


==== DHCOR STM32MP1 STM CubeMX configuration ====
==== How to load U-Boot with dfu-util ====  
* [https://www.dropbox.com/s/4i0la7q1wkv4anh/DHCOR-PinMux-TFBGA361-Avenger96-HW200_2019-05-03.zip?dl=0 Avegner96 CubeMX configuration (release date: 03.05.2019)]
*[[U-Boot recovery for STM32MP1 DHSOM via DFU |U-Boot recovery for STM32MP1 DHSOM via DFU]]


==== Binary package ====
==== SPI Flash and eMMC Image Programming via UMS (universal mass storage) ====
* [https://www.dropbox.com/s/6w7iqqos5zpveap/Avenger96_v1.2_binary_deploy.zip?dl=0 Avenger96 v1.2 binary package for eMMC programming]
*[[Avenger96 UMS Image Programming | Avenger96 UMS Image Programming]]


==== Yocto meta layer ====
==== SPI Flash and eMMC Image Programming via Cube Programmer (OLD) ====
* [https://github.com/dh-electronics/meta-av96 Yocto meta layer]
*[[Avenger96 Image Programming | Avenger96 Image Programming]]
DH electronics Github contains the meta-av96 layer for ST v1.0.0 SDK. Please see readme.txt which describes the build process.


==== Images====
==== How to calibrate resistive touchscreens ====
* [https://www.dropbox.com/s/wm1faek37u8c9v9/Avenger96_v2.0.2_2019-04-25.zip?dl=0 Avenger96 v2.0.2 Starter Image]
*[[Calibration of resistive touchscreens]]


'''Changelog v2.0.1 to v2.0.2:'''
== Mezzanine Boards by DH electronics ==
* Supported features in U-Boot: UART, DDR3, QSPI, uSD, eMMC, ethernet
* PRODUCT_BELOW_2V5 fix in U-Boot
* Supported features in Linux: UART, uSD, eMMC, USB host, USB OTG, HDMI, GPU, WiFi, Bluetooth, Gbit ethernet
* STM32CubeProgrammer can initialize NOR, eMMC, uSD
* Avenger96 can boot from uSD or NOR+eMMC
* BSP contains a single meta-av96 layer and a readme.txt
* BSP builds the whole uSD or NOR+eMMC image in a single step, no extra file operations are needed
* Standard STM32MP157C-DK2 demo runs on Avenger96: WiFi hotspot, video playback with sound, 3D demo
Improvements compared to av96 v2.0.1:
* SDMMC1,2,3 order fixed, build process simplified
* WiFi fixed
* Sound over HDMI, GPU support (there was no GPU in v2.0.1 because of EULA issues during build)
* Bluetooth support, dummy soundcard added for BT (not tested yet)
* QSPI, eMMC in U-Boot, PRODUCT_BELOW_2V5 programming added -> Gbit ethernet
* STM32CubeProgrammer can initialize NOR, eMMC, uSD (a single manual modification of flashlayout files is still needed for NOR+eMMC boot -> needs to be documented yet)


'''Changelog v1.2 to v2.0.1:'''
==== DSI Display Adaptor Board ====
* Switch to ST v1.0.0 SDK with 4.19 kernel
You can easily add an DSI display to your Avenger96 with the help of the DSI Display Adaptor Board.  
* Till now, not all features of v1.2 (based on beta1 release of ST with 4.14 kernel support) are supported with v2.0.1 release
The display can be activated easily on our Mainline Image with a device tree overlay as described [[DHCOR_STM32MP1_Linux| here]].  
* NOT working: QSPI in U-Boot and Linux, eMMC in U-Boot, WiFi, …
To get one of the boards, simply reach out to us and we'll prepare one for you.
* Working interfaces: HDMI, Ethernet, USB, uSD card and Gigabit ethernet (on board with programmed PRODUCT_BELOW_2V5 fuse)
'''Changelog v1.1 to v1.2:'''
* /home/root folder contains simple OpenAMP demo
* HSLVEN_QSPI fix (from ST) was added to make QSPI boot work again with PRODUCT_BELOW_2V5 programmed
'''Changelog v1.0 to v1.1:'''
* Updated U-Boot which programs the PRODUCT_BELOW_2V5 fuse if necessary and reboots the board
* BUCK3 voltage changed to 2.5V which enables Gbit ethernet support
* Icon added in Weston for starting glmark2-es2-wayland
* /etc/issue contains version info
* Reduced display resolution of HDMI


'''Old Images and Yocto releases:'''
[[File:DSI Display Adaptor Board.jpg|400px|DSI Display Adaptor Board]]
* [https://www.dropbox.com/s/bevx8wv1fpf2ir8/Avenger96_v2.0.1_2019-04-12.zip?dl=0 Avenger96 v2.0.1 Starter Image]
* [https://www.dropbox.com/s/6x484idku2youbw/meta-av96.thud.e11d35a1_2019-04-12.zip?dl=0 Avenger96 Yocto meta layer (based on v2.0.1 image from 2019-04-12)]
* [https://www.dropbox.com/s/6oe6r1w3ig1vhep/Avenger96_v1.2_2019-03-29.zip?dl=0 Avenger96 v1.2 Starter Image]
* [https://www.dropbox.com/s/c30rbj1z4wijpx4/Avenger96_v1.1_2019-03-15.zip?dl=0 Avenger96 v1.1 Starter Image]
* [https://www.dropbox.com/s/cu3ivdukcp1x40g/Avenger96_EW_v1.0_2019-02-15.zip?dl=0 Avenger96 Embedded World v1.0 Starter Image]


== Links ==
== Links ==
* [https://www.96boards.org/ 96Boards]
* [https://wiki.st.com/stm32mpu/wiki/Main_Page STM32 MPU wiki]
* [https://wiki.st.com/stm32mpu/wiki/Category:Device_tree_configuration STM32 MPU wiki - Device tree configuration]
* [https://wiki.st.com/stm32mpu/index.php/STM32MP15_resources STM32MP15 resources]
* [https://www.96boards.org 96Boards]

Latest revision as of 06:44, 17 July 2024

The Avenger96 board is the official DHCOR STM32MP1 reference design!

COM Avenger96Board

Introduction

The AVENGER Board is a 96Boards compliant consumer edition board based on the STM32MP15 series of SoCs. The STM32MP15 series is a highly integrated multi-market applications processor designed to enable secure and portable applications within the Internet of Things. AVENGER board features Dual-core Arm® Cortex®-A7 processors operating at up to 650 MHz, Single core Arm® Cortex® M4 operating up to 209 MHz. In addition, an extensive set of interfaces and connectivity peripherals are included to interface to cameras, touch-screen displays, MMC/SD cards and media processor engine. It also fully supports wireless communication, including WLAN and BLE.

Technical Details

  • STM32MP157AAC
    • 2x ARM® Cortex-A7 up to 650 MHz
    • 1x ARM® Cortex-M4 up to 209 MHz

  • GPU 1x 3D GPU Vivante® @ 533 MHz - OpenGL® ES 2.0
  • PMIC STPMIC1A
  • DDR3 DRAM 1024 Mbyte @ 533 MHz
  • eMMC Flash 8 Gbyte, v4.51 interface
  • NOR Flash 2 Mbyte, Quad SPI interface
  • EEPROM 128 byte
  • microSD Socket UHS-I speed grade, v3.01
  • USB Host 2x type A, 2.0 high-speed
  • USB OTG 1x type micro-AB, 2.0 high-speed
  • HDMI WXGA (1366x768) @ 60 fps, HDMI 1.4
  • WiFi / Bluetooth
    • WiFi 5 GHz & 2.4GHz IEEE 802.11a / b / g / n / ac
    • Bluetooth® v4.2 (BR/EDR/BLE)
    • PCB antenna
  • Ethernet 10 / 100 / 1000 Mbit/s, IEEE 802.3-compliant
  • Push-Buttons Power and reset
  • Battery Socket CR1216, CR1220 and CR1225
  • LEDs
    • 4x green user controlled LEDs
    • 1x blue Bluetooth enabled
    • 1x yellow WiFi enabled
    • 1x red power supply okay
  • Boot Mode 3 bit boot mode switch
  • Debug Interface JTAG interface via tag-connect
  • Supply (SYS_DCIN) 8 - 18 VDC
  • Temperature Range 0 - 40 °C
  • Dimensions 100 x 85 mm
  • Expansion Connectors
    • 2 x UART
    • 2 x I2C
    • 1 x I2S
    • 1 x SPI
    • 12 x GPIOs (also useable as 2x CAN, 2x ADC)
    • 1 x MIPI-CSI2
    • 1 x MIPI-DSI

Product Change Notifications (PCN)

DHCOR STM32MP15

Downloads

Documentation

Design Files

Software

DH Mainline based Linux

NEW How to start with custom DHCOR design?
The patch below is an example patch which applies on top of u-boot v2021.01 and implements a custom board derived from 3V3 option of DHCOR STM32MP1 SoM. That's pretty much all you have to change to implement the board. But, please tweak the DTs esp. where there are the FIXME comments.
NEW 0001-ARM-dts-stm32-Add-DHCOR-based-FOO-board-u-boot-v2021.01.patch

OpenSTLinux

This project is NOT maintained from DH electronics!!! Please use the "DH Mainline based Linux" version for your project. The OpenSTLinux should only be used for testing!!!
  • Info:
- Based on OpenSTLinux v3.0
- GPU support based on original vivante GPU driver.
- Based on kernel 5.10.x and Yocto version dunfell
DH electronics Github contains the meta-av96 layer for ST SDK. Please see readme.txt which describes the build process.
Starter Image Changelog
This Image includes four different bootmodes to support some additional mezzanine boars. Click here to learn, how to change them.
X-LINUX-AI OpenSTLinux Expansion Package: Description: Expansion Package that targets artificial intelligence for STM32MP1 Series devices.

Useful instructions

How to test OV5640 camera

To use the D3 mezzanine board with AV96 and the OV5640 camera, one has to apply the correct DTO first:

STM32MP> setenv loaddtos '#conf-stm32mp157a-avenger96.dtb#conf-stm32mp15xx-avenger96-overlay-ov5640-x7.dtbo'; boot

Afterward it is possible to stream frames from the camera:

$ XDG_RUNTIME_DIR=/var/run/user/$(id -u weston)/ gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw,width=1280,height=720 ! queue ! waylandsink

How to load U-Boot with dfu-util

SPI Flash and eMMC Image Programming via UMS (universal mass storage)

SPI Flash and eMMC Image Programming via Cube Programmer (OLD)

How to calibrate resistive touchscreens

Mezzanine Boards by DH electronics

DSI Display Adaptor Board

You can easily add an DSI display to your Avenger96 with the help of the DSI Display Adaptor Board. The display can be activated easily on our Mainline Image with a device tree overlay as described here. To get one of the boards, simply reach out to us and we'll prepare one for you.

DSI Display Adaptor Board

Links