Added function to set output power level.

Author: DeanCording

include/rf.h

@@ -224,11 +224,11 @@
 #define RF_RF_SETUP_RF_DR_LOW			0x20
 #define RF_RF_SETUP_PLL_LOCK			0x10
 #define RF_RF_SETUP_RF_DR_HIGH			0x08
-#define RF_RF_SETUP_RF_PWR				0x06
+#define RF_RF_SETUP_RF_PWR			0x06
 #define RF_RF_SETUP_RF_PWR_0_DBM		0x06
-#define RF_RF_SETUP_RF_PWR_NEG_6_DBM 	0x04
-#define RF_RF_SETUP_RF_PWR_NEG_12_DBM	0x02
-#define RF_RF_SETUP_RF_PWR_NEG_18_DBM	0x00
+#define RF_RF_SETUP_RF_PWR_NEG_6_DBM 		0x04
+#define RF_RF_SETUP_RF_PWR_NEG_12_DBM		0x02
+#define RF_RF_SETUP_RF_PWR_NEG_18_DBM		0x00
 //The following can be used in lieu of RF_RF_SETUP_RF_DR_LOW and RF_RF_SETUP_RF_DR_HIGH to set the data rate
 #define RF_RF_SETUP_RF_DR_2_MBPS		RF_RF_SETUP_RF_DR_HIGH
 #define RF_RF_SETUP_RF_DR_1_MBPS		0
@@ -383,6 +383,8 @@ void rf_power_up_param(bool rx_active_mode, uint8_t config);
 void rf_power_down();
 void rf_power_down_param(uint8_t config);
 
+void rf_set_output_power(uint8_t);
+
 uint8_t rf_write_register(uint8_t regnumber, uint8_t * dataptr, uint16_t len);
 uint8_t rf_read_register(uint8_t regnumber, uint8_t * dataptr, uint16_t len);
 uint8_t rf_read_register_1_byte(uint8_t regnumber);

src/rf/src/rf_set_output_power.c

@@ -0,0 +1,54 @@
+/////////////////////////////////////////////////////////////////////////////
+//
+// File: rf_output_power.c
+//
+// Copyright Dean Cording, 2013
+//
+// The author provides no guarantees, warantees, or promises, implied or
+//  otherwise.  By using this software you agree to indemnify the author
+//  of any damages incurred by using it.
+//
+/////////////////////////////////////////////////////////////////////////////
+
+/////////////////////////////////////////////////////////////////////////////
+// This library is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Lesser General Public
+// License as published by the Free Software Foundation; either
+// version 2.1 of the License, or (at your option) any later version.
+//
+// This library is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+/////////////////////////////////////////////////////////////////////////////
+
+#include "rf.h"
+#include "rf_src.h"
+
+
+/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+//
+// void rf_set_output_power(uint8_t power)
+//
+// Description:
+//  Sets the TX power level of the device (0dBm, -6dBm, -12dBm, -18dBm)
+//
+// Parameters:
+//  uint8_t power - new power level RF_RF_SETUP_RF_PWR_[0|NEG_6|NEG_12|NEG_18]_DBM
+//
+// Return value:
+//  None
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+void rf_set_output_power(uint8_t power)
+{
+	if (power <= RF_RF_SETUP_RF_PWR_0_DBM) {
+		uint8_t rf_setup = rf_read_register_1_byte(RF_RF_SETUP);
+		rf_setup = (rf_setup & ~RF_RF_SETUP_RF_PWR) | power;
+		rf_write_register(RF_RF_SETUP, &rf_setup, 1);
+	}
+}