OSD32MP1 Debian SDK v3.0

This repository contains the list of repositories used for OSD32MP1 Debian SDK v3.0

Introduction

OSD32MP1 Debian SDK can be used to develop Debian Linux images for OSD32MP1 based platforms. The SDK runs on host desktop preferably runnning Ubuntu. Docker is used to containerize the build environment. Souce code from ST (OpenSTLinux) is used, for TF-A, U-Boot, Linux kernel, GCNano and STM32CubeMP1. So, the SDK is compatible with software from ST. Binary images for both SD card and eMMC can be generated. Cube Programmer can be used to flash the eMMC via USB.

The following repositories make up OSD32MP1 Debian SDK::

Package	URL
TF-A Source code	https://github.com/STMicroelectronics/arm-trusted-firmware.git
U-Boot Source code	https://github.com/STMicroelectronics/u-boot.git
Linux kernel Source code	https://github.com/STMicroelectronics/linux.git
GCNano Binaries	https://github.com/STMicroelectronics/gcnano-binaries.git
STM32Cube MP1 Package	https://github.com/STMicroelectronics/STM32CubeMP1.git
Debian multistrap Source code	https://github.com/octavosystems/osd32mp1-multistrap.git
Docker image Source code	https://github.com/octavosystems/osd32mp1-debian-docker.git
Build tools source code	https://github.com/octavosystems/osd32mp1-build-tools.git

Boards supported:

Board	Webpage
OSD32MP1-RED	https://octavosystems.com/octavo_products/osd32mp1-red/

Requirements

Tested on Ubuntu 20.04 LTS

The following packges are recommended:

Package	Version
repo	v2.13 or higher
git	2.17 or higher
Python	3.x
Docker	19.x
qemu-user-static	1:4.2-3ubuntu6.19
STM32MP1 Cube Programmer	2.9 or higher

OSD32MP1 Target binary versions:

The following version of the image are supported in release:

Package	Version	Source URL
TF-A	v2.4-stm32mp-r1	https://github.com/STMicroelectronics/arm-trusted-firmware.git
U-Boot	2020.10-stm32mp-r1	https://github.com/STMicroelectronics/u-boot.git
Linux Kernel	v5.10-stm32mp-r1	https://github.com/STMicroelectronics/linux.git
GCNano(binaries)	gcnano-6.4.3-binaries	https://github.com/STMicroelectronics/gcnano-binaries.git
STM32CubeMP1	1.4	https://github.com/STMicroelectronics/STM32CubeMP1.git

How to use the SDK

Setup Host computer

1. sudo apt-get update
2. sudo apt-get upgrade
3. sudo apt-get install git docker.io qemu-user-static
4. sudo systemctl enable docker
5. sudo systemctl start docker
6. Install repo: https://stackoverflow.com/questions/4350344/how-to-install-androids-repo-on-my-ubuntu-system

Install Cube Programmer from here: https://www.st.com/en/development-tools/stm32cubeprog.html Please see https://wiki.st.com/stm32mpu/wiki/STM32CubeProgrammer for Cube Programmer installation instructions and setup.

Get SDK source code

1. mkdir ~/osd32mp1-workspace
2. cd ~/osd32mp1-workspace
3. repo init -u https://github.com/octavosystems/osd32mp1-debian
4. repo sync

NOTE: If you encounter the following error: "repo init -u https://github.com/octavosystems/osd32mp1-debian failed by responsing fatal: Couldn't find remote ref refs/heads/master", you will need to use the following command for #3:

repo init -u https://github.com/octavosystems/osd32mp1-debian -b main

Compile docker image

1. cd ~/osd32mp1-workspace/docker
2. sudo make build

Compile target image for OSD32MP1-RED V1_2

1. cd ~/osd32mp1-workspace/docker
2. sudo make run
3. make all

Outputs

The following outputs are generated in ~/osd32mp1-workspace/deploy :

Output	Filename	Comment
1	tf-a-stm32mp157c-osd32mp1-red-v1_2-emmc.stm32	Binary for OSD32M1 arm-trusted-firmware eMMC
2	tf-a-stm32mp157c-osd32mp1-red-v1_2-sdcard.stm32	Binary for OSD32MP1 arm-trsuted-firmware SD card
3	tf-a-stm32mp157c-osd32mp1-red-v1_2-usb.stm32	Binary for OSD32MP1 arm-trsuted-firmware SD card USB boot
4	fip-stm32mp157c-osd32mp1-red-v1_2-trusted.bin	FiP Binary for OSD32MP1 U-Boot
4	FlashLayout_sdcard_stm32mp157c-osd32mp1-red-v1_2-trusted.tsv	Flash layout file for OSD32MP1-RED trusted - SD card
5	FlashLayout_sdcard_stm32mp157c-osd32mp1-red-v1_2-trusted.raw	Binary image for OSD32MP1-RED trusted - SD card
6	FlashLayout_emmc_stm32mp157c-osd32mp1-red-v1_2-trusted.tsv	Flash layout file for OSD32MP1-RED trsudted - eMMC
7	octavo-bootfs-debian-lxqt-stm32mp157c-osd32mp1-red-v1_2.ext4	BOOTFS binary for OSD32MP1-RED
8	octavo-rootfs-debian-lxqt-emmc-stm32mp157c-osd32mp1-red-v1_2.ext4	ROOTFS binary for OSD32MP1-RED - eMMC
9	octavo-rootfs-debian-lxqt-sdcard-stm32mp157c-osd32mp1-red-v1_2.ext4	ROOTFS binary for OSD32MP1-RED - SD card
10	octavo-vendorfs-debian-lxqt-stm32mp157c-osd32mp1-red-v1_2.ext4	VENDORFS binary for OSD32MP1-RED

Deploy on SD card (where sdX is the device assignment for SD card)

1. cd ~/osd32mp1-workspace/deploy/
2. sudo dd if=FlashLayout_sdcard_stm32mp157c-osd32mp1-red-v1_2-trusted.raw of=/dev/sdX bs=1M conv=fdatasync status=progress

Flash eMMC

STM32MP1 Cube Programmer is required for this procedure

1. Set boot mode for OSD32MP1-RED to USB boot (000)
2. Connect USB-C cable between OSD32MP1-RED and Host computer.

To determine device numnber for the board connected:

3. STM32_Programmer_CLI -l USB

      -------------------------------------------------------------------
                        STM32CubeProgrammer v2.9.0                  
      -------------------------------------------------------------------

=====  DFU Interface   =====

Total number of available STM32 device in DFU mode: 1

  Device Index           : USB1
  USB Bus Number         : 003
  USB Address Number     : 002
  Product ID             : DFU in HS Mode @Device ID /0x500, @Revision ID /0x0000
  Serial number          : 002700223239511737383434
  Firmware version       : 0x0110
  Device ID              : 0x0500

The above device indicates the board is connected as USB1.

Flash the eMMC

4. STM32_Programmer_CLI -c port=USB1 -w FlashLayout_emmc_stm32mp157c-osd32mp1-red-v1_2-trusted.tsv

How to contribute

1. Clone repo with a new branch: git checkout https://github.com/octavosystems/xxx -b new_branch_name
2. Change and test
3. Submit pull request