 |
AM273x MCU+ SDK
08.04.00
|
|
|
AM273x MCU+ SDK
08.04.00
|
|
Welcome to MCU+ SDK for AM273X. This SDK contains examples, libraries and tools to develop RTOS and no-RTOS based applications for ARM R5F, TI C66x CPUs and related peripherals.
To get started, see Getting Started
When migrating from Processor SDK RTOS, see Migration Guides for more details.
Given below is a block diagram of the SW modules in this SDK,
The main software components in the block diagram are described below
| Software Components | Documentation Page | Description |
|---|---|---|
| OS Kernel | ||
| No RTOS | NO RTOS | Contains modules which implement no-RTOS execution environment consisting of timers, ISR, main thread. Allows software on top to run in bare metal mode. |
| FreeRTOS Kernel | FreeRTOS | FreeRTOS Kernel, provides a execution environment consisting of tasks, semaphores, timers, see https://www.freertos.org/RTOS.html |
| FreeRTOS POSIX | FreeRTOS | Limited POSIX APIs with FreeRTOS underneath, provides pthreads, mqueue, semaphore, see https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_POSIX/index.html |
| Driver Porting Layer (DPL) | Driver Porting Layer (DPL) | APIs used by drivers to abstract the OS environment. Example, Semaphore, HW interrupts, mutex, clock. |
| Device Drivers and HAL (Hardware Abstraction Layer) | ||
| SOC Peripheral Drivers | SOC Peripheral Drivers | Device Drivers library and APIs for peripherals within the SOC. Example, I2C, GPIO, UART. |
| Board Peripheral Drivers | Board Peripheral Drivers | Device Drivers library and APIs for peripherals on the board or EVM. Example, Flash, EEPROM. |
| Protocol Stacks and Middleware | ||
| LwIP | Enet Lwip CPSW Example | TCP/UDP IP networking stack |
| Examples and Demos | ||
| Examples and Demos | Examples and Demos | Examples and demos showing usage of different SW libraries and APIs |
| Tools (used on host machine) | ||
| Code Composer Studio (CCS) | Using SDK with CCS Projects | IDE used to build projects, debug programs, see |
| TI CLANG Compiler Toolchain | TI CLANG CGT HOMEPAGE | CLANG based ARM compiler from TI for ARM R5F and M4F |
| TI C6000 Compiler Toolchain | TI C6000 CGT HOMEPAGE | C66x compiler from TI |
| SysConfig | Using SDK with SysConfig | System configuration tool, used to configure peripherals, pinmux, clocks and generate system initialization code |
| TI Resource Explorer (TIREX) | Using SDK with TI Resource Explorer | Web broswer based tool to explore the SDK, select, import and run the examples |
| SDK Tools and Utilities | Tools and Utilities | Additional tools and utilities, like flashing tools, booting tools, CCS loading scripts used with the SDK development flow |
Given below is a overview of the directory structure to help you navigate the SDK and related tools.
| Folder/Files | Description |
|---|---|
| ${SDK_INSTALL_PATH}/ | |
| README_FIRST_AM273X.html | Open this file in a web browser to reach this user guide |
| makefile | Top level makefile to build the whole SDK using "make" |
| imports.mak | Top level makefile to list paths to dependant tools |
| docs/ | Offline browseable HTML documentation |
| examples/ | Example applications for AM273X, across multiple boards, CPUs, NO-RTOS, RTOS |
| source/ | Device drivers, middleware libraries and APIs |
| tools/ | Tools and utilities like CCS loading scripts, initialization scripts. |
| ${SDK_INSTALL_PATH}/source/ | |
| board/ | Board peripheral device drivers |
| drivers/ | SOC peripheral device drivers |
| kernel/ | NO RTOS and RTOS kernel and Driver Porting layer (DPL) for these environments |
| ${SDK_INSTALL_PATH}/examples/ | |
| drivers/ | SOC and board level focused device drivers examples. The examples are based on both NO-RTOS and RTOS |
| empty/ | Template projects to copy to your workarea and then modify based on your custom application needs |
| kernel/ | NO RTOS, RTOS examples like task switch, POSIX demo and DPL hello world examples |
| ${SDK_INSTALL_PATH}/tools/ | |
| / | Additional tools and utilities used by the SDK |
Given below are the paths where the different tools needed outside the SDK, like CCS, SysConfig are installed by default in Windows. In Linux, the tools are installed by default in ${HOME}/ti.
| Folder/Files | Description |
|---|---|
| C:/ti/ccs1200 | Code composer studio |
| C:/ti/sysconfig_1.13.0 | SysConfig. NOTE, SysConfig is also installed as part of CCS at ${CCS_INSTALL_PATH}/ccs/utils/sysconfig_x.x.x |
| C:/ti/ti-cgt-armllvm_2.1.1.LTS | TI ARM CLANG compiler tool chain |
| C:/ti/ccs1200/ccs/tools/compiler/ti-cgt-c6000_8.3.12 | Code composer studio |
The licensing information of this SDK, as well as any third-party components included which are made available under a number of other open-source licenses are enumerated as part of the manifest. A complete manifest along with export control information is detailed here [LINK]
For additional help and support, see https://e2e.ti.com/support/microcontrollers/arm-based-microcontrollers-group/arm-based-microcontrollers/f/arm-based-microcontrollers-forum
This user guide is generated using doxygen, v1.8.20. See https://www.doxygen.nl/index.html
1.8.20