Skip to content

Commit 6018356

Browse files
glaroquepraneethbajjuri
glaroque
authored and
praneethbajjuri
committed
feat(android): rework Applications Notes
Most of Application Notes were same for android board so move them in generic folder source/android and update it to support multiple Boards. Signed-off-by: Guillaume La Roque <glaroque@baylibre.com>
1 parent d286ced commit 6018356

21 files changed

Lines changed: 327 additions & 732 deletions

‎configs/AM62PX/AM62PX_android_toc.txt‎

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,17 @@ devices/AM62PX/android/index
22
devices/AM62PX/android/Release_Specific
33
devices/AM62PX/android/Release_Specific_Release_Notes
44
devices/AM62PX/android/Application_Notes
5-
devices/AM62PX/android/Application_Notes_Partitions
65
devices/AM62PX/android/Application_Notes_dtbo_support
7-
devices/AM62PX/android/Application_Notes_Android_Bootloader_SD_Card
8-
devices/AM62PX/android/Application_Notes_Android_SD_CARD
9-
devices/AM62PX/android/Application_Notes_Android_Dual_Screen
10-
devices/AM62PX/android/Application_Notes_Android_Low_Power
11-
devices/AM62PX/android/Application_Notes_Camera
12-
devices/AM62PX/android/Application_Notes_Android_Multimedia_Video
13-
devices/AM62PX/android/Application_Notes_Sample_Maps_App
146

7+
android/Application_Notes_Android_Bootloader_SD_Card
8+
android/Application_Notes_Android_Dual_Screen
9+
android/Application_Notes_Android_Low_Power
10+
android/Application_Notes_Android_Multimedia_Video
11+
android/Application_Notes_Android_SD_CARD
12+
android/Application_Notes_Camera
13+
android/Application_Notes_Partitions
14+
android/Application_Notes_Sample_Maps_App
15+
android/Application_Notes_Simple_UI_App
1516
android/Overview_Getting_Started_Guide
1617
android/Overview_Building_the_SDK
1718
android/Overview

‎configs/AM62X/AM62X_android_toc.txt‎

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,17 @@ devices/AM62X/android/index
22
devices/AM62X/android/Release_Specific
33
devices/AM62X/android/Release_Specific_Release_Notes
44
devices/AM62X/android/Application_Notes
5-
devices/AM62X/android/Application_Notes_Partitions
65
devices/AM62X/android/Application_Notes_dtbo_support
7-
devices/AM62X/android/Application_Notes_Android_Bootloader_SD_Card
8-
devices/AM62X/android/Application_Notes_Android_SD_CARD
9-
devices/AM62X/android/Application_Notes_Android_Dual_Screen
10-
devices/AM62X/android/Application_Notes_Android_Low_Power
11-
devices/AM62X/android/Application_Notes_Camera
12-
devices/AM62X/android/Application_Notes_Simple_UI_App
136
devices/AM62X/android/Application_Notes_BeaglePlay
147

8+
android/Application_Notes_Android_Bootloader_SD_Card
9+
android/Application_Notes_Android_Dual_Screen
10+
android/Application_Notes_Android_Low_Power
11+
android/Application_Notes_Android_SD_CARD
12+
android/Application_Notes_Camera
13+
android/Application_Notes_Partitions
14+
android/Application_Notes_Sample_Maps_App
15+
android/Application_Notes_Simple_UI_App
1516
android/Overview_Getting_Started_Guide
1617
android/Overview_Building_the_SDK
1718
android/Overview

‎source/android/Application_Notes_Android_Bootloader_SD_Card.rst‎

Lines changed: 158 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,158 @@
1+
.. _android-bootloader-sdcard:
2+
3+
#############################
4+
Android Bootloader on SD Card
5+
#############################
6+
7+
This application note contains steps to flash initial bootloaders
8+
from SD Card instead of using snagboot.
9+
10+
****************
11+
SD Card Creation
12+
****************
13+
14+
In order to flash the AM62x board's eMMC the fist time, a SD card containing the required bootloaders will have to be used
15+
to boot into U-Boot and use fastboot.
16+
17+
.. warning::
18+
19+
Make sure to use the same bootloaders as the release you are flashing.
20+
The latest release is ``11.00.00``.
21+
22+
Identify the SD Card
23+
====================
24+
25+
To start, identify your SD card with:
26+
27+
.. code-block:: console
28+
29+
$ sudo fdisk -l
30+
31+
In this example, the SD card will be: ``/dev/mmcblk0``.
32+
33+
Prepare the SD Card
34+
===================
35+
36+
The preparation of the SD Card is done via the :file:`flashall.sh` script.
37+
Make sure to identify the board model, and the SD card path.
38+
39+
Then, run:
40+
41+
.. ifconfig:: CONFIG_part_variant in ('AM62X')
42+
43+
.. code-block:: console
44+
45+
# If you are using binaries built locally
46+
$ cd out/target/product/am62x
47+
48+
(OR)
49+
50+
# If you are using pre-built binaries from SDK download page
51+
$ cd AM62x_11.00.00_emmc
52+
53+
# for AM62x SK EVM (GP)
54+
$ sudo ./flashall.sh --board am62x-sk --bootloader --sdcard /dev/mmcblk0
55+
56+
# for AM62x SK EVM (HS-FS)
57+
$ sudo ./flashall.sh --board am62x-sk --hsfs --bootloader --sdcard /dev/mmcblk0
58+
59+
# for AM62x LP SK EVM (GP)
60+
$ sudo ./flashall.sh --board am62x-lp-sk --bootloader --sdcard /dev/mmcblk0
61+
62+
# for AM62x LP SK EVM (HS-FS)
63+
$ sudo ./flashall.sh --board am62x-lp-sk --bootloader --hsfs --sdcard /dev/mmcblk0
64+
65+
.. ifconfig:: CONFIG_part_variant in ('AM62PX')
66+
67+
.. code-block:: console
68+
69+
# If you are using binaries built locally
70+
$ cd out/target/product/am62p
71+
72+
(OR)
73+
74+
# If you are using pre-built binaries from SDK download page
75+
$ cd AM62Px_11.00.00_emmc
76+
77+
$ sudo ./flashall.sh --board am62px-sk --bootloader --sdcard /dev/mmcblk0
78+
79+
.. ifconfig:: CONFIG_part_variant in ('AM67A')
80+
81+
.. code-block:: console
82+
83+
# If you are using binaries built locally
84+
$ cd out/target/product/am67a
85+
86+
(OR)
87+
88+
# If you are using pre-built binaries from SDK download page
89+
$ cd AM67A_11.00.00_emmc
90+
91+
# for AM67a EVM (HS-FS only)
92+
$ sudo ./flashall.sh --board am67a-evm --bootloader --sdcard /dev/mmcblk0
93+
94+
*************
95+
eMMC flashing
96+
*************
97+
98+
Flashing instructions
99+
=====================
100+
101+
Once the build is complete, follow the steps below to flash the images to eMMC.
102+
Use the SD card created in previous step to get started.
103+
104+
Procedure is same whether the pre-built images from SDK download page is used or
105+
the images are built from source.
106+
107+
1. Change the Boot Mode DIP switches to SD card boot mode:
108+
109+
.. ifconfig:: CONFIG_part_variant in ('AM62X')
110+
111+
.. list-table::
112+
:widths: 16 16 16
113+
:header-rows: 1
114+
115+
* - Switch Label
116+
- SW2: 12345678
117+
- SW3: 12345678
118+
119+
* - SD
120+
- 01000000
121+
- 11000010
122+
123+
.. ifconfig:: CONFIG_part_variant in ('AM62PX')
124+
125+
.. list-table::
126+
:widths: 16 16 16
127+
:header-rows: 1
128+
129+
* - Switch Label
130+
- SW5: 12345678
131+
- SW4: 12345678
132+
133+
* - SD
134+
- 01000000
135+
- 11000010
136+
137+
2. Insert the SD card into the |__PART_FAMILY_NAME__| SK EVM.
138+
139+
3. Ensure the device is plugged in with USB host and debug UART/serial debug
140+
141+
4. Open a terminal debugger to view console output from the device:
142+
143+
.. ifconfig:: CONFIG_part_variant in ('AM62X','AM62PX')
144+
145+
.. code-block:: console
146+
147+
$ sudo picocom -b 115200 -r -l /dev/ttyUSB0
148+
149+
5. Boot the board with SD card.
150+
151+
6. Stop at U-Boot console (interrupt the auto-boot countdown) and do below commands to setup Android
152+
partition table:
153+
154+
.. code-block:: console
155+
156+
=> env default -f -a; saveenv
157+
158+
Then, continue following the default :ref:`flashing instructions from step 5<step_5_flashing_instructions>`.

source/devices/AM62X/android/Application_Notes_Android_Dual_Screen.rst renamed to source/android/Application_Notes_Android_Dual_Screen.rst

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,48 +4,50 @@ Android Dual Screen Support
44

55
This application note contains steps to enable dual screen with Android in mirror mode or extended mode.
66

7-
The following panel is currently supported with the AM625 SK EVM revision E3 board:
7+
The following panel is currently supported with the |__PART_FAMILY_NAME__| SK EVM revision E3 board:
88

99
- **Microtips Technology USA (13-101HIEB0HF0-S) 10.1" WUXGA (1920x1200) TFT LCD panel**
1010

1111
.. note::
1212

1313
By default Android configures the displays in mirror mode.
1414

15-
*************************************************
16-
How to enable Microtips LVDS panel on AM62 SK EVM
17-
*************************************************
15+
*******************************************************************
16+
How to enable Microtips LVDS panel on |__PART_FAMILY_NAME__| SK EVM
17+
*******************************************************************
1818

1919
**Steps to enable OLDI Panel DT overlay:**
2020

2121
#. Follow the :ref:`android-dtbo` guide.
2222

23-
**Steps to enable touch on the Microtips Panel on AM625 SK EVM:**
23+
.. ifconfig:: CONFIG_part_variant in ('AM62X')
2424

25-
**Note**: The following steps are only applicable on AM625 SK EVM revision E3 board.
25+
**Steps to enable touch on the Microtips Panel on AM625 SK EVM:**
2626

27-
#. Power off the LVDS board by disconnecting the 12V barrel jack (do not power off the SK EVM)
28-
#. Run the following commands from the Linux prompt:
27+
**Note**: The following steps are only applicable on AM625 SK EVM revision E3 board.
2928

30-
.. code-block:: console
29+
#. Power off the LVDS board by disconnecting the 12V barrel jack (do not power off the SK EVM)
30+
#. Run the following commands from the Linux prompt:
3131

32-
console:/ $ su
33-
console:/ # rmmod ili210x
34-
console:/ # i2ctransfer -f -y 0 w3@0x3f 0x09 0x1 0x0e
35-
console:/ # i2ctransfer -f -y 0 w6@0x3f 0x08 0x04 0x47 0x50 0x73 0x68
32+
.. code-block:: console
3633
37-
#. Power on the LVDS board
38-
#. Run the following command:
34+
console:/ $ su
35+
console:/ # rmmod ili210x
36+
console:/ # i2ctransfer -f -y 0 w3@0x3f 0x09 0x1 0x0e
37+
console:/ # i2ctransfer -f -y 0 w6@0x3f 0x08 0x04 0x47 0x50 0x73 0x68
3938
40-
.. code-block:: console
39+
#. Power on the LVDS board
40+
#. Run the following command:
4141

42-
console:/ # insmod /vendor/lib/modules/ili210x.ko
42+
.. code-block:: console
4343
44-
After re-initializing the module, the touch IC should now be registered as an input and touch should be functional.
44+
console:/ # insmod /vendor/lib/modules/ili210x.ko
4545
46-
.. attention::
46+
After re-initializing the module, the touch IC should now be registered as an input and touch should be functional.
4747

48-
This step need to be done each time the board reboots.
48+
.. attention::
49+
50+
This step need to be done each time the board reboots.
4951

5052
*****************************************
5153
How to enable Extended Display in Android

source/devices/AM62PX/android/Application_Notes_Android_Low_Power.rst renamed to source/android/Application_Notes_Android_Low_Power.rst

File renamed without changes.

source/devices/AM62PX/android/Application_Notes_Android_Multimedia_Video.rst renamed to source/android/Application_Notes_Android_Multimedia_Video.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Android Multimedia (Video encode/decode)
55
########################################
66

77
This application note describes video decoding/encoding using the onboard Wave5 chip
8-
found in the Texas Instruments AM62Px SoC.
8+
found in the Texas Instruments |__PART_FAMILY_NAME__| SoC.
99

1010
The Wave5 hardware is implemented via:
1111

@@ -29,7 +29,7 @@ We can run a sample playback via ``atest`` from a development tree.
2929
.. code-block:: console
3030
3131
# Standard Android build commands
32-
$ cd ${YOUR_PATH}/ti-aosp-15
32+
$ cd ${YOUR_PATH}/ti-aosp-16
3333
$ source build/envsetup.sh
3434
$ lunch <BUILD_TARGET>
3535
@@ -145,5 +145,5 @@ To enable more logs, ``v4l2_codec2`` should be rebuild. It's possible to enable
145145

146146
.. code-block:: console
147147
148-
$ cd ~/src/ti-aosp-15/external/v4l2_codec2
148+
$ cd ~/src/ti-aosp-16/external/v4l2_codec2
149149
$ sed -i 's#//\#define LOG_NDEBUG 0#\#define LOG_NDEBUG 0#' *.cpp

source/devices/AM62X/android/Application_Notes_Android_SD_CARD.rst renamed to source/android/Application_Notes_Android_SD_CARD.rst

Lines changed: 33 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,13 @@ Build U-Boot
5252

5353
Follow this link to build the :ref:`android-build-bootloaders`.
5454

55-
Rebuild U-Boot then copy :file:`u-boot.img` in Android build system environment : :file:`vendor/ti/am62x/bootloader/am62-sk`
55+
.. ifconfig:: CONFIG_part_variant in ('AM62X')
56+
57+
Rebuild U-Boot then copy :file:`u-boot.img` in Android build system environment : :file:`vendor/ti/am62x/bootloader/am62-sk`
58+
59+
.. ifconfig:: CONFIG_part_variant in ('AM62PX')
60+
61+
Rebuild U-Boot then copy :file:`u-boot.img` in Android build system environment : :file:`vendor/ti/am62x/bootloader/am62px-sk`
5662

5763
Build Android
5864
=============
@@ -62,7 +68,7 @@ Go in your Android environment then rebuild with ``TARGET_SDCARD_BOOT=true`` bui
6268

6369
.. code-block:: console
6470
65-
$ cd ${YOUR_PATH}/ti-aosp-15
71+
$ cd ${YOUR_PATH}/ti-aosp-16
6672
$ source build/envsetup.sh
6773
$ lunch <BUILD_TARGET>
6874
$ m TARGET_SDCARD_BOOT=true
@@ -77,17 +83,33 @@ Flashing SD Card
7783

7884
- Change the boot mode DIP switches to SD card boot mode:
7985

80-
.. list-table::
81-
:widths: 16 16 16
82-
:header-rows: 1
86+
.. ifconfig:: CONFIG_part_variant in ('AM62X')
87+
88+
.. list-table::
89+
:widths: 16 16 16
90+
:header-rows: 1
91+
92+
* - Switch Label
93+
- SW2: 12345678
94+
- SW3: 12345678
95+
96+
* - SD
97+
- 01000000
98+
- 11000010
99+
100+
.. ifconfig:: CONFIG_part_variant in ('AM62PX')
101+
102+
.. list-table::
103+
:widths: 16 16 16
104+
:header-rows: 1
83105

84-
* - Switch Label
85-
- SW2: 12345678
86-
- SW3: 12345678
106+
* - Switch Label
107+
- SW5: 12345678
108+
- SW4: 12345678
87109

88-
* - SD
89-
- 01000000
90-
- 11000010
110+
* - SD
111+
- 01000000
112+
- 11000010
91113

92114
- Go in :file:`out` directory in android environment.
93115

0 commit comments

Comments
 (0)