Initialization Utility#

RAIL Initialization Utility#

This optional software component can be enabled to include default functionality related to RAIL initialization configuration.

Note: Multiple instances of this component can be enabled in application code. This is particularly useful for multiprotocol scenarios.

Configuration Options#

The following configuration options can be changed:

  • Enable/disable RAIL initialization.

    • Enable/disable Bluetooth BLE support. If not using Bluetooth, this option can be disabled to reduce memory usage, but if left enabled, no difference in performance occurs.

    • Enable/disable dynamic multiprotocol (DMP) support. This option allocates memory for use by the radio scheduler incorporated into the multiprotocol RAIL library. This should be left disabled for single protocol RAIL library use, which includes switched multiprotocol (SMP) support.

    • Enable/disable initialization complete callback.

  • Enable/disable channel configuration.

    • Configure a proprietary channel configuration on boot. This specifically involves the use of the channelConfigs array in rail_config.c/h.

    • If using a proprietary channel configuration, specify the channel index for use (i.e., index x of array channelConfigs[x]).

  • Enable/disable calibration configuration.

    • Enable/disable temperature-dependent calibrations (e.g., voltage controlled oscillator calibration).

    • Enable/disable one-time calibrations (e.g., image rejection calibration).

  • Enable/disable auto transition configuration.

    • Configure TX transitions on Success and Failure.

    • Configure RX transitions on Success and Failure.

  • Enable/disable radio callback event configuration.

    • Configure RX events.

    • Configure TX events.

    • Configure protocol-specific events.

    • Configure dynamic multiprotocol-specific events.

    • Configure maintenance events. Note: Some protocol-specific events share the same event flag with other protocols; enabling one will enable them all. See rail_types.h::RAIL_Event_t.