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_v6.0, 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 by one as described below. If a counter is not associated with the type of isochronous stream specified, the value of the parameter shall be ignored.

Counter Associated When Incremented Streams 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 specific payload by its flush point. TX_Last_Subevent_- CIS in Peripher- The Link Layer transmits a CIS Data PDU in the last Packets al role subevent of a CIS event. Retransmitted_Packets CIS The Link Layer retransmits a CIS Data PDU. CRC_Error_Packets CIS and BIS The Link Layer receives a packet with a CRC error. Counter Associated When Incremented Streams RX_Unreceived_- CIS and BIS The Link Layer does not receive a specific payload by Packets its flush point (on a CIS) or the end of the event it is associated with (on a BIS; see [Vol 6] Part B, Section 4.4.6.6). Duplicate_Packets CIS The Link Layer receives a retransmission of a CIS Data PDU.

Table 7.4: 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.