|
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 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. |
11 | 13 |
|
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. |
13 | 15 |
|
14 | 16 | Hardware Setup |
15 | 17 | -------------- |
16 | 18 |
|
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: |
18 | 20 |
|
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) |
26 | 28 |
|
27 | | -Create SD Card using balenaEtcher |
28 | | ---------------------------------- |
| 29 | +.. _processor-sdk-debian-create-sd-card: |
29 | 30 |
|
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 | +-------------------------------- |
34 | 33 |
|
35 | | -2. Download and install the balenaEtcher tool: |
| 34 | +#. Download the default bootable SD card image (IMG file) available on the release page: |
36 | 35 |
|
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`` |
39 | 37 |
|
40 | | -| |
| 38 | +#. Download and install the balenaEtcher tool: |
41 | 39 |
|
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. |
43 | 42 |
|
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: |
47 | 44 |
|
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: |
49 | 48 |
|
50 | | -| |
| 49 | + .. image:: /images/balena_etcher.png |
51 | 50 |
|
52 | 51 | Set the EVM to SD card Boot mode |
53 | 52 | -------------------------------- |
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 `AM62x SK EVM User's Guide <https://www.ti.com/tool/SK-AM62B>`__ 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 | +`AM62x SK EVM User's Guide <https://www.ti.com/tool/SK-AM62B-P1>`__ for detailed information about boot mode configurations. |
| 55 | +For quick reference, the figure below shows the boot mode switch setting for SD card boot. |
55 | 56 |
|
56 | | -.. Image:: /images/AM62x_SD_boot.jpg |
| 57 | +.. image:: /images/AM62x_SD_boot.jpg |
57 | 58 |
|
58 | 59 | Boot and Validate Debian |
59 | 60 | ------------------------ |
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. |
61 | 62 |
|
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. |
66 | 65 |
|
67 | | -.. Image:: /images/debian_homescreen.png |
| 66 | +.. image:: /images/debian_homescreen.png |
68 | 67 |
|
69 | | -You've successfully booted Debian on AM62x. |
| 68 | +You've successfully booted Debian on |__PART_FAMILY_DEVICE_NAMES__|. |
70 | 69 |
|
71 | 70 | 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>`__ |
73 | 72 |
|
74 | 73 | Also export ``http_proxy``, ``https_proxy``, ``ftp_proxy`` and ``no_proxy`` with appropriate values if needed. |
75 | 74 |
|
76 | 75 | 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:. |
77 | 76 |
|
78 | | -.. Image:: /images/debian_apt_update.png |
| 77 | +.. image:: /images/debian_apt_update.png |
79 | 78 |
|
80 | 79 | To install any package available on Debian Standard Package Archive and TI Package Archive use ``apt install``. |
81 | 80 |
|
82 | 81 | As an example to install and run ``fortune`` package. |
83 | 82 |
|
84 | | -.. Image:: /images/debian_apt_install.png |
| 83 | +.. image:: /images/debian_apt_install.png |
85 | 84 |
|
86 | 85 | More packages can be installed at runtime following the instructions provided to help with the development work flow. |
87 | 86 |
|
0 commit comments