Skip to content

Commit d12c6b9

Browse files
jonaswood01StaticRocket
authored andcommitted
docs(debian): Update AM64x for 11.01.05.03 release
Added release notes, fixed formatting, and updated some content. Updates following Jul 2025 11.01 release. Signed-off-by: Jonas Wood <jw@ti.com>
1 parent 26a5d24 commit d12c6b9

File tree

4 files changed

+76
-32
lines changed

4 files changed

+76
-32
lines changed

configs/AM64X/AM64X_debian_toc.txt

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

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

source/devices/AM64X/debian/Getting_Started_Guide.rst

Lines changed: 37 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -4,80 +4,85 @@
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 user can install any new package by using inbuilt 'apt' utility 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.
1013

11-
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.
1215

1316
Hardware Setup
1417
--------------
1518

16-
In addition to the Evaluation Module (EVM) or the Starter Kit itself, use the following hardware:
19+
In addition to the Evaluation Module (EVM) or the Starter Kit (SK) itself, the following hardware is needed:
1720

18-
1. Barrel jack power supply
19-
2. Micro-SD card reader
20-
3. Micro-SD card (16GB or larger recommended)
21-
4. USB Micro-B cable for UART serial communication
22-
5. Ethernet cable (For network access)
21+
- Barrel jack 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+
- Ethernet cable (For network access)
2326

24-
Create SD Card using balenaEtcher
25-
---------------------------------
27+
.. _processor-sdk-debian-create-sd-card:
2628

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

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

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

37-
|
36+
#. Download and install the balenaEtcher tool:
3837

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

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

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

47-
|
47+
.. image:: /images/balena_etcher.png
4848

4949
Set the EVM to SD card Boot mode
5050
--------------------------------
51-
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 `AM64x SK EVM User's Guide <https://www.ti.com/tool/SK-AM64B>`__ or the `TMDS64EVM User's Guide <https://www.ti.com/tool/TMDS64EVM>`__ (depending on the device) for detailed information about boot mode configurations. For quick reference, the following figure shows the boot mode switch setting for SD card boot.
51+
The simplest way to run Linux on the EVM or SK is through an SD card. For that, configure the EVM or SK for SD card boot mode. Refer to
52+
`AM64x EVM User's Guide <https://www.ti.com/tool/TMDS64EVM>`__ or `AM64x SK User's Guide <https://www.ti.com/tool/SK-AM64B>`__ (depending on the device)
53+
for detailed information about boot mode configurations. For quick reference, the figure below shows the boot mode switch setting for SD card boot.
5254

53-
.. Image:: /images/AM64x_SD_boot.jpg
55+
.. image:: /images/AM64x_SD_boot.jpg
5456

5557
Boot and Validate Debian
5658
------------------------
5759
Make sure to connect the UART and Ethernet cable to the EVM. Insert the SD Card in the board and Power ON the EVM.
5860

5961
After approximately 20 seconds, the board should boot and you should see the on-board LED glowing.
6062

61-
You've successfully booted Debian on AM64x.
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.
6265

6366
To verify the distro, connect via the UART console and try running ``neofetch`` on the terminal. The output of the command can be observed on the screen as shown below.
6467

65-
.. Image:: /images/debian_neofetch.png
68+
.. image:: /images/debian_neofetch.png
69+
70+
You've successfully booted Debian on |__PART_FAMILY_DEVICE_NAMES__|.
6671

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

7075
Also export ``http_proxy``, ``https_proxy``, ``ftp_proxy`` and ``no_proxy`` with appropriate values if needed.
7176

7277
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:.
7378

74-
.. Image:: /images/debian_apt_update.png
79+
.. image:: /images/debian_apt_update.png
7580

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

7883
As an example to install and run ``fortune`` package.
7984

80-
.. Image:: /images/debian_apt_install.png
85+
.. image:: /images/debian_apt_install.png
8186

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

source/devices/AM64X/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/AM64X/linux/Release_Specific
1819
Getting_Started_Guide
1920
/debian/Building_Debian_Image
2021
/debian/Building_Debian_Packages

source/devices/AM64X/linux/Release_Specific_Release_Notes.rst

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -169,6 +169,42 @@ Yocto
169169
| Release Tag: 11.01.05.03
170170
|
171171
172+
Debian (Armbian)
173+
----------------
174+
175+
.. list-table::
176+
:header-rows: 1
177+
:widths: 15, 30, 30, 30
178+
179+
* - Component
180+
- Branch Info
181+
- Tag Info
182+
- Config Info
183+
* - U-Boot
184+
- `ti-u-boot-2025.01 <https://github.com/TexasInstruments/ti-u-boot/tree/ti-u-boot-2025.01>`__
185+
- `11.01.05 <https://github.com/TexasInstruments/ti-u-boot/releases/tag/11.01.05>`__
186+
- `Build <https://github.com/TexasInstruments/armbian-build/blob/5f357a146d6a72dad1b5677e4cfdc111a9f3a935/config/sources/families/k3.conf#L85>`__
187+
* - ATF
188+
- `master <https://github.com/ARM-Software/arm-trusted-firmware/tree/master>`__
189+
- `v2.13+ <https://github.com/ARM-software/arm-trusted-firmware/commit/d90bb650fe4cb3784f62214ab5829f4051c38d0a>`__
190+
- `Build <https://github.com/TexasInstruments/armbian-build/blob/5f357a146d6a72dad1b5677e4cfdc111a9f3a935/config/sources/families/k3.conf#L83>`__
191+
* - OPTEE
192+
- `master <https://github.com/OP-TEE/optee_os/tree/master>`__
193+
- `4.6.0 <https://github.com/OP-TEE/optee_os/releases/tag/4.6.0>`__
194+
- `Build <https://github.com/TexasInstruments/armbian-build/blob/5f357a146d6a72dad1b5677e4cfdc111a9f3a935/config/sources/families/k3.conf#L111>`__
195+
* - Linux Firmware
196+
- `ti-linux-firmware <https://github.com/TexasInstruments/ti-linux-firmware/tree/ti-linux-firmware>`__
197+
- `11.01.05 <https://github.com/TexasInstruments/ti-linux-firmware/releases/tag/11.01.05>`__
198+
- `Git Clone <https://github.com/TexasInstruments/armbian-build/blob/5f357a146d6a72dad1b5677e4cfdc111a9f3a935/config/sources/families/k3.conf#L98>`__
199+
* - Linux Kernel
200+
- `ti-linux-6.12.y <https://github.com/TexasInstruments/ti-linux-kernel/tree/ti-linux-6.12.y>`__
201+
- `11.01.05 <https://github.com/TexasInstruments/ti-linux-kernel/releases/tag/11.01.05>`__
202+
- `non-RT <https://github.com/TexasInstruments/armbian-build/blob/2025.07-release/config/kernel/linux-k3-current.config>`__, `RT <https://github.com/TexasInstruments/armbian-build/blob/2025.07-release/config/kernel/linux-k3-current-rt.config>`__
203+
* - Armbian Build
204+
- `2025.07-release <https://github.com/TexasInstruments/armbian-build/tree/2025.07-release>`__
205+
- `11.01.05.03 <https://github.com/TexasInstruments/armbian-build/releases/tag/11.01.05.03>`__
206+
- `Build <https://github.com/TexasInstruments/armbian-build/blob/2025.07-release/config/sources/families/k3.conf>`__, `Board <https://github.com/TexasInstruments/armbian-build/blob/2025.07-release/config/boards/sk-am64b.conf>`__
207+
172208
Issues Tracker
173209
==============
174210

0 commit comments

Comments
 (0)