The docker-ccstudio-ide Docker image provides a CI/CD environment for projects developed in the Code Composer Studio IDE from Texas Instruments. Code Composer Studio is an integrated development environment (IDE) for TI's microcontrollers and processors, comprising a suite of tools used to develop and debug embedded applications.

To create the uoohyo/ccstudio-ide Docker image, execute the following command inside the docker-ccstudio-ide directory:

docker build -t uoohyo/ccstudio-ide .

Pull the uoohyo/ccstudio-ide image from Docker Hub using the following command:

docker pull uoohyo/ccstudio-ide:latest

Run the pulled image. By default, the image is configured with the latest version of Code Composer Studio available at the time of the image update. The development tools are set to support C2000 real-time MCUs:

docker run -it uoohyo/ccstudio-ide:latest

You can modify environment variables when running the uoohyo/ccstudio-ide image to specify the version and development tools configuration of Code Composer Studio to be installed. Here is how you can customize it:

docker run -it \
-e MAJOR_VER=12 \
-e MINOR_VER=7 \
-e PATCH_VER=0 \
-e BUILD_VER=00007 \
-e COMPONENTS=PF_C28 \
uoohyo/ccstudio-ide:latest

The structure of the Code Composer Studio version is as follows:

<MAJOR_VER> . <MINOR_VER> . <PATCH_VER> . <BUILD_VER>

As of April 24, 2024, the latest released version of Code Composer Studio is 12.7.0.00007. The default environment variables are set accordingly

ENV MAJOR_VER=12
ENV MINOR_VER=7
ENV PATCH_VER=0
ENV BUILD_VER=00007

For the latest version information, visit this link.

When installing Code Composer Studio, you can choose from various Texas Instruments Inc. product families. Below is a list of installable product families:

Multiple product families can be installed by separating their names with a comma in the COMPONENTS variable. Here is an example that installs development tools for both PF_MSP430 and PF_CC2X:

docker run -it
-e COMPONENTS PF_MSP430, PF_CC2X
uoohyo/ccstudio-ide:latest

Once the image is running, you can add projects to the workspace and execute builds based on specific build options. Below are example commands to demonstrate these actions.

Import a project into the workspace:

eclipse -noSplash -data <workspace_path> -application com.ti.ccstudio.apps.projectImport -ccs.location <project_path>

Build a project using specific configuration:

eclipse -noSplash -data <workspace_path> -application com.ti.ccstudio.apps.projectBuild -ccs.projects <project_name> -ccs.configuration <build_name>

These commands utilize the eclipse executable to manage projects within the Code Composer Studio environment without the need for a graphical interface, making them ideal for automated environments such as continuous integration setups.

For more detailed commands and explanations, visit this link.

MIT License

Copyright (c) 2024 uoohyo

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.