This repository contains ti_wisunfan examples for TI devices supported by the SimpleLink Low Power F2 SDK (LPF2). To learn which devices are supported by the SDK, refer to the SDK Device Association section.
This repository redistributes examples from TI's SimpleLink LPF2 SDK. This SDK is part of the SimpleLink Low Power ecosystem.
More details, including supported devices, IDEs, and toolchains, are provided in the respective SDK release notes.
The examples/ directory contains the same examples provided in the SDK, in the same directory structure.
The LPF2 SDK is provided as a Git submodule in the cc13xx_cc26xx_sdk subdirectory.
As a quick reference, you can initialize and update a single Git submodule in one step like this:
# To initialize and update the LPF2 SDK
.../simplelink-ti_wisunfan-examples$ git submodule update --init cc13xx_cc26xx_sdk
Alternatively you can initialize/update all submodules when cloning a repo
with git clone --recurse-submodules {repo-ref}
. See Git documentation for
details.
Once initialized and updated, you can refer to the SDK's README.md and Release Notes for details on how to download its dependencies, and build its libraries.
Note, the links above are to online copies of the latest SDK READMEs. They are useful for online readers, but be sure to consult the SDK submodule's actual README.md after cloning, checking out your branch/tag, and updating your submodule, as details may change from release to release.
Each time you update an SDK submodule, you will need to build its libraries.
Refer to each SDK's README.md for specifics, but generally you will need to edit
the imports.mak file at the top, then run make
.
After building the SDK libraries, you can build the ti_wisunfan examples. The examples support a few ways to build:
Remember, before building the examples, you must build the SDK libraries!
To build an example from the command line using GNU
make, change into the
appropriate example's directory (e.g.
{rtos}/{board}/ti_wisunfan/{example}/{rtos}/{toolchain}), then run make
.
.../simplelink-ti_wisunfan-examples$ cd examples/rtos/CC1352R1_LAUNCHXL/ti_wisunfan/ns_node/tirtos7/ticlang/
.../ticlang$ make
Note, you can also clean the example with make clean
.
Remember, before building the examples, you must build the SDK libraries!
The examples also include TI Code Composer Studio (CCS) project support, enabling them to be imported into, and built by, CCS.
Before importing the example, the SDK(s) location must be registered with CCS:
- Preferences->Code Composer Studio->Products
- Select Add...
- Navigate to the SDK submodule location
- Select Open
Repeat for each SDK you will be using. This registers the SDK with CCS. Successful registration of an SDK will show it in the "Discovered Products" list:
Now you can import an example!
- Project->Import CCS Project...
- Select search-directory->Browse...
- Navigate to a directory within your clone of the example repo to search for examples and Select Folder
- Select the example(s) you wish to import and press Finish
Remember, before building the examples, you must build the SDK libraries!
Follow the instructions in your respective SDK's Quick Start Guide:
Click the links below for a list of boards that ti_wisunfan examples are provided for. Note that TI does not provide boards for every device, so in some cases you may need to SysConfig-migrate an example from a similar board to your specific device.