| BlueNRG-1 ACI APIs and events callbacks

- Main Page
- Modules
- Classes
- Files

Functions
HCI TESTING API

HCI TESTING API layer. More...

## Functions

tBleStatus | hci_le_receiver_test (uint8_t RX_Frequency)
| This command is used to start a test where the DUT receives test reference packets at a fixed interval. The tester generates the test reference packets. (See Bluetooth Specification v.4.1, Vol. 2, Part E, 7.8.28) More...
tBleStatus | hci_le_transmitter_test (uint8_t TX_Frequency, uint8_t Length_Of_Test_Data, uint8_t Packet_Payload)
| This command is used to start a test where the DUT generates test reference packets at a fixed interval. The Controller shall transmit at maximum power. An LE Controller supporting the LE_Transmitter_Test command shall support Packet_Payload values 0x00, 0x01 and 0x02. An LE Controller may support other values of Packet_Payload. (See Bluetooth Specification v.4.1, Vol. 2, Part E, 7.8.29) More...
tBleStatus | hci_le_test_end (uint16_t *Number_Of_Packets)
| This command is used to stop any test which is in progress. The Number_Of_Packets for a transmitter test shall be reported as 0x0000. The Number_Of_Packets is an unsigned number and contains the number of received packets. (See Bluetooth Specification v.4.1, Vol. 2, Part E, 7.8.30) More...

## Detailed Description

HCI TESTING API layer.

## Function Documentation

tBleStatus hci_le_receiver_test | ( | uint8_t | RX_Frequency | ) |

This command is used to start a test where the DUT receives test reference packets at a fixed interval. The tester generates the test reference packets. (See Bluetooth Specification v.4.1, Vol. 2, Part E, 7.8.28)

Parameters

  RX_Frequency | N = (F - 2402) / 2 Range: 0x00 - 0x27. Frequency Range : 2402 MHz to 2480 MHz

Return values

  Value | indicating success or error code.

tBleStatus hci_le_test_end | ( | uint16_t * | Number_Of_Packets | ) |

This command is used to stop any test which is in progress. The Number_Of_Packets for a transmitter test shall be reported as 0x0000. The Number_Of_Packets is an unsigned number and contains the number of received packets. (See Bluetooth Specification v.4.1, Vol. 2, Part E, 7.8.30)

Parameters

  [out] | Number_Of_Packets | Number of packets received

Return values

  Value | indicating success or error code.

tBleStatus hci_le_transmitter_test | ( | uint8_t | TX_Frequency,
|  | uint8_t | Length_Of_Test_Data,
|  | uint8_t | Packet_Payload
| ) |  |

This command is used to start a test where the DUT generates test reference packets at a fixed interval. The Controller shall transmit at maximum power. An LE Controller supporting the LE_Transmitter_Test command shall support Packet_Payload values 0x00, 0x01 and 0x02. An LE Controller may support other values of Packet_Payload. (See Bluetooth Specification v.4.1, Vol. 2, Part E, 7.8.29)

Parameters

  TX_Frequency | N = (F - 2402) / 2 Range: 0x00 - 0x27. Frequency Range : 2402 MHz to 2480 MHz
  Length_Of_Test_Data | 0x00-0x25 Length in bytes of payload data in each packet 0x26-0xFF Reserved for future use
  Packet_Payload | 0x00 Pseudo-Random bit sequence 9 0x01 Pattern of alternating bits '11110000' 0x02 Pattern of alternating bits '10101010' 0x03 Pseudo-Random bit sequence 15 0x04 Pattern of All '1' bits 0x05 Pattern of All '0' bits 0x06 Pattern of alternating bits '00001111' 0x07 Pattern of alternating bits '0101' 0x08-0xFF Reserved for future use

Return values

  Value | indicating success or error code.