Skip to content

feat(edgeai): Add a guide on EdgeAI memory carveout overlay #375

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
VeeruPrudhvi merged 1 commit into from
Jul 14, 2025
Merged

feat(edgeai): Add a guide on EdgeAI memory carveout overlay #375

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 57 additions & 3 deletions source/devices/AM62AX/edgeai/faq.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,67 @@
.. _pub_edgeai_FAQs:

====
####
FAQs
====
####

.. _pub_edgeai_overlay:

*****************************************************************************************************************************************
Why does "ERROR: Unable to map memory @ 0xa2000000..." appear after applying a custom DTBO using name_overlays from SDK 11.1 with EdgeAI?

Check warning on line 10 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.HeadingPunctuation] Do not use end punctuation in headings.

Raw Output:
{"message": "[RedHat.HeadingPunctuation] Do not use end punctuation in headings.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 10, "column": 137}}}, "severity": "WARNING"}

Check warning on line 10 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Spelling] Verify the word 'name_overlays'. It is not in the American English spelling dictionary used by Vale.

Raw Output:
{"message": "[RedHat.Spelling] Verify the word 'name_overlays'. It is not in the American English spelling dictionary used by Vale.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 10, "column": 98}}}, "severity": "WARNING"}

Check warning on line 10 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Definitions] Define acronyms and abbreviations (such as 'DTBO') on first occurrence if they're likely to be unfamiliar.

Raw Output:
{"message": "[RedHat.Definitions] Define acronyms and abbreviations (such as 'DTBO') on first occurrence if they're likely to be unfamiliar.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 10, "column": 87}}}, "severity": "INFO"}

Check warning on line 10 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Ellipses] Avoid the ellipsis (...) except to indicate omitted words.

Raw Output:
{"message": "[RedHat.Ellipses] Avoid the ellipsis (...) except to indicate omitted words.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 10, "column": 51}}}, "severity": "INFO"}
*****************************************************************************************************************************************

Background
==========

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``).

Check warning on line 16 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.SentenceLength] Try to keep sentences to an average of 32 words or fewer.

Raw Output:
{"message": "[RedHat.SentenceLength] Try to keep sentences to an average of 32 words or fewer.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 16, "column": 1}}}, "severity": "INFO"}
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>`__

Check failure on line 17 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsErrors] Use 'environment' rather than 'env'.

Raw Output:
{"message": "[RedHat.TermsErrors] Use 'environment' rather than 'env'.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 17, "column": 94}}}, "severity": "ERROR"}

Check warning on line 17 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Slash] Use either 'or' or 'and' in 'board/ti'

Raw Output:
{"message": "[RedHat.Slash] Use either 'or' or 'and' in 'board/ti'", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 17, "column": 71}}}, "severity": "WARNING"}

Issue
=====

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.

Check warning on line 22 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsWarnings] Consider using 'might' or 'can' rather than 'may' unless updating existing content that uses the term.

Raw Output:
{"message": "[RedHat.TermsWarnings] Consider using 'might' or 'can' rather than 'may' unless updating existing content that uses the term.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 22, "column": 103}}}, "severity": "WARNING"}

Check warning on line 22 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Using] Use 'by using' instead of 'using' when it follows a noun for clarity and grammatical correctness.

Raw Output:
{"message": "[RedHat.Using] Use 'by using' instead of 'using' when it follows a noun for clarity and grammatical correctness.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 22, "column": 24}}}, "severity": "WARNING"}
This means the essential EdgeAI memory carve-out overlay (:file:`k3-am62a7-sk-edgeai.dtbo`) is no longer applied.
As a result, EdgeAI applications may fail to allocate memory, showing errors such as:

Check warning on line 24 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.SimpleWords] Use simple language. Consider using 'assign' or 'divide' rather than 'allocate'.

Raw Output:
{"message": "[RedHat.SimpleWords] Use simple language. Consider using 'assign' or 'divide' rather than 'allocate'.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 24, "column": 46}}}, "severity": "INFO"}

Check warning on line 24 in source/devices/AM62AX/edgeai/faq.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsWarnings] Consider using 'might' or 'can' rather than 'may' unless updating existing content that uses the term.

Raw Output:
{"message": "[RedHat.TermsWarnings] Consider using 'might' or 'can' rather than 'may' unless updating existing content that uses the term.", "location": {"path": "source/devices/AM62AX/edgeai/faq.rst", "range": {"start": {"line": 24, "column": 34}}}, "severity": "WARNING"}

.. code-block:: console

APP_LOG: ERROR: Unable to map memory @ 0xa2000000 of size 3288576 bytes !!!

Who is affected?
================

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.

Solution
========

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.
For example - To enable IMX219 camera support

.. code-block:: console

name_overlays=ti/k3-am62a7-sk-edgeai.dtbo ti/k3-am62x-sk-csi2-imx219.dtbo

This ensures the memory region required by EdgeAI applications is reserved.

Summary Table
-------------

.. csv-table:: Summary
:header: "SDK Version","Default EdgeAI Overlay","Action Needed When Customizing Overlays"

"≤ 10.1", "None", "Only add your required overlays"
"≥ 11.1", "EdgeAI overlay applied", "Must re-apply EdgeAI overlay when overriding `name_overlays`"

.. tip::

If you encounter memory mapping errors after customizing overlays, verify that the EdgeAI carve-out overlay is present in your configuration.

.. _pub_edgeai_multiple_usb_cams:

*****************************************************************************
Getting Error when trying to capture from multiple USB cameras simultaneously
=============================================================================
*****************************************************************************

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