Skip to content

Commit c10e4a6

Browse files
cshilwantVeeruPrudhvi
authored andcommitted
feat(edgeai): Add a guide on EdgeAI memory carveout overlay
* From SDK 11.1, the EdgeAI memory carveouts are maintained as a separate overlay - k3-am62a7-sk-edgeai.dtbo Hence, add an FAQ for users on the same * While at it, also fix the faq.rst to follow guidelines for section headers as per [0] [0]: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#sections Signed-off-by: Chirag Shilwant <[email protected]>
1 parent 8001858 commit c10e4a6

File tree

1 file changed

+57
-3
lines changed
  • source/devices/AM62AX/edgeai

1 file changed

+57
-3
lines changed

source/devices/AM62AX/edgeai/faq.rst

Lines changed: 57 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,67 @@
11
.. _pub_edgeai_FAQs:
22

3-
====
3+
####
44
FAQs
5-
====
5+
####
6+
7+
.. _pub_edgeai_overlay:
8+
9+
*****************************************************************************************************************************************
10+
Why does "ERROR: Unable to map memory @ 0xa2000000..." appear after applying a custom DTBO using name_overlays from SDK 11.1 with EdgeAI?
11+
*****************************************************************************************************************************************
12+
13+
Background
14+
==========
15+
16+
Starting with Processor SDK 11.1, the :file:`k3-am62a7-sk-edgeai.dtbo` overlay is automatically applied by default in the AM62A board environment (``ti-u-boot``).
17+
This is set via the ``name_overlays`` variable in U-Boot, as seen in `board/ti/am62ax/am62ax.env <https://git.ti.com/cgit/ti-u-boot/ti-u-boot/tree/board/ti/am62ax/am62ax.env?h=11.01.05#n22>`__
18+
19+
Issue
20+
=====
21+
22+
If you add or override overlays using :file:`uEnv.txt` (e.g. for enabling IMX219 camera support), you may unintentionally replace the default ``name_overlays`` value.
23+
This means the essential EdgeAI memory carve-out overlay (:file:`k3-am62a7-sk-edgeai.dtbo`) is no longer applied.
24+
As a result, EdgeAI applications may fail to allocate memory, showing errors such as:
25+
26+
.. code-block:: console
27+
28+
APP_LOG: ERROR: Unable to map memory @ 0xa2000000 of size 3288576 bytes !!!
29+
30+
Who is affected?
31+
================
32+
33+
EdgeAI users upgrading to SDK 11.1 (or newer) who apply custom device tree overlays and do not re-apply the EdgeAI carve-out overlay.
34+
35+
Solution
36+
========
37+
38+
Always include :file:`k3-am62a7-sk-edgeai.dtbo` in your overlays when customizing ``name_overlays`` in :file:`uEnv.txt` or at the U-Boot prompt.
39+
For example - To enable IMX219 camera support
40+
41+
.. code-block:: console
42+
43+
name_overlays=ti/k3-am62a7-sk-edgeai.dtbo ti/k3-am62x-sk-csi2-imx219.dtbo
44+
45+
This ensures the memory region required by EdgeAI applications is reserved.
46+
47+
Summary Table
48+
-------------
49+
50+
.. csv-table:: Summary
51+
:header: "SDK Version","Default EdgeAI Overlay","Action Needed When Customizing Overlays"
52+
53+
"≤ 10.1", "None", "Only add your required overlays"
54+
"≥ 11.1", "EdgeAI overlay applied", "Must re-apply EdgeAI overlay when overriding `name_overlays`"
55+
56+
.. tip::
57+
58+
If you encounter memory mapping errors after customizing overlays, verify that the EdgeAI carve-out overlay is present in your configuration.
659

760
.. _pub_edgeai_multiple_usb_cams:
861

62+
*****************************************************************************
963
Getting Error when trying to capture from multiple USB cameras simultaneously
10-
=============================================================================
64+
*****************************************************************************
1165

1266
This is a common issue faced in the industry with many USB cameras.
1367
You may get errors like ``Failed to allocate required memory.`` when tying to

0 commit comments

Comments
 (0)