1. Configuration Setting Command

Configures the data-register paths, frequency band, and crystal load capacitance.

Register Fields

Bits

Name

Meaning

API

7

el

TX data register enable

rfm12_set_tx_data_register_enable()

6

ef

RX FIFO enable

rfm12_set_rx_fifo_enable()

5:4

b1:b0

Frequency band

rfm12_set_frequency_band()

3:0

x3:x0

Crystal load capacitance

rfm12_set_xtal_cap()

rfm12_set_tx_data_register_enable()

RFM12_result_t rfm12_set_tx_data_register_enable(RFM12_t *dev, RFM12_enable_t enable)

Stage the TX data register enable setting.

Parameters:
  • dev – RFM12 radio instance.

  • enable – Enable or disable the TX data register.

Returns:

RFM12_OK on success, or an appropriate RFM12_result_t error.

rfm12_set_rx_fifo_enable()

RFM12_result_t rfm12_set_rx_fifo_enable(RFM12_t *dev, RFM12_enable_t enable)

Stage the RX FIFO enable setting.

Parameters:
  • dev – RFM12 radio instance.

  • enable – Enable or disable the RX FIFO.

Returns:

RFM12_OK on success, or an appropriate RFM12_result_t error.

rfm12_set_frequency_band()

RFM12_result_t rfm12_set_frequency_band(RFM12_t *dev, RFM12_frequency_band_t band)

Stage the operating frequency band.

Parameters:
  • dev – RFM12 radio instance.

  • band – Frequency band to select.

Returns:

RFM12_OK on success, or an appropriate RFM12_result_t error.

rfm12_set_xtal_cap()

RFM12_result_t rfm12_set_xtal_cap(RFM12_t *dev, RFM12_xtal_cap_t cap)

Stage the crystal load capacitance setting.

Parameters:
  • dev – RFM12 radio instance.

  • cap – Crystal load capacitance setting.

Returns:

RFM12_OK on success, or an appropriate RFM12_result_t error.

rfm12_reset_config_setting()

RFM12_result_t rfm12_reset_config_setting(RFM12_t *dev)

Reset the staged Configuration Setting Command values to their defaults.

Parameters:
  • dev – RFM12 radio instance.

Returns:

RFM12_OK on success, or an appropriate RFM12_result_t error.