BLE Channel Sounding (CS) Antenna Offset Utility#

RAIL BLE Channel Sounding Antenna Offset Utility#

This optional software component can be enabled to include board-specific antenna offset values which are accounted for during CS distance measurements. The maximum number of antennas supported for CS is 4, with each antenna carrying a distance offset value in units of centimeters for both a wireless and wired antenna configuration.

Configuration Options#

The following configuration macros are available for modification:

• CS Antenna Offset:

  • SL_RAIL_UTIL_CS_ANTENNA_COUNT: Number of antennas used during CS.

  • SL_RAIL_UTIL_CS_ANTENNA_CONFIG_TYPE: Indicates the antenna configuration type being used, either wireless or wired. By default, a wireless configuration will be selected, with the macro set to SL_RAIL_UTIL_CS_ANTENNA_OFFSET_CONFIG_TYPE_WIRELESS, or 0. To select a wired antenna configuration type, set the macro field to SL_RAIL_UTIL_CS_ANTENNA_OFFSET_CONFIG_TYPE_WIRED, or 1.

  • SL_RAIL_UTIL_CS_ANTENNA_OFFSET_WIRELESS_CM: Wireless antenna offset values for each antenna, in cm.

  • SL_RAIL_UTIL_CS_ANTENNA_OFFSET_WIRED_CM: Wired antenna offset values for each antenna, in cm.

Note: The antenna offset values for each antenna are calculated offsets for each antenna and should be used. Additonally, the number of antenna offsets set for a wireless or wired antenna configuration must be proportional or greater than the number of antennas configured for CS. Offset values for unused antennas will be ignored.