Datasheet documentation hw acceleration update

Author: TaddyHC

content/hardware/02.uno/boards/uno-q/datasheet/datasheet.md

@@ -262,27 +262,27 @@ JMISC handles both domains: 1.8 V MPU lines sit alongside 3.3 V MCU signals (e.g
 
 <p style="text-align: justify;">The Adreno 702 GPU provides hardware-accelerated 3D graphics rendering through open-source Mesa drivers. Applications can access GPU acceleration via standard graphics APIs, including OpenGL, OpenGL ES, Vulkan, and OpenCL.</p>
 
-| **Graphics API** | **Driver** | **Hardware Support** | **Current Driver Version** | **Device Name** |
+| **Graphics API** | **Driver** | **Hardware Support** | **Current Driver Version** | **Device Name**        |
 |------------------|------------|----------------------|----------------------------|------------------------|
-| Desktop OpenGL   | freedreno  | -                    | 3.1                        | FD702                  |
-| OpenGL ES        | freedreno  | 3.1                  | 3.1                        | FD702                  |
-| Vulkan           | turnip     | 1.1                  | 1.0.318                    | Turnip Adreno (TM) 702 |
-| OpenCL           | Mesa       | 2.0                  | 2.0                        | -                      |
+| Desktop OpenGL   | freedreno  | -                    | 3.1                        | FD702                  |
+| OpenGL ES        | freedreno  | 3.1                  | 3.1                        | FD702                  |
+| Vulkan           | turnip     | 1.1                  | 1.0.318                    | Turnip Adreno (TM) 702 |
+| OpenCL           | Mesa       | 2.0                  | 2.0                        | -                      |
 
 <p style="text-align: justify;">The Adreno 702 GPU features unified memory architecture, sharing system RAM with the CPU for data transfer. It supports 64-bit memory addressing and provides direct rendering capabilities for optimal graphics performance.</p>
 
-| **Parameter** | **Specification** |
+| **Parameter**                  | **Specification**                |
 |--------------------------------|----------------------------------|
-| Clock Frequency                | 845 MHz                          |
-| Memory Architecture            | Unified (shared with system RAM) |
-| Available Video Memory         | 1740 MB                          |
-| Memory Addressing              | 64-bit                           |
-| Direct Rendering               | Yes                              |
-| Maximum 2D Texture Size        | 16384 × 16384 pixels             |
-| Maximum 3D Texture Size        | 2048³ voxels                     |
-| Maximum Cube Map Size          | 16384 × 16384 pixels             |
-| OpenGL Shading Language (GLSL) | 1.40                             |
-| OpenGL ES Shading Language     | 3.10 ES                          |
+| Clock Frequency                | 845 MHz                          |
+| Memory Architecture            | Unified (shared with system RAM) |
+| Available Video Memory         | 1740 MB                          |
+| Memory Addressing              | 64-bit                           |
+| Direct Rendering               | Yes                              |
+| Maximum 2D Texture Size        | 16384 × 16384 pixels             |
+| Maximum 3D Texture Size        | 2048³ voxels                     |
+| Maximum Cube Map Size          | 16384 × 16384 pixels             |
+| OpenGL Shading Language (GLSL) | 1.40                             |
+| OpenGL ES Shading Language     | 3.10 ES                          |
 
 <p style="text-align: justify;">The Mesa graphics stack provides full support for standard OpenGL extensions and features. Applications using OpenGL, OpenGL ES, or Vulkan will automatically use hardware acceleration without additional configuration. Standard graphics utilities such as <code>mesa-utils</code> and <code>vulkan-tools</code> work out of the box on the UNO Q.</p>
 
@@ -294,68 +294,66 @@ JMISC handles both domains: 1.8 V MPU lines sit alongside 3.3 V MCU signals (e.g
 
 <p style="text-align: justify;">The Adreno 702 GPU includes dedicated hardware video encoders and decoders accessible through the <code>V4L2 (Video4Linux2)</code> API via <code>/dev/video0</code> and <code>/dev/video1</code> devices. Hardware acceleration is available for the following video codecs:</p>
 
-| **Codec** | **Encoding** | **Decoding** | **GStreamer Element** |
+| **Codec**    | **Encoding** | **Decoding** | **GStreamer Element**     |
 |--------------|--------------|--------------|---------------------------|
-| H.264 (AVC)  | Yes          | Yes          | v4l2h264enc / v4l2h264dec |
-| H.265 (HEVC) | Yes          | Yes          | v4l2h265enc / v4l2h265dec |
-| VP9          | No           | Yes          | v4l2vp9dec                |
+| H.264 (AVC)  | Yes          | Yes          | v4l2h264enc / v4l2h264dec |
+| H.265 (HEVC) | Yes          | Yes          | v4l2h265enc / v4l2h265dec |
+| VP9          | No           | Yes          | v4l2vp9dec                |
 
-#### Video Encoding Capabilities
+<p style="text-align: justify;">The hardware video encoder and decoder offload compression and decompression tasks from the CPU to dedicated hardware, enabling efficient real-time video processing. This reduces system power consumption and allows the CPU to focus on application logic. Hardware acceleration is available for resolutions up to 1920×1080 (Full HD), including common formats such as 720p (1280×720).</p>
 
-<p style="text-align: justify;">The hardware video encoder offloads compression tasks from the CPU to dedicated encoding hardware, allowing real-time video capture and streaming. This reduces system power consumption and allows the CPU to focus on application logic rather than video processing.</p>
+#### GStreamer Integration
 
-| **Parameter** | **Specification** |
-|-------------------------|-----------------------------------------------------|
-| Maximum Resolution      | 1920×1080 (Full HD, 1080p)                          |
-| CPU Load Reduction      | Significant reduction compared to software encoding |
-| Bitrate Control         | Configurable constant/variable bitrate modes        |
-| Quality Parameters      | Adjustable encoding quality and compression ratio   |
-| Supported Pixel Formats | NV12, YUV420                                        |
+<p style="text-align: justify;">The recommended approach for accessing hardware video acceleration is through <strong>GStreamer</strong>, which provides a high-level pipeline interface to the V4L2 devices. The following GStreamer elements provide hardware-accelerated video processing:</p>
 
-#### Video Decoding Capabilities
+For H.264 decoding, the following pipeline can be used:
 
-<p style="text-align: justify;">The hardware video decoder enables smooth playback of compressed video streams with minimal CPU utilization. This is particularly beneficial for media player applications, video conferencing, and streaming services, where efficient decoding is essential for maintaining frame rates and reducing battery consumption.</p>
+```bash
+gst-launch-1.0 filesrc location=videos/xxxxx.mp4 \
+  ! qtdemux name=demux demux.video_0 ! queue ! h264parse ! v4l2h264dec \
+  ! videoconvert ! autovideosink
+```
 
-| **Parameter** | **Specification** |
-|-------------------------|-----------------------------------------------------|
-| Maximum Resolution      | 1920×1080 (Full HD, 1080p)                          |
-| Performance             | Real-time decoding at 30 fps for Full HD            |
-| CPU Utilization         | Minimal CPU load during hardware-accelerated decode |
-| Use Cases               | Video playback, streaming, conferencing             |
-| Supported Pixel Formats | NV12, YUV420 output                                 |
+For H.265 decoding, the following pipeline can be used:
 
-#### GStreamer Integration
+```bash
+gst-launch-1.0 filesrc location=videos/xxxxx.mp4 \
+  ! qtdemux name=demux demux.video_0 ! queue ! h265parse ! v4l2h265dec \
+  ! videoconvert ! autovideosink
+```
 
-<p style="text-align: justify;">The recommended approach for accessing hardware video acceleration is through <strong>GStreamer</strong>, which provides a high-level pipeline interface to the V4L2 devices. The following GStreamer elements provide hardware-accelerated video processing:</p>
+For VP9 decoding, the following pipeline can be used:
 
-**Example H.264 Decoding Pipeline:**
 ```bash
-gst-launch-1.0 filesrc location=video.mp4 \
- ! qtdemux name=demux demux.video_0 ! queue ! h264parse ! v4l2h264dec \
-  ! videoconvert ! autovideosink
+gst-launch-1.0 filesrc location=videos/xxxxx.webm \
+  ! matroskademux ! queue ! v4l2vp9dec \
+  ! videoconvert ! autovideosink
 ```
 
-**Example H.265 Encoding Pipeline:**
+For H.264 encoding, the following pipeline can be used:
+
 ```bash
 gst-launch-1.0 videotestsrc num-buffers=30 \
- ! video/x-raw,width=1920,height=1080,framerate=30/1 \
-  ! v4l2h265enc ! h265parse ! mp4mux ! filesink location=output.mp4
+  ! video/x-raw,width=1280,height=720,framerate=30/1 \
+  ! v4l2h264enc ! h264parse ! mp4mux ! filesink location=/tmp/output.mp4
 ```
 
-**Example VP9 Decoding Pipeline:**
+For H.265 encoding, the following pipeline can be used:
+
 ```bash
-gst-launch-1.0 filesrc location=video.webm \
- ! matroskademux ! queue ! v4l2vp9dec \
-  ! videoconvert ! autovideosink
+gst-launch-1.0 videotestsrc num-buffers=30 \
+  ! video/x-raw,width=1920,height=1080,framerate=30/1 \
+  ! v4l2h265enc ! h265parse ! mp4mux ! filesink location=/tmp/output.mp4
 ```
 
-**Concurrent Encoding/Decoding:**
+For concurrent encoding and decoding, the following pipeline can be used:
+
 ```bash
 gst-launch-1.0 -v videotestsrc num-buffers=1000 \
- ! video/x-raw,format=NV12,width=1280,height=720,framerate=30/1 \
-  ! v4l2h264enc capture-io-mode=4 output-io-mode=2 ! h264parse \
- ! v4l2h264dec capture-io-mode=4 output-io-mode=2 ! videoconvert \
-  ! autovideosink
+  ! video/x-raw,format=NV12,width=1280,height=720,framerate=30/1 \
+  ! v4l2h264enc capture-io-mode=4 output-io-mode=2 ! h264parse \
+  ! v4l2h264dec capture-io-mode=4 output-io-mode=2 ! videoconvert \
+  ! autovideosink
 ```
 
 <div style="background-color: rgba(0, 170, 228, 0.2); border-left: 6px solid rgba(0, 120, 180, 1); margin: 20px 0; padding: 15px;">
@@ -841,6 +839,7 @@ Lors de l’ installation et de l’ exploitation de ce dispositif, la distance
 
 |  **Date**  | **Revision** | **Changes**                                    |
 | :--------: | :----------: | ---------------------------------------------- |
+| 24/11/2025 |      4       | Add hardware acceleration section (graphics APIs, video codecs, OpenCL support); remove incorrect default password reference |
 | 05/11/2025 |      3       | Update operational information                 |
 | 27/10/2025 |      2       | Mechanical drawing and RTC power detail update |
 | 01/10/2025 |      1       | First release                                  |