Skip to content

Commit 6aa31b4

Browse files
jonaswood01StaticRocket
authored andcommitted
docs(debian): Update AM62Px for 11.01.16.13 release
Added release notes, fixed formatting, and updated some content. Updates following Oct 2025 AM62Px PG1.2 release. Signed-off-by: Jonas Wood <jw@ti.com>
1 parent 6d16bf0 commit 6aa31b4

File tree

5 files changed

+85
-41
lines changed

5 files changed

+85
-41
lines changed

configs/AM62PX/AM62PX_debian_config.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,12 +16,13 @@ Replacement Variables
1616
'__PART_FAMILY_NAME__' : 'AM62Px'
1717
'__PART_FAMILY_DEVICE_NAMES__' : 'AM62Px'
1818
'__PRODUCT_LINE_NAME__' : 'Sitara MPU'
19-
'__SDK_BUILD_MACHINE__' : 'am62xx-evm'
19+
'__SDK_BUILD_MACHINE__' : 'am62pxx-evm'
2020
'__SDK_FULL_NAME__' : 'Debian for AM62Px'
2121
'__SDK_SHORT_NAME__' : 'Debian'
2222
'__SDK_DOWNLOAD_URL__' : '`AM62Px-SDK-Download-page <https://www.ti.com/tool/PROCESSOR-SDK-AM62P>`__'
2323
'__LINUX_UBUNTU_VERSION_LONG__' : '22.04 (64-bit)'
2424
'__LINUX_UBUNTU_VERSION_SHORT__' : '22.04'
25+
'__OPTEE_PLATFORM_FLAVOR__' : 'k3-am62px'
2526

2627
Configuration Values
2728
--------------------

configs/AM62PX/AM62PX_debian_toc.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
devices/AM62PX/debian/index
22

33
debian/Overview
4+
devices/AM62PX/linux/Release_Specific
5+
devices/AM62PX/linux/Release_Specific_Release_Notes
46
devices/AM62PX/debian/Getting_Started_Guide
57
debian/Building_Debian_Image
68
debian/Building_Debian_Packages

source/devices/AM62PX/debian/Getting_Started_Guide.rst

Lines changed: 39 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -4,84 +4,83 @@
44
Getting Started with Debian
55
***************************
66

7-
The SD card Image tisdk-debian-bookworm-<machine> provided on the |__SDK_DOWNLOAD_URL__| is all you need to get started and explore Debian on TI microprocessors.
7+
The SD card Debian Image provided on the |__SDK_DOWNLOAD_URL__| is all you need to get started and explore
8+
Debian on TI microprocessors.
89

9-
The Debian Image provided has all the basic packages required to boot with weston as default window manager. The user can install any new package by using inbuilt 'apt' utility
10-
and customize the filesystem as required.
10+
The Debian Image provided has all the basic packages required to boot with weston as default window manager.
11+
The user can install any new package using Debian's default ``apt`` package manager and customize the
12+
filesystem as desired.
1113

12-
Follow the steps mentioned in this page to create an SD Card.
14+
Follow the steps mentioned in this page to flash an SD Card.
1315

1416
Hardware Setup
1517
--------------
1618

17-
In addition to the SK Evaluation Module (EVM) itself, use the following hardware:
19+
In addition to the SK Evaluation Module (EVM) itself, the following hardware is needed:
1820

19-
1. USB Type-C 5V - 15V and 3A power supply
20-
2. Micro-SD card reader
21-
3. Micro-SD card (16GB or larger recommended)
22-
4. USB Micro-B cable for UART serial communication
23-
5. HDMI display and HDMI cable
24-
6. USB mouse and Keyboard (For controlling the UI)
25-
7. Ethernet cable (For network access)
21+
- USB Type-C 5V - 15V and 3A power supply
22+
- Micro-SD card reader
23+
- Micro-SD card (16GB or larger recommended)
24+
- USB Micro-B cable for UART serial communication
25+
- HDMI display and HDMI cable
26+
- USB mouse and Keyboard (For controlling the UI)
27+
- Ethernet cable or CC33xx M.2 WiFi card (For network access)
2628

27-
Create SD Card using balenaEtcher
28-
---------------------------------
29+
.. _processor-sdk-debian-create-sd-card:
2930

30-
1. Download the default bootable SD card image (WIC file) available on the release page as
31-
tisdk-debian-bookworm-<machine>.wic.xz
32-
33-
|
31+
Flash SD Card using balenaEtcher
32+
--------------------------------
3433

35-
2. Download and install the balenaEtcher tool:
34+
#. Download the default bootable SD card image (IMG file) available on the release page:
3635

37-
Balena Etcher is an open-source utility that can be installed on both Linux and Windows.
38-
Download the tool from `this link <https://www.balena.io/etcher/>`__ and install it.
36+
``tisdk-debian-<debian version>-<TI EVM board>-<TI PSDK version>-Armbian-<armbian version>.img``
3937

40-
|
38+
#. Download and install the balenaEtcher tool:
4139

42-
3. Flash the WIC image to the SD card:
40+
Balena Etcher is an open-source utility that can be installed on both Linux and Windows.
41+
Download the tool from `this link <https://www.balena.io/etcher/>`__ and install it.
4342

44-
Insert a micro SD card into the USB SD card reader and start Etcher. Choose the debian wic
45-
image to be flashed, choose the USB SD card reader as the target, and then click "Flash".
46-
Etcher will decompress the image and write it to the SD card, as shown in the following:
43+
#. Flash the IMG image to the SD card:
4744

48-
.. Image:: /images/balena_etcher.png
45+
Insert a micro SD card into the USB SD card reader and start Etcher. Choose the debian img
46+
image to be flashed, choose the USB SD card reader as the target, and then click "Flash".
47+
Etcher will decompress the image and write it to the SD card, as shown below:
4948

50-
|
49+
.. image:: /images/balena_etcher.png
5150

5251
Set the EVM to SD card Boot mode
5352
--------------------------------
54-
The simplest way to run Linux on the SK EVM is through an SD card. For that, configure the EVM in SD card boot mode. Refer to `AM62Px SK EVM User's Guide <https://www.ti.com/tool/SK-AM62P-LP>`__ for detailed information about boot mode configurations. For quick reference, the following figure shows the boot mode switch setting for SD card boot.
53+
The simplest way to run Linux on the SK EVM is through an SD card. For that, configure the EVM for SD card boot mode. Refer to
54+
`AM62Px SK EVM User's Guide <https://www.ti.com/tool/SK-AM62P-LP>`__ for detailed information about boot mode configurations.
55+
For quick reference, the figure below shows the boot mode switch setting for SD card boot.
5556

56-
.. Image:: /images/AM62x_SD_boot.jpg
57+
.. image:: /images/AM62x_SD_boot.jpg
5758

5859
Boot and Validate Debian
5960
------------------------
60-
Make sure to connect the Ethernet cable, HDMI Display, Mouse and Keyboard to the EVM. Insert the SD Card in the board and Power ON the EVM.
61+
Make sure to connect the Ethernet cable or CC33xx M.2 WiFi card, HDMI Display, Mouse and Keyboard to the EVM. Insert the SD Card in the board and Power ON the EVM.
6162

62-
After a few moments, a configuration script will start running. This script will walk you through creating
63-
a user account, setting a root password, configuring the date and other initial setup options. When
64-
the setup finishes, restart the board. Upon reboot, the weston wallpaper should appear on your
65-
display.
63+
During first bootup, a setup script will run. This script guides the user through setting up user account, root password, date and so on.
64+
Once the setup ends, reboot the board. Weston screen will appear on the display.
6665

67-
.. Image:: /images/debian_homescreen.png
66+
.. image:: /images/debian_homescreen.png
6867

69-
You've successfully booted Debian on AM62x.
68+
You've successfully booted Debian on |__PART_FAMILY_DEVICE_NAMES__|.
7069

7170
If the board is connected to a private network, setup the proxy to be able to access the Internet.
72-
For more info, refer to `apt.conf(5) man page <https://manpages.debian.org/bookworm/apt/apt.conf.5.en.html>`__
71+
For more info, refer to `apt.conf(5) man page <https://manpages.debian.org/trixie/apt/apt.conf.5.en.html>`__
7372

7473
Also export ``http_proxy``, ``https_proxy``, ``ftp_proxy`` and ``no_proxy`` with appropriate values if needed.
7574

7675
Do an ``apt update`` to make sure that the proxy is properly set and apt recognizes it. The sample output of the command is as shown below:.
7776

78-
.. Image:: /images/debian_apt_update.png
77+
.. image:: /images/debian_apt_update.png
7978

8079
To install any package available on Debian Standard Package Archive and TI Package Archive use ``apt install``.
8180

8281
As an example to install and run ``fortune`` package.
8382

84-
.. Image:: /images/debian_apt_install.png
83+
.. image:: /images/debian_apt_install.png
8584

8685
More packages can be installed at runtime following the instructions provided to help with the development work flow.
8786

source/devices/AM62PX/debian/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ Debian Developer's Guide
1515
:numbered:
1616

1717
/debian/Overview
18+
/devices/AM62PX/linux/Release_Specific
1819
Getting_Started_Guide
1920
/debian/Building_Debian_Image
2021
/debian/Building_Debian_Packages

source/devices/AM62PX/linux/Release_Specific_Release_Notes.rst

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,8 @@ status for all packages included in this release. The manifest can be
3434
found on the SDK download page or in the installed directory as indicated below.
3535

3636
- Linux Manifest: :file:`<PSDK_PATH>/manifest/software_manifest.htm`
37+
- Debian Manifest: `TI debian software manifest 11.01.16.13
38+
<https://dr-download.ti.com/software-development/software-development-kit-sdk/MD-9ti3Ig9hNi/11.01.16.13/software_manifest_debian_am62pxx-evm_am62pxx-evm.htm>`__
3739

3840

3941
Release 11.01.16.13
@@ -80,6 +82,9 @@ What's new
8082
Build Information
8183
=================
8284

85+
Arago (Yocto/OE)
86+
----------------
87+
8388
.. list-table::
8489
:header-rows: 1
8590
:widths: 15, 30, 30, 30
@@ -121,6 +126,42 @@ Build Information
121126
- `11.01.16.13 <https://git.ti.com/cgit/ti-sdk-linux/meta-tisdk/tag/?h=11.01.16.13>`__
122127
-
123128

129+
Debian (Armbian)
130+
----------------
131+
132+
.. list-table::
133+
:header-rows: 1
134+
:widths: 15, 30, 30, 30
135+
136+
* - Component
137+
- Branch Info
138+
- Tag Info
139+
- Config Info
140+
* - U-Boot
141+
- `ti-u-boot-2025.01 <https://github.com/TexasInstruments/ti-u-boot/tree/ti-u-boot-2025.01>`__
142+
- `11.01.16 <https://github.com/TexasInstruments/ti-u-boot/releases/tag/11.01.16>`__
143+
- `Build <https://github.com/TexasInstruments/armbian-build/blob/53f037d7be54ea1f203aa46aaf61b03eb9a58585/config/sources/families/k3.conf#L103>`__
144+
* - ATF
145+
- `master <https://github.com/ARM-Software/arm-trusted-firmware/tree/master>`__
146+
- `v2.13+ <https://github.com/ARM-software/arm-trusted-firmware/commit/e0c4d3903b382bf34f552af53e6d955fae5283ab>`__
147+
- `Build <https://github.com/TexasInstruments/armbian-build/blob/53f037d7be54ea1f203aa46aaf61b03eb9a58585/config/sources/families/k3.conf#L101>`__
148+
* - OPTEE
149+
- `master <https://github.com/OP-TEE/optee_os/tree/master>`__
150+
- `4.7.0+ <https://github.com/OP-TEE/optee_os/commit/a9690ae39995af36a31b7a4f446f27ea0787e3a4>`__
151+
- `Build <https://github.com/TexasInstruments/armbian-build/blob/53f037d7be54ea1f203aa46aaf61b03eb9a58585/config/sources/families/k3.conf#L130>`__
152+
* - Linux Firmware
153+
- `ti-linux-firmware <https://github.com/TexasInstruments/ti-linux-firmware/tree/ti-linux-firmware>`__
154+
- `11.01.16 <https://github.com/TexasInstruments/ti-linux-firmware/releases/tag/11.01.16>`__
155+
- `Git Clone <https://github.com/TexasInstruments/armbian-build/blob/53f037d7be54ea1f203aa46aaf61b03eb9a58585/config/sources/families/k3.conf#L116>`__
156+
* - Linux Kernel
157+
- `ti-linux-6.12.y <https://github.com/TexasInstruments/ti-linux-kernel/tree/ti-linux-6.12.y>`__
158+
- `11.01.16 <https://github.com/TexasInstruments/ti-linux-kernel/releases/tag/11.01.16>`__
159+
- `non-RT <https://github.com/TexasInstruments/armbian-build/blob/2025.10-release/config/kernel/linux-k3-current.config>`__, `RT <https://github.com/TexasInstruments/armbian-build/blob/2025.10-release/config/kernel/linux-k3-current-rt.config>`__
160+
* - Armbian Build
161+
- `2025.10-release <https://github.com/TexasInstruments/armbian-build/tree/2025.10-release>`__
162+
- `11.01.16.13 <https://github.com/TexasInstruments/armbian-build/releases/tag/11.01.16.13>`__
163+
- `Build <https://github.com/TexasInstruments/armbian-build/blob/2025.10-release/config/sources/families/k3.conf>`__, `Board <https://github.com/TexasInstruments/armbian-build/blob/2025.10-release/config/boards/am62pxx-evm.conf>`__
164+
124165

125166
Issues Tracker
126167
==============

0 commit comments

Comments
 (0)