Bluetooth Mesh SAR Configuration Server Model#

Bluetooth Mesh SAR Configuration Server Model.

SAR Configuration Server, control the segmentation and reassembly behavior of the node

Modules#

sl_btmesh_evt_sar_config_server_sar_transmitter_set

sl_btmesh_evt_sar_config_server_sar_receiver_set

Functions#

sl_status_t
sl_btmesh_sar_config_server_get_sar_transmitter(uint8_t *segment_interval_step, uint8_t *unicast_retrans_count, uint8_t *unicast_retrans_wo_progress_count, uint16_t *unicast_retrans_interval_step, uint16_t *unicast_retrans_interval_increment, uint8_t *multicast_retrans_count, uint16_t *multicast_retrans_interval_step)
sl_status_t
sl_btmesh_sar_config_server_set_sar_transmitter(uint8_t segment_interval_step, uint8_t unicast_retrans_count, uint8_t unicast_retrans_wo_progress_count, uint16_t unicast_retrans_interval_step, uint16_t unicast_retrans_interval_increment, uint8_t multicast_retrans_count, uint16_t multicast_retrans_interval_step)
sl_status_t
sl_btmesh_sar_config_server_get_sar_receiver(uint8_t *segments_threshold, uint8_t *ack_delay_increment, uint32_t *discard_timeout, uint8_t *segment_interval_step, uint8_t *ack_retrans_count)
sl_status_t
sl_btmesh_sar_config_server_set_sar_receiver(uint8_t segments_threshold, uint8_t ack_delay_increment, uint32_t discard_timeout, uint8_t segment_interval_step, uint8_t ack_retrans_count)

Function Documentation#

sl_btmesh_sar_config_server_init#

sl_status_t sl_btmesh_sar_config_server_init ()

Initialize the SAR Configuration Server

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 21146 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_sar_config_server_deinit#

sl_status_t sl_btmesh_sar_config_server_deinit ()

Deinitialie the SAR Configuration Server

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 21156 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_sar_config_server_get_sar_transmitter#

sl_status_t sl_btmesh_sar_config_server_get_sar_transmitter (uint8_t * segment_interval_step, uint8_t * unicast_retrans_count, uint8_t * unicast_retrans_wo_progress_count, uint16_t * unicast_retrans_interval_step, uint16_t * unicast_retrans_interval_increment, uint8_t * multicast_retrans_count, uint16_t * multicast_retrans_interval_step)
Parameters
[out]segment_interval_step

SAR Segment Interval Step in milliseconds

[out]unicast_retrans_count

SAR Unicast Retransmissions Count

[out]unicast_retrans_wo_progress_count

SAR Unicast Retransmissions Without Progress Count

[out]unicast_retrans_interval_step

SAR Unicast Retransmissions Interval Step in milliseconds

[out]unicast_retrans_interval_increment

SAR Unicast Retransmissions Interval Increment

[out]multicast_retrans_count

SAR Multicast Retransmissions Count

[out]multicast_retrans_interval_step

SAR Multicast Retransmissions Interval in milliseconds

Query the local SAR Transmitter configuration

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 21177 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_sar_config_server_set_sar_transmitter#

sl_status_t sl_btmesh_sar_config_server_set_sar_transmitter (uint8_t segment_interval_step, uint8_t unicast_retrans_count, uint8_t unicast_retrans_wo_progress_count, uint16_t unicast_retrans_interval_step, uint16_t unicast_retrans_interval_increment, uint8_t multicast_retrans_count, uint16_t multicast_retrans_interval_step)
Parameters
[in]segment_interval_step

SAR Segment Interval Step

The Segment Interval Step controls the interval between transmissions of segments of a segmented message in milliseconds. The value is the range of 10ms to 160ms in 10ms steps, intermediate values are rounded down to the nearest multiple of 10. Default value is 20ms.

[in]unicast_retrans_count

SAR Unicast Retransmissions Count

The SAR Unicast Retransmission Count controls the maximum number of transmissions of segments of segmented messages to a unicast destination. Valid range is 0 - 15, where 0 represents a single transmission. The default value is 7, resulting in 8 transmissions total.

[in]unicast_retrans_wo_progress_count

SAR Unicast Retransmissions Without Progress Count

The SAR Unicase Retransmissions Without Progress Count controls the maximum number of retransmissions of segments of segmented messages to a unicast destination without progress (without marking newly marking any segments acknowledged). Valid range is 0 - 15, where 0 represents a single transmission. The default value is 2, resulting in 3 transmissions. The value of this state should be set to a value greater by two or more than the value of the SAR Acknowledgement Retransmissions Count on a peer node. This helps prevent the SAR transmitter from abandoning the SAR prematurely.

[in]unicast_retrans_interval_step

SAR Unicast Retransmissions Interval Step

The SAR Unicast Retransmissions Interval Step state controls the minimum interval between retransmissions of segments of a segmented message for a destination that is a unicast address in 25ms steps. Valid range is 25 - 400ms, intermediate values are rounded down to the nearest multiple of 25. Default value is 200ms.

[in]unicast_retrans_interval_increment

SAR Unicast Retransmissions Interval Increment

The SAR Unicast Retransmissions Interval Increment state controls the incremental component of the interval between retransmissions of segments of a segmented message for a destination that is a unicast address in 25ms steps. Valid range is 25 - 400ms, intermediate values are rounded down to the nearest multiple of 25. Default value is 50ms.

[in]multicast_retrans_count

SAR Multicast Retransmissions Count

The SAR Multicast Retransmissions Count state controls the maximum number of transmissions of segments of segmented messages to a group address or a virtual address. Valid range is 0 - 15, where 0 represents a single transmission. The default value is 1, resulting in 2 transmissions.

[in]multicast_retrans_interval_step

SAR Multicast Retransmissions Interval

The SAR Multicast Retransmissions Interval Step state controls the interval between retransmissions of segments of a segmented message for a destination that is a group address or a virtual address in 25ms steps. Valid range is 25-400ms, intermediate values are rounded down to the nearest multiple of 25. Default values is 100ms.

Set the local SAR Transmitter configuration

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 21256 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_sar_config_server_get_sar_receiver#

sl_status_t sl_btmesh_sar_config_server_get_sar_receiver (uint8_t * segments_threshold, uint8_t * ack_delay_increment, uint32_t * discard_timeout, uint8_t * segment_interval_step, uint8_t * ack_retrans_count)
Parameters
[out]segments_threshold

SAR Segments Threshold

The SAR Segments Threshold state represents the size of a segmented message in number of segments above which the Segment Acknowledgment messages are enabled. Valid range is 0 - 31, the default value is 3.

[out]ack_delay_increment

SAR Acknowledgment Delay Increment

The SAR Acknowledgment Delay Increment state control the interval between the reception of a new segment of a segmented message for a destination that is a unicast address and the transmission of the Segment Acknowledgment for that message. Valid range is 0 - 7, default is 2.

[out]discard_timeout

SAR Discard Timeout

The SAR Discard Timeout state controls the time that the lower transport layer waits after receiving unique segments of a segmented message before discarding that segmented message in 5s steps. Valid range is 5000 - 80000ms, intermediate values are rounded down to the nearest multiple of 5s. The default value is 10000ms.

[out]segment_interval_step

SAR Receiver Segment Interval Step

The SAR Receiver Segment Interval Step state indicates the interval between received segments of a segmented message in milliseconds. This is used to control rate of transmission of Segment Acknowledgment messages. Valid range is 10 - 160, intermediate values are rounded down to the nearest multiple of 10. The default value is 20ms.

[out]ack_retrans_count

SAR Acknowledgment Retransmissions Count

The SAR Acknowledgment Retransmissions Count state controls the maximum number of retransmissions of Segment Acknowledgment messages sent by the lower transport layer. Valid range is 0 - 3. The default value is 2, representing 2 retransmissions or 3 in total.

Query the local SAR Receiver configuration

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 21313 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_sar_config_server_set_sar_receiver#

sl_status_t sl_btmesh_sar_config_server_set_sar_receiver (uint8_t segments_threshold, uint8_t ack_delay_increment, uint32_t discard_timeout, uint8_t segment_interval_step, uint8_t ack_retrans_count)
Parameters
[in]segments_threshold

SAR Segments Threshold

The SAR Segments Threshold state represents the size of a segmented message in number of segments above which the Segment Acknowledgment messages are enabled. Valid range is 0 - 31, the default value is 3.

[in]ack_delay_increment

SAR Acknowledgment Delay Increment

The SAR Acknowledgment Delay Increment state control the interval between the reception of a new segment of a segmented message for a destination that is a unicast address and the transmission of the Segment Acknowledgment for that message. Valid range is 0 - 7, default is 2.

[in]discard_timeout

SAR Discard Timeout

The SAR Discard Timeout state controls the time that the lower transport layer waits after receiving unique segments of a segmented message before discarding that segmented message in 5s steps. Valid range is 5000 - 80000ms, intermediate values are rounded down to the nearest multiple of 5s. The default value is 10000ms (10s).

[in]segment_interval_step

SAR Receiver Segment Interval Step

The SAR Receiver Segment Interval Step state indicates the interval between received segments of a segmented message in milliseconds. This is used to control rate of transmission of Segment Acknowledgment messages. Valid range is 10 - 160, intermediate values are rounded down to the nearest multiple of 10. The default value is 20ms.

[in]ack_retrans_count

SAR Acknowledgment Retransmissions Count

The SAR Acknowledgment Retransmissions Count state controls the maximum number of retransmissions of Segment Acknowledgment messages sent by the lower transport layer. Valid range is 0 - 3. The default value is 2, representing 2 retransmissions or 3 in total.

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 21368 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

Macro Definition Documentation#

sl_btmesh_cmd_sar_config_server_init_id#

#define sl_btmesh_cmd_sar_config_server_init_id
Value:
0x01630028

Definition at line 20918 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_cmd_sar_config_server_deinit_id#

#define sl_btmesh_cmd_sar_config_server_deinit_id
Value:
0x02630028

Definition at line 20919 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_cmd_sar_config_server_get_sar_transmitter_id#

#define sl_btmesh_cmd_sar_config_server_get_sar_transmitter_id
Value:
0x03630028

Definition at line 20920 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_cmd_sar_config_server_set_sar_transmitter_id#

#define sl_btmesh_cmd_sar_config_server_set_sar_transmitter_id
Value:
0x04630028

Definition at line 20921 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_cmd_sar_config_server_get_sar_receiver_id#

#define sl_btmesh_cmd_sar_config_server_get_sar_receiver_id
Value:
0x05630028

Definition at line 20922 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_cmd_sar_config_server_set_sar_receiver_id#

#define sl_btmesh_cmd_sar_config_server_set_sar_receiver_id
Value:
0x06630028

Definition at line 20923 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_rsp_sar_config_server_init_id#

#define sl_btmesh_rsp_sar_config_server_init_id
Value:
0x01630028

Definition at line 20924 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_rsp_sar_config_server_deinit_id#

#define sl_btmesh_rsp_sar_config_server_deinit_id
Value:
0x02630028

Definition at line 20925 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_rsp_sar_config_server_get_sar_transmitter_id#

#define sl_btmesh_rsp_sar_config_server_get_sar_transmitter_id
Value:
0x03630028

Definition at line 20926 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_rsp_sar_config_server_set_sar_transmitter_id#

#define sl_btmesh_rsp_sar_config_server_set_sar_transmitter_id
Value:
0x04630028

Definition at line 20927 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_rsp_sar_config_server_get_sar_receiver_id#

#define sl_btmesh_rsp_sar_config_server_get_sar_receiver_id
Value:
0x05630028

Definition at line 20928 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h

sl_btmesh_rsp_sar_config_server_set_sar_receiver_id#

#define sl_btmesh_rsp_sar_config_server_set_sar_receiver_id
Value:
0x06630028

Definition at line 20929 of file /mnt/raid/workspaces/ws.cynwT2I6w/overlay/gsdk/protocol/bluetooth/build/native/mesh_app/inc/sl_btmesh_api.h