|
4 | 4 | Getting Started with Debian |
5 | 5 | *************************** |
6 | 6 |
|
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. |
8 | 9 |
|
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. |
10 | 13 |
|
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. |
12 | 15 |
|
13 | 16 | Hardware Setup |
14 | 17 | -------------- |
15 | 18 |
|
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: |
17 | 20 |
|
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) |
23 | 26 |
|
24 | | -Create SD Card using balenaEtcher |
25 | | ---------------------------------- |
| 27 | +.. _processor-sdk-debian-create-sd-card: |
26 | 28 |
|
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 | +-------------------------------- |
31 | 31 |
|
32 | | -2. Download and install the balenaEtcher tool: |
| 32 | +#. Download the default bootable SD card image (IMG file) available on the release page: |
33 | 33 |
|
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`` |
36 | 35 |
|
37 | | -| |
| 36 | +#. Download and install the balenaEtcher tool: |
38 | 37 |
|
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. |
40 | 40 |
|
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: |
44 | 42 |
|
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: |
46 | 46 |
|
47 | | -| |
| 47 | + .. image:: /images/balena_etcher.png |
48 | 48 |
|
49 | 49 | Set the EVM to SD card Boot mode |
50 | 50 | -------------------------------- |
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. |
52 | 54 |
|
53 | | -.. Image:: /images/AM64x_SD_boot.jpg |
| 55 | +.. image:: /images/AM64x_SD_boot.jpg |
54 | 56 |
|
55 | 57 | Boot and Validate Debian |
56 | 58 | ------------------------ |
57 | 59 | Make sure to connect the UART and Ethernet cable to the EVM. Insert the SD Card in the board and Power ON the EVM. |
58 | 60 |
|
59 | 61 | After approximately 20 seconds, the board should boot and you should see the on-board LED glowing. |
60 | 62 |
|
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. |
62 | 65 |
|
63 | 66 | 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. |
64 | 67 |
|
65 | | -.. Image:: /images/debian_neofetch.png |
| 68 | +.. image:: /images/debian_neofetch.png |
| 69 | + |
| 70 | +You've successfully booted Debian on |__PART_FAMILY_DEVICE_NAMES__|. |
66 | 71 |
|
67 | 72 | 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>`__ |
69 | 74 |
|
70 | 75 | Also export ``http_proxy``, ``https_proxy``, ``ftp_proxy`` and ``no_proxy`` with appropriate values if needed. |
71 | 76 |
|
72 | 77 | 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:. |
73 | 78 |
|
74 | | -.. Image:: /images/debian_apt_update.png |
| 79 | +.. image:: /images/debian_apt_update.png |
75 | 80 |
|
76 | 81 | To install any package available on Debian Standard Package Archive and TI Package Archive use ``apt install``. |
77 | 82 |
|
78 | 83 | As an example to install and run ``fortune`` package. |
79 | 84 |
|
80 | | -.. Image:: /images/debian_apt_install.png |
| 85 | +.. image:: /images/debian_apt_install.png |
81 | 86 |
|
82 | 87 | More packages can be installed at runtime following the instructions provided to help with the development work flow. |
83 | 88 |
|
0 commit comments