HciLEDirectionFindingTransmitterTest(int, int, BluetoothDtmLEPatternType, BluetoothDtmTransmitterPhy, BluetoothDtmDirectionFindingMode, int, double, double, int[], out int)
- Updated2025-10-13
- 2 minute(s) read
Sends a command to the device under test (DUT) to start the transmitter test.
Syntax
Namespace: NationalInstruments.BluetoothDtm
public int HciLEDirectionFindingTransmitterTest(int channelNumber, int payloadLength, BluetoothDtmLEPatternType lePatternType, BluetoothDtmTransmitterPhy phy, BluetoothDtmDirectionFindingMode directionFindingMode, int switchingPatternLength, double cteLength, double cteSlotDuration, int[] antennaID, out int status)
Parameters
| Name | Type | Description |
|---|---|---|
| channelNumber | int | Specifies the Bluetooth transmit channel number of the generated signal. The default value is 0. |
| payloadLength | int | Specifies the length of payload data in each packet that the DUT transmits. This value is expressed in bytes. The default value is 37. |
| lePatternType | BluetoothDtmLEPatternType | Specifies the type of payload to use for the LE packet. Payload type values of Type_Prbs9, Type_11110000, and Type_10101010 must be supported by the DUT. The remaining payload type values are optional. The default value is Type_Prbs9. |
| phy | BluetoothDtmTransmitterPhy | Specifies the type of the packet to be transmitted by the physical layer of the DUT. The default value is Phy_1Mbps |
| directionFindingMode | BluetoothDtmDirectionFindingMode | Specifies the mode of direction finding. The default value is Disabled. |
| switchingPatternLength | int | Specifies the length of the antenna switching pattern. The default value is 0. |
| cteLength | double | Specifies the length of the constant tone extension field in the generated signal. This value is expressed in seconds. This parameter is applicable only when you set the Direction Finding Mode parameter to either AngleofArrival or AngleofDeparture. The default value is 160 microseconds. |
| cteSlotDuration | double | Specifies the length of the antenna switching and sampling slots in the constant tone extension field. This value is expressed in seconds. The default value is 1 us. |
| antennaID | int[] | Specifies the array of Antenna IDs in the antenna switching pattern. The length of Antenna IDs array must be equal to Length Of Switching Pattern. |
| status | out int | Returns the status of the transmitter test command. The DUT receives and executes the transmitter test command if the status parameter returns a 0x00 value. The transmitter test command fails if the status parameter returns a non-zero (0x01-0xFF) value. |
Returns
Returns the status code of this method. The status code either indicates success or describes a warning condition.