◆ sdc_hci_cmd_vs_min_val_of_max_acl_tx_payload_set()

uint8_t sdc_hci_cmd_vs_min_val_of_max_acl_tx_payload_set ( const sdc_hci_cmd_vs_min_val_of_max_acl_tx_payload_set_t * p_params )

#include <softdevice_controller/include/sdc_hci_vs.h>

Set the minimum value that will be used as maximum Tx octets for ACL connections.

This command sets the minimum value of maximum ACL payload length that can be sent in each packet. If the configured event length is shorter than what is required to send a packet pair of 27 bytes in each direction, the controller will use this value to determine how much it can reduce the payload size to satisfy the event length requirements. LL Control PDUs are not affected by this API.

Together with sdc_hci_cmd_vs_event_length_set(), this API allows the controller to schedule ACLs events closer together with other activities.

This API must be called before issuing a command to create a connection, or before starting a connectable advertiser.

The default and maximum value of this parameter is 27. The minimum supported value of this parameter is 10.

Setting this parameter to a lower value will result in more link layer fragmentation, reducing the maximum throughput.

Setting this parameter to a value lower than 27 bytes may result in interoperability issues with older Bluetooth products. It is therefore not recommended to use this API for applications interacting with devices qualified for Bluetooth Specification 5.1 or older.

The configured value is retained after issuing an HCI Reset command.

Event(s) generated (unless masked away): When the command has completed, an HCI_Command_Complete event shall be generated.

Parameters

[in] p_params Input parameters.

Return values

0	if success.

Returns: Returns value between 0x01-0xFF in case of error. See Vol 2, Part D, Error for a list of error codes and descriptions.