2.1. Release Notes - 07_03_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 highligted in Fixed Issues also please check Upgrade and Compatibility for backward compatibility
2.1.2. What’s New¶
| ID | Description | Module | Supported Platforms |
|---|---|---|---|
| JACINTOREQ-1040 | Support for AM65xx SR2.1 | COMMON | AM65xx |
| PINDSW-4824 | Unified Ethernet LLD supporting ICSSG | Ethernet | AM65xx |
| PDK-8726 | OSPI Cache Support | OSPI | J721E, J7200, AM65xx |
| ETHFW-1697 | Enet LLD - ICSSG support in MAC mode | ENET | AM65XX |
| ETHFW-1698 | Enet LLD - ICSSG support in Switch mode | ENET | AM65XX |
| ETHFW-1700 | Enet LLD - Time Sync support for ICSSG | ENET | AM65XX |
| ETHFW-1734 | TimeSync: Integrate ICSSG in TimeSync LLD v2 | ENET | AM65XX |
2.1.3. Upgrade and Compatibility¶
2.1.3.1. emac¶
- pdk/packages/ti/drv/emac Will be deprecated in subsequent release
- From SDK versioned v07.03.00, enet drivers support ICSSG ports too
- emac is replaced by enet drivers
2.1.3.2. Sciclient¶
- The Sciclient Sciclient_service API does not accept NULL pointers for the pRespPayload and expects the respPayloadSize to be the size of the structure pointed to by pRespPayload.
2.1.3.3. BoardCfg RM¶
- Sciclient Defaulf BoardCfg RM updated to remove HOST_ID_ALL entries and align with Linux RM Cfg
2.1.3.4. ENET¶
Added support for ICSSG Switch and Dual-MAC Ethernet peripherals.
EnetDma_openRxCh() and EnetDma_openTxCh() APIs now take a handle to the EnetDma object. This handle is usually handily available in application but can also be retrieved from the Enet_Handle via Enet_getDmaHandle().
ENET_RM_IOCTL_ALLOC_RX_FLOW now takes a channel index. This is required for ICSSG Switch where there are two channels with 8 flows each. For ICSSG Dual-MAC or CPSW_2G, application should pass a channel index of 0.
Added ENET_PER_IOCTL_SET_VLAN_AWARE and ENET_PER_IOCTL_SET_VLAN_UNAWARE IOCTLs. Currently supported only in ICSSG peripherals.
EnetPer_Poll() no longer takes just an event mask. It now takes a single event type and optional arguments. Please refer to the specific event type for the arguments to be passed, if any.
txPktTc and txTsId fields have been added to EnetUdma_PktInfo for ICSSG peripheral usage. They are not required for CPSW. No action needed for applications using CPSW peripheral that initialize EnetUdma_PktInfo via EnetDma_initPktInfo(), otherwise must explicity set txPktTc to ENET_TRAFFIC_CLASS_INV.
The following IOCTLs have been renamed.
- CPSW_IOCTL_[UN]REGISTER_RX_DEFAULT_FLOW to ENET_IOCTL_[UN]REGISTER_RX_DEFAULT_FLOW.
- CPSW_IOCTL_[UN]REGISTER_DSTMAC_RX_FLOW to ENET_IOCTL_[UN]REGISTER_DSTMAC_RX_FLOW.
Mdio_Cfg has added isMaster field for cases where MDIO module is shared with multiple peripherals, so only one peripheral (master) must perform the MDIO initial configuration and be skipped by the other peripherals (slaves). This is not needed by applications using CPSW.
Ethernet driver is migrated to ENET LLD in this release. EMAC LLD will be deprecated from next release.
2.1.3.5. Board Library¶
If applications were relying on Board_init (BOARD_INIT_UNLOCK_MMR) API for MMR UNLOCK, the below listed partions is not supported now.
- Main MMR Partition 2 & 6
- MCU MMR Partition 2 & 6
- Wakeup MMR Partition 2 & 6
This change is made to ensure MMR partitions owned by DMSC are not unlocked in board library.
Applications which need access to these MMR partitions have to unlock them explicitly before accessing them and lock them after the access.
2.1.3.6. Board Diagnostics¶
Board diagnostic test framework which integrates diagnostic tests into menu based execution is no longer supported. This module is meant for board manufacturers and not validated as part of the SDK.
Board diagnostic tests serve as reference for board bring-up and they are not recommended to be used as reference for production software development.
2.1.4. Device Support¶
- AM65XX SR1.0 SR2.0, SR2.1 and HS
| sysfw name | AM65xx SR revision |
|---|---|
| sysfw.bin | SR1.0 |
| sysfw-hs-enc.bin | SR1.0 HS |
| sysfw_sr2.bin | SR2.0 & SR2.1 |
| sysfw_sr2-hs-enc.bin | SR2.0 HS & SR2.1 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 |
|---|---|
| Sys Bios | 6_83_02_07 |
| XDC Tools | 3_61_04_40_core |
| Network Development Kit (NDK) | 3_80_00_19 |
| Network Services for NDK (NS) | 2_80_00_17 |
| TI ARM R5F code generation tools | 20.2.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_41_00_01 |
2.1.7. Fixed Issues¶
| ID | Head Line | Module | Affected Versions | Affected Platforms |
|---|---|---|---|---|
| PRSDK-8037 | USB 3.0 Host mode fails on AM65x PG2.0 | USB | 7.02.00 | AM65xx |
| PRSDK-8812 | USB3.0: Baremetal diagnostic test code shall be supported | USB | 7.02.00 | AM65xx |
| PDK-9711 | ICSSG lld example failure when all ports are used together (6 ports)- resource allocation failure on open | PRUSS/Board | 7.01.00 | AM65xx |
| PDK-9705 | ICSSG diag test failure with 128 byte packets | BOARD | 7.01.00 | AM65xx |
| PDK-9693 | mcu1_1 applications fail to run through sbl | SBL | 7.01.00 | AM65xx |
| PDK-9667 | PCIe example failure | PCIe | 7.00.00 | AM65xx |
| PDK-9313 | ICSSG EMAC diagnostic test failure | BOARD | 7.01.00 | AM65xx |
| PDK-8721 | pm system config test fails for mcu1_1 core of am65xx | PM | 7.01.00 | AM65xx |
| PDK-8667 | udma_baremetal_ospi_flash_testapp failing | UDMA | 7.01.00 | AM65xx |
| PDK-8574 | OSPI diagnostic test failure in PHY mode | BOARD | 7.01.00 | AM65xx |
| PDK-8179 | am65 ICSSG HwAttrs error | CSL | 6.02.00 | AM65xx |
| PDK-6707 | [DIAG TEST]: PCIe diagnostic test failure | BOARD | 7.00.00 | AM65xx |
| PDK-6706 | McSPI : Driver Master example is not functional | McSPI | 7.02.00 | AM65xx |
| PDK-5257 | Support Windows Package for Core SDK | COMMON | 7.00.00 | AM65xx |
| PDK-4968 | [BOARD] Board module should not touch lock/unlock for resources owned by DMSC | BOARD | 7.02.00 | AM65xx |
| PDK-8502 | Uniflash flash programmer failure in DMA mode | BOARD | 07.01.00 | J721E, AM65xx |
| PDK-8226 | R5FSS: The same interrupt cannot be nested back-2-back within another interrupt | CSL | 07.00.00 | J721E, AM65xx |
| PDK-6706 | McSPI : Driver Master example is not functional | McSPI | 07.00.00 | J721E, AM65xx |
| PDK-9770 | GPIO_LedBlink_TestApp : Interrupt not observed on ES 2.0 | GPIO | 07.00.00 | AM65xx |
2.1.8. Known Issues¶
| ID | Head Line | Module | Reported in Release | Affected Platforms | Impact | Workaround in this release |
|---|---|---|---|---|---|---|
| PDK-9748 | USB : 3.0 : Hagiwara drive : fails to enumerate as 3.0 : once in 250 times average | USB 3.0 | 07.00.00 | AM65xx | Hagiwara USB 3.0 devices may not be enumerated as 3.0 | Consider operating in 2.0 mode |
| PDK-9750 | USB: USB3.0 enumeration failing for some of the adapters | USB 3.0 | 07.00.00 | AM65xx | Some of USB 3.0 devices may not be enumerated as 3.0 | Consider operating in 2.0 mode |
| PDK-9751 | PCIE-0 : Gen 3 : Intermittent failures during Gen 3 mode on AM65x PG2.0 | PCIe | 07.00.00 | AM65xx | GEN 3 mode is stable | Use GEN 2 mode |
| PDK-8946 | McSPI : All data words not transmitted in FIFO, interrupt mode when length not divisible by FIFO | McASP | 07.01.00 | AM65xx | In Complete data transfers | Transfer length should be multiple of FIFO depth |
| PDK-9717 | AM65xx : SA2UL : Demo application is not functional | SA2UL | 07.03.00 | AM65xx | SA2UL Is not functional | None |
| PDK-8846 | [DSS Test]Sync-lost is observed for RGB24/BGR24 test-cases | DSS | 07.01.00 | AM65xx | No images displayed on the screen / flicker | None |
| PDK-8841 | csl_cbass_baremetal_test_app fails on QoS Test | CBAS | 07.01.00 | AM65xx | None | None |
| PDK-6742 | McASP regression test app some tests are failing | CBAS | 07.00.00 | AM65xx | None | None |
| PDK-8166 | MMCSD read/write failure with 1.8V - no I/F to program timings params | MMC/SD | 07.00.00 | AM65xx | Requires timing update in driver io != 3.3v | None |
| PDK-5224 | Active DP -> HDMI adapter doesn’t work | DSS | 00.09.01 | J721E | DP to HDMI adapter for display cannot be used. | None |
| PDK-6992 | Display flickers for BT601 output format | DSS | 07.00.00 | J721E | None | |
| PDK-8320 | ICSS V1 CSL not up to date with ICSSG | CSL | 07.00.00 | J721E, AM65xx | None | Patch available. Will be included in next release |
| PDK-9437 | Increase in Boot time when DDR ECC is enabled | BOARD | 07.02.00 | J721E, J7200 | Increase in boot time | Use UDMA for priming the DDR. |
| PDK-9456 | I2C Driver does not return error when camera/client is not available on the I2C bus | I2C | 07.02.00 | J721E | Application continues even if sensors programming has failed. | None |
| PDK-9433 | MASTER _BYPASS bit in PHY_MASTER_CONTROL should be controlled based on the clock | OSPI | 07.01.00 | J721E | None | None |
| PDK-6975 | Pulsar (R5F) : High priority interrupt is missed by VIM | CSL, OSAL | 07.00.00 | J721E, J7200, AM65xx | Baremetal implementation is pending | Use SYSBIOS instead of baremetal |
| PDK-8407 | J721E: MCU Timer 0 is not usable from application (sysbios) with SBL | OSAL, SBL | 07.01.00 | J721E | None | Use any other timer |
| PDK-8300 | UDMA MCU NAVSS Channel Num 5 is not functional, when booting the application using the SBL bootloader. | UDMA | 07.01.00 | J721E | Low Impact. UDMA MCU NAVSS Channel 5 can’t be used when booting the application using the SBL bootloader. | Use any other channel. In the defaultBoardCfg Channel no. 5 is not used. The issue will be seen only when the boardcfg is updated to use channel 5. |
| PDK-6789 | MCU/Main NAVSS UDMA memcpy from L2SRAM fails | UDMA | 07.00.00 | J721E | Transfer works fine when source buffer, destination buffer and TRPD buffers are in L2SRAM. The issue happens only when the ring memory is in L2SRAM location | Use ring memory from non-L2SRAM location |
| PDK-5228 | Output mismatch when each region requiring 3 TRs | VHWA | 01.00.00 | J721E | In multi-region mode with more then 3 TR per region can’t be used | In multi-region mode for each region less than 3 TR should be used |
| PDK-5226 | DOF generated wrong output with SOF if pixel in all row are not enabled | VHWA | 01.00.00, 00.09.01 | J721E | When using the SOF if the Paxel rows without any pixel enabled is not in consecutive pair with lead to lead to output mismatch | This issue is due to shift in flowvector out buffer. While generating the SOF binary map make sure that Paxel rows without any pixel enabled should be in consecutive pair |
| PDK-5217 | VPAC VISS driver doesn’t support several valid mux combinations for outputs | VHWA | 01.00.00, 00.09.01 | J721E | VISS output with Chroma only and one of the RGB component enabled may not work | Enable YUV420 instead of Chroma only while using RGB component |
| ETH-1534 | [CPSW] Packet drop with QSGMII ports IPerf | Enet | 06.02.00 | J721E, J7200 | None | None |
| ETH-1670 | mcu2_1: loopback: Test fails to setup interrupts in iteration 2 | Enet | 07.01.00 | J721E | None | Avoid restarting Enet LLD on J721E mcu2_1 core |
| PRSDK-5074 | McASP driver hangs with small buffer size | McASP | 05.01.00 | J721E, AM65xx | None | Use packet size 32 samples or greater |
| PDK-6549 | MCU2 core diagnostic tests not running through sbl | BOARD | 07.00.00 | J721E | None | Use CCS/JTAG to run the tests |
| PDK-6548 | Display port (eDP) diagnostic test failure | BOARD | 07.00.00 | J721E | None | Use display sample application |
| PDK-8577 | PMIC: Asynchronous Interrupt tests failure on Main domain R5 Cores and mcu1_1 core | BOARD | 07.01.00 | J721E | None | Use Polled mode |
| PDK-9426 | ECAP CSL Capture Event Counter Reset Function Fails | CSL | 07.03.00 | J721E, J7200 | None | None |
| PDK-8601 | CSL ECC test application fails on J721E and J7200 | CSL | 07.01.00 | J721E, J7200 | None | None |
| PDK-9528 | SBL prebuild binary for J721E HS doesn’t work from package | SBL | 07.03.00 | J721E-HS | None | Cleanup the SBL library and re-build the SBL image for HS. Commands: - Clean sbl_lib_uart (make sbl_lib_uart_clean) - Build for HS (make -sj sbl_uart_img_hs) |
| PDK-8653 | CSI2-RX: Stream FIFO Overflow observed for 4 channel input with FrameSync | CSI2-RX | 06.02.00 | J721E | Multi-channel capture with FrameSync cannot be used. | None |
| PDK-8600 | SBL optimizations for OSPI boot mode | SBL | 07.00.00 | J721E | None | None |
| PDK-9490 | OSPI_Baremetal_Flash_Dma_TestApp fails on mpu1_0 in release mode | OSPI | 07.03.00 | J7200 | None | None |
| ETHFW-1810 | icssg: RX ch teardown timed out observed in NIMU restart | ENET | 07.03.00 | AM65XX | Low - observed during shutdown sequence | None |
| ETHFW-1747 | enet: icssg: Incorrect rxTxTotalByte in unicast test | ENET | 07.03.00 | AM65XX | Low - network statistics, no functional impact | None |
| ETHFW-1767 | timesync: v2: TimeSync PTP restart is not supported | ENET | 07.03.00 | AM65XX | Impacts only applications that require stack restart | None |
| ETHFW-1809 | DUT stopped forwarding frames in one direction | ENET | 07.03.00 | AM65XX | Firmware doesn’t handle long burst of packets at line rate | None |
2.1.9. Limitations¶
2.1.9.1. PDK¶
- PDK examples do not supported SMP mode. Some of examples still support build in SMP mode but these binaries are not supported or validated.
2.1.9.2. ENET¶
- ICSSG integration with NDK is done only for ICSSG Dual-MAC. Driver level support is available for Dual-MAC and Switch.
- TimeSync PTP integration is done only for ICSSG-Dual MAC.
- TimeSync is possible only in one MAC port at a time.
- Different VLAN modes are not supported in Dual-MAC mode (within given ICSSG MAC ports). Both MACs should either be in VLAN aware or VLAN unaware mode.
- Independent VLAN learning is not supported in Dual-MAC mode.