AM261x 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 AM261X Industrial Communications SDK Release Notes 2025.00.00 and AM261X 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
Dual channel support using two independent PRU cores, handle-based API architecture, periodic trigger modes (CMP and CAP), SysConfig-based initialization, per-channel encoder timeout configuration Position Sense BiSS-C
Dual channel support using two independent PRU cores, improved sampling for RX data, handle-based API architecture, different IEP CAP signal per slice, SysConfig-based initialization Position Sense HDSL
Dual channel support using two independent PRU cores, handle-based API architecture, periodic trigger modes (CMP and CAP), SysConfig-based initialization Position Sense Nikon A-format
Dual channel support using two independent PRU cores, handle-based API architecture, periodic trigger modes (CMP and CAP), SysConfig-based initialization Position Sense EnDat
Dual channel support using two independent PRU cores, Handle-based API architecture, Periodic trigger modes (CMP and CAP), SysConfig-based initialization Position Sense Tamagawa

Device and Validation Information

SOC Supported CPUs EVM Host PC
AM261x R5F AM261x LaunchPad Revision A (referred to as am261x-lp in code).
Windows 10 64b or Ubuntu 18.04 64b or MacOS

Dependent Tools, Compiler and Other Open Source SW Module Information

Tools Supported CPUs Version
AM261x Industrial Communications SDK R5F 2025.00.00.08
AM261x MCU+ SDK R5F, M4F 11.00.00.29
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 AM261x MCU+ SDK) R5F 11.1.0
LwIP (included in AM261x MCU+ SDK) R5F STABLE-2_2_1_RELEASE
Mbed-TLS (included in AM261x MCU+ SDK) R5F 2.13.1
Uniflash (included in AM261x 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, dual channel using two independent PRU cores, 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, 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-AM261 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, dual channel using two independent PRU cores, Recovery Time for 2.2 command set, Interface speed of 5 and 10 MHz, periodic trigger modes (CMP and CAP), continuous mode, BP-AM2BLDCSERVO Boosterpack with LP-AM261 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-AM261 25 Mbps data rate, Multi-channel concurrent operation, Daisy chain topology, Long cable (upto 100 meters)
HDSL R5F YES FreeRTOS, NORTOS Single channel, Dual channel using two independent PRU cores, Free Run mode, Sync mode, Short Message Read and Write, Long Message Read and Write, Pipeline Channel Data, Cable length upto 10 meters, BP-AM2BLDCSERVO Boosterpack with LP-AM261 Long cable upto 100 meters, Trace feature for logging registers
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, 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-AM261 Bus connection with 8 encoders
Tamagawa R5F YES FreeRTOS, NORTOS Absolute position, Encoder ID, Reset, EEPROM Read, EEPROM Write, 2.5 Mbps Encoder, periodic trigger modes (CMP and CAP), BP-AM2BLDCSERVO Boosterpack with LP-AM261 5 Mbps encoder

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-5690 HDSL: EDGE register is not updated Position Sense HDSL 10.0.1 onwards NOTE: This register is not implemented in TI HDSL solution. It is documented as a known difference in TI HDSL Exceptions List.
PINDSW-8296 HDSL: Incorrect SAFE_SUM value is seen Position Sense HDSL 10.0.1 onwards -
PINDSW-9308 Nikon: nikon_calc_clock API does not handle baud rate correctly Position Sense Nikon A-format 10.0.1 onwards -
PINDSW-9312 Nikon: Data type of velocity and acceleration is unsigned integer Position Sense Nikon A-format 10.0.1 onwards -
EXT_EP-13295, PINDSW-9317 BiSS-C: bissc_update_data_len does not set number of encoders correctly Position Sense BiSS-C 10.0.1 onwards -
PINDSW-9371 SysConfig allows multiple channels to be selected simultaneously from 1 PRU Position Sense BiSS-C, Position Sense EnDat, Position Sense HDSL, Position Sense Nikon A-format, Position Sense Tamagawa 10.0.0 onwards -
PINDSW-9372 BiSS-C/Nikon: SysConfig shows option for load share mode Position Sense BiSS-C, Position Sense Nikon A-format 10.0.1 onwards This option is not relevant for AM261x
PINDSW-9385 EnDat: Recovery time does not work with EnDat 2.2 supplementary commands for certain EnDat frequencies Position Sense EnDat 10.0.0 onwards -
PINDSW-9605 Unable to open example.syscfg directly from SysConfig tool All examples 10.0.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.1 onwards -
EXT_EP-13298, PINDSW-10244 EnDat: Variations seen in propagation delay measurement with different PRU Clock frequencies Position Sense EnDat 10.0.0 onwards -
PINDSW-10275 HDSL: Sync pulse alignment does not work Position Sense HDSL 10.0.1 onwards -
EXT_EP-13300, PINDSW-10365 Shared memory region located in TCM marked as Cached in SDK examples Position Sense EnDat 10.0.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.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.
EXT_EP-13294, PINDSW-10670 HDSL: Communication drops seen in SYNC mode Position Sense HDSL 10.0.1 onwards -

Known Issues

ID Head Line Module Applicable Releases Workaround
PINDSW-6486 HDSL: RSSI register shows higher values than expected for a non-noisy setup Position Sense HDSL 10.0.1 onwards -
PINDSW-7130 HDSL: Few protocol resets seen during initialization with Free Run mode on LP-AM243 and LP-AM261 Position Sense HDSL 10.0.1 onwards -
PINDSW-7163 HDSL: Trailer data contains 4 zeros instead of 5 Position Sense HDSL 10.0.1 onwards -
PINDSW-7474 HDSL: Sync mode does not work with cable length > 10 meters Position Sense HDSL 10.0.1 onwards -
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.1 onwards -
PINDSW-10391 HDSL: Free run mode does not work with cable length > 10 meters when PRU runs at 225 MHz Position Sense HDSL 10.0.1 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.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.1 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
    • HDSL
    • Nikon A-format
    • Tamagawa

Examples

Module Affected API Change Additional Remarks

Drivers

Module Affected API or structure Change Additional Remarks
Note
Arm is a registered trademark of Arm Limited (or its subsidiaries or affiliates) in the US and/or elsewhere.