Skip to content

Commit be16ff7

Browse files
committed
style(E5010): Cleanup Documentation and Add J722S
Removing the direct references to AM62A and replacing them with common macros. Also updating differences between AEN and 62a. There are not many since it is the same IP and same clock configuration for both platforms. All latency numbers and performance metrics are common between the two. Signed-off-by: Brandon Brnich <[email protected]>
1 parent 9c93cc8 commit be16ff7

File tree

1 file changed

+43
-19
lines changed

1 file changed

+43
-19
lines changed

source/linux/Foundational_Components/Kernel/Kernel_Drivers/E5010_JPEG_Encoder.rst

Lines changed: 43 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. include:: /_replacevars.rst
2+
13
******************
24
E5010 JPEG Encoder
35
******************
@@ -102,8 +104,8 @@ of video encoding based use-cases utilizing this driver as demonstrated in below
102104
103105
Building the driver
104106
===================
105-
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.
106-
If using a separate defconfig, It can be enabled explicitly for compilation by setting corresponding Kconfig as shown below:
107+
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.
108+
If using a separate defconfig, it can be enabled explicitly for compilation by setting corresponding Kconfig as shown below:
107109

108110
.. code-block:: kconfig
109111
@@ -172,22 +174,44 @@ Due to runtime power management feature, when JPEG encoder
172174
is not being used by any of the applications, it stays in suspended
173175
state and same can be verified using k3conf utility as shown below :
174176

175-
.. code-block:: console
177+
.. ifconfig:: CONFIG_part_variant in ('AM62AX')
178+
179+
.. code-block:: console
180+
181+
root@am62axx-evm:~# k3conf dump device 201
182+
|------------------------------------------------------------------------------|
183+
| VERSION INFO |
184+
|------------------------------------------------------------------------------|
185+
| K3CONF | (version 0.3-nogit built Thu Jul 25 14:13:02 UTC 2024) |
186+
| SoC | AM62Ax SR1.0 |
187+
| SYSFW | ABI: 4.0 (firmware version 0x000a '10.0.8--v10.00.08 (Fiery Fox))') |
188+
|------------------------------------------------------------------------------|
189+
190+
|---------------------------------------------------|
191+
| Device ID | Device Name | Device Status |
192+
|---------------------------------------------------|
193+
| 201 | AM62AX_DEV_JPGENC0 | DEVICE_STATE_OFF |
194+
|---------------------------------------------------|
195+
196+
.. ifconfig:: CONFIG_part_variant in ('J722S', 'AM67')
197+
198+
.. code-block:: console
199+
200+
root@j722s-evm-evm:~# k3conf dump device 201
201+
|------------------------------------------------------------------------------|
202+
| VERSION INFO |
203+
|------------------------------------------------------------------------------|
204+
| K3CONF | (version 0.3-nogit built Thu Jul 25 14:13:02 UTC 2024) |
205+
| SoC | J722S SR1.0 |
206+
| SYSFW | ABI: 4.0 (firmware version 0x000a '10.0.8--v10.00.08 (Fiery Fox))') |
207+
|------------------------------------------------------------------------------|
208+
209+
|---------------------------------------------------|
210+
| Device ID | Device Name | Device Status |
211+
|---------------------------------------------------|
212+
| 201 | J722S_DEV_JPGENC0 | DEVICE_STATE_OFF |
213+
|---------------------------------------------------|
176214
177-
root@am62axx-evm:~# k3conf dump device 201
178-
|------------------------------------------------------------------------------|
179-
| VERSION INFO |
180-
|------------------------------------------------------------------------------|
181-
| K3CONF | (version 0.3-nogit built Thu Jul 25 14:13:02 UTC 2024) |
182-
| SoC | AM62Ax SR1.0 |
183-
| SYSFW | ABI: 4.0 (firmware version 0x000a '10.0.8--v10.00.08 (Fiery Fox))') |
184-
|------------------------------------------------------------------------------|
185-
186-
|---------------------------------------------------|
187-
| Device ID | Device Name | Device Status |
188-
|---------------------------------------------------|
189-
| 201 | AM62AX_DEV_JPGENC0 | DEVICE_STATE_OFF |
190-
|---------------------------------------------------|
191215
192216
.. ifconfig:: CONFIG_part_variant in ('AM62AX')
193217

@@ -375,7 +399,7 @@ Buffer alignment requirements
375399

376400
Performance and Latency Benchmarking
377401
====================================
378-
The E5010 core is clocked at 250Mhz in AM62A and theoretical performance expectation
402+
The E5010 core is clocked at 250Mhz on |__PART_FAMILY_DEVICE_NAMES__| and theoretical performance expectation
379403
with this clocking is as below :
380404

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

392-
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 :
416+
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 :
393417

394418
.. code-block:: console
395419

0 commit comments

Comments
 (0)