Skip to content

E5010 Documentation Update #29

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
merged 2 commits into from
Nov 7, 2024
Merged

E5010 Documentation Update #29

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9c93cc8
fix(config): Add IMG Encoder to J722s and AM67 Documentation
b-brnich Oct 31, 2024
be16ff7
style(E5010): Cleanup Documentation and Add J722S
b-brnich Oct 31, 2024
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
1 change: 1 addition & 0 deletions configs/AM67/AM67_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/Audio
linux/Foundational_Components/Kernel/Kernel_Drivers/Camera/CSI2RX
linux/Foundational_Components/Kernel/Kernel_Drivers/Crypto
linux/Foundational_Components/Kernel/Kernel_Drivers/Display/DSS7
linux/Foundational_Components/Kernel/Kernel_Drivers/E5010_JPEG_Encoder
linux/Foundational_Components/Kernel/Kernel_Drivers/GPIO
linux/Foundational_Components/Kernel/Kernel_Drivers/I2C
linux/Foundational_Components/Kernel/Kernel_Drivers/MCAN
Expand Down
1 change: 1 addition & 0 deletions configs/J722S/J722S_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/Audio
linux/Foundational_Components/Kernel/Kernel_Drivers/Camera/CSI2RX
linux/Foundational_Components/Kernel/Kernel_Drivers/Crypto
linux/Foundational_Components/Kernel/Kernel_Drivers/Display/DSS7
linux/Foundational_Components/Kernel/Kernel_Drivers/E5010_JPEG_Encoder
linux/Foundational_Components/Kernel/Kernel_Drivers/GPIO
linux/Foundational_Components/Kernel/Kernel_Drivers/I2C
linux/Foundational_Components/Kernel/Kernel_Drivers/MCAN
Expand Down
62 changes: 43 additions & 19 deletions source/linux/Foundational_Components/Kernel/Kernel_Drivers/E5010_JPEG_Encoder.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
.. include:: /_replacevars.rst

******************
E5010 JPEG Encoder
******************
Expand Down Expand Up @@ -102,8 +104,8 @@ of video encoding based use-cases utilizing this driver as demonstrated in below

Building the driver
===================
The E5010 JPEG driver is already enabled as a kernel module in processor SDK 9.0 for AM62A in the default defconfig being used for the board.
If using a separate defconfig, It can be enabled explicitly for compilation by setting corresponding Kconfig as shown below:
The E5010 JPEG driver is already enabled as a kernel module on |__PART_FAMILY_DEVICE_NAMES__| as part of the default defconfig being used for the board.
If using a separate defconfig, it can be enabled explicitly for compilation by setting corresponding Kconfig as shown below:

.. code-block:: kconfig

Expand Down Expand Up @@ -172,22 +174,44 @@ Due to runtime power management feature, when JPEG encoder
is not being used by any of the applications, it stays in suspended
state and same can be verified using k3conf utility as shown below :

.. code-block:: console
.. ifconfig:: CONFIG_part_variant in ('AM62AX')

.. code-block:: console

root@am62axx-evm:~# k3conf dump device 201
|------------------------------------------------------------------------------|
| VERSION INFO |
|------------------------------------------------------------------------------|
| K3CONF | (version 0.3-nogit built Thu Jul 25 14:13:02 UTC 2024) |
| SoC | AM62Ax SR1.0 |
| SYSFW | ABI: 4.0 (firmware version 0x000a '10.0.8--v10.00.08 (Fiery Fox))') |
|------------------------------------------------------------------------------|

|---------------------------------------------------|
| Device ID | Device Name | Device Status |
|---------------------------------------------------|
| 201 | AM62AX_DEV_JPGENC0 | DEVICE_STATE_OFF |
|---------------------------------------------------|

.. ifconfig:: CONFIG_part_variant in ('J722S', 'AM67')

.. code-block:: console

root@j722s-evm-evm:~# k3conf dump device 201
|------------------------------------------------------------------------------|
| VERSION INFO |
|------------------------------------------------------------------------------|
| K3CONF | (version 0.3-nogit built Thu Jul 25 14:13:02 UTC 2024) |
| SoC | J722S SR1.0 |
| SYSFW | ABI: 4.0 (firmware version 0x000a '10.0.8--v10.00.08 (Fiery Fox))') |
|------------------------------------------------------------------------------|

|---------------------------------------------------|
| Device ID | Device Name | Device Status |
|---------------------------------------------------|
| 201 | J722S_DEV_JPGENC0 | DEVICE_STATE_OFF |
|---------------------------------------------------|

root@am62axx-evm:~# k3conf dump device 201
|------------------------------------------------------------------------------|
| VERSION INFO |
|------------------------------------------------------------------------------|
| K3CONF | (version 0.3-nogit built Thu Jul 25 14:13:02 UTC 2024) |
| SoC | AM62Ax SR1.0 |
| SYSFW | ABI: 4.0 (firmware version 0x000a '10.0.8--v10.00.08 (Fiery Fox))') |
|------------------------------------------------------------------------------|

|---------------------------------------------------|
| Device ID | Device Name | Device Status |
|---------------------------------------------------|
| 201 | AM62AX_DEV_JPGENC0 | DEVICE_STATE_OFF |
|---------------------------------------------------|

.. ifconfig:: CONFIG_part_variant in ('AM62AX')

Expand Down Expand Up @@ -375,7 +399,7 @@ Buffer alignment requirements

Performance and Latency Benchmarking
====================================
The E5010 core is clocked at 250Mhz in AM62A and theoretical performance expectation
The E5010 core is clocked at 250Mhz on |__PART_FAMILY_DEVICE_NAMES__| and theoretical performance expectation
with this clocking is as below :

+-------------------+--------------------+
Expand All @@ -389,7 +413,7 @@ with this clocking is as below :
With these numbers theoretically E5010 core can handle 3840x2160@60fps equivalent load
for 4:2:2 video formats and 3840x2160@75fps equivalent load for 4:2:0 video formats.

This however requires the upstream element (for e.g. camera) to support above rates. On AM62A board fastest locally available upstream element source is `wave5 VPU decoder <../../../Foundational_Components_Multimedia_wave5.html>`__ which provides maximum performance of 3840x2160@59 fps with low bitrate files and we were able to achieve same performance after passing this decoded data to E5010 JPEG Encoder as shown in below example :
This however requires the upstream element (for e.g. camera) to support above rates. On |__PART_FAMILY_DEVICE_NAMES__| board fastest locally available upstream element source is :ref:`wave5 VPU decoder <foundational-components-multimedia>` which provides maximum performance of 3840x2160@59 fps with low bitrate files and we were able to achieve same performance after passing this decoded data to E5010 JPEG Encoder as shown in below example :

.. code-block:: console

Expand Down
Loading