Examples User’s Guide

Warning

This documentation is under construction. It will be in a progressively more complete state at each SDK release. As always, we recommend to use the latest version of the SDK if possible, since that will ensure latest updates to improve development and functionality. If you have a specific question on any portion of this documentation, please reach out to us on E2E.

The Proprietary RF examples utilize the Radio Control Layer (RCL).

The RCL offers low-level API’s to run radio operation commands to setup the radio for transmit or receive.

Proprietary RF Examples

Proprietary RF examples are available for the FREERTOS, but can also be used without any RTOS at all. That is possible with the NoRTOS Driver Porting Layer.

The Proprietary RF examples can be imported from the following SDK directory: {SDK_INSTALL_DIR}/examples/rtos/<PLATFORM>/prop_rf/

Carrier Wave

Basic example for RF performance measurements and testing, written directly on top of the RCL driver. Set the radio into various test modes. Transmission of modulated or unmodulated signal. Easy to change radio configuration.

Echo Rx/Tx

The Echo Tx example transmits a packet and immediately switches over to receiver mode and waits for its echo. The Echo Rx example starts in receiver mode and transmits back any received packets (echo).

Packet Error Rate

The Packet Error Rate (PER) example showcases different RF transfer modes of the CC23xx. Multiple packets are transmitted or received and the packet error rate is calculated. The result is shown on an LCD/UART display.

Packet Rx/Tx

Simple examples that show how to transmit and receive packets using the RCL.

Running Examples in Code Composer Studio (CCS)

The following walks through importing and building one of the Proprietary RF examples using the CCS IDE and the TI Resource Explorer.

  1. If CCS is not already installed; download and install CCS from the Code Composer Studio tool page.

    If it is installed it is recommended that you install the available updates.

  2. Download and install the SimpleLink Low Power F3 SDK from here:

    This step is recommended, but optional as the TI Resource explorer can download the examples from the resource explorer server. The rest of this section will assume that you have downloaded the SDK.

  3. Open CCS, and use the menu option View-> Resource Explorer.

  4. Browse to the example of interest in the Resource Explorer.

    ../_images/trex-examples.png

    Figure 16. CCS Resoure Explorer Examples

  5. Select the CCS or GCC compiler, we recommend using the CCS compiler, but compiling with GCC in the CCS IDE is also possible. Then select the example name and click the CCS icon in the top left to import it into your workspace.

    ../_images/trex-import.png

    Figure 17. CCS Project Selection

  6. Build and download and debug the project by clicking on the ‘bug’. The first time it will take some time due to the FREERTOS build.

    ../_images/bug.png

    Figure 18. CCS Debug

  7. Click run to run the example.

    ../_images/run.png

    Figure 19. CCS Run

Running Examples in IAR

  1. Please make sure you’re using the IAR version which is recommended in the SimpleLink Low Power F3 SDK release notes.If IAR Arm Workbench is not already installed, download and install IAR Workbench for Arm from https://www.iar.com .

  2. Download and install the SimpleLink Low Power F3 SDK from here:

  3. Open IAR and create a new workspace with the menu option File -> New  -> Workspace

    You can use this workspace for one or more examples.

  1. Import the IAR Custom Argument Variables file with the menu option Tools -> Configure Custom Argument Variables. The location and file to be imported is C:/ti/<SDK>/tools/iar/SIMPLELINK_CC23XX_SDK.custom_argvars.

    ../_images/iar-argvars.png

    Figure 20. Custom Argument Variables

  2. Save the Workspace with the menu option File -> Save Workspace As....

  3. To enable the Custom Argument Variables for this workspace close and open the workspace with the menu options File -> Close Workspace and File -> Open -> Workspace.

  4. Select the menu option Help -> Information Center and select the Integrated Solutions icon:

    ../_images/iar-integratedsolutions.png

    Figure 21. Integrated Solutions

  5. Select the Texas Instruments Example projects and then click on the example applications link.

    ../_images/iar-ti.png

    Figure 22. Texas Instruments Examples

  6. Follow the instructions on this page to import and build the project.

  7. When you click on one of the examples, it will ask you to place a copy of the project file in another folder. Save it in a sub-folder of your workspace. If you are going to import only one example into your workspace, you can put the project file into the same folder as the workspace file.

  8. Download and debug the example with the menu option Project -> Download and Debug.