From 09127d6be235a9d1f807e770781440e852e978b3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Julio=20C=C3=A9sar=20Su=C3=A1stegui?= Date: Thu, 11 Jun 2026 11:38:39 -0600 Subject: [PATCH] style: normalize Android RST indentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Julio César Suástegui --- source/android/Overview_Flashing.rst | 437 +++++++++++++-------------- 1 file changed, 218 insertions(+), 219 deletions(-) diff --git a/source/android/Overview_Flashing.rst b/source/android/Overview_Flashing.rst index 94a7126c7..aea30622d 100644 --- a/source/android/Overview_Flashing.rst +++ b/source/android/Overview_Flashing.rst @@ -120,279 +120,279 @@ Once the build is complete, follow the steps below to flash the images to eMMC. - On the left, a terminal to send commands from the PC to the device - On the right, the ``picocom`` console to run commands on the device -.. list-table:: - :header-rows: 1 + .. list-table:: + :header-rows: 1 - * - PC - - Device - * - run ``snagrecover``: + * - PC + - Device + * - run ``snagrecover``: - .. ifconfig:: CONFIG_part_variant in ('AM62X') + .. ifconfig:: CONFIG_part_variant in ('AM62X') - .. code-block:: console + .. code-block:: console - # If you are using binaries built locally - $ cd out/target/product/am62x - - (OR) - - # If you are using pre-built binaries from SDK download page - $ cd AM62x_11.00.01_emmc + # If you are using binaries built locally + $ cd out/target/product/am62x - # for AM62x SK EVM (GP) - $ snagrecover -s am625 -f ./am62x-sk-evm.yaml + (OR) + + # If you are using pre-built binaries from SDK download page + $ cd AM62x_11.00.01_emmc - # for AM62x SK EVM (HS-FS) - $ snagrecover -s am625 -f ./am62x-sk-evm-hsfs.yaml + # for AM62x SK EVM (GP) + $ snagrecover -s am625 -f ./am62x-sk-evm.yaml - # for AM62x LP SK EVM (GP) - $ snagrecover -s am625 -f ./am62x-lp-sk-evm.yaml - - # for AM62x LP SK EVM (HS-FS) - $ snagrecover -s am625 -f ./am62x-lp-sk-evm-hsfs.yaml - - .. ifconfig:: CONFIG_part_variant in ('AM62PX') - - .. code-block:: console - - # If you are using binaries built locally - $ cd out/target/product/am62p - - (OR) - - # If you are using pre-built binaries from SDK download page - $ cd AM62Px_11.00.01_emmc - - $ snagrecover -s am625 -f ./am62px-sk-evm-hsfs.yaml - - .. ifconfig:: CONFIG_part_variant in ('AM67A') - - .. code-block:: console - - # If you are using binaries built locally - $ cd out/target/product/am67a - - (OR) - - # If you are using pre-built binaries from SDK download page - $ cd AM67A_11.00.01_emmc - - # for AM67A EVM (HS-FS only: by default) - $ snagrecover -s am62p5 -f ./am67a-evm-hsfs.yaml - - produces:: - - Starting recovery of am625 board - Installing firmware tiboot3 - Searching for partition id... - Downloading file... - Could not read status after end of manifest phase - Done - Done installing firmware tiboot3 - Installing firmware tispl - Searching for partition id... - Downloading file... - Done - Done installing firmware tispl - Installing firmware u-boot - Searching for partition id... - Downloading file... - Done - Sending detach command... - Done installing firmware u-boot - Installing firmware u-boot - Searching for partition id... - Downloading file... - Done - Sending detach command... - Done installing firmware u-boot - Done recovering am625 board - - - Halt the autoboot countdown by pressing any key:: - - U-Boot SPL 2023.04-g83660642 (Jul 15 2024 - 11:30:29 +0000) - SYSFW ABI: 4.0 (firmware rev 0x000a '10.0.6--v10.00.06 (Fiery Fox)') - SPL initial stack usage: 17048 bytes - Trying to boot from DFU - ##########################################################DOWNLOAD ... OK - Ctrl+C to exit ... - ##############################################################DOWNLOAD ... OK - Ctrl+C to exit ... - Authentication passed - Authentication passed - Authentication passed - init_env from device 10 not supported! - Authentication passed - Authentication passed - Starting ATF on ARM64 core... - - NOTICE: BL31: v2.10.0(release):09.02.00.009 - NOTICE: BL31: Built : 11:30:24, Jul 15 2024 - - U-Boot SPL 2023.04-g83660642 (Jul 15 2024 - 11:30:56 +0000) - SYSFW ABI: 4.0 (firmware rev 0x000a '10.0.6--v10.00.06 (Fiery Fox)') - SPL initial stack usage: 1904 bytes - Trying to boot from DFU - #####DOWNLOAD ... OK - Ctrl+C to exit ... - Authentication passed - Authentication passed - - - U-Boot 2023.04-g83660642 (Jul 15 2024 - 11:30:56 +0000) - - SoC: AM62PX SR1.0 HS-FS - Model: Texas Instruments AM62P5 SK - DRAM: 2 GiB (effective 8 GiB) - Core: 80 devices, 30 uclasses, devicetree: separate - MMC: mmc@fa10000: 0, mmc@fa00000: 1 - Loading Environment from MMC... OK - In: serial - Out: serial - Err: serial - Net: eth0: ethernet@8000000port@1, eth1: ethernet@8000000port@2 - Hit any key to stop autoboot: 0 - => - - * - - - .. _step_5_flashing_instructions: - - Ensure the default U-Boot environment is configured with: + # for AM62x SK EVM (HS-FS) + $ snagrecover -s am625 -f ./am62x-sk-evm-hsfs.yaml - .. code-block:: console + # for AM62x LP SK EVM (GP) + $ snagrecover -s am625 -f ./am62x-lp-sk-evm.yaml + + # for AM62x LP SK EVM (HS-FS) + $ snagrecover -s am625 -f ./am62x-lp-sk-evm-hsfs.yaml + + .. ifconfig:: CONFIG_part_variant in ('AM62PX') + + .. code-block:: console + + # If you are using binaries built locally + $ cd out/target/product/am62p + + (OR) - => env default -f -a; saveenv; - ## Resetting to default environment - Saving Environment to MMC... Writing to MMC(0)... OK + # If you are using pre-built binaries from SDK download page + $ cd AM62Px_11.00.01_emmc - .. tip:: + $ snagrecover -s am625 -f ./am62px-sk-evm-hsfs.yaml - By default, no Device-Tree Overlays are selected. - Follow this link to configure :ref:`android-dtbo` + .. ifconfig:: CONFIG_part_variant in ('AM67A') - * - - - Enable fastboot mode on the device by executing below command. + .. code-block:: console - Before running this, make sure USB-C cable is connected from the host PC to the EVM: + # If you are using binaries built locally + $ cd out/target/product/am67a - .. code-block:: console + (OR) - => fastboot 0 + # If you are using pre-built binaries from SDK download page + $ cd AM67A_11.00.01_emmc - * - Run the the :file:`flashall.sh` script to start flashing the binaries to eMMC: + # for AM67A EVM (HS-FS only: by default) + $ snagrecover -s am62p5 -f ./am67a-evm-hsfs.yaml - .. ifconfig:: CONFIG_part_variant in ('AM62X') + produces:: - .. code-block:: console + Starting recovery of am625 board + Installing firmware tiboot3 + Searching for partition id... + Downloading file... + Could not read status after end of manifest phase + Done + Done installing firmware tiboot3 + Installing firmware tispl + Searching for partition id... + Downloading file... + Done + Done installing firmware tispl + Installing firmware u-boot + Searching for partition id... + Downloading file... + Done + Sending detach command... + Done installing firmware u-boot + Installing firmware u-boot + Searching for partition id... + Downloading file... + Done + Sending detach command... + Done installing firmware u-boot + Done recovering am625 board + + - Halt the autoboot countdown by pressing any key:: - # If you are using binaries built locally - $ cd out/target/product/am62x + U-Boot SPL 2023.04-g83660642 (Jul 15 2024 - 11:30:29 +0000) + SYSFW ABI: 4.0 (firmware rev 0x000a '10.0.6--v10.00.06 (Fiery Fox)') + SPL initial stack usage: 17048 bytes + Trying to boot from DFU + ##########################################################DOWNLOAD ... OK + Ctrl+C to exit ... + ##############################################################DOWNLOAD ... OK + Ctrl+C to exit ... + Authentication passed + Authentication passed + Authentication passed + init_env from device 10 not supported! + Authentication passed + Authentication passed + Starting ATF on ARM64 core... - (OR) + NOTICE: BL31: v2.10.0(release):09.02.00.009 + NOTICE: BL31: Built : 11:30:24, Jul 15 2024 - # If you are using pre-built binaries from SDK download page - $ cd AM62x_11.00.01_emmc + U-Boot SPL 2023.04-g83660642 (Jul 15 2024 - 11:30:56 +0000) + SYSFW ABI: 4.0 (firmware rev 0x000a '10.0.6--v10.00.06 (Fiery Fox)') + SPL initial stack usage: 1904 bytes + Trying to boot from DFU + #####DOWNLOAD ... OK + Ctrl+C to exit ... + Authentication passed + Authentication passed + + + U-Boot 2023.04-g83660642 (Jul 15 2024 - 11:30:56 +0000) + + SoC: AM62PX SR1.0 HS-FS + Model: Texas Instruments AM62P5 SK + DRAM: 2 GiB (effective 8 GiB) + Core: 80 devices, 30 uclasses, devicetree: separate + MMC: mmc@fa10000: 0, mmc@fa00000: 1 + Loading Environment from MMC... OK + In: serial + Out: serial + Err: serial + Net: eth0: ethernet@8000000port@1, eth1: ethernet@8000000port@2 + Hit any key to stop autoboot: 0 + => + + * - + - .. _step_5_flashing_instructions: + + Ensure the default U-Boot environment is configured with: - # for AM62x SK EVM (GP) - $ sudo ./flashall.sh --board am62x-sk + .. code-block:: console - # for AM62x SK EVM (HS-FS) - $ sudo ./flashall.sh --board am62x-sk --hsfs + => env default -f -a; saveenv; + ## Resetting to default environment + Saving Environment to MMC... Writing to MMC(0)... OK - # for AM62x LP SK EVM (GP) - $ sudo ./flashall.sh --board am62x-lp-sk + .. tip:: - # for AM62x LP SK EVM (HS-FS) - $ sudo ./flashall.sh --board am62x-lp-sk --hsfs + By default, no Device-Tree Overlays are selected. + Follow this link to configure :ref:`android-dtbo` - board: am62x-sk - Fastboot: ./fastboot - Generating bootloader-am62x-sk.img ... - mkfs.fat 4.2 (2021-01-31) - Generating bootloader-am62x-sk.img: DONE - Create GPT partition table - OKAY [ 0.032s] + * - + - Enable fastboot mode on the device by executing below command. - .. ifconfig:: CONFIG_part_variant in ('AM62PX') + Before running this, make sure USB-C cable is connected from the host PC to the EVM: .. code-block:: console - # If you are using binaries built locally - $ cd out/target/product/am62p + => fastboot 0 - (OR) + * - Run the the :file:`flashall.sh` script to start flashing the binaries to eMMC: - # If you are using pre-built binaries from SDK download page - $ cd AM62Px_11.00.01_emmc + .. ifconfig:: CONFIG_part_variant in ('AM62X') - $ sudo ./flashall.sh --board am62px-sk - board: am62px-sk - Fastboot: ./fastboot - Generating bootloader-am62px-sk.img ... - mkfs.fat 4.2 (2021-01-31) - Generating bootloader-am62px-sk.img: DONE - Create GPT partition table - OKAY [ 0.032s] + .. code-block:: console - .. ifconfig:: CONFIG_part_variant in ('AM67A') + # If you are using binaries built locally + $ cd out/target/product/am62x - .. code-block:: console + (OR) - # If you are using binaries built locally - $ cd out/target/product/am67a + # If you are using pre-built binaries from SDK download page + $ cd AM62x_11.00.01_emmc - (OR) + # for AM62x SK EVM (GP) + $ sudo ./flashall.sh --board am62x-sk - # If you are using pre-built binaries from SDK download page - $ cd AM67A_11.00.01_emmc + # for AM62x SK EVM (HS-FS) + $ sudo ./flashall.sh --board am62x-sk --hsfs - # for AM67A EVM (HS-FS only: by default) - $ sudo ./flashall.sh --board am67a-evm - board: am67a-evm - Fastboot: ./fastboot - Generating bootloader-am67a-evm.img ... - mkfs.fat 4.2 (2021-01-31) - Generating bootloader-am67a-evm.img: DONE - Create GPT partition table - OKAY [ 0.032s] + # for AM62x LP SK EVM (GP) + $ sudo ./flashall.sh --board am62x-lp-sk - - :: + # for AM62x LP SK EVM (HS-FS) + $ sudo ./flashall.sh --board am62x-lp-sk --hsfs - Writing GPT: success! - dwc3-generic-peripheral usb@31000000: request 00000000f7ec4040 was not queued to ep1in-bulk - ** Bad device specification mmc tiboot3_a ** - ** Bad device specification mmc tiboot3_a ** - Couldn't find partition mmc tiboot3_a - dwc3-generic-peripheral usb@31000000: request 00000000f7ec4040 was not queued to ep1in-bulk + board: am62x-sk + Fastboot: ./fastboot + Generating boot loader image ... + mkfs.fat 4.2 (2021-01-31) + Generating boot loader image: DONE + Create GPT partition table + OKAY [ 0.032s] + .. ifconfig:: CONFIG_part_variant in ('AM62PX') + .. code-block:: console -.. tip:: + # If you are using binaries built locally + $ cd out/target/product/am62p + + (OR) + + # If you are using pre-built binaries from SDK download page + $ cd AM62Px_11.00.01_emmc + + $ sudo ./flashall.sh --board am62px-sk + board: am62px-sk + Fastboot: ./fastboot + Generating boot loader image ... + mkfs.fat 4.2 (2021-01-31) + Generating boot loader image: DONE + Create GPT partition table + OKAY [ 0.032s] + + .. ifconfig:: CONFIG_part_variant in ('AM67A') - If you get ``mcopy`` command not found error on Linux PC, install the ``mtools`` package: + .. code-block:: console - .. code-block:: console + # If you are using binaries built locally + $ cd out/target/product/am67a - $ apt-get install mtools + (OR) -.. warning:: + # If you are using pre-built binaries from SDK download page + $ cd AM67A_11.00.01_emmc - It's possible that the in-memory partition layout is still from an older system. + # for AM67A EVM (HS-FS only: by default) + $ sudo ./flashall.sh --board am67a-evm + board: am67a-evm + Fastboot: ./fastboot + Generating boot loader image ... + mkfs.fat 4.2 (2021-01-31) + Generating boot loader image: DONE + Create GPT partition table + OKAY [ 0.032s] - In that case, we can observe flashing errors similar to:: + - :: - writing 'tiboot3'... - FAILED (remote: invalid partition or device) + Writing GPT: success! + dwc3-generic-peripheral usb@31000000: request 00000000f7ec4040 was not queued to ep1in-bulk + ** Bad device specification mmc tiboot3_a ** + ** Bad device specification mmc tiboot3_a ** + Couldn't find partition mmc tiboot3_a + dwc3-generic-peripheral usb@31000000: request 00000000f7ec4040 was not queued to ep1in-bulk - When that happens: - 1. Reboot into the newly flashed bootloader with ``$ fastboot reboot bootloader`` - 2. Restart the flashing from :ref:`U-Boot environment `. + .. tip:: -5. Once the flashing is complete, power off the board + If you get ``mcopy`` command not found error on Linux PC, install the ``mtools`` package: -6. Change boot mode DIP switches to boot from eMMC user partitions and power cycle the board: + .. code-block:: console + + $ apt-get install mtools + + .. warning:: + + It's possible that the in-memory partition layout is still from an older system. + + In that case, we can observe flashing errors similar to:: + + writing 'tiboot3'... + FAILED (remote: invalid partition or device) + + When that happens: + + 1. Reboot into the newly flashed boot loader with ``$ fastboot reboot bootloader`` + 2. Restart the flashing from :ref:`U-Boot environment `. + + +#. Once the flashing is complete, power off the board + +#. Change boot mode DIP switches to boot from eMMC user partitions and power cycle the board: .. ifconfig:: CONFIG_part_variant in ('AM62X') @@ -437,5 +437,4 @@ Once the build is complete, follow the steps below to flash the images to eMMC. - 00000000 -7. Board should boot the Android images now. - +#. Board should boot the Android images now.