 |
nrfxlib API 3.3.99
|
|
nrfxlib API 3.3.99
|
| uint8_t sdc_hci_cmd_le_create_big_test | ( | const sdc_hci_cmd_le_create_big_test_t * | p_params | ) |
#include <softdevice_controller/include/sdc_hci_cmd_le.h>
LE Create BIG Test.
The description below is extracted from Core_v6.3, Vol 4, Part E, Section 7.8.104
This command should only be used for testing purposes.
The command is used to create one or more BISes of a BIG (see [Vol 6] Part B, Section 4.4.6). All BISes in the BIG have the same values for all parameters.
The BIG_Handle contains the identifier of the BIG. This parameter is allocated by the Host and used by the Controller and the Host to identify a BIG.
The Advertising_Handle identifies the associated periodic advertising train of the BIG.
The Num_BIS parameter contains the total number of BISes in the BIG.
The SDU_Interval parameter specifies the time interval of the periodic SDUs.
The ISO_Interval parameter contains the time duration between two consecutive BIG anchor points.
The NSE (Number of SubEvents) parameter contains the total number of subevents that are used to transmit BIS Data PDUs for each BIS in a BIG event. The NSE parameter shall be greater than or equal to IRC × BN. The Max_SDU parameter contains the maximum size, in octets, of an SDU. The minimum value of the Max_SDU parameter in the ISO Transmit Test mode when the Payload_Type = 1 or 2 shall be 4.
The Max_PDU parameter contains the maximum size of every BIS Data PDU for every BIS in the BIG.
The PHY parameter is a bit field that indicates the PHY used for transmission of PDUs of BISes in the BIG. The Host shall set only one bit in this parameter and the Controller shall use the PHY set by the Host.
The Packing parameter indicates the method of arranging subevents of multiple BISes. The subevents can be arranged in Sequential or Interleaved arrangement. This parameter shall be ignored when there is only one BIS in the BIG.
The Framing parameter indicates the format of the BIS Data PDUs and the mode of framed PDUs (see [Vol 6] Part G, Section 2) that the Controller shall use on the specified BIG.
The BN (Burst Number) parameter contains the number of new payloads for each BIS in a BIS event.
The IRC (Immediate Repetition Count) parameter contains the number of times the scheduled data packet is transmitted (see [Vol 6] Part B, Section 4.4.6). The IRC parameter shall be an integer in the range 1 to (NSE ÷ BN).
The PTO (Pre_Transmission_Offset) parameter contains the offset in number of ISO_Intervals for pre transmissions of data packets (see [Vol 6] Part B, Section 4.4.6).
The Encryption parameter identifies the encryption mode of the BISes in the BIG. If the Encryption parameter is set to 1 (encrypted), the Broadcast_Code is used in the encryption of payloads (see [Vol 6] Part B, Section 4.4.6).
The Broadcast_Code parameter is a 16-octet field that is used to generate the session key to encrypt payloads of all BISes in the BIG. When the Encryption parameter is set to 0 (unencrypted), all 16 octets of the Broadcast_Code parameter shall be set to zero by the Host and ignored by the Controller.
Errors:
See Section 4.5.2 for a list of error types and descriptions.
Type Condition Error code
MC The PHY parameter contains a bit for a PHY that the Controller does not Unsupporte
support or is reserved for future use. d Feature
or
Parameter
Value
(0x11)
MC The Controller cannot create all BISes of the BIG or Num_BIS exceeds the Rejected
maximum value supported by the Controller. due to
Limited
Resources
(0x0D)
MC Advertising_Handle does not identify a periodic advertising train, Unknown Ad
identifies a periodic advertising train associated with another BIG, or vertising
identifies a periodic advertising train that has responses and the Identifier
Controller does not support PAwR. (0x42)
MC BIG_Handle identifies a BIG that is already created. Command
Disallowed
(0x0C)
MC Max_PDU, NSE, BN, IRC, or PTO exceeds the value supported by the Unsupporte
Controller. d Feature
or
Parameter
Value
(0x11)
MC NSE is not an integer multiple of BN or is less than IRC × BN. Unsupporte
d Feature
or
Parameter
Value
(0x11)
MC Any parameter is not in the specified range. Unsupporte
d Feature
or
Parameter
Value
(0x11)
M The BIG parameters are incompatible in a way not covered by one of the Invalid
previous two items. HCI
Command
Parameters
(0x12)
M The length of the associated periodic advertising, with the BIGInfo added Packet Too
to the ACAD, is greater than the maximum that the Controller can transmit Long
within the periodic advertising interval. If advertising on the LE Coded (0x45)
PHY, then the S=8 coding shall be assumed unless the current advertising
parameters require the use of S=2 for an advertising physical channel, in
which case the S=2 coding shall be assumed for that advertising physical
channel.
Event(s) generated (unless masked away):
When the Controller receives the HCI_LE_Create_BIG_Test command, the Controller sends the HCI_Command_Status event to the Host. When the HCI_LE_Create_BIG_Test command has completed, the HCI_LE_Create_BIG_Complete event is generated.
| [in] | p_params | Input parameters. |
| 0 | if success. |
1.12.0