OAD Image Tool¶
The OAD image tool is a script written in python that is intended to process the compiler output in the form of a hexfile and prepare the image for over the air transfer.
The major components of the oad_image_tool include:
- Conversion from *.hex to *.bin
- Padding the image to be word aligned
- Calculating the CRC and embedding it in the image header
- Optional: Merging a split image into a single app + stack image
The tool is located in the tools/common/oad
folder of the SimpleLink CC26x2 SDK.
Running the tool¶
The OAD Image Tool is distributed in both source and binary form. The correct binary will be bundled with the installer for a given platform (i.e. Linux, Windows, Mac). However, the tool can also be run in source if desired.
The tool is intended to run as a post build step to an OAD application. When
run as a post build step, the tool will generate an output binary file named
<app_name>_oad.bin
where <app_name>
is the name and path specified by
the required -o
argument to the script.
It is recommended to use the OAD enabled example application from the intended protocol stack component of the SimpleLink CC26x2 SDK and copy + modify the post build step as needed.
Running the Tool from Source¶
In general, it is recommended to invoke the tool via the binaries distributed with the SimpleLink CC26x2 SDK. However if it is required to run the tool is source, the following steps should be taken:
- Ensure Python 2.7.1 is installed on the system
- Install the required packages via pip (see requirements.txt and README.html in the same folder as the tool)
Required Arguments/Getting help¶
If help is needed when running the tool, invoke it with the -h
option which
will describe the supported features of the tool, the arguments and the actions
they perform.