Radio Configuration

If your project uses smartrf_settings files to configure the radio settings, you can use SysConfig to configure the radio settings. E.g. if you are using an RF Driver project or an EasyLink project, you can use the Radio Configuration SysConfig view to add settings to smartrf_settings.c/h. In this case, SysConfig can be used instead of SmartRF Studio to configure the RF settings of your project.

Most configurable parameters in the Radio Configuration view are also found as a configurable parameter in SmartRF Studio. If there is a specific parameter you need documentation about, please check SmartRF Studio or in the CC13x2 CC26x2 SimpleLink Wireless MCU Technical Reference Manual.

In the following sections, rfPacketTx is used as the example, but the instructions are valid for any example project that uses smartrf_settings.c/h to configure the RF settings.

Note

Radio Configuration in SysConfig will only make changes to smartrf_settings.c/h. Any required changes to your application files you must do on your own.

Open An Example Project

Open the standalone SysConfig tool or a SysConfig-enabled example project (found in the {SDK_INSTALL_DIR}/examples/syscfg_preview folder).

Open the .syscfg file.

Adding RF Settings

In the Radio Configuration view, you will see that the RF settings are divided into modes; Proprietary mode, BLE mode, IEEE 802.15.4 mode. You can have multiple sets of RF settings simultaneously.

../_images/ccs_syscfg.png

  1. Add RF Mode

    In the Radio Configuration view, you will see that the RF settings are divided by mode; Proprietary mode, BLE mode and IEEE 802.15.4 mode. Add at least one set of RF Settings.

  2. Choose Phy Type

    The Phy Type will limit the other RF settings (e.g. available frequency bands), so it should be set first.

    ../_images/phy_type.png

  3. Name the Set of RF Settings

    Each set of RF Settings must have a name, which is used when generating every RF driver command. Two different sets of RF Settings can not have the same name. Scroll down to Code Export Configuration and select the desired Symbol Name Generation Method:

    • Legacy - Bare-bones names are generated. You can only have one set of RF Settings with the Legacy name.
    • Automatic - Each object will be given the selected PHY as a suffix.
    • Custom - You can configure the name as you like.

  4. Configure the Settings

    Some of the parameters you can adjust are frequency band, Tx power etc. Each parameter is more thoroughly explained if you open SmartRF Studio. Make sure your settings make sense from an RF point of view. Certain parameter combinations will give you a build error. Other will give you a hint to a file where you need to change a different parameter based on your SysConfig parameters. In this case, make sure to comply (as SysConfig will not make this change for you).

  5. Save the .syscfg file.

  6. Generate the files

    You can see the generated files by clicking the <> symbol. In this example, board.c/h was generated by the “TI DRIVERS” view and smartrf_settings/smartrf_settings.c/h was generated by the “Radio Configuration” view.

    ../_images/generated_files_prop.png

    If you are using the System Configuration stand-alone tool, you will have to import every generated file to your IDE.

    If you are using the SysConfig CCS plug-in, you can generate all the files by building your project. After the build has completed, you will find the generated files in the output folder of your project. In this example, it’s the folder called “Debug” of the rfPacketTx example.

    ../_images/generated_folder_prop.png

    The Radio Settings are shown separately in the generated smartrf_settings.c. In this example, one set of RF Settings was added. These settings are found under a RF Setting header.

    Listing 7. smartrf_settings.h - RF Setting Header
    //*********************************************************************************
//  RF Setting:   50 kbps, 2-GFSK, 25 kHz deviation (Preview)
//
//  PHY:          2gfsk50kbps
//  Setting file: setting_tc706.json
//*********************************************************************************

  7. Adjust Your Application Files

    The names of RF objects have been generated according to the naming rules chosen in Code Export Configuration. Make sure your application is using the correct name whenever an RF object is used.

    In this example, RF objects are only called from rfPacketTx.c. For each RF object, make sure the name is correct according to the RF Settings you have generated. This is also valid if your application uses multiple sets of RF Settings. Use build errors and warnings to make sure you are using the correct settings.

    Attention

    Whenever you re-build the project, SysConfig will re-generate the files. Because of this, any changes made directly in the files (smartrf_settings.c/h) will be overwritten and lost.