CC1200 Driver

Diff: CC1200.h

Revision:

1:98af824b145e

Parent:

0:0c3532738887

Child:

2:2a447e8e50b8

--- a/CC1200.h	Tue Jun 30 02:26:28 2020 -0700
+++ b/CC1200.h	Sun Aug 09 23:39:21 2020 -0700
@@ -174,7 +174,7 @@
 private:
 	// chip data variables
 	bool chipReady = false;
-	State state;
+	State state = State::IDLE;
 	bool isCC1201;
 
 	// current state variables
@@ -284,10 +284,10 @@
 
 	/**
 	 * Set what state the radio will enter when a packet is sent.
-	 * @param state State when a packet is transmitted.
+	 * @param txState State when a packet is transmitted.
 	 * Accepts State::TX, State::IDLE, State::FAST_TX_ON, and State::RX.
 	 */
-	void setOnTransmitState(State state);
+	void setOnTransmitState(State txState);
 
 	enum class FSCalMode : uint8_t
 	{
@@ -406,10 +406,17 @@
 	 * NOTE: The symbol rate and the RX filter bandwidth must be compatible with each other.
 	 * See the user guide for details.
 	 *
+	 * A number of different registers must be configured in order to properly configure the radio for a given bandwidth.
+	 * This call currently sets the following register fields:
+	 * - CHAN_BW.ADC_CIC_DECFACT
+	 * - CHAN_BW.BB_CIC_DECFACT
+	 * - MDMCFG1.DVGA_GAIN
+	 * - MDMCFG0.DATA_FILTER_EN
+	 * - SYNC_CFG0.RX_CONFIG_LIMITATION
+	 *
 	 * @param bandwidthHz the bandwidth in Hz
-	 * @param isCC1201 whether the current chip is a CC1201 instead of a CC1200.  The CC1201 has a more limited set of valid bandwidth settings.
 	 */
-	void setRXFilterBandwidth(float bandwidthHz, bool isCC1201 = false);
+	void setRXFilterBandwidth(float bandwidthHz);
 
 	/**
 	 * Get the ADC CIC decimation that was calculated by the most recent setRXFilterBandwidth() call.
@@ -492,6 +499,90 @@
 	 */
 	void configurePreamble(uint8_t preambleLengthCfg, uint8_t preambleFormatCfg);
 
+	/**
+	 * Enum for different PA ramp times.
+	 */
+	enum class RampTime : uint8_t
+	{
+		RAMP_3_8_SYMBOL = 0b0,
+		RAMP_3_2_SYMBOL = 0b1,
+		RAMP_3_SYMBOL = 0b10,
+		RAMP_6_SYMBOL = 0b11
+	};
+
+	/**
+	 * Set the length and shape of the power amplifier ramp-up curve.
+	 * See section 7.1 for details.
+	 *
+	 * The PA will gradually ramp from off to full amplitude in rampTime relative to the
+	 * symbol rate.  At 1/3 of rampTime it will have ramped to (firstRampLevel / 16) * full amplitude,
+	 * and at 2/3 of rampTime it will have ramped to ((secondRampLevel + 7) / 16) * full amplitude.
+	 */
+	void setPARampRate(uint8_t firstRampLevel, uint8_t secondRampLevel, RampTime rampTime);
+
+	// Automatic Gain Control (AGC) Config
+	// ------------------------------------------------------------------------------
+
+	/**
+	 * Set the AGC reference level which is the internal target power level that
+	 * the AGC tries to adjust to.
+	 *
+	 * The user manual section 6.4 gives a rough formula to calculate this, but I've just used the SmartRF values.
+	 *
+	 * @param level Internal power level in dB.
+	 */
+	void setAGCReferenceLevel(uint8_t level);
+
+	/**
+	 * Enum for possible AGC actions after is a sync word detection.
+	 * See AGC_CFG3 register description for more info.
+	 */
+	enum class SyncBehavior : uint8_t
+	{
+		FREEZE_NONE = 0b000,
+		FREEZE_GAIN = 0b001,
+		AGC_SLOWMODE = 0b010,
+		FREEZE_BOTH = 0b011
+	};
+
+	/**
+	 * Set the AGC behavior after a sync word is detected.
+	 * @param behavior
+	 */
+	void setAGCSyncBehavior(SyncBehavior behavior);
+
+	/**
+	 * Enum for possible gain tables to use.
+	 * See AGC_CFG2 register description for more info.
+	 */
+	enum class GainTable : uint8_t
+	{
+		OPTIMIZED_LINEARITY = 0b00,
+		NORMAL = 0b01,
+		LOW_POWER = 0b10,
+		ZERO_IF = 0b11
+	};
+
+	/**
+	 * Set the gain table and min and max values within that table to use.
+	 * Min and max values are indexes into the current selected table.
+	 */
+	void setAGCGainTable(GainTable table, uint8_t minGainIndex, uint8_t maxGainIndex);
+
+	/**
+	 * Configure the change in input signal power that must be sensed before the AGC starts to adjust itself.
+	 * See the register description for AGC_CFG0.AGC_HYST_LEVEL
+	 * @param hysteresisCfg
+	 */
+	void setAGCHysteresis(uint8_t hysteresisCfg);
+
+	/**
+	 * Configure the rate that the AGC changes the receive gain.
+	 * See the register description for AGC_CFG0.AGC_SLEWRATE_LIMIT
+	 * @param slewrateCfg
+	 */
+	void setAGCSlewRate(uint8_t slewrateCfg);
+
 	// Register level functions
 	// ------------------------------------------------------------------------------