Get started with SysConfig

System Configuration Tool (SysConfig) is a graphical interface for configuring your SimpleLink CC13x2 / 26x2 SDK project. Configuration files, C source files and header files are generated based on the parameters configured in the SysConfig dashboard.

SysConfig can be used as a standalone tool, or as a plug-in to CCS.

Attention

Files and code generated by SysConfig should be thoroughly checked and reviewed.

Using Stand-alone SysConfig

You can find the standalone SysConfig tool on the SysConfig Standalone Installer Download Page.

Open the System Configuration Tool, and select your device, part and package, then press START.

When you have finished configuring your .syscfg file, save and generate files. Export the generated files to your project, overwriting existing files if necessary. Make any needed changes to your application for interfacing with the SysConfig-generated files.

Using SysConfig with IAR Workbench

If you are using IAR, you can use SysConfig as a standalone desktop tool to generate the configuration files to be compiled and linked with your application.

These steps assume the TI Code Generation Tools are installed in the default location. The figures use the MSP432 SDK as an example, but other SimpleLink SDKs follow the same procedure.

  1. Install SysConfig as a standalone tool within the default location (C:\ti).

  2. Open IAR and follow these steps to configure it to use the correct viewer for *.syscfg files:

    1. Choose Tools > Configure Viewers from the menus, and then click New.
    2. Type .syscfg in the File name extensions field.
    3. Type $SYSCONFIG_ROOT$\nw\nw.exe $SYSCONFIG_ROOT$ --compiler iar -s $SIMPLELINK_CC13X2_26X2_SDK_INSTALL_DIR$\.metadata\product.json --output $PROJ_DIR$ $FILE_PATH$ with the Command line option selected.
../_images/sysconfig_iar_1.png

Figure 114. Editing Viewer Extensions

  1. Follow these steps to import custom argument variables into IAR:

    1. Choose Tools > Configure Custom Argument Variables from the menus.
    2. Choose the Workspace or Global tab depending on how you want to apply the variables. (If you’re not sure, choose Workspace.)
    3. Click the Import button and browse to \tools\iar within your SimpleLink CC13x2 / 26x2 SDK installation. Select the *.custom_argvars file provided there and click OK.
    4. Click the Add Variable button and add SYSCONFIG_ROOT as a variable with the value c:/ti/sysconfig_x.x.xxx (where the version matches the location of your SysConfig installation, see release notes for SysConfig version).
../_images/sysconfig_iar_2.jpg

Figure 115. Configuring Custom Argument Variables

  1. Import an example project workspace.
  2. Double click on the *.syscfg file in your project. This will open the SysConfig standalone tool. You can configure all the settings, then save your changes and switch back to the IAR view.
  3. Rebuild the project to perform the custom build step, which uses SysConfig to generate additional files.
../_images/sysconfig_iar_3.png

Figure 116. Building with SysConfig in IAR

Using SysConfig as a Plug-In to CCS

SysConfig requires CCS v. 8.3 or later. (Please use the version of CCS recommended for the SimpleLink CC13x2 / 26x2 SDK you are working with. You can find the recommended tool version numbers in the release notes.)

In CCS, import a SysConfig enabled project from the examples folder.

In the project folder in CCS, you will see a .syscfg file. Open this file to start the SysConfig graphical interface.

../_images/sysconfig_dashboard.png

Viewing SysConfig Output

If you click the Generated Files (< >) Generated Files button at the top of the Configuration pane you will find a list of Generated Files. After selecting a file you will be able, in real-time, to identify how the changes in the GUI effect the generated files. This will help you review the relationship between the GUI and the code.

../_images/syscfg_generated_files_ble.png

Figure 117. Generated Files