.. _release_notes_11_02_02_|dev_platform|:


Release notes - 11_02_02
^^^^^^^^^^^^^^^^^^^^^^^^

Documentation
=============

The documentation included with the PSDK QNX SDK is specific to the PSDK QNX |dev_platform| package and for SDP |qnx_sdp_short_version|.

PSDK RTOS |dev_platform| package documentation (:ref:`psdk_rtos_components_|dev_platform|`) must also be referenced, for full understanding of PSDK QNX |dev_platform| support.


PSDK QNX |dev_platform| Features
=================================

.. NOTE::

   * Reference PSDK RTOS |dev_platform| package documentation (|psdk_rtos_user_guide|) for an extensive list of new and current features supported by PSDK QNX + PSDK RTOS. This section lists only the features that are PSDK QNX |dev_platform| specific.
   * For features & drivers enabled by the QNX BSP, please refer to BSP Documentation or contact QNX.
   * This release is tested on Ubuntu (x86_64) 22.04 systems and may not work on earlier or later Ubuntu systems.
   * Support for io-pkt is not available for |dev_platform|.


.. ifconfig:: QNX_SDP_VERSION in ('710')

   .. important::

      As of the PSDK QNX 11.0 release, the io-pkt networking stack is deprecated and the io-sock networking stack is the
      recommended stack for the |dev_platform| SoC. The io-pkt drivers will not be packaged with the SDK.
      This source will continue to be available if requested. To request access please reach out to your TI contact.

      For more details please refer to the developer note: :ref:`devnp_710_developer_note`


Enabled in this Release
-----------------------

.. NOTE::

     This is a bug-fix only release on top of the 11_02_01 release


Features enabled in this release, specific to the PSDK QNX |dev_platform| package are:

   * An updated section on Errata related information is added to release notes

   * Bug fixes

     * SCI-Client: Crash when resuming from suspend to RAM scenarios
     * UDMA: Pull in PDK errata fixes. See in :ref:`release_notes_errata`
     * QNX OSAL: Use of CLOCK_REALTIME instead of CLOCK_MONOTONIC
     * Various unit test related fixes.
     * Various Documentation fixes.

For additional new updates, please refer PSDK RTOS package documentation (:ref:`psdk_rtos_components_|dev_platform|`).

Enabled in Previous Releases
----------------------------

Features enabled in previous release, specific to the PSDK QNX |dev_platform| package are:

   * A developer note for enabling QNX display driver is available.
   * Safety qualified drivers for UDMA, OSAL, SCIClient and safety qualified OSAL library
   * IPC Resource manager now has an argument to configure the ISR thread priority.

      * Non-ISR threads remain configurable via the QNX ``on -p <priority> <executable>`` utility.
   * Added support for reading CPU load information in app_utils.
   * Added utility reading DIE ID information (run ``use ti-hwmon`` for more details).
   * Added utility for reading VTM temperature sensor information (run ``use ti-hwmon`` for more details).


      * Please get in touch with your TI contact for details on how to request for the CSP. For |dev_platform|, please refer to the J784S4 collaterals.

   * VPU video codec updates

     * Empirical values for internal and external buffers used for Codec published.
     * Various encode and decode fps rates published.
     * Resource manager support for VPU video encoder
     * Resource manager support for VPU video decoder
     * Multi-core codec support.
     * Codec IO-buffer and Internal buffer management using SharedMemoryAllocator.
     * Supports usage of DDR high-mem (>4G range). Default base address is "0x8 C000 0000" with a total of 768MB.

   * OMX IL Component support for VPU video encoder and File-based OMX encoder test application (H.264 & HEVC)

     * Configurable GOP Preset support. Can configure combinations of I and P frames
     * Supports logging at different levels
     * Supports a multi-threaded implementation
     * Encoder multichannel support up to 8x1080p streams
     * Encoder supports performance up to 1x1080p at 60fps and 2x1080p at 30fps
     * Added SPS & PPS NAL units along with each IDR frame

   * OMX IL Component support for VPU video decoder and File-based OMX decoder test application (H.264 & HEVC)

     * Support for YUV 420 and pseudo-YUV 422 output formats.
     * Supports zero-copy buffer passing between application and codec
     * Supports I, P and B frame decoding
     * Supports decode of stream headers in advance
     * Supports logging at different levels
     * Supports a multi-threaded implementation
     * HW Watchdog for Decoder
     * Decoder to recovery from SW stream errors
     * Decoder supports de-blocking filter
     * Support for block-level spatial & temporal error concealment
     * Support for user input to determine number of non-linear frame buffers

   * VPU codec (encoder and decoder) with test app

     * HEVC & H.264 4K Encode support with file-to-file encode test app
     * HEVC & H.264 4K Decode support with file-to-file decode test app
     * Multi-instance HEVC/H.264 Encode & Decode support with multi-inst test app

   * OMX IL Component support for VPU video encode & decode (H.264 & HEVC)

     * Decode/Encode: Support for 2x HW VPU instances for Video Encode / Decode
     * Decode/Encode: Supports Interrupt mode for VPU codec
     * Decode/Encode: Supports 8 channel D1@30fps Encode + 8 channel D1@30fps Decode
     * Encode: Supports Rate control - VBR and CBR
     * Encode: Supports CBR (e.g., for Video Conferencing), 2-10 Mbps
     * Decode: Performance profiler added for VPU decode
     * Decode: Publish Codec Capabilities through API

   * Bug fixes

     * Sciclient random ACK failure fixed.
     * UDMA Resource Manager fixed the duplicate UDMA flow-id allocation
     * Running iperf with parallel instance of cpsw2g and cpsw9g
     * The ipc_test failing to ping ipc echo testb DM image
     * The tiudma-mgr cannot be restarted after being slayed
     * The udma_memcpy_test hangs forever in case of failure
     * CPSW2G direct ethernet cable connection
     * Decode: Fixed junk frames at the end for streams greater than 1080p
     * Decode/Encode: Multi-instance decode/encode failure fixed
     * Decode: OMX decoder fails to decode H.264 Level5 bitstreams of long play length
     * Decode: VPU fails to decode high-bitrate (>100 Mbps) 4K resolution videos
     * Decode: OMX decoder fails to decode 2x 4K HEVC/H264 bitstreams due to out-of-memory
     * Decode: OMX decode application does not check for num input bufs being exactly 2
     * Decode: OMX decode of 4x H.264 1080p bitstreams produces incorrect output frames
     * UDMA driver refactor to enable concurrent access of udma resources
     * Added test capability to support larger memcpy for UDMA
     * IPC driver returns incorrect return code during a timeout
     * Remove dependency on bootloader to set the MMCSD clocks
     * Added support to allocate UDMA proxy per process
     * Remove DEBUG_PRINT flag in the ipclld common.mk file
     * Address Compiler Warning -Wno-address-of-packed-member
     * OSAL: DebugP_log1 using _SLOG_ERROR instead of _SLOG_LOG
     * OSAL: Fixed ``HwiP_create`` not respecting requested thread priorities.

For additional new updates, please refer PSDK RTOS package documentation (:ref:`psdk_rtos_components_|dev_platform|`).

Change Requests
---------------

The following Change requests have been made for this release.

   * Re-evaluate safety requirement for TI's reference shared memory allocator


Hardware support
----------------

.. NOTE::

    Refer to Release Notes in PSDK RTOS User Guide(|psdk_rtos_user_guide|) for detailed information on supported Hardware.


Software Dependencies
=====================

QNX Dependency
--------------

.. NOTE::

  The PSDK QNX package is dependent on installations from QNX Software Center.
  The below QNX packages were used for PSDK QNX |psdk_qnx_version| build and verification.

.. ifconfig:: QNX_SDP_VERSION in ('800')

  QNX SDP 8.0
  ...........

  .. important::

   For information on io-sock ethernet driver refer to the developer note :ref:`devnp_710_developer_note`.


  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX SDP 800 Package          | Build ID     | Package ID                                       + Package Version                 |
  +==============================+==============+==================================================+=================================+
  | QNX® Software Development    | 141          | com.qnx.qnx800                                   | 8.0.0.00141T202311271501L       |
  | Platform 8.0                 |              |                                                  | (Validated against this version |
  |                              |              |                                                  | contact QNX for latest)         |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 8.0 BSP for Texas   | 35           | com.qnx.qnx800.bsp.hw.ti_j742s2_evm              | 0.1.0.00035T202411151542L       |
  | Instruments Jacinto 7 J742S2 |              |                                                  |                                 |
  | Evaluation Modules           |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 8.0 Screen Board    | 132          | com.qnx.qnx800.target.screen.board.j742s2        | 4.0.2.00132T202501161817L       |
  | Support J742S2 (with         |              |                                                  |                                 |
  | Debug Symbols)               |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 8.0 Networking -    | 600          | com.qnx.qnx800.target.net.iosock                 | 0.3.0.00600T202507302003L       |
  | io-sock                      |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 8.0 Networking -    | 104          | com.qnx.qnx800.target.net.devs.cpsw              | 0.3.0.00104T202507311314L       |
  | io-sock cpsw Drivers         |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+


.. ifconfig:: QNX_SDP_VERSION in ('710')

  QNX SDP 7.1
  ...........

  .. important::

      For more details concerning using io-sock on J742S2, please refer to the developer note: :ref:`devnp_710_developer_note`

  QNX SDP 7.1 (with io-sock based networking)
  ...........................................

  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX SDP 710 Package          | Build ID     | Package ID                                       + Package Version                 |
  +==============================+==============+==================================================+=================================+
  | QNX® Software Development    | 472          | com.qnx.sdp710                                   | 7.1.0.00472T202006132107S       |
  | Platform 7.1                 |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP7.1 BSP for Texas    |              | com.qnx.qnx710.bsp.ti_j742s2_evm_iosock          |  EA1 Release                    |
  | Instruments Jacinto 7 J742S2 |              |                                                  |  (Please contact your QNX       |
  | Evaluation Modules           |              |                                                  |  representative)                |
  | with iosock                  |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 7.1 Screen Board    |              | (Please contact your QNX representative)         | (Please contact your QNX        |
  | Support J742S2 (with         |              |                                                  | representative)                 |
  | Debug Symbols)               |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 7.1 Multimedia -    | 404          | com.qnx.qnx710.target.mm.openmaxil.core          | 2.1.0.00404T202201111113L       |
  | OpenMAX IL API (with         |              |                                                  |                                 |
  | Debug Symbols)               |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 7.1 Networking -    |              | com.qnx.qnx800.target.net.iosock                 | (Please contact your QNX        |
  | io-sock                      |              |                                                  | representative)                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+



Device Support and Validation Information
=========================================

+--------------------+-------------------------------+---------------------------------+-------------------------------+
| SoC                | Build Host (OS)               | Run Target (OS)                 | Test Platform                 |
+====================+===============================+=================================+===============================+
| |dev_platform|     | x86_64 (Linux Ubuntu 22.04)   | R5F & C7x running TI-RTOS       | TI EVM with daughter cards    |
|                    |                               |                                 |                               |
|                    |                               | A72 running QNX                 |                               |
+--------------------+-------------------------------+---------------------------------+-------------------------------+


.. NOTE::

    Refer  :ref:`evm_setup_|dev_platform|` for more details on the TI EVM support.


Open Defects
============

Below table lists all the current open defects:

.. csv-table::
   :header: "ID", "Head Line"
   :widths: 30, 130

    `EXT_PSDKQA-8 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-8>`_, VPU: OMX decoder fails to decode H.264 mixed resolution 1080p/720p video
    `EXT_PSDKQA-24 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-24>`_, SDK to evaluate and remove short_enums compiler flag across modules


Closed Issues
=============

Below table lists all the defects closed from previous releases:

.. csv-table::
   :header: "ID", "Head Line"
   :widths: 30, 130

    `EXT_PSDKQA-16 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-16>`_, VPU: QNX Encoder Performance - 4x 1080p60 not met. At 47fps now
    `EXT_PSDKQA-18 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-18>`_, CPSW5G/9G: Destroying interface freezes prompt
    `EXT_PSDKQA-23 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-23>`_, Address Compiler Warning -Wno-address-of-packed-member
    `EXT_PSDKQA-25 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-25>`_, OSAL: DebugP_log1 using _SLOG_ERROR instead of _SLOG_LOG
    `EXT_PSDKQA-27 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-27>`_, Remove DEBUG_PRINT flag in the ipclld common.mk file
    `EXT_PSDKQA-28 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-28>`_, QNX IPC - Need to make the task priority a configurable item
    `EXT_PSDKQA-29 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-29>`_, TDA4VM: Duplication of messages received by RPMessage_recv()


Known Issues
============

A list of key known issues with the PSDK QNX release is provided below.

.. NOTE::

    Refer to individual :ref:`psdk_rtos_components_|dev_platform|` release notes for known issues in each component


+--------+--------------------------+---------------------------------------------------------------------------------+
| Index  | Module                   |  Description                                                                    |
+========+==========================+=================================================================================+
|  1     | QNX UDMA RM              | UDMA resource manager may not free UDMA resources when client exits             |
|        |                          | unexpectedly.                                                                   |
+--------+--------------------------+---------------------------------------------------------------------------------+

.. _release_notes_errata:

Errata
======

   * UDMA

       * i2431 - When receiving data from a PSIL/PDMA peripheral, EOP flag needs to be set in the each TR's configuration specific flag field and PDMA's X-Y FIFO Mode Static TR "Z" parameter should be set to non zero value in order for channel teardown to function properly and not cleanup the internal state memory. Otherwise it leads to channel lockups on subsequent runs. The PDMA Z count should also match the TR size, so that PDMA delineates each transfer as an individual packet.
       * i2234 - Non-triggered transfers need EOL_ICNT0 for sub-64B sizes
       * i2163 - Triggered transfers need trigger-type-specific EOL settings, (ICNT1_DEC → EOL_ICNT0, ICNT2_DEC → EOL_ICNT0_ICNT1, ICNT3_DEC → _ICNT1_ICNT2)


Additional Reports
==================

For additional reports like test report, traceability refer PSDK RTOS Additional Reports

