CS Reflector#

Channel Sounding (CS) Reflector role implementation for all BLE Channel Sounding apps.

Modules#

cs_reflector_config_t

connection_ctx_t

Enumerations#

enum

cs_sync_antenna_t {

CS_SYNC_ANTENNA_1 = 1

CS_SYNC_ANTENNA_2 = 2

CS_SYNC_SWITCHING = 0xfe

CS_SYNC_ANTENNA_1 = 1

CS_SYNC_ANTENNA_2 = 2

CS_SYNC_SWITCHING = 0xfe

}

Functions#

bool

cs_reflector_identify(uint8_t conn_handle)

sl_status_t

cs_reflector_create(uint8_t conn_handle, cs_reflector_config_t *reflector_config)

uint8_t

cs_reflector_get_active_instance_count(void)

sl_status_t

cs_reflector_delete(uint8_t conn_handle)

bool

cs_reflector_on_bt_event(sl_bt_msg_t *evt)

connection_ctx_t *

cs_rcm_get_connection_ctx(const uint8_t conn_handle)

sl_status_t

cs_rcm_add_new_initiator_connection(const uint8_t conn_handle)

void

cs_rcm_remove_initiator_connection(const uint8_t conn_handle)

bool

cs_rcm_can_accept_new_connection(void)

uint8_t

cs_rcm_get_number_of_connections(void)

Macros#

#define

CS_REFLECTOR_CS_EVENT_BUF_SIZE (16)

#define

CS_REFLECTOR_MAX_CONNECTIONS SL_BT_CONFIG_MAX_CONNECTIONS

#define

CS_REFLECTOR_MIN_TX_POWER_DBM (-3)

#define

CS_REFLECTOR_MAX_TX_POWER_DBM (20)

#define

CS_REFLECTOR_ANTENNA_OFFSET 0

#define

CS_REFLECTOR_CS_SYNC_ANTENNA CS_SYNC_SWITCHING

#define

CS_REFLECTOR_LOG 1

#define

CS_REFLECTOR_LOG_PREFIX "[Reflector]"

#define

REFLECTOR_CONFIG_DEFAULT undefined

Enumeration Documentation#

cs_sync_antenna_t#

cs_sync_antenna_t

Enumerator
CS_SYNC_ANTENNA_1
CS_SYNC_ANTENNA_2
CS_SYNC_SWITCHING
CS_SYNC_ANTENNA_1
CS_SYNC_ANTENNA_2
CS_SYNC_SWITCHING

Function Documentation#

cs_reflector_identify#

bool cs_reflector_identify (uint8_t conn_handle)

Parameters

Type	Direction	Argument Name	Description
uint8_t	[in]	conn_handle	the connection handle to identify

Determine whether a connection handle has a reflector associated to it

Returns

true if the handle has an associated reflector instance, false otherwise

cs_reflector_create#

sl_status_t cs_reflector_create (uint8_t conn_handle, cs_reflector_config_t * reflector_config)

Parameters

Type	Direction	Argument Name	Description
uint8_t	[in]	conn_handle	the connection handle for which to create the reflector
cs_reflector_config_t *	[in]	reflector_config	reflector configuration parameters

Create a reflector for the given connection handle

Returns

status of the operation

cs_reflector_get_active_instance_count#

uint8_t cs_reflector_get_active_instance_count (void )

Parameters

Type	Direction	Argument Name	Description
void	N/A

Get the number of active reflector instances

Returns

the number of active reflector instances

cs_reflector_delete#

sl_status_t cs_reflector_delete (uint8_t conn_handle)

Parameters

Type	Direction	Argument Name	Description
uint8_t	[in]	conn_handle	the connection handle for which to delete the reflector

Delete the reflector associated with the given connection handle

Returns

status of the operation

cs_reflector_on_bt_event#

bool cs_reflector_on_bt_event (sl_bt_msg_t * evt)

Parameters

Type	Direction	Argument Name	Description
sl_bt_msg_t *	[in]	evt	the Bluetooth stack event to handle

Handle a Bluetooth stack event

Returns

true to forward the message to the host in NCP case

cs_rcm_get_connection_ctx#

connection_ctx_t * cs_rcm_get_connection_ctx (const uint8_t conn_handle)

Parameters

Type	Direction	Argument Name	Description
const uint8_t	[in]	conn_handle	the connection handle to search for

Find the pointer to a connection context which belongs to the provided connection handle.

Returns

the pointer of the context corresponding to the provided connection handle, NULL if not found

cs_rcm_add_new_initiator_connection#

sl_status_t cs_rcm_add_new_initiator_connection (const uint8_t conn_handle)

Parameters

Type	Direction	Argument Name	Description
const uint8_t	[in]	conn_handle	the connection handle to register

Returns

status of the operation

cs_rcm_remove_initiator_connection#

void cs_rcm_remove_initiator_connection (const uint8_t conn_handle)

Parameters

Type	Direction	Argument Name	Description
const uint8_t	[in]	conn_handle	the connection handle to remove

Remove an initiator connection with the provided handle.

cs_rcm_can_accept_new_connection#

bool cs_rcm_can_accept_new_connection (void )

Parameters

Type	Direction	Argument Name	Description
void	N/A

Tell whether an additional connection can be accepted.

Returns

true if an additional connection can be accepted, false otherwise

cs_rcm_get_number_of_connections#

uint8_t cs_rcm_get_number_of_connections (void )

Parameters

Type	Direction	Argument Name	Description
void	N/A

Show the number of active connections.

Returns

the number of active connections