feat TX power

Objective

Describe the power setting feature in Baloo.

Description

Baloo provides the user with a direct interface to select the power setting for transmissions (often called TX power).

The user can select a desired value (among those supported by the platorm) which is set at initialization. A dedicated function allows to modify this setting at any time during execution.

This feature is always active.

Availability

Available for all supported platforms.

Compatibility

Compatible with all the features and communication primitives.

Using the feature

The user can select the desired TX power using the following macro (typically in project-conf.h)

#define GMW_CONF_RF_TX_POWER 

The admissible values for this macro are listed in a enum in the platform configuration file (gmw-conf-<platform>.h). Below is the list for the sky mote as an example:

typedef enum
{
  GMW_RF_TX_PWR_0_dBm           = 31,
  GMW_RF_TX_PWR_MINUS_1_dBm     = 27,
  GMW_RF_TX_PWR_MINUS_3_dBm     = 23,
  GMW_RF_TX_PWR_MINUS_5_dBm     = 19,
  GMW_RF_TX_PWR_MINUS_7_dBm     = 15,
  GMW_RF_TX_PWR_MINUS_10_dBm    = 11,
  GMW_RF_TX_PWR_MINUS_15_dBm    = 7,
  GMW_RF_TX_PWR_MINUS_25_dBm    = 3
} gmw_rf_tx_power_t;

The user can modify the TX power setting at run time using the gmw_set_tx_power() function (see gmw-platform.h).