2.1. Release Notes - 08_06_00

2.1.1. Introduction

This release notes provides important information that will assist you in using the PDK software package for the Jacinto family of devices. This document provides the product information and known issues that are specific to the PDK software package.

New features added / supported is listed below and defects fixed are highlighted in Fixed Issues. Also please check Upgrade and Compatibility for backward compatibility

2.1.2. What’s New

ID Description Module Supported Platforms
NA NONE NA NA

2.1.3. Upgrade and Compatibility

2.1.3.1. PDK

  • Added new target, namely safertos_examples, to build all SafeRTOS examples supported by PDK.
    • For Example: make -sj custom_target BUILD_TARGET_LIST_ALL=safertos_examples BOARD=<board> BUILD_PROFILE_LIST_ALL=<list_of_build_profiles>

2.1.3.2. SafeRTOS

  • SafeRTOS examples earlier named as test_task_switch_safertos and safertos_test_ut are now renamed as task_switch_safertos and unit_test_safertos respectively.

2.1.3.3. OSAL

  • For SafeRTOS, all tasks are created with FPU enabled.

  • clockfxn paramater for ClockP_create is updated from type ‘void*’ to function pointer of type ClockP_FxnCallback

    void (*ClockP_FxnCallback)(void *args);
    

2.1.3.4. RTOS

  • C7X support files such as boot.c, Startup.c, Cache.c, etc, are moved to the CSL layer. They were earlier part of the respective RTOS portable layer.

2.1.3.5. OSPI

  • A New parameter “opMode” is added to CSL_ospiConfigPhyDLL() API. This lets user to configure Phy to operate in either master mode or bypass mode.

2.1.4. Device Support

  • J721S2 GP SR 1.0 (BOARD=j721s2_evm)

  • Associated TIFS versions:

    TIFS name J721S2 SR revision
    tifs.bin SR1.0 GP
    tifs-hs-enc.bin SR1.0 HS

2.1.5. Validation Information

For details on the validated examples refer to the platform specific test report available here.

2.1.6. Tool Chain Information

Component Version
FreeRTOS Kernel 10.4.3
lwIP stack 2.1.2
lwIP-contrib 2.1.0
TI ARM CLANG 1.3.0.LTS
PRU code generation tools 2.3.3
GCC ARM code generation tools ARCH64 9.2-2019.12
CGT XML Processing Scripts 2.61.00
System Analyzer (UIA Target) 2_30_01_02
Component Version
TI C7x code generation tools 3.1.0.LTS

2.1.7. Change Request

Refer to monthly roadmap slides for changes in the planned features

2.1.8. Fixed Issues

ID Head Line Module Affected Versions Affected Platforms
PDK-12241 CSIRX: Incorrect DATA Shift value for RAW8 mode CSI2RX 08.04.00 J721E, J721S2, J784S4
PDK-12242 CSIRX: Incorrect Dual Pixel mode for YUV422 CSI2RX 08.04.00 J721E, J721S2, J784S4
PDK-12023 Heap OSAL hangs if previous allocation has buffer overflow OSAL 08.02.00 J721E, J721S2
PDK-12085 [DSS] HPD Pulse event is not handled in the eDP driver DSS 08.02.00 J721E, J721S2, J784S4
PDK-11984 J721S2/TDA4VE : Missing PCIE+USB3 multilink Torrent CSL in PDK CSL 08.04.00 J721S2
PDK-12233 SciServer: Multiple definition of Hwi Data SCICLIENT 08.04.00 J721E, J7200, J721S2, J784S4
PDK-12258 MCSPI DMA does not support 48bit address space MCSPI 08.04.00 J721E, J7200, J721S2, J784S4
PDK-12327 FreeRTOS taskLoad is not proper OSAL 08.02.00 J721E, J7200, J721S2, J784S4
PDK-12358 Non-supported Sciclient APIs are present in header files SCICLIENT 08.04.00 J721E, J7200, J721S2, J784S4
PDK-12544 [DOC]: Update the doc the signed SBL cannot work on GP device SBL 08.05.00 J721S2
PDK-12493 While loop in SemaphoreP_reset() waits from return value 0 which is not available OSAL 08.04.00 J721S2
PDK-12416 CSL: Wrong PCIe files are packaged in SDK CSL 08.04.00 J721S2, J784S4
PDK-12491 SBL: SBL_authentication() function is not defined SBL 08.05.00 J721E, J7200, J721S2, J784S4
PDK-12406 OSPI PHY Tuning - DLL Half Clock Lock Mode w/ DTR enabled OSPI 08.02.00 J721E, J7200, J721S2, J784S4

2.1.9. Known Issues

ID Head Line Module Reported in Release Affected Platforms Impact Workaround in this release
PDK-11854 USART: Spurious DMA Interrupts UART 08.04.00 J721E, J7200, J721S2 None None
PDK-11973 USART: Erroneous clear/trigger of timeout interrupt UART 08.02.00 J721E, J7200, J721S2 None None
PDK-12163 [CSIRX]: YUV422-8bit data-type capture not working CSIRX 08.04.00 J721S2 None None
PDK-12213 IPC: stack corruption of taskWaiter used in RPMessage_getRemoteEndPt IPC 08.00.00 J721E, J7200, J721S2, J784S4 None Make taskWaiter element as global
PDK-12243 DSS: rxBuffer range check missing in DP_mailbox DSS 08.04.00 J721E, J721S2, J784S4 DP sink module should not send message > 1 KB size None
PDK-12257 [DSS/eDP]: Busy Waiting in eDP driver causes hang DSS 08.04.00 J721E, J721S2 Can cause hang in the display driver in case mailbox is empty. None
PDK-12461 [OSAL]: Mutex implementation uses recursive mutex of FreeRTOS OSAL 08.05.00 J721E, J721S2, J784S4 Misleading naming convention of FreeRTOS Mutex APIs None
PDK-12489 [DOF]: Predictors are reset in the SET_PARAMS control command VHWA 08.05.00 J721E,J721S2 If the predictors are changed in the same handle,dof does not work and returns error in the SubmitRequest API None
PDK-12551 J721S2/J784S4: Main2MCU IRQ Router allocations fail for output lines 32 to 41 SCICLIENT 08.05.00 J721S2, J784S4 Cannot use Main2MCU IRQ Router allocations for output lines 32 to 41 None
PDK-12570 GLBCE is not correctly enabled in multi-handle scenario VHWA 08.05.00 J721E, J721S2, J784S4 When VISS driver is used in multi-handle scenario with one of the handle having GLBCE disabled,driver does not enable GLBCE properly for the handles where it is enabled. None

2.1.10. Limitations

2.1.10.1. PDK

  • PDK examples do not support SMP mode. Some of examples still support build in SMP mode but these binaries are not supported or validated.
  • TI Clang compiler does not enable O3 optimization level and Thumb2 mode which were enabled by default with TI ARM CGT compiler. This has an impact on driver throughput. E.g. Ethernet performance has reduced by ~20% on J721S2
  • The PMU counter overflow is not handled in Baremetal for use of CycleprofilerP APIs or the TimerP_getTimeInUsecs API.
    • Applications can periodically use the CycleprofilerP_refreshCounter to check overflow and refresh the higher bits of the PMU counter.

2.1.10.2. ENET

  • Scatter-gather functionality is currently supported only for packet transmission.

2.1.10.3. SafeRTOS

  • OSAL APIs namely, HwiP_disable and HwiP_restore can only be called from a privileged mode. These APIs will give an assertion error for an unprivileged context.
  • When snprintf is interrupted by an ISR, C7X core may crash while returning from the ISR. - As a workaround, snprintf can be protected with Hwip_disable() and HwiP_restore() to disable the interrupts.