Product Release Notes
Table of Contents
Introduction
This is the release notes for MCUSW_J7_09.01.00 release, produced on 2023-11-10.
The MCUSW package consists of MCAL Driver & Demos/Applications for J721E/J7200/J721S2/J784S4 family of devices . The MCAL modules are compliant to AUTOSAR specification versioned 4.3.1 .
Licensing
Refer to Processor SDK Automotive manifest at top level and MCUSW Manifest for MCUSW Manifest.
Getting Started
The MCUSW User Guide provides the documentation and references necessary to begin development on TI’s platforms using MCUSW.
Documentation
- MCUSW User Guide:
- MCUSW Configurator User Guide:
This document details Supported driver, Installation, Dependencies, Build instructions, Steps to run example applications, Module Specific User Guides, API Guide, Test Reports, Design Document and others.
Refer this before attempting to reconfigure MCAL modules. This include steps to Install Configurator (EB), Configurator Licensing, Generation of MCAL Configurations and others.
Dependencies
NOT Included in MCUSW Package:
MCUSW MCAL Configurator lists the steps required to get access to Configurator.
Configurator package name is MCUSW_09_01_00_10_CONFIG-windows-installer.exe, and contains following items:- MCAL Configurator Plugins (${EB_INSTALL_DIR}/mcal_drv/mcal_config)
- MCAL Compliance Support Package with Safety Collateral. Please note: MCUSW_J7_03.00.00 Release (SDK8.6) is Safety Certified.
What’s New
New features supported in this release:
- The MCUSW Release Version is updated to follow new Version number scheme.
- Updated Compiler Version: ti-cgt-armllvm_3.2.0.LTS
- Several Fixed Defects.
Compatibility
Please note that the MCAL Release Versioning has changed and now is in accordance with AUTOSAR requirement SRS_BSW_00321. The MCAL Module Version number (Major.Minor.Patch) is updated only during release cycle based on the change in source/compatibilty with previous release. MCAL Modules will not have a common version number. MCAL Package release version and the Bundle Version of the configurator plugins will be updated for each new release.
Details based on SRS_BSW_00321. The Version numbers of MCAL AUTOSAR Basic SW Modules shall be enumurated according to the below rules:
- Increasing the more significant digit of a version number resets all less significant digits.
- PATCH_VERSION is incremented if the module is still upwards and downwards compatible (ex. Bug fixes).
- MINOR_VERSION is incremented if the module is still downwards compatible (ex. valid functionality added).
- MAJOR_VERSION is incremented if the module is not compatible any more (ex. existing API valid).
IMPORTANT NOTE: User should ensure to use below modules version for MCUSW_J7_09.01.00 release. User should take care to not mis-match or mix-and-match the versions with various MCUSW releases. Bundle Version of all plugins is 9.1.0.
| Module | Module Version for Release | Remarks |
|---|---|---|
| ADC | 9.0.1 | Minor Bug Fix. Refer to “Fixes Defects” |
| CAN | 9.0.1 | Minor Bug Fix. Refer to “Fixes Defects” |
| CDD IPC | 10.0.0 | User should re-generate the CDD IPC configuration files, and create seperate interrupt call back for each configured channel. Please refer to provided CDD IPC example application. |
| DIO | 9.0.1 | Minor Bug Fix. Refer to “Fixes Defects” |
| GPT | 9.0.1 | Minor Bug Fix. Refer to “Fixes Defects” |
| ICU | 9.0.1 | Minor Bug Fix. Refer to “Fixes Defects” |
| PWM/EPWM | 9.0.1 | Minor Bug Fix. Refer to “Fixes Defects” |
| MCU | 9.1.0 | Minor Bug Fix. |
| SPI | 9.0.1 | Minor Bug Fix. Refer to “Fixes Defects” |
| FLS | 10.0.0 | Configuration update to support custom flash. Refer to FLS User guide. |
| WDG | 9.0.0 | None |
| ETH | 9.1.0 | Configuration Changes Required. |
| ETH TRCV | 9.1.0 | Configuration Changes Required. |
| OS | 9.0.1 | Minor Bug Fix. Refer to “Fixes Defects” |
| EcuM | 9.0.0 | None |
| DEM | 9.0.0 | None |
Ethernet Driver (Virtual MAC)
Virtual MAC driver has migrated to ETHFW version 0.4.0 which provides a modified set of commands and parameters. The impact on Virtual MAC driver is summarized in table below.
| Virtual MAC API | Remarks |
|---|---|
Eth_DispatchVirtmacAddUnicastAddr() |
API has been removed. User can use Eth_DispatchVirtmacSubscribeDstMac() instead |
Eth_DispatchVirtmacAddMcastAddr() |
Parameter changes. numLsbToIgnore and portList are no longer required |
Eth_DispatchVirtmacDelAddr() |
Should be used exclusively to delete multicast addresses added via Eth_DispatchVirtmacAddMcastAddr() as opposed to unicast/multicast as in previous release |
Eth_DispatchVirtmacAddVlan() |
Parameter changes. portList no longer required as the VLAN is created by ETHFW only. Remote clients can only join/leave the VLAN |
Eth_SendCustomNotify() |
API has been removed. ETHFW no longer supports client-to-server notifications |
Consequently, Ethernet VirtMAC utilities also changed. This is the recommended porting guideline:
| Previous version | Replaced by | Remarks |
|---|---|---|
EthUtils_VirtMacsubscribeDefaultAddr() |
EthUtils_VirtMacRegisterMacAddr() |
Enables unicast traffic forwarding towards VirtMAC driver |
EthUtils_VirtMacsubscribeDefaultAddr() |
EthUtils_VirtMacSubMcastAddr() |
Subscribes to a multicast (it must be exclusive multicast) |
EthUtils_VirtMacaddSubHostUcastAddr() |
EthUtils_VirtMacRegisterMacAddr() |
Disables unicast traffic forwarding to VirtMAC driver |
EthUtils_VirtMacaddSubMcastAddr() |
EthUtils_VirtMacSubMcastAddr() |
Subscribes to a multicast (it must be exclusive multicast) |
EthUtils_VirtMacdelUnsubAddr() |
EthUtils_VirtMacUnsubMcastAddr() |
Unsubscribes from a multicast (it must be exclusive multicast) |
EthUtils_VirtMacaddVlanId() |
EthUtils_VirtMacJoinVlan() |
Joins a VLAN previously setup by ETHFW |
EthUtils_VirtMacdelVlanId() |
EthUtils_VirtMacLeaveVlan() |
Leaves a VLAN previously joined |
Device Support
Supported SoCs: J721E & J721S2 & J7200 & J784S4
Validation
This release was built and validated using the following tools.
Build Tools (included in Processor SDK)
- ti-cgt-armllvm_3.2.0.LTS
Fixed Defects
| ID | Summary |
|---|---|
| MCAL-17627 | canTxstatus is busy even after Cancellation of Finished messages is set for respective Tx Buffer |
| MCAL-17626 | tempCount = startCount outside do-while loop in CAN ,but inside the do-while loop in other drivers. |
| MCAL-16825 | Possible type mismatches Uint32 to uint32 for Eth |
| MCAL-16042 | ETH: MDIO errata workaround doesn't deliver requested MDCLK |
| MCAL-15807 | CDD_IPC: DET error in checking for max IPC buffer size |
| MCAL-15806 | Sending Preamble (32 one's) is missing in MDIO Read/Write operation in Manual Mode |
| MCAL-15778 | Icu, Pwm configured to interrupt category 2,give linker error: |
| MCAL-15776 | Compiling errors in J7 - CSL Files |
| MCAL-15384 | Asynchronous Jobs in FLS driver |
| MCAL-13028 | SPI application build error with precompile configuration |
| MCAL-12923 | Type casting issue in CDD IPC |
| MCAL-12658 | EPWM Example: Waveforms not generating required voltage |
| MCAL-12657 | ICU Example: Proper PIN information is not known (residual from PWM/EPWM Applications) |
| MCAL-11548 | ICU Driver: Wrong implementation of ICU ISR in plugin for CAT2 |
| MCAL-8751 | Mailbox index always passed as 0 in case of TX interrupt processing for FIFO |
Open Defects
| ID | Summary |
|---|---|
| MCAL-19254 | j784s4 fls_app_dac phy tune sometimes fail |
| MCAL-19128 | fls_app (interrupt) interrupt configuration error on XSPI EVMs in both release and debug mode |
| MCAL-16824 | Possible type mismatches because of usage e.g. sint32 in combination with int32_t: |
| MCAL-15390 | MCAL OSPI NOR Flash Driver - 4 bytes addressing mode not available in SDR conifguration |
| MCAL-15304 | Reserved pins mismatch in DIO configuration file for WKUP_GPIO0 |
| MCAL-12893 | MCAL CSL_armR5CacheWb API not updated based on PDK-12218 |
| MCAL-12871 | SPI Driver: MCU2_1 Core Application Hung |
| MCAL-12556 | MCU Reset not performed by SYSFW but direct register write instead |
| MCAL-9620 | Spi_AsyncTransmit can not transmit more than 32 bytes |
| MCAL-8518 | SPI_setupEB cannot support DMA transfers greater than 32-bits |
| MCAL-8514 | Spi_AsyncTransmit taking longer than expected |
| MCAL-8350 | FLS Driver instability with read-lengths not multiples of 256 bytes |
| MCAL-5205 | can_profile_app not giving CAN TX signal output on J721E HS device |
Known Limitations
| Module | Remarks | Workaround |
|---|---|---|
| CDD IPC | CDD IPC Profile App not supported in this release | User should use CDD IPC App for reference. |
| CDD IPC | CDD IPC Linux App on mcu1_0 core not validated in this release | User should use CDD IPC App Linux on mcu2_1 core for reference. |
Support
For technical support and additional assistance, visit E2E or contact local TI Field Application Engineer.