sdc_hci_cmd_le_read_iso_link_quality()

uint8_t sdc_hci_cmd_le_read_iso_link_quality	(	const sdc_hci_cmd_le_read_iso_link_quality_t *	p_params,
		sdc_hci_cmd_le_read_iso_link_quality_return_t *	p_return
	)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Read ISO Link Quality.

The description below is extracted from Core_v5.4, Vol 4, Part E, Section 7.8.116

This command returns the values of various counters related to link quality that are associated with the isochronous stream specified by the Connection_Handle parameter.

This command may be issued on both the Central and Peripheral if the connection handle identifies a CIS and on the Synchronized Receiver if the connection handle identifies a BIS.

Each of the remaining return parameters shall contain the current value of the corresponding counter; all the values shall be recorded at the same moment. Each counter shall be a 32-bit unsigned value, shall be initialized to zero when the isochronous stream is created, and shall be incremented as described below. If a counter is not associated with the type of isochronous stream specified, the value of the parameter shall be ignored.

                              Associated

Counter Streams When Incremented

TX_UnACKed_Packets CIS The Link Layer does not receive an acknowledgment for a CIS Data PDU that it transmitted at least once by its flush point (see [Vol 6] Part B, Section 4.5.13.5).

TX_Flushed_Packets CIS The Link Layer does not transmit a spe- cific payload by its flush point.

TX_Last_Subevent_- CIS in Peripheral The Link Layer transmits a CIS Data Packets role PDU in the last subevent of a CIS event.

Retransmitted_Packets CIS The Link Layer retransmits a CIS Data PDU.

Table 7.3: Isochronous streams link quality counters Associated Counter Streams When Incremented

CRC_Error_Packets CIS and BIS The Link Layer receives a packet with a CRC error.

RX_Unreceived_Packets CIS and BIS The Link Layer does not receive a spe- cific payload by its flush point (on a CIS) or the end of the event it is associ- ated with (on a BIS; see [Vol 6] Part B, Section 4.4.6.6).

Duplicate_Packets CIS The Link Layer receives a retransmis- sion of a CIS Data PDU.

Table 7.3: Isochronous streams link quality counters

If the Connection_Handle parameter does not identify a current CIS connection or a BIS that the Controller is synchronized to, the Controller shall return the error code Unknown Connection Identifier (0x02).

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

Parameters

[in]	p_params	Input parameters.
[out]	p_return	Extra return 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.