Android Release 11 00 00

.rstcheck.cfg

@@ -3,5 +3,5 @@ ignore_directives = ifconfig
 # ignore the following languages because they require external compilers and
 # snippets in this repo depend on external code
 ignore_languages = c,cpp,c++
-ignore_substitutions = __PART_FAMILY_NAME__,__PART_FAMILY_DEVICE_NAMES__,__PRODUCT_LINE_NAME__,__SDK_BUILD_MACHINE__,__SDK_FULL_NAME__,__SDK_SHORT_NAME__,__SDK_INSTALL_FILE__,__SDK_INSTALL_DIR__,__SDK_DOWNLOAD_URL__,__LINUX_UBUNTU_VERSION_LONG__,__LINUX_UBUNTU_VERSION_SHORT__,__OPTEE_PLATFORM_FLAVOR__,__RTOS_UBUNTU_VERSION_LONG__,__WINDOWS_SUPPORTED_LONG__,__FEATURINGMATRIX__,__SYSFW_CORE_NAME__,__PCIE_BASE_ADDRESS__,__PCIE_DEVICE_ID__,__IMAGE_TYPE__
+ignore_substitutions = __PART_FAMILY_NAME__,__PART_FAMILY_DEVICE_NAMES__,__PRODUCT_LINE_NAME__,__SDK_BUILD_MACHINE__,__SDK_FULL_NAME__,__SDK_SHORT_NAME__,__SDK_INSTALL_FILE__,__SDK_INSTALL_DIR__,__SDK_DOWNLOAD_URL__,__LINUX_UBUNTU_VERSION_LONG__,__LINUX_UBUNTU_VERSION_SHORT__,__OPTEE_PLATFORM_FLAVOR__,__RTOS_UBUNTU_VERSION_LONG__,__WINDOWS_SUPPORTED_LONG__,__FEATURINGMATRIX__,__SYSFW_CORE_NAME__,__PCIE_BASE_ADDRESS__,__PCIE_DEVICE_ID__,__IMAGE_TYPE__,__SDK_OS_NAME__
 ignore_messages = (Hyperlink target.*is not referenced\.)

Makefile

@@ -21,10 +21,20 @@ $(info ROOTDIR is $(ROOTDIR))
 
 $(info DEVFAMILY is $(DEVFAMILY_UP))
 
-ifeq ($(DEVFAMILY_UP), $(filter $(DEVFAMILY_UP), J721E J7200 J721S2 J784S4 AM68 AM69 J722S AM67 J742S2 AM68A AM67A AM69A TDA4VM))
-  CONFDIR = source/devices/J7_Family/${OS_LOW}
+ifeq ($(OS_LOW), android)
+  # For Android, AM67A and AM67 have their own device directories
+  ifeq ($(DEVFAMILY_UP), $(filter $(DEVFAMILY_UP), J721E J7200 J721S2 J784S4 AM68 AM69 J722S J742S2 AM68A AM69A TDA4VM))
+    CONFDIR = source/devices/J7_Family/${OS_LOW}
+  else
+    CONFDIR = source/devices/$(DEVFAMILY_UP)/${OS_LOW}
+  endif
 else
-  CONFDIR = source/devices/$(DEVFAMILY_UP)/${OS_LOW}
+  # For Linux and other OSes, use J7_Family grouping including AM67A and AM67
+  ifeq ($(DEVFAMILY_UP), $(filter $(DEVFAMILY_UP), J721E J7200 J721S2 J784S4 AM68 AM69 J722S AM67 J742S2 AM68A AM67A AM69A TDA4VM))
+    CONFDIR = source/devices/J7_Family/${OS_LOW}
+  else
+    CONFDIR = source/devices/$(DEVFAMILY_UP)/${OS_LOW}
+  endif
 endif
 
 $(info CONFDIR is $(CONFDIR))

configs/AM62PX/AM62PX_android_toc.txt

@@ -2,16 +2,18 @@ devices/AM62PX/android/index
 devices/AM62PX/android/Release_Specific
 devices/AM62PX/android/Release_Specific_Release_Notes
 devices/AM62PX/android/Application_Notes
-devices/AM62PX/android/Application_Notes_Partitions
 devices/AM62PX/android/Application_Notes_dtbo_support
-devices/AM62PX/android/Application_Notes_Android_Bootloader_SD_Card
-devices/AM62PX/android/Application_Notes_Android_SD_CARD
-devices/AM62PX/android/Application_Notes_Android_Dual_Screen
-devices/AM62PX/android/Application_Notes_Android_Low_Power
-devices/AM62PX/android/Application_Notes_Camera
-devices/AM62PX/android/Application_Notes_Android_Multimedia_Video
-devices/AM62PX/android/Application_Notes_Sample_Maps_App
 
+android/Application_Notes_Android_Bootloader_SD_Card
+android/Application_Notes_Android_Dual_Screen
+android/Application_Notes_Android_Low_Power
+android/Application_Notes_Android_Multimedia_Video
+android/Application_Notes_Android_SD_CARD
+android/Application_Notes_Android_Secure_Build
+android/Application_Notes_Camera
+android/Application_Notes_Partitions
+android/Application_Notes_Sample_Maps_App
+android/Application_Notes_Simple_UI_App
 android/Overview_Getting_Started_Guide
 android/Overview_Building_the_SDK
 android/Overview

configs/AM62X/AM62X_android_toc.txt

@@ -2,16 +2,18 @@ devices/AM62X/android/index
 devices/AM62X/android/Release_Specific
 devices/AM62X/android/Release_Specific_Release_Notes
 devices/AM62X/android/Application_Notes
-devices/AM62X/android/Application_Notes_Partitions
 devices/AM62X/android/Application_Notes_dtbo_support
-devices/AM62X/android/Application_Notes_Android_Bootloader_SD_Card
-devices/AM62X/android/Application_Notes_Android_SD_CARD
-devices/AM62X/android/Application_Notes_Android_Dual_Screen
-devices/AM62X/android/Application_Notes_Android_Low_Power
-devices/AM62X/android/Application_Notes_Camera
-devices/AM62X/android/Application_Notes_Simple_UI_App
 devices/AM62X/android/Application_Notes_BeaglePlay
 
+android/Application_Notes_Android_Bootloader_SD_Card
+android/Application_Notes_Android_Dual_Screen
+android/Application_Notes_Android_Low_Power
+android/Application_Notes_Android_SD_CARD
+android/Application_Notes_Android_Secure_Build
+android/Application_Notes_Camera
+android/Application_Notes_Partitions
+android/Application_Notes_Sample_Maps_App
+android/Application_Notes_Simple_UI_App
 android/Overview_Getting_Started_Guide
 android/Overview_Building_the_SDK
 android/Overview

configs/AM67A/AM67A_android_config.txt

@@ -0,0 +1,38 @@
+# General family replacement variables and configuration values for Android build
+
+# This file is processed by Python scripts to define both replacement
+# variable and configuration values for a device family build.
+# For replacement variables, all variables should be listed on a single
+# line, and all the variables should be listed on consecutive lines
+# (i.e. no additional blank lines between the replacement variables).
+# Similarly, all the configuration values should be listed on individual,
+# consecutive lines (with no blank linues between the configuration values).
+#
+# Note that neither replacement variables nor configuration values may contain
+# a colon (i.e. ":") in their name.  However, values may contain colons.
+
+Replacement Variables
+---------------------
+'__PART_FAMILY_NAME__'           : 'AM67A'
+'__PART_FAMILY_DEVICE_NAMES__'   : 'AM67A'
+'__PRODUCT_LINE_NAME__'          : 'Sitara MPU'
+'__SDK_OS_NAME__'                : 'Processor SDK Android'
+'__SDK_FULL_NAME__'              : 'Processor SDK Android AM67A'
+'__SDK_SHORT_NAME__'             : 'PSDKA'
+'__LINUX_UBUNTU_VERSION_LONG__'  : '22.04 (64-bit)'
+'__LINUX_UBUNTU_VERSION_SHORT__' : '22.04'
+'__RTOS_UBUNTU_VERSION_LONG__'   : '22.04 (64-bit), 16.04 (64-bit)'
+'__WINDOWS_SUPPORTED_LONG__'     : '10 (64-bit)'
+'__FEATURINGMATRIX__'            : \
+'__SYSFW_CORE_NAME__'            : 'TIFS'
+
+Configuration Values
+--------------------
+'CONFIG_part_family'      : 'AM67A_family'
+'CONFIG_part_variant'     : 'AM67A'
+'CONFIG_sdk'              : 'PSDKA'
+'CONFIG_icss_support'     : 'no'
+'CONFIG_rt_linux_support' : 'no'
+'CONFIG_gpu_ip'           : 'Rogue_BXS'
+'CONFIG_crypto'           : 'sa2ul'
+'CONFIG_mcrc'             : 'mcrc'

configs/AM67A/AM67A_android_tags.py

@@ -0,0 +1,9 @@
+# Device Family name
+fam_name = 'AM67A'
+
+# Project name and HTML title
+project = u'Processor SDK Android for AM67A'
+html_title = 'Processor SDK AM67A Documentation'
+
+# The master toctree document.
+master_doc = 'devices/AM67A/android/index'

configs/AM67A/AM67A_android_toc.txt

@@ -0,0 +1,26 @@
+devices/AM67A/android/index
+devices/AM67A/android/Release_Specific
+devices/AM67A/android/Release_Specific_Release_Notes
+devices/AM67A/android/Application_Notes
+devices/AM67A/android/Application_Notes_dtbo_support
+devices/AM67A/android/Application_Notes_BeagleY_AI
+
+android/Application_Notes_Android_Bootloader_SD_Card
+android/Application_Notes_Android_Dual_Screen
+android/Application_Notes_Android_Multimedia_Video
+android/Application_Notes_Android_SD_CARD
+android/Application_Notes_Android_Secure_Build
+android/Application_Notes_Camera
+android/Application_Notes_Partitions
+android/Application_Notes_Sample_Maps_App
+android/Application_Notes_Simple_UI_App
+android/Overview_Getting_Started_Guide
+android/Overview_Building_the_SDK
+android/Overview
+android/Overview_Technical_Support
+android/Overview_Flashing
+
+android/Foundational_Components
+android/Foundational_Components_Kernel
+android/Foundational_Components_Bootloaders
+android/Foundational_Components_OTA

source/android/Application_Notes_Android_Bootloader_SD_Card.rst

@@ -0,0 +1,178 @@
+.. _android-bootloader-sdcard:
+
+#############################
+Android Bootloader on SD Card
+#############################
+
+This application note contains steps to flash initial bootloaders
+from SD Card instead of using snagboot.
+
+****************
+SD Card Creation
+****************
+
+In order to flash the AM62x board's eMMC the fist time, a SD card containing the required bootloaders will have to be used
+to boot into U-Boot and use fastboot.
+
+.. warning::
+
+   Make sure to use the same bootloaders as the release you are flashing.
+   The latest release is ``11.00.00``.
+
+Identify the SD Card
+====================
+
+To start, identify your SD card with:
+
+.. code-block:: console
+
+   $ sudo fdisk -l
+
+In this example, the SD card will be: ``/dev/mmcblk0``.
+
+Prepare the SD Card
+===================
+
+The preparation of the SD Card is done via the :file:`flashall.sh` script.
+Make sure to identify the board model, and the SD card path.
+
+Then, run:
+
+.. ifconfig:: CONFIG_part_variant in ('AM62X')
+
+   .. 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.00_emmc
+
+      # for AM62x SK EVM (GP)
+      $ sudo ./flashall.sh --board am62x-sk --bootloader --sdcard /dev/mmcblk0
+
+      # for AM62x SK EVM (HS-FS)
+      $ sudo ./flashall.sh --board am62x-sk --hsfs --bootloader --sdcard /dev/mmcblk0
+
+      # for AM62x LP SK EVM (GP)
+      $ sudo ./flashall.sh --board am62x-lp-sk --bootloader --sdcard /dev/mmcblk0
+
+      # for AM62x LP SK EVM (HS-FS)
+      $ sudo ./flashall.sh --board am62x-lp-sk --bootloader --hsfs --sdcard /dev/mmcblk0
+
+.. 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.00_emmc
+
+      $ sudo ./flashall.sh --board am62px-sk --bootloader --sdcard /dev/mmcblk0
+
+.. 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.00_emmc
+
+      # for AM67a EVM (HS-FS only)
+      $ sudo ./flashall.sh --board am67a-evm --bootloader --sdcard /dev/mmcblk0
+
+*************
+eMMC flashing
+*************
+
+Flashing instructions
+=====================
+
+Once the build is complete, follow the steps below to flash the images to eMMC.
+Use the SD card created in previous step to get started.
+
+Procedure is same whether the pre-built images from SDK download page is used or
+the images are built from source.
+
+1. Change the Boot Mode DIP switches to SD card boot mode:
+
+   .. ifconfig:: CONFIG_part_variant in ('AM62X')
+
+      .. list-table::
+         :widths: 16 16 16
+         :header-rows: 1
+
+         * - Switch Label
+           - SW2: 12345678
+           - SW3: 12345678
+
+         * - SD
+           - 01000000
+           - 11000010
+
+   .. ifconfig:: CONFIG_part_variant in ('AM62PX')
+
+      .. list-table::
+         :widths: 16 16 16
+         :header-rows: 1
+
+         * - Switch Label
+           - SW5: 12345678
+           - SW4: 12345678
+
+         * - SD
+           - 01000000
+           - 11000010
+
+   .. ifconfig:: CONFIG_part_variant in ('AM67A')
+
+      .. list-table::
+         :widths: 16 16 16
+         :header-rows: 1
+
+         * - Switch Label
+           - SW3: 12345678
+           - SW4: 12345678
+
+         * - SD
+           - 11000010
+           - 01000000
+
+2. Insert the SD card into the |__PART_FAMILY_NAME__| SK EVM.
+
+3. Ensure the device is plugged in with USB host and debug UART/serial debug
+
+4. Open a terminal debugger to view console output from the device:
+
+   .. ifconfig:: CONFIG_part_variant in ('AM62X','AM62PX')
+
+      .. code-block:: console
+
+         $ sudo picocom -b 115200 -r -l /dev/ttyUSB0
+
+   .. ifconfig:: CONFIG_part_variant in ('AM67A')
+
+      .. code-block:: console
+
+         $ sudo picocom -b 115200 -r -l /dev/ttyUSB2
+
+5. Boot the board with SD card.
+
+6. Stop at U-Boot console (interrupt the auto-boot countdown) and do below commands to setup Android
+   partition table:
+
+   .. code-block:: console
+
+      => env default -f -a; saveenv
+
+Then, continue following the default :ref:`flashing instructions from step 5<step_5_flashing_instructions>`.