F28-F29 Software Migration Guide  1.00.00.00
RTLib Migration Guide

Table of Contents

Introduction

This guide explains issues and aspects related to migrating real-time libraries (RTLibs) from F28x to F29x devices.

In the C2000Ware SDK, the following real-time libraries are available for F28x devices.

  • Control - this refers to DCL, the Digital Control Library
  • DSP - this consists of Fixed-point and Floating-point (FPU) as well as VCU/VCRC based libraries.
  • Math - this consists of CLAMath, FastIntDiv, FPUfastRTS, and IQMath libraries.

In the F29x SDK, the following real-time libraries are available for F29x devices.

  • DCL - this refers to the Digital Control Library
  • DSP - this consists of Floating-point (FPU) DSP libraries. Fixed-point libraries are planned for a future release. VCU/VCRC DSP functionality is not applicable since the F29x devices do not contain the corresponding hardware IP.
  • FastMath - this consists of CRC libraries that correspond to the VCU/VCRC libraries. It also consists of optimized RTS math functions that illustrate the use of the TMU in the C29 CPU, and generally the C29 ISA.
  • IQMath - this is a C library of IQMath functions that are compatible to the F28x IQMath library.

API Mapping

  • DCL
    • DCL function names have been changed in F29x to more accurately reflect the Control operation
    • For backward compatibility, dcl.h includes dcl_c28_compatibility.h with F28-F29 API mapping
  • DSP
    • CFFT_f32.h, fir_f32.h, and iir_f32.h are re-used from F28x
    • FIR_f32_calc is replaced with fir_f32_asm (assembly implementation) and fir_f32_c (C implementation)
    • IIR_f32_calc is replaced with iir_f32_loop (block implementation) and iir_f32_sample (sample implementation)
    • CFFT_f32_brev is replaced with CFFT_f32_bitrev
  • FastMath
    • vcu2_crc.h, vcu2_types.h and many CRC specific header files are re-used from F28x
    • The C LUT based CRC APIs are the same as F28x. Assembly based CRC APIs are new - CRC_run8BitAsm, CRC_run16BitAsm, and CRC_run32BitAsm
  • IQMath
    • This is a C library of IQMath functions that are compatible to the F28x IQMath library.