[FAQ] MCU-PLUS-SDK-AM263X: MCU+ SDK on MacOS for am26x devices

Clone and build from GIT

Repo Tool Setup

MCU+ SDK has multiple components (in multiple repositories) and dependencies (like compiler, CCS and other tools). We use repo tool from Google to manage these multiple repositories. 
Follow the below mentioned steps to setup repo tool:

Make sure python3 is installed and is in your OS path.
Make sure homebrew is installed

To install the repo client,
Do the following in the terminal:

brew install repo && brew install gpg



Cloning The Repositories

Note that depending on the SoC you're working with, the components you clone might be slightly different. So please choose the manifest folder according to the SoC of your interest. For example, we are showing for am263x below.

repo init -u github.com/.../mcupsdk-manifests.git -m am263x/dev.xml -b main

After the repo is initialized, do a

repo sync

This should clone all the repositories required for MCU+ SDK development. Now download and install the dependencies.

Downloading And Installing Dependencies

In MacOS the dependencies have to be manually installed. Given below are the steps:

• Download and install Code Composer Studio v12.6 from here.
  Install at default folder, $(HOME)/ti
  
  
• Download and install SysConfig 1.19.0 from here. 
  Install at default folder, $(HOME)/ti
  
  
• Download and install GCC for ARM R5 from below link
  GNU-RM
  Install at default folder, $(HOME)/ti
  
  
• Download and install Node.js v12.18.4 LTS
  

  brew install nvm
  nvm install 12.18.4

  
  ,Or go to the NodeJS Website and use the installer to download and install v12.18.4 of node. Install in the default directory.
  After successful installation, run an npm ci inside the mcu_plus_sdk folder like so:
  
$ cd mcu_plus_sdk/
$ npm ci
$ cd ../
  
  This should install the node packages required for the SDK.
  
  
• Download and install doxygen,
  

  brew install doxygen



• Installing OpenSSL
  Some of the SDK signing scripts are dependent on OpenSSL v1.1.1. The v1.1.1 is important, OpenSSL 3.0 is not compatible with the current signing scripts of SDK
  

  brew install openssl@1.1
  
  

Now that the dependencies are installed, you can start the repositories with a default branch dev by doing below:

repo start dev --all



Changes to be done in SDK

Make the following changes in the code base:

1. 1.    .../mcu_plus_sdk/.project/templates/imports.mak.xdt
      
      
      
   2.  .../mcu_plus_sdk/.project/templates/makefile_ccs_bootimage_gen.xdt
      
      
      
   3.  .../mcu_plus_sdk/.project/templates/makefile_executable.xdt
      
      
      
      
      

Note: The above changes in the makefiles are applicable regardless of whether you use an installer from https://ti.com/ or clone from git.
           The template files are not delivered as part of the installer nor is there an option to recreate all the makefiles for the same.

Building the SDK

Basic Building With Makefiles

NOTE

• Unless mentioned otherwise, all below commands are invoked from root folder of the "mcu_plus_sdk" repository.
• Pass one of these values to "DEVICE="
• You can also build components (examples, tests or libraries) in release or debug profiles. To do this pass one of these values to "PROFILE="

1. Run the following command to create makefiles.

   make gen-buildfiles DEVICE=am263x
   

2. To see all granular build options, run

   make -s help DEVICE=am263x
   

   This should show you commands to build specific libraries, examples or tests.

3. Make sure to build the libraries before attempting to build an example. For example, to build a Hello World example for AM263x, run the following:

   make -s -j4 libs DEVICE=am263x PROFILE=debug
   

   Once the library build is complete, to build the example run:

   make -s -C examples/hello_world/am263x-cc/r5fss0-0_nortos/ti-arm-clang all PROFILE=debug

Note: Importing a project directly in CCS is not supported for AM26x devices on MacOS.

4. Following are the commands to build all libraries and all examples. Valid PROFILE's are "release" or "debug"

   make -s -j4 clean DEVICE=am263x PROFILE=debug
   make -s -j4 all   DEVICE=am263x PROFILE=debug
   
   

Running the examples

CCS support is not officially available for AM26x devices as of now.

Workaround:

Copy the following files from a linux installation

After copying these files, follow the Target Configuration setup to get CCS Load, Launch and Run Example working.

Note: Only script based Flashing of an example is supported on MacOS

Hello World example running on AM263x-CC on MacOS(CCS 12.6)

More information on SDK usage

For more details on SDK usage, please refer to the SDK user guide. User guides contain information on

• Building the SDK
• EVM setup,
• CCS Setup, loading and running examples
• Flashing the EVM
• SBL, ROV and much more.

Note that user guides are specific to a particular device. The links for all the supported devices are given below.

• AM263x User Guide