Please note as of Wednesday, August 15th, 2018 this wiki has been set to read only. If you are a TI Employee and require Edit ability please contact x0211426 from the company directory.
SimpliciTI - Configuring RF Setting
- 1 Generating SimpliciTI Setting Header File
- 2 SimpliciTI Packet Sniffing
This wiki describes a compact guide for using SmartRF Studio to generate header files containing RF configurations which is used by SimpliciTI protocol stack. For this guide, the EM430F6139RF900 with CC430F6137 on-board will be used, together with [http://www.ti.com/tool/cc1111emk868-915 CC1111 USB Evaluation Module Kit 868/916 MHz) as packet sniffer.
Generating SimpliciTI Setting Header File
Starting SmartRF Studio
Download and install SmartRF Studio (this guide uses SmartRF Studio v1.14.0), then start the software. Click on the target device (in this example CC430), and select "Open RF Device in off-line mode":
This will open Device Control Panel for the selected device.
Device Control Panel
In this window, choose the "Expert Mode" (1) tab for the upper-left window and some commonly used RF settings can be found in this window. In the "RF Parameters" section (2), the detail RF configurations such as the base/carrier frequency, modulation format, etc. can be found and tweaked if necessary. One most important thing to be noticed here is to select the correct crystal frequency (Xtal frequency). After finished with configuring the RF parameters, press the "Register export" button (3) which is located upper right of the Device Control Panel window. This will open the "Register Export" window.
In the "Register Export" window, first select "SimpliciTI settings" (1) under "Template Name" in "Templates" section. Then to make sure that all needed register values will be exported, click the "Select..." button (2) in the upper right of "Registers" section. This will open the "Register Selection" window:
Click at the triple right arrow button in the middle (>>>) to select all possible registers, and then click "OK" button. This will bring the control back to the "Register Export" window. The final step is to click the "Export to File ..." button (3) and save the new header file into the <SIMPLICIT_BASE_FOLDER>\Components\mrfi\smartrf\<RADIO_NAME>. For this example with default SimpliciTI-IAR-1.2.0 installation, the generated smartrf_CC430.h file shall be copied into C:\Texas Instruments\SimpliciTI-IAR-1.2.0\Components\mrfi\smartrf\CC430 folder.
NOTE: if necessary, rename and save the previous header file before replacing it with the newly generated one from SmartRF Studio.
NOTE: comparing with the original smartrf_xxx.h header file in the SimpliciTI, the original header file might have less registers listed in the file. The main reason to export all registers in this case is just to avoid incompatibility of different revisions of SmartRF Studio and the SimpliciTI stack. So the stack will basically take what it needs from the header file (so better to generate all register settings).
- SimpliciTI radio family1, family5, and family7 imports the RF setting in mrfiRadioCfg which can be found in mrfi_radio.c
- SimpliciTI radio family2 hard-codes the value in MRFI_Init() function of mrfi_radio.c
(mrfi_radio.c is not directly included in the project, rather than it is included by mrfi.c by means of the selected MRFI_CCXXXX macro setting during compilation).
After the last step, the whole SimpliciTI project shall be re-compiled to make sure that the new header file containing the new RF configuration will be used during compilation.
SimpliciTI Packet Sniffing
Generating Packet Sniffing Configuration File
As mentioned at the beginning of this guide, the SmartRF Studio can also be used to generate SmartRF Packet Sniffer configuration file. In this case, the CC1111EMK USB Dongle is used and therefore start SmartRF Studio 7 again and select CC1111 as the target device:
In the Device Control Panel window, select the RF parameters which match the RF parameters which are generated for the SimpliciTI stack above. For this example, the parameters are:
- Base frequency: 868 MHz
- Channel number: 0
- Channel spacing: 200 kHz
- Xtal frequency: (board/HW specific)
- Data rate: 38.4 kBaud
- RX filter BW: 100 kHz
- Modulation format: GFSK/2-GFSK
- Deviation:20 kHz
- Manchester enable: no
- PA ramping: no
NOTE: When working with different radios (such as this example which uses CC430 as SimpliciTI nodes and the CC1111 as the sniffer), it is advised to put in the values manually to the RF parameter text fields to get the best matching configurations. The value will be adjusted however by the SmartRF Studio automatically. More information about RF compatibility between transceivers can be found in the following link: SimpliciTI_FAQ#Compatibility_Between_Different_Transceivers.
After finished with the RF parameter settings, click once again the "Register Export" button on upper right side of the window which will open the "Register Export" window.
In the "Register Export" window, select "Packet sniffer settings" as the template (1), the press the "Select..." (2) button to open "Register Selection" window. Click the triple right button (3) and the press "OK" (4) in the "Register Selection" window. After getting back to the "Register Export" window, finally click "Export To File..." for generating the configuration file which is named CC1111.prs for this example.
Flashing SmartRF Packet Sniffer Firmware
Before being able to use the CC1111EMK USB Dongle with the [SmartRF Packet Sniffer], it is necessary to flash the SmartRF Sniffer to the USB dongle. This can be done by using e.g. the [CC-Debugger] hardware programmer together with the [SmartRF Flash Programmer] Software. The firmware can be found per default under C:\Program Files\Texas Instruments\SmartRF Tools\Packet Sniffer\bin\general\firmware after installing the SmartRF Packet Sniffer. For the CC1111EMK, the sniffer_fw_ccxx11.hex binary shall be programmed to the dongle.
Starting SmartRF Packet Sniffer
After the sniffer firmware has been flashed to the dongle, start the [SmartRF Packet Sniffer] software and choose "SimpliciTI" as the protocol type. In the sniffer window, the CC1111 which has been flashed with the sniffer firmware shall be recognized as "Capturing device" in the bottom window:
Click on the "Radio Configuration" tab in the bottom window, and then click the "Browse..." (1) button to select the CC1111.prs file which is generated from the previous step, and then the right arrow button (2) to start sniffing the packets.
Run the SimpliciTI firmware with the header file containing the matching RF parameters. The packets shall be now be captured on the SmartRF Sniffer window: