nrfxlib API 3.3.99
Loading...
Searching...
No Matches

◆ sdc_hci_cmd_le_frame_space_update()

uint8_t sdc_hci_cmd_le_frame_space_update ( const sdc_hci_cmd_le_frame_space_update_t * p_params)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Frame Space Update.

The description below is extracted from Core_v6.3, Vol 4, Part E, Section 7.8.151

This command allows the Host to request a change to one or more frame space values. This command may be issued on both the Central and the Peripheral.

The Frame_Space_Min and Frame_Space_Max parameters indicate the minimum and maximum allowed frame space values that the Controller should use, respectively. The Frame_Space_Min parameter shall not be greater than the Frame_Space_Max parameter.

The PHYS and Spacing_Types parameters indicate which frame space values are to be updated. At least one bit shall be set in the PHYS parameter and at least one bit shall be set in the Spacing_Types parameter.

The actual parameter values selected by the Link Layer may be different from the parameter values provided by the Host through this command.

If the Host issues this command with Frame_Space_Max less than the frame space value, then the Controller shall ignore the value provided by the Host and shall use the frame space value in use as the Frame_Space_Max.

Errors:

See Section 4.5.2 for a list of error types and descriptions.

Type   Condition                                                                   Error code
MC     Connection_Handle does not identify an active ACL connection.               Unknown
                                                                                   Connection
                                                                                   Identifier
                                                                                   (0x02)
MC     Frame_Space_Max is less than Frame_Space_Min.                               Invalid HCI
                                                                                   Command
                                                                                   Parameters
                                                                                   (0x12)
MC     No bits are set in PHYS or in Spacing_Types.                                Invalid HCI
                                                                                   Command
                                                                                   Parameters
                                                                                   (0x12)
MC     An unsupported bit is set in PHYS or Spacing_Types.                         Unsupported
                                                                                   Feature or
                                                                                   Parameter
                                                                                   Value (0x11)
MC     A bit set in PHYS or Spacing_Types corresponds to a feature that the        Unsupported
       Controller already knows is not supported by the remote device (e.g.        Remote
       because it has already received a corresponding error response from the     Feature
       remote device or has checked the features supported by the remote           (0x1A)
       device).

Event(s) generated (unless masked away):

When the Controller receives the HCI_LE_Frame_Space_Update command, the Controller shall send the HCI_Command_Status event to the Host. When the HCI_LE_Frame_Space_Update command has completed, an HCI_LE_Frame_Space_Update_Complete event shall be generated.

Parameters
[in]p_paramsInput parameters.
Return values
0if 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.