Avenger96: Difference between revisions

From Wiki-DB
Jump to navigationJump to search
Ageisreiter (talk | contribs)
Ageisreiter (talk | contribs)
 
(106 intermediate revisions by 5 users not shown)
Line 1: Line 1:
'''The Avenger96 board is the official DHCOR STM32MP1 reference design!'''
{|
{|
|
|
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 ==
* [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)]


== Documentation ==
== Documentation ==
* [https://www.dropbox.com/s/f9jvcdq8rgb3e3f/DOC_Getting-Started-588-200_R03_2020-05-29.pdf?dl=1 Avenger96 588-200 Getting-Started R03]
* [[media:DOC_Getting-Started-588-200_R05_2024-07-17.pdf|Getting-Started with Avenger96 (R05)]]
* [https://www.dropbox.com/s/40k1tygmsiogy6r/USM_DHCOR-STM32MP1_R05_2019-12-12.pdf?dl=0 '''NEW''' DHCOR STM32MP1 User Manual R05 <span style="color:#FF0000">'''IMPORTANT: Please have a look at NEW chapter 24. Hardware design checklist'''</span> ]
* [[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>]]
:'''IMPORTANT''' Please also have a look at the STM32 MPU wiki: [[Avenger96#Links | Links]]
* More about the STM32 MPU is on the [[Avenger96#Links | Links section]]


== Design Files ==
== Design Files ==
Line 74: Line 86:
* [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/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]
* [https://www.dropbox.com/s/s4n5j9wzhhrv6so/DHCOR_STM32MP1_3D_STEP_586-100_R02.zip?dl=0 DHCOR STM32MP1 3D STEP file]
* [https://www.dropbox.com/s/4i0la7q1wkv4anh/DHCOR-PinMux-TFBGA361-Avenger96-HW200_2019-05-03.zip?dl=0 Avenger96 CubeMX configuration (release date: 03.05.2019)]
* [[media:Stm32mp15xx-dhcor-avenger96_2023-04-18.zip | Avenger96 CubeMX configuration (release date: 18.04.2023)]]


== Software ==
== 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 ===
=== OpenSTLinux ===
* [https://github.com/dh-electronics/manifest-av96 Yocto meta layer --> Github]
: <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>
:DH electronics Github contains the meta-av96 layer for ST v1.2.0 SDK. Please see readme.txt which describes the build process.
* '''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/i29htstp35awt3m/Avenger96_v5.0.0_2020-07-08.zip?dl=0 '''NEW''' OpenSTLinux-4.19-thud v5.0.0 Starter Image]
* [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]]'''
:[[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.
:'''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/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]
* [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]
=== Debian ===
* [http://releases.linaro.org/96boards/avenger96/ Debian Buster Starter Image]


== Useful instructions ==
== 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


==== SPI Flash and eMMC Image Programming ====
Afterward it is possible to stream frames from the camera:
*[[Avenger96 Image Programming | Avenger96 Image Programming]]
$ 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


==== Add camera support to Avenger96 board ====
==== How to load U-Boot with dfu-util ====  
*[[Avenger96 Camera Support | '''NEW''' Avenger96 Camera Support]]
*[[U-Boot recovery for STM32MP1 DHSOM via DFU |U-Boot recovery for STM32MP1 DHSOM via DFU]]


== Links ==
==== SPI Flash and eMMC Image Programming via UMS (universal mass storage) ====
* [https://wiki.st.com/stm32mpu/wiki/Main_Page STM32 MPU wiki]
*[[Avenger96 UMS Image Programming | Avenger96 UMS Image Programming]]
* [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]


== OpenSTLinux-4.19-thud Image Changelog ==
==== SPI Flash and eMMC Image Programming via Cube Programmer (OLD) ====
'''Changelog v4.1.0 to v5.0.0:'''
*[[Avenger96 Image Programming | Avenger96 Image Programming]]
* tf-a now supports pure eMMC boot on silicon revision 2.1, rev Z
* init script moved to meta-av96-scripts repo, manifest file moved to manifest-av96 repo. meta-av96 layer is now totally independent of the manifest and init scripts.
* meta-av96 now uses STM32MP15-Ecosystem-v1.2.0
* meta-av96 and av96-5.0.img uSD card image now support the “apt-get” feature of STM32MP15-Ecosystem-v1.2.0


'''Changelog v3.2.0 to v4.1.0:'''
==== How to calibrate resistive touchscreens ====
* STMIPID02 and D3 camera mezzanine patches added, OV5640 camera can be tested with the default Weston GUI.
*[[Calibration of resistive touchscreens]]
* Source folder structure reworked. meta-av96 now uses a ‘repo’ manifest-based setup. ‘thud’ branch created and folder structure resembles more the ST way.


'''Changelog v2.1.0 to v3.2.0:'''
== Mezzanine Boards by DH electronics ==
* U-Boot sets ethernet MAC address from 24AA02 EEprom
* mmc0 now supports switching to 1.8V, UHS-I cards speeded up
* HW version 1 added to U-Boot device tree, U-Boot now checks HW version of the actual Avenger96 board
* Flashlayout file generation fixed, no need to change Flashlayout files manually before programming nor+emmc


'''Changelog v2.0.3 to v2.1.0:'''
==== DSI Display Adaptor Board ====
* HDMI max resolution fixed, it’s 1280x720@60Hz again
You can easily add an DSI display to your Avenger96 with the help of the DSI Display Adaptor Board.  
* DRAM size in U-Boot fixed, Linux now sees the whole 1GB
The display can be activated easily on our Mainline Image with a device tree overlay as described [[DHCOR_STM32MP1_Linux| here]].  
* UART0 and SPI now supported on low-speed extension connector
To get one of the boards, simply reach out to us and we'll prepare one for you.
* tpm2-tools and tpm2-tss-engine for openssl added, TPM2.0 chip on Tresor board supported by openssl


'''Changelog v2.0.2 to v2.0.3:'''
[[File:DSI Display Adaptor Board.jpg|400px|DSI Display Adaptor Board]]
* DHCP server running at usb0 network interface


'''Changelog v2.0.1 to v2.0.2:'''
== Links ==
* Supported features in U-Boot: UART, DDR3, QSPI, uSD, eMMC, ethernet
* [https://wiki.st.com/stm32mpu/wiki/Main_Page STM32 MPU wiki]
* PRODUCT_BELOW_2V5 fix in U-Boot
* [https://wiki.st.com/stm32mpu/wiki/Category:Device_tree_configuration STM32 MPU wiki - Device tree configuration]
* Supported features in Linux: UART, uSD, eMMC, USB host, USB OTG, HDMI, GPU, WiFi, Bluetooth, Gbit ethernet
* [https://wiki.st.com/stm32mpu/index.php/STM32MP15_resources STM32MP15 resources]
* STM32CubeProgrammer can initialize NOR, eMMC, uSD
* [https://www.96boards.org 96Boards]
* 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:'''
* Switch to ST v1.0.0 SDK with 4.19 kernel
* 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
* NOT working: QSPI in U-Boot and Linux, eMMC in U-Boot, WiFi, …
* 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:'''
* [https://www.dropbox.com/s/ygjzu52syc63fi4/Avenger96_v4.1.0_2020-02-12.zip?dl=0 OpenSTLinux-4.19-thud v4.1.0 Starter Image]
* [https://www.dropbox.com/s/3r52ld1f5zl09jb/Avenger96_v3.2.0_2019-08-09.zip?dl=0 OpenSTLinux-4.19-thud v3.2.0 Starter Image]
* [https://www.dropbox.com/s/4x0olkqv3g983d7/Avenger96_v2.1.0_2019-05-22.zip?dl=0 Avenger96 v2.1.0 Starter Image]
* [https://www.dropbox.com/s/ypv15rpe5a6wze4/Avenger96_v2.0.3_2019-05-03.zip?dl=0 Avenger96 v2.0.3 Starter Image]
* [https://www.dropbox.com/s/wm1faek37u8c9v9/Avenger96_v2.0.2_2019-04-25.zip?dl=0 Avenger96 v2.0.2 Starter Image]
* [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]

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