AM263Px Motor Control SDK  2025.00.00
Release Notes 2025.00.00

Attention
  1. Please refer to individual module pages for more details on each feature, unsupported features, important usage guidelines.
  2. Motor Control SDK 10.x included the Industrial Communications SDK and MCU+ SDK in bundled ind_comms_sdk and mcu_plus_sdk folders. Starting with Motor Control SDK 2025.00.00, these folders are no longer included and must be downloaded separately. Motor Control SDK installer provides an option to install the required Industrial Communications SDK and MCU+ SDK.
  3. For release notes of Industrial Communications SDK and MCU+ SDK, please refer to AM263PX Industrial Communications SDK Release Notes 2025.00.00 and AM263PX MCU+ SDK Release Notes 11.00.00 respectively.
Note
These examples will show usage of SW modules and APIs on a specific CPU instance and OS combination.
Unless noted otherwise, the SW modules would work in both FreeRTOS and NORTOS environment.
Unless noted otherwise, the SW modules would work on any of the R5F's present on the SOC.
Unless noted otherwise, the SW modules would work on all supported EVMs

New in this Release

Feature Module
EnDat3 protocol support with 12.5 Mbps data rate, Manchester encoding, frame-based communication (HPF/LPH/LPF), foreground and background communication channels, host trigger and periodic trigger modes Position Sense EnDat3
Handle-based API architecture, periodic trigger modes (CMP and CAP), SysConfig-based initialization, per-channel encoder timeout configuration Position Sense BiSS-C
Handle-based API architecture, periodic trigger modes (CMP and CAP), SysConfig-based initialization Position Sense Nikon A-format
Handle-based API architecture, periodic trigger modes (CMP and CAP), SysConfig-based initialization Position Sense EnDat
Handle-based API architecture, Periodic trigger modes (CMP and CAP), SysConfig-based initialization Position Sense Tamagawa

Device and Validation Information

SOC Supported CPUs Boards Host PC
AM263Px R5F AM263Px ControlCard Rev B (referred to as am263px-cc in code). Windows 10 64b or Ubuntu 18.04 64b or MacOS
AM263Px R5F AM263Px LaunchPad Rev A (referred to as am263px-lp in code). Windows 10 64b or Ubuntu 18.04 64b or MacOS

Dependent Tools, Compiler and Other Open Source SW Module Information

Tools / SW module Supported CPUs Version
AM263Px Industrial Communications SDK R5F 2025.00.00.08
AM263Px MCU+ SDK R5F, M4F 11.00.00.19
Code Composer Studio R5F 20.3.0
SysConfig R5F 1.25.0, build 4268
TI ARM CLANG R5F 4.0.3.LTS
FreeRTOS Kernel (included in AM263Px MCU+ SDK) R5F 11.1.0
LwIP (included in AM263Px MCU+ SDK) R5F STABLE-2_2_1_RELEASE
Mbed-TLS (included in AM263Px MCU+ SDK) R5F 2.13.1
Uniflash (included in AM263Px MCU+ SDK) R5F 9.3.0

Key Features

Position Sense

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
BiSS-C R5F YES FreeRTOS, NORTOS Single channel, Multi channel using single PRU core and three PRU cores (load share mode), point-to-point connection, single byte register communication using control communication, automatic processing delay detection and compensation, interface speed of 1, 2, 5, 8, and 10 MHz, long cable (upto 100 meters), host trigger mode, periodic trigger modes (CMP and CAP), daisy chaining, safety mode (safety CRC and sign-of-life counter), BP-AM2BLDCSERVO Boosterpack with LP-AM263P Control communication: BiSS-C Commands (Control Select bit (CTS) = 0), start bit delay and sequential multi-byte access with Register Communication (Control Select bit (CTS) = 1)
EnDat R5F YES FreeRTOS, NORTOS Single channel, Multi channel using single PRU core and three PRU cores (load share mode), recovery time for 2.2 command set, interface speed of 4, 8 and 16 MHz, long cable (upto 100 meters), periodic trigger modes (CMP and CAP), continuous mode, BP-AM2BLDCSERVO Boosterpack with LP-AM263P Encoder receive communication command
EnDat3 R5F YES FreeRTOS, NORTOS Single channel, Manchester encoding, data transfer rate of 12.5 Mbps, frame-based protocol (HPF/LPH/LPF), foreground communication commands (DATA0-DATA7, DATA, DATANOP, RESET, CLEAR, ECHO, RATE, HELLO), background communication commands (NOP, READ, WRITE, RECONFIGURE, AUTH, PROTECT, SETPASS, LOCATE), host trigger mode, periodic trigger modes (CMP and CAP), automatic CRC verification, BP-AM2BLDCSERVO Boosterpack with LP-AM263P 25 Mbps data rate, Multi-channel concurrent operation, Daisy chain topology, Long cable (upto 100 meters)
Nikon A-format R5F YES FreeRTOS, NORTOS Nikon A-format version 2.1 and version 3.0, Single channel, Multi channel using single PRU core and three PRU cores (load share mode), point-to-point connection, bus connection up to 7 encoders, individual and multiple transmission mode with encoder addresses ranging between ENC1-ENC8, baud rates from 2.5 MHz, 4 MHz, 6.67 MHz, 8 MHz, and 16 MHz, up to 40-bit absolute position (single turn + multi turn) data with additional information, long cable (upto 100 meters), host trigger mode, periodic trigger modes (CMP and CAP), BP-AM2BLDCSERVO Boosterpack with LP-AM263P Bus connection with 8 encoders
Tamagawa R5F YES FreeRTOS, NORTOS Single channel, Multi channel using single PRU core, absolute position, encoder ID, reset, EEPROM read, EEPROM write, 2.5 Mbps Encoder, periodic trigger modes (CMP and CAP), BP-AM2BLDCSERVO Boosterpack with LP-AM263P 5 Mbps encoder
Tamagawa over SOC UART R5F YES FreeRTOS Single channel, absolute position, encoder ID, reset, EEPROM read, EEPROM write, 2.5 Mbps Encoder, CRC verification 5 Mbps encoder, long cable length

Real Time Libraries

Module Supported CPUs SysConfig Support OS Support Key features tested Key features not tested
Control R5F YES FreeRTOS, NORTOS Field Weakening Control, Maximum Torque Per Ampere, Strator voltage frequency generator support -
Digital Control Library (DCL) R5F YES FreeRTOS, NORTOS Linear PI, Linear PID, Linear PI with double integrator (PI2), Direct Form 1 (first order), Direct Form 1 (second order), Direct Form 1 (third order), Direct Form 2 (second order), Direct Form 2 (third order), Non-linear PID controller -
Observer R5F YES FreeRTOS, NORTOS Sensored eQEP-based encoder, Hall sensor, Sensorless Enhanced Sliding Mode Observer, both speed measurement for sensored (speedcalc) and sensorless (speedfr) -
SFRA R5F YES FreeRTOS, NORTOS Software Frequency Response Analyzer support -
Transforms R5F YES FreeRTOS, NORTOS Clarke transformation, Park transformation, Inverse Park transformation, Space Vector Generation (SVGEN), Common-mode subtraction approach, DPWM Generation (Part of SVGEN), Maximum Modulation, Minimum Modulation, SVGEN current reconstruction for single-shunt (SVGENCURRENT), Phase voltage reconstruction in overmodulation (VOLTS_RECON) -
Utilities R5F YES FreeRTOS, NORTOS Angle Compensation Generator, Step Response, Datalog, Trapezoid generator -

Fixed Issues

ID Head Line Module Applicable Releases Resolution/Comments
PINDSW-9371 SysConfig allows multiple channels to be selected simultaneously from 1 PRU Position Sense BiSS-C, Position Sense EnDat, Position Sense Nikon A-format, Position Sense Tamagawa 10.0 onwards -
PINDSW-9605 Unable to open example.syscfg directly from SysConfig tool All examples 10.0 onwards -
PINDSW-9784 Position Sense: PR0_PRU0_GPIO7 pin is not available in SoC, but shown in SysConfig modules Position Sense BiSS-C, Position Sense EnDat, Position Sense Nikon, Position Sense Tamagawa 10.0 onwards -
PINDSW-9788 BiSS-C/Nikon: SysConfig does not enable the required PRU GPIO pins Position Sense BiSS-C, Position Sense Nikon A-format 10.0 onwards -
EXT_EP-13300, PINDSW-10365 Shared memory region located in TCM marked as Cached in SDK examples Position Sense EnDat 10.0 onwards In SDK examples, PRU firmware for EnDat store the data into R5F TCM memory.
EXT_EP-13301, PINDSW-10389 Tamagawa: Periodic command does not work with a lower cycle period Position Sense Tamagawa 10.0 onwards Due to maximum value of RX frame size being configured always for all commands, the periodic mode does not work for lower periods for certain commands.

Known Issues

ID Head Line Module Applicable Releases Workaround
PINDSW-9179 Nikon: PRU Firmware gets stuck if encoder does not respond with number of bytes expected by driver Position Sense Nikon A-format 10.0 onwards -
PINDSW-10641 Unable to create a new .syscfg with MCSDK directly from SysConfig tool SysConfig 2025.0 onwards Copy an example.syscfg file from SDK example and use it

Limitations

Attention
Please refer to individual module pages for more details on known limitations and unsupported features.
ID Head Line Module Reported in Release Applicable Devices Workaround
MCUSDK-208 gmake with -j can sometimes lock up Windows command prompt Build 10.0 onwards AM64x, AM243x Use bash for windows as part of git for windows or don't use -j option
PINDSW-9370 Nikon: Only 7 encoders can be tested in bus connection with BP-AM2BLDCSERVO Position Sense Nikon 10.0 onwards Unable to test 8 encoders because of voltage drop when using BP-AM2BLDCSERVO is used

Upgrade and Compatibility Information for Motor Control SDK 2025.0.0

Attention
When migrating from MCU+ SDK, see Migration Guide for more details.

This section lists changes which could affect user applications developed using older SDK versions. Read this carefully to see if you need to do any changes in your existing application when migrating to this SDK version relative to previous SDK version. Also refer to older SDK version release notes to see changes in earlier SDKs.

SDK drivers for following modules underwent significant architectural changes including a move to handle-based APIs, enhanced periodic trigger modes, improved SysConfig integration, etc. For module specific migration details, refer to links from Migration Details for Motor Control SDK 10.02.00 to Motor Control SDK 2025.00.00.

  • Position Sense
    • BiSS-C
    • EnDAT 2
    • Nikon A-format
    • Tamagawa

Examples

Module Affected API Change Additional Remarks

Drivers

Module Affected API or structure Change Additional Remarks
Tamagawa over SOC UART tamagawa_init() Return type changed from void to int32_t (SystemP_SUCCESS / SystemP_FAILURE). Added NULL pointer validation. -
Tamagawa over SOC UART tamagawa_command_process() Return values standardized to SystemP_SUCCESS / SystemP_FAILURE -
Note
Arm is a registered trademark of Arm Limited (or its subsidiaries or affiliates) in the US and/or elsewhere.