 |
nrfxlib API 3.3.99
|
|
nrfxlib API 3.3.99
|
| uint8_t sdc_hci_cmd_le_create_cis | ( | const sdc_hci_cmd_le_create_cis_t * | p_params | ) |
#include <softdevice_controller/include/sdc_hci_cmd_le.h>
LE Create CIS.
The description below is extracted from Core_v6.3, Vol 4, Part E, Section 7.8.99
This command is used by the Central’s Host to create one or more CISes using the connections identified by the ACL_Connection_Handle arrayed parameter.
The CIS_Count parameter is the total number of CISes created by this command.
The CIS_Connection_Handle[i] parameter specifies the connection handle corresponding to the configuration of the CIS to be created and whose configuration is already stored in a CIG.
The ACL_Connection_Handle[i] parameter specifies the connection handle of the ACL connection associated with each CIS to be created. The list of the ACL_Connection_Handles shall be in the same order as the list of the CIS_Connection_Handles e.g., CIS_Connection_Handle[1] will connect to the Peripheral associated with the ACL_Connection_Handle[1].
If this command is issued on the Central before the devices have performed the Feature Exchange procedure, then the Controller shall complete that procedure before initiating the Connected Isochronous Stream Creation procedure (see [Vol 6] Part B, Section 5.1.15).
Note: The order of the CIS connection handles in this command does not relate to the order of connection handles in the return parameters of the HCI_LE_Set_CIG_Parameters command or the HCI_LE_Set_CIG_Parameters_Test command.
Note: If an error is reported in the HCI_Command_Status event, it means that no CIS is created and the Host cannot determine which CIS had the error. Therefore, in the case of an error that only affects one CIS of several, reporting the error in the HCI_LE_CIS_Established event for that CIS means that the remaining CISes are still created and the Host can determine which CIS had the error.
Errors:
See Section 4.5.2 for a list of error types and descriptions.
Type Condition Error code
MC An ACL_Connection_Handle[i] does not identify an existing ACL connection. Unknown
Connection
Identifier
(0x02)
MC A CIS_Connection_Handle[i] does not identify a CIS or CIS configuration. Unknown
Connection
Identifier
(0x02)
MC A CIS has already been created. Connection
Already
Exists
(0x0B)
MC Two different CIS_Connection_Handle[i] identify the same CIS. Invalid HCI
Command
Parameters
(0x12)
MC Not all of the HCI_LE_CIS_Established events from the previous use of the Command
command have been generated. Disallowed
(0x0C)
MC An ACL_Connection_Handle[i] identifies a connection where the Controller Command
is the Peripheral. Disallowed
(0x0C)
MC The Connected Isochronous Stream (Host Support) feature bit (see [Vol 6] Command
Part B, Section 4.6.27) is not set. Disallowed
(0x0C)
M An invalid combination of parameters was specified in the Unsupported
HCI_LE_Set_CIG_Parameters or HCI_LE_Set_CIG_Parameters_Test command that Feature or
created the CIS configuration, but the Controller could not detect the Parameter
problem without knowing the properties of the ACL connection associated Value
with the CIS. (0x11)
Event(s) generated (unless masked away):
When the Controller receives the HCI_LE_Create_CIS command, the Controller sends the HCI_Command_Status event to the Host. An HCI_LE_CIS_Established event will be generated for each CIS when it is established or if it is disconnected or considered lost before being established; until all the events are generated, the command remains pending.
| [in] | p_params | Input parameters. |
| 0 | if success. |
1.12.0