Driver for TI's CC1200 radio ICs. Forget hardcoded register settings -- this driver calculates everything from scratch!
Dependents: CC1200-MorseEncoder CC1200-Examples
CC1200 Driver
by Jamie Smith / USC Rocket Propulsion Lab
After months of work, we are proud to present our driver for Texas Instruments' CC1200 digital radio IC! This driver has been written from scratch to be an easy and flexible way of using this radio transceiver. For our application, we needed to be able to tune each and every setting of the radio to try and eke that last bit of performance of our system - so using premade configurations alone wasn't going to cut it! Instead, this driver calculates each parameter of the radio using the equations and instructions given in the datasheet. So, you can tweak parameters to your heart's content, and you shouldn't have to do any math yourself!
Features
- Automatic calculation of correct register values for:
- RF frequency
- FSK deviation
- Symbol rate
- Output power
- RX filter bandwidth (this one's harder than it looks!)
- Easy handling of data packets
- GPIO configuration
- Preamble and sync word configuration
- RTOS compatible (always locks SPI bus during transactions)
- Two debug levels available
- RSSI and LQI support
Not Supported
- Transparent mode
- FM mode
- ASK parameter configuration
- Frequency offsets
Examples
- See the example project here for an example of how to use the driver.
- Another example (using a more exotic configuration) is the CC1200-MorseEncoder.
Changelog
Version 1.2 May 3 2021
- Added unfinished infinite length packet support via the readStream() and writeStream() functions. The API is complete and basic usage works but there's still a bug I haven't been able to track down yet where incorrect data is transmitted at the end of a stream. Use with caution!
- Added
preferHigherCICDec
parameter tosetRXFilterBandwidth
- Removed
setIFMixCFG()
(which takes a byte parameter) and replaced it withsetIFCfg()
, which takes documented enum class values. - Added
setAGCSettleWait()
, which per my testing is needed for correct 430MHz operation. - Added support for reading RSSI and LQI values, both from packet appended status bytes and from the registers.
- Update 430MHz black box registers based on SmartRF values
- Removed
setIQMismatchCompensationEnabled()
. This call has been replaced by the new 2nd parameter tosetIFCfg()
.
Version 1.1 Aug 28 2020
- Add fixed length packet support and other features needed for Morse support.
- Fix bug causing weird behavior with low sample rates (<1ksps).
NOTE: you must now call setPacketMode() when configuring the radio.
Version 1.0 Aug 10 2020
Initial Release
History
Update to v1.2
2021-05-03, by Jamie Smith [Mon, 03 May 2021 02:41:34 -0700] rev 5
Update to v1.2
Add fixed length packet support and other features needed for Morse support. Fix bug causing weird behavior with low sample rates (<1ksps). NOTE: you must now call setPacketMode() when configuring the radio.
2020-08-28, by Jamie Smith [Fri, 28 Aug 2020 15:39:31 -0700] rev 4
Add fixed length packet support and other features needed for Morse support. Fix bug causing weird behavior with low sample rates (<1ksps). NOTE: you must now call setPacketMode() when configuring the radio.
Fix compilation with Arm Compiler
2020-08-10, by Jamie Smith [Mon, 10 Aug 2020 01:47:24 -0700] rev 3
Fix compilation with Arm Compiler
Update to Mbed OS 6. Also fix CC1200::hasReceivedPacket, which has never actually worked until now (whoops)
2020-08-10, by Jamie Smith [Mon, 10 Aug 2020 01:30:40 -0700] rev 2
Update to Mbed OS 6. Also fix CC1200::hasReceivedPacket, which has never actually worked until now (whoops)
Add a few new features, fix issue with reading from wrong FIFO
2020-08-09, by Jamie Smith [Sun, 09 Aug 2020 23:39:21 -0700] rev 1
Add a few new features, fix issue with reading from wrong FIFO
Add initial version of driver
2020-06-30, by Jamie Smith [Tue, 30 Jun 2020 02:26:28 -0700] rev 0
Add initial version of driver