CS Reflector#

typedef#

typedef (struct { int8_t max_tx_power_dbm;} )

cs_reflector_identify#

bool cs_reflector_identify (uint8_t conn_handle)

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)

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 )

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)

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)

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)

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)

Register a new initiator connection with the provided handle.

Returns

• status of the operation

cs_rcm_remove_initiator_connection#

void cs_rcm_remove_initiator_connection (const uint8_t conn_handle)

Remove an initiator connection with the provided handle.

cs_rcm_can_accept_new_connection#

bool cs_rcm_can_accept_new_connection (void )

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 )

Show the number of active connections.

Returns

• the number of active connections

cs_reflector_event_buf_clear#

void cs_reflector_event_buf_clear (void )

Clear all data from the CS event buffer.

cs_reflector_event_buf_get_free_space#

uint32_t cs_reflector_event_buf_get_free_space (void )

Tell the number of free slots available in the CS event buffer.

Returns

• the number of free slots available in the CS event buffer

cs_reflector_event_buf_purge_data#

void cs_reflector_event_buf_purge_data (const uint8_t conn_handle)

Purge any data from the CS event buffer associated with a connection. Useful when an initiator disconnects and we don't want any leftover measurement data in the buffer.

cs_reflector_event_buf_get_element_for_write#

cs_event_data_t * cs_reflector_event_buf_get_element_for_write (void )

Find a pointer to a buffer element which is free to write, yields NULL if no writable elements are available.

Returns

• pointer to a free buffer element, NULL if none available

cs_reflector_event_buf_get_next_element#

cs_event_data_t * cs_reflector_event_buf_get_next_element (const uint8_t conn_handle)

Provide a pointer to the next available data for a given connection, yields NULL if no next data is available.

Returns

• pointer to the next available data, NULL if none available

cs_reflector_event_buf_find#

cs_event_data_t * cs_reflector_event_buf_find (const uint8_t conn_handle, const uint16_t procedure_index, const uint16_t subevent_index)

Find and return an exact result from the CS event buffer.

Returns

• pointer to the result if available, NULL if not found

cs_reflector_event_buf_get_next_unindicated#

cs_event_data_t * cs_reflector_event_buf_get_next_unindicated (const uint8_t conn_handle)

Find a pointer to the next available data which we haven't sent an indication about for a given connection.

Returns

• pointer to the result if available, NULL if none available

CS_REFLECTOR_MAX_CONNECTIONS#

#define CS_REFLECTOR_MAX_CONNECTIONS

SL_BT_CONFIG_MAX_CONNECTIONS

CS_REFLECTOR_CS_EVENT_BUF_SIZE#

#define CS_REFLECTOR_CS_EVENT_BUF_SIZE

(16)

CS_REFLECTOR_MIN_TX_POWER_DBM#

#define CS_REFLECTOR_MIN_TX_POWER_DBM

(-3)

CS_REFLECTOR_MAX_TX_POWER_DBM#

#define CS_REFLECTOR_MAX_TX_POWER_DBM

(20)

CS_REFLECTOR_ANTENNA_OFFSET#

#define CS_REFLECTOR_ANTENNA_OFFSET

0

CS_REFLECTOR_LOG#

#define CS_REFLECTOR_LOG

1

CS_REFLECTOR_LOG_PREFIX#

#define CS_REFLECTOR_LOG_PREFIX

"[Reflector]"

CS_EVENT_BUF_DATA_MAX_LEN#

#define CS_EVENT_BUF_DATA_MAX_LEN

256