MSPM33 SDK Release Notes

Table of Contents

Important Notes

• 📝 Updated information will be posted online at e2e.ti.com.

Introduction

The MSPM33 SDK delivers components that enable engineers to develop applications on Texas Instruments MSPM33 microcontroller devices. The product is comprised of multiple software components and examples of how to use these components together. In addition, examples are provided to demonstrate the use of each functional area and each supported device and as a starting point for your own projects.

The MSPM33 MCU portfolio offers a single development environment that delivers flexible hardware, software and tool options for customers developing applications. A one-time investment with the MSPM33 software development kit (SDK) allows you create portable and modular code, opening the door to create unlimited applications.

This is version 1.03.00.01 of the MSPM33 SDK.

Documentation

• MSPM33 SDK Documentation Overview
• MSPM33 SDK Documentation Overview - Chinese
• MSPM33 SDK Known Issues and FAQ
• Software License
• Software Manifest

What’s Included

The MSPM33 SDK includes the following features:

• DriverLib and Header Files - v1.03.00:
  • Support for MSPM33C321A
• SysConfig - v1.03.00:
  • Support for code generation of all DriverLib peripherals
  • Clock Tree for easier configuration of Clock System
  • NONMAIN Configurator
  • Security Configuration
  • Project Configuration
  • QSPI module support
• Security:
  • Peripheral protection examples
  • Debug unlock examples
  • BSL Host examples for I2C and UART.
  • Boot manager - Customer Secure code.
• Middleware:
  • CMSIS DSP Library v1.16
  • LIN Commander and Responder examples
  • EdgeAI - Motor fault detection, AC arc fault detection, PIR detection, character recognition, blower imbalance, torque measurement, and generic timeseries examples
  • QSPI Flash abstraction layer
• Code examples:
  • Hundreds of examples from low-level drivers
• RTOS:
  • FreeRTOS Library - v11.2.0
• Documentation:
  • Comprehensive software documentation including user guides and multiple API guides
  • Tools Guide including quick start guides and user guides for MSPM33 tools including IDEs, code generation, debuggers and programmers

What’s New

This release v1.03.00.01 includes:

• DriverLib Library - v1.03.00.01:
  • Modified read waitstate APIs for main, trim and engineering regions in dl_core.h
  • Fixed truncated UART driverlib API macro names
  • Fixed DL_VREF_isPowerEnabled to use passed VREF instance parameter
  • Fixed DL_TRNG_isPowerEnabled to use passed TRNG instance parameter
  • Fixed DL_FlashCTL_getFlashSectorNumber unused argument warning
  • Fixed DL_GPIO_setDigitalInternalResistor casting warning
  • Fixed DL_RTC_Common_getTimeStampCalendar linking error for non-RTC_A devices
  • Added SystemInit() with FPU coprocessor initialization for MSPM33C321x
• Middleware
  • Updated CMSIS DSP Library to v1.16
  • Added LIN Commander and Responder examples (ported from MSPM0)
  • Added EdgeAI middleware (msp-ai) with motor fault detection, AC arc fault detection, PIR detection and waveform classification examples
  • Added QSPI Flash abstraction layer (source/ti/external_flash)
  • Added HAL abstraction layer (source/ti/hal) with compiler and UART HAL support
  • MSP Crypto Library: Added RSA-2048 signature verification (PSS and PKCS#1 v1.5 padding)
  • MSP Crypto Library: P-384 curve operations now use hardware PKA acceleration
  • Boot Manager: Added HW SHA with CPU copy support for larger image sizes
  • Boot Manager: Documented bank swap policy and NonMain configuration for both banks
• Examples
  • Driverlib
    • HSADC
      • hsadc_max_freq_dma
    • I2C
      • i2c_controller_display_throughput
      • i2c_target_display_throughput
    • SPI
      • spi_controller_display_throughput
      • spi_peripheral_display_throughput
    • UART
      • uart_tx_display_throughput
      • uart_rx_display_throughput
    • RTC
      • rtc_calibration_lfxt_utc
    • DMA
      • dma_gather_transfer
  • Demos
    • QSPI NOR Flash
      • qspi_flash_readback_QPI
      • qspi_flash_readback_DMA
  • EdgeAI
    • ac_arc_fault_data_capture
    • ac_arc_fault_deploy
    • ac_arc_fault_detection_live_preview
    • arc_fault
    • blower_imbalance
    • character_recognition
    • generic_timeseries_anomalydetection
    • generic_timeseries_classification
    • generic_timeseries_classification_live_preview
    • generic_timeseries_forecasting
    • generic_timeseries_regression
    • motor_fault
    • motor_fault_data_capture
    • motor_fault_deploy
    • motor_fault_live_preview
    • pir_detection_ai
    • pir_detection_data_capture
    • pir_detection_live_preview
    • timeseries_data_capture
    • torque_measurement
    • waveform_classifier_ai
  • LIN
    • lin_commander
    • lin_responder
  • BSL
    • secondary_bsl_empty
  • Crypto
    • Hash
      • hash_sha256
      • hash_sha384
      • hash_sha512
    • PQC ML-DSA
      • pqc_mldsa_44_keygen
      • pqc_mldsa_44_sign_pure
      • pqc_mldsa_44_sign_ctx_pure
      • pqc_mldsa_44_sign_ctx_prehash
      • pqc_mldsa_44_verify_ctx_pure
      • pqc_mldsa_44_verify_ctx_prehash
      • pqc_mldsa_65_keygen
      • pqc_mldsa_65_sign_pure
      • pqc_mldsa_65_sign_ctx_pure
      • pqc_mldsa_65_sign_ctx_prehash
      • pqc_mldsa_65_verify_pure
      • pqc_mldsa_87_keygen
      • pqc_mldsa_87_sign_pure
      • pqc_mldsa_87_sign_ctx_pure
      • pqc_mldsa_87_sign_ctx_prehash
      • pqc_mldsa_87_verify_ctx_pure
      • pqc_mldsa_87_verify_ctx_prehash
  • Security
    • Added GCC compiler support for all security examples (TrustZone, GSC, Debug Lock)
• SysConfig
  • Added QSPI peripheral module support with code generation
  • Added DMA gather mode configuration support
  • Fixed HSADC pinmux for SOC channel pin resources and internal signal filtering
  • Enabled UARTLIN in SysConfig view
  • Fixed MCANCLK divider macro name in SYSCTL code generation
  • Fixed SYSPLL_Freq_CLK2X property name case mismatch
  • Fixed QSPI DMA trigger values and removed RX timeout for controller-only mode
  • Fixed NonMain NVM configuration descriptions
  • Fixed NonMain write protection variable name mismatch
  • Fixed Bank 0 block address calculation for sectors 32-63
  • Fixed flash bank swap CRC mismatch in NonMain configuration
• Tools
  • Added Arm GCC toolchain support

Operating Systems Support

• Windows 11
• Ubuntu 22.04
• macOS Sequoia

Dependencies

This release was validated with the following components:

• Code Composer Studio
  • Code Composer Studio 20.5.0
• TI Arm Clang Compiler
  • TI Clang v4.0.4_LTS. Also included with CCS 20.5.0
• SysConfig
  • SysConfig 1.27.x. Also included with CCS 20.5.0.
• GNU Code Generation Tools
  • Arm gcc-arm-none-eabi-9-2019-q4-major.
• IAR Embedded Workbench
  • IAR for Arm 9.70.2.
  • IAR patch for MSPM33 device support

Device Support

• MSPM33C321A

Known Issues

Please refer to the MSPM33 SDK Known Issues and FAQ document for a detailed list of known issues and workarounds.

Upgrade and Compatibility Information

• DriverLib API changes:
  • DL_VREF_isPowerEnabled and DL_TRNG_isPowerEnabled now use the passed instance parameter instead of a fixed instance. Code relying on the previous behavior should verify the correct instance is passed.
  • HSADC PPB zero-crossing feature has been removed. Code using this feature should be updated.
  • Several UART driverlib API macro names were truncated in previous releases and have been corrected. Code using the old truncated names will need to be updated.
  • Read waitstate APIs in dl_core.h have been modified for main, trim and engineering regions.
• CMSIS DSP: Updated from v1.7.0 to v1.16. Refer to CMSIS DSP release notes for any API changes.
• Crypto Library: P-384 curve operations now use hardware PKA acceleration instead of software implementation. This may affect timing behavior of cryptographic operations.

Previous Releases

• v1.02.00.00
• DriverLib Library - v1.02.00.00:
  • PKA
• Middleware
  • Added support for CMSIS DSP Library v1.7.0
• Examples
  • Driverlib
    • sysctl_shutdown
    • i2s_target_read_multibyte_fifo_poll
    • i2s_controller_write_multibyte_fifo_poll
  • Demos
    • lvgl
    • cc3200boosterpack_audio_playback
  • CMSIS DSP
    • cmsis_dsp_fft_q15
    • cmsis_dsp_empty
  • Security
    • peripheral_protect_basic
      • peripheral_protect_basic_secure
      • peripheral_protect_basic_non_secure
    • peripheral_protect_dma
      • peripheral_protect_dma_secure
      • peripheral_protect_dma_non_secure
    • debug_unlock_L2
      • debug_unlock_L2_secure
      • debug_unlock_L2_non_secure
    • ecdsa_p256
      • ecdsa_p256_sign
      • ecdsa_p256_sha256_verify
    • ecdsa_p384
      • ecdsa_p384_sign
      • ecdsa_p384_verify
    • ecdsa_p521
      • ecdsa_p521_sign
      • ecdsa_p521_verify
  • BSL
    • bsl_host_mcu_to_mspm33c321a_target_uart
    • bsl_host_mcu_to_mspm33c321a_target_i2c
  • Boot Manager
    • customer_secure_code
    • customer_secure_sample_image
• Middleware
  • Implementation of the publicly available MCUboot for secure booting
    • Dual Authentication Support using ECDSA (P-256) and MLDSA-87
    • Image verification and secure boot capabilities
    • Rollback protection for enhanced security
• v1.01.00.00_EA2
  • SysConfig - v1.26.0:
    • New modules with syscfg support
      • HSADC
      • I2S
      • Clock tree
  • DriverLib Library - v1.01.00.00:
    • MSPM33MR-27: The MSPM33 DriverLib shall support the QSPI module (DL_QSPI)
    • MSPM33MR-28: The MSPM33 DriverLib shall support the I2S/TDM serial audio interface module (DL_SAI)
    • MSPM33MR-182: The MSPM33 DriverLib shall support the comparator channel scanning HW state machine for low power analog monitoring
  • Examples
    • Security
      • memory_protect
        • memory_protect_secure
        • memory_protect_non_secure
      • gpio_toggle
        • gpio_toggle_secure
        • gpio_toggle_non_secure
    • Driverlib
      • Timer
        • timx_timer_mode_capture_duty_and_period
        • timx_timer_mode_capture_edge_capture
        • timx_timer_mode_compare_edge_count
        • timx_timer_mode_pwm_center_stop
        • timx_timer_mode_pwm_edge_sleep
        • timx_timer_mode_pwm_edge_sleep_shadow
        • timx_timer_mode_pwm_x_trig_stop_restore
      • Systick
        • systick_periodic_timer
      • Scratchpad
        • scratchpad_retain_on_vdd_loss
      • RTC
        • rtc_offset_calibration_lfxt
        • rtc_termperature_calibration_lfxt
      • MCAN
        • mcan_single_message_tx
        • mcan_multi_message_tx
        • mcan_message_rx
      • I2S
        • i2s_controller_transmit_dma
      • COMP
        • comp_analog_filter
        • comp_dac_to_timer_event
        • comp_hs_dac_vref_external
        • comp_lp_dac_vref_internal
  • Infrastructure Update
    • MSPM33MR-35: TI Code Composer Studio Theia IDE shall include full support for all MSPM33C_1 GPNs
    • MSPM33MR-42: SysConfig configuration tool shall support configuration of superset GPN (all packages)
    • MSPM33MR-173: The MSPM33-SDK shall provide a quick start guide for CCS IDE
    • MSPM33MR-36: A support package (early adopter support) for IAR EWARM IDE shall be provided to support MSPM33C_1 superset GPN
    • New DSSM Authentication based commands added in CCS: Mass Erase, Factory Reset, Password Authentication.
    • SDK installer support for Apple MAC OS
• v1.00.00.00_EA1
  • SysConfig - v1.25.0:
    • MSPM33MR-34: A P2 support package (early adopter support) shall be provided for TI Code Composer Studio Theia IDE to support MSPM33C_1 superset GPN. Below modules are supported:
    • Board
    • Configuration NVM
    • DMA
    • GPIO
    • IWDT
    • RTC
    • RTC_A
    • SYSCTL
    • SYSTICK
    • TAMPER IO
    • WWDT
    • COMP
    • VREF
    • I2C
    • I2C-SMBUS
    • MCAN
    • SPI
    • UART
    • UART-LIN
    • TIMER
    • TIMER - CAPTURE
    • TIMER - COMPARE
    • TIMER - PWM
    • TIMER - QEI
    • AESADV
    • TIMER FAULT
    • GSC
    • SHA
    • TRNG
    • CRCP
    • EVENT
  • DriverLib Library - v1.00.00.00:
    • MSPM33MR-7: The MSPM33 DriverLib shall support the 12-bit SAR ADC (DL_HSADC)
    • MSPM33MR-8: The MSPM33 DriverLib shall support the dual-mode comparator (DL_COMP)
    • MSPM33MR-9: The MSPM33 DriverLib shall support the advanced AES (DL_AESADV)
    • MSPM33MR-10: The MSPM33 DriverLib shall support the CRCP module (DL_CRCP)
    • MSPM33MR-11: The MSPM33 DriverLib shall support the DMA controller (DL_DMA)
    • MSPM33MR-12: The MSPM33 DriverLib shall support the flash controller (DL_FLASHCTL)
    • MSPM33MR-13: The MSPM33 DriverLib shall support GPIO and IOMUX modules (DL_GPIO)
    • MSPM33MR-14: The MSPM33 DriverLib shall support UNICOM overlays (DL_I2C)
    • MSPM33MR-15: The MSPM33 DriverLib shall support UNICOM overlays (DL_SPI)
    • MSPM33MR-16: The MSPM33 DriverLib shall support UART UNICOM overlays (DL_UART)
    • MSPM33MR-17: The MSPM33 DriverLib shall support the LFSS independent WDT (DL_IWDT)
    • MSPM33MR-19: The MSPM33 DriverLib shall support the low frequency sub system (DL_LFSS)
    • MSPM33MR-20: The MSPM33 DriverLib shall support the MCAN peripheral (DL_MCAN)
    • MSPM33MR-21: The MSPM33 DriverLib shall support the LFSS real-time clock (DL_RTC)
    • MSPM33MR-22: The MSPM33 DriverLib shall support the LFSS scratchpad (DL_SCRATCHPAD)
    • MSPM33MR-23: The MSPM33 DriverLib shall support the GP timer modules for instance configurations in MSPM33C *(DL_TIMA, DL_TIMG)
    • MSPM33MR-24: The MSPM33 DriverLib shall support the random number generator (TRNG)
    • MSPM33MR-25: The MSPM33 DriverLib shall support the VREF module (DL_VREF)
    • MSPM33MR-26: The MSPM33 DriverLib shall support the window watchdog (DL_WWDT)
    • MSPM33MR-29: The MSPM33 DriverLib shall support the SHA2 accelerator (DL_SHA2)
    • MSPM33MR-32: The MSPM33 DriverLib for MSPM33C_32 shall support the MSPM33C_32 SYSCTL module (DL_SYSCTL)
  • Infrastructure Update
    • MSPM33MR-34: A P2 support package (early adopter support) shall be provided for TI Code Composer Studio Theia IDE 20.3

Versioning

This product follows a version format, M.mm.pp.bb, where:

• M is a single digit Major number
• mm is a 2 digit minor number
• pp is a 2 digit patch number
• bb is a 2 digit incrementing build counter

Technical Support and Product Updates

• To request a new feature or file a software bug, please contact your local sales representative, TI support team or E2E.