.. _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.

.. 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:


   * Shared Memory Allocator Resource Manager
   * SCIClient Resource Manager
   * A72 OpenVx Integration
   * A72 Vision Apps Demo Support
   * UDMA Resource Manager
   * IPC Resource Manager
   * K3conf utility
   * SBL Boot flow support for QNX
   * DDR BW analysis tool
   * Datasheet added for IPC and io-pkt cpsw ethernet drivers
   * Support and validation with the PSDK RTOS release
   * PDK library build updated from using PDK makefile system to QNX makefile
   * Update to build system to use QCONF_OVERRIDE and support for .sym file
   * Debug build profile deprecate from the PSDK QNX build system
   * The release package now has version controlled with git with a single release commit to enable convenient patching
   * UDMA driver refactor to enable concurrent access of udma resources
   * Added test capability to support larger memcpy for UDMA
   * 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).
   * Introduces a feature to optionally enable the use of usermode hostid. Refer to the feature specific documentation (:ref:`developer_notes_new_host_id`) for more details.

      * Please get in touch with your TI contact for details on how to request for the CSP.

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

   * IO-PKT CPSW2G Driver

     * A72 driver for CPSW2G
     * Support for gPTP
     * Use of enet-lld
     * SMMU support
     * HW-checksum offloading
   * IO-PKT CPSW9G Virtual Driver

     * A72 driver for CPSW9G
     * Use of enet-lld
     * Time sync with EthFW support added to CPSW9G Virtual driver
     * HW-checksum offloading
     * Single core multicast support
     * Support for dynamic IP and MAC configuration
     * Removed dependency on remote device.
     * Handle CPSW recovery message and re-init the devnp driver.

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

   * OMX IL Component IMG video codec updates

     * IMG driver error reporting upto OMX compoment level
     * Performance profiler for the IMG decoder
     * OMX QNX color formats enumeration updated to OMX defined color formats

   * IMG video encoder

     * Resource manager support for IMG video encoder
     * OMX IL Component support for IMG video encoder and File-based OMX encoder test application (H.264)
     * Supports both Constant Bit-rate (CBR) & Variable Bit-rate (VBR) encoding
     * Supports logging at different levels
     * Supports a multi-threaded implementation

   * IMG video decoder

     * Resource manager support for IMG video decoder
     * OMX IL Component support for IMG video decoder and File-based OMX decoder test application (H.264 / HEVC)
     * Decodes 8-bit & 10-bit color videos to 420/422 output formats (NV12, NV16, P010, P210)
     * Supports zero-copy buffer passing between application and codec
     * Supports I, P and B frame decoding
     * Supports both progressive and interlaced video decoding
     * Supports recovery from video stream errors
     * Supports decode of stream headers in advance
     * Supports strided output buffers as needed
     * Supports logging at different levels
     * Supports a multi-threaded implementation
     * Decoder to support HW Watchdog
     * Decoder to recover from MMU faults
     * Decoder to recover from hardware lockup
     * Decoder supports performance upto 8x1080p30/4x1080p60

   * Bug fixes

     * OSAL: Fixed ``HwiP_create`` not respecting requested thread priorities.
     * 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
     * Simultaneous OMX decodes of HEVC and H.264 videos together
     * 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
     * Added qnxfs partition for SD card boot to address boot time delay
     * Sciclient random ACK failure fixed.
     * UDMA Resource Manager fixed the duplicate UDMA flow-id allocation
     * 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 Screen Board    | 132          | com.qnx.qnx800.target.screen.board.j721e         | 4.0.2.00132T202501161817L       |
  | Support J721E (with          |              |                                                  |                                 |
  | Debug Symbols)               |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 8.0 BSP for Texas   | 339          | com.qnx.qnx800.bsp.hw.ti_j721e_am752x_evm        | 0.3.0.00339T202507311446L       |
  | Instruments Jacinto 7 J721E  |              |                                                  |                                 |
  | (DRA829/TDA4xM) Evaluation   |              |                                                  |                                 |
  | Module                       |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | 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::

      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 J721E, J721S2, J784S4, J742S2 and J722S SoCs. 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`

  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    |              |                                                  | EA1 release                     |
  | Instruments Jacinto 7 J721E  |              | com.qnx.qnx710.bsp.ti_j721e_am752x_evm_iosock    | (Please contact your QNX        |
  | (DRA829/TDA4xM) Evaluation   |              |                                                  | representative )                |
  | Modules with io-sock         |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 7.1 Screen Board    |              | (Please contact your QNX representative)         | (Please contact your QNX        |
  | Support Jacinto 7 (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)                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+


  QNX SDP 7.1 (with io-pkt 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    | 106          | com.qnx.qnx710.bsp.ti_j721e_am752x_evm           |                                 |
  | Instruments Jacinto 7 J721E  |              |                                                  |                                 |
  | (DRA829/TDA4xM) Evaluation   |              |                                                  |                                 |
  | Modules                      |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 7.1  Screen Board   | 202          | com.qnx.qnx710.target.screen.board.null          | 3.0.1.00202T202007031336S       |
  | Support Null Driver (with    |              |                                                  |                                 |
  | Debug Symbols)               |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+
  | QNX® SDP 7.1 Screen Board    | 137          | com.qnx.qnx710.target.screen.board.j721e         | 3.2.0.00137T202210261823L       |
  | Support Jacinto 7 (with      |              |                                                  | (contact QNX)                   |
  | 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)               |              |                                                  |                                 |
  +------------------------------+--------------+--------------------------------------------------+---------------------------------+



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

+--------------------+-------------------------------+---------------------------------+-------------------------------+
| SoC                | Build Host (OS)               | Run Target (OS)                 | Test Platform                 |
+====================+===============================+=================================+===============================+
| |dev_platform|     | x86_64 (Linux Ubuntu 22.04)   | R5F, C6x, 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-17 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-17>`_, Virtual client: io-pkt: Fix memory leak during CPSW recovery
    `EXT_PSDKQA-24 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-24>`_, SDK to evaluate and remove short_enums compiler flag across modules
    `EXT_PSDKQA-30 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-30>`_, ETHFW + SBL OSPI Fails with QNX OS


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

Below table lists all the defects closed from previous releases:

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

    `EXT_PSDKQA-18 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-18>`_, CPSW5G/9G: Destroying interface freezes prompt
    `EXT_PSDKQA-22 <https://sir.ext.ti.com/jira/browse/EXT_PSDKQA-22>`_, SafeRTOS: IPC echo test fails to ping mcu cores
    `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

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

    +--------+--------------------------+---------------------------------------------------------------------------------+
    | Index  | Module                   |  Description                                                                    |
    +========+==========================+=================================================================================+
    |  1     | A72 DSS on               | The A72 control of DSS on HDMI Display is not working in                        |
    |        | HDMI                     | some scenario.                                                                  |
    +--------+--------------------------+---------------------------------------------------------------------------------+
    |  2     | QNX UDMA RM              | UDMA resource manager may not free UDMA resources when client exits             |
    |        |                          | unexpectedly.                                                                   |
    +--------+--------------------------+---------------------------------------------------------------------------------+

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

    +--------+--------------------------+---------------------------------------------------------------------------------+
    | Index  | Module                   |  Description                                                                    |
    +========+==========================+=================================================================================+
    |  1     | QNX UDMA RM              | UDMA resource manager may not free UDMA resources when client exits             |
    |        |                          | unexpectedly.                                                                   |
    +--------+--------------------------+---------------------------------------------------------------------------------+
    |  2     | QNX virtual display      | QNX virtual display is not part of the screen package. Please refer the         |
    |        | config                   | screen release notes for more details or contact QNX representative.            |
    +--------+--------------------------+---------------------------------------------------------------------------------+
    |  3     | QNX Networking (io-sock) | Issues have been seen trying to run io-sock with revision                       |
    |        |                          | com.qnx.qnx800.target.net.iosock/0.0.2.00417T202407041502L. Please use the      |
    |        |                          | specified revision mentioned above. Further support should be directed to QNX.  |
    +--------+--------------------------+---------------------------------------------------------------------------------+

.. _release_notes_errata:

Errata
======

   * UDMA

       * 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

