Attributes

attributes.py - Contains the ID of all attributes belongs to the module.

class nirfmxbluetoothgen.attributes.AttributeID(value)

Bases: Enum

This enum class contains the ID of all attributes belongs to the module.

ACTUAL_HEADROOM = 6

Returns the actual headroom used by the BT Generation. This value is expressed in dB. You can use this value to configure the peak power of the generation hardware.

ACTUAL_PAYLOAD_LENGTH = 44

Returns the actual payload length, in bytes, that is calculated by the BT Generation.

If you set the PAYLOAD_LENGTH_MODE attribute to NIBTSG_VAL_PAYLOAD_LENGTH_MODE_MAXIMUM_LENGTH, the BT Generation returns the maximum permissible payload data length as specified in the Bluetooth specifications. If you set the PAYLOAD_LENGTH_MODE attribute to NIBTSG_VAL_PAYLOAD_LENGTH_MODE_USER_DEFINED, the BT Generation returns the value that you specify in the PAYLOAD_LENGTH attribute. If the value that you specify in the PAYLOAD_LENGTH attribute exceeds the maximum permissible payload length for the packet, the BT Generation returns this maximum permissible payload length.

For LE-HDT Packets when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1 and FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE is set to NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_USER_DEFINED, the Actual Payload Length is computed as Payload length = (Nb * BLOCK_SIZE) + LAST_BLOCK_SIZE for each payload. Here Nb is number of transmitted blocks depends on the TXBLOCK_MAP attribute.

You must use “payload x” as the active channel string to configure this property for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1.

ALL_IQ_IMPAIRMENTS_ENABLED = 23

Specifies whether to enable I/Q impairments.

The default value is NIBTSG_VAL_TRUE.

AUTO_HEADROOM_ENABLED = 3

Specifies whether the BT Generation calculates the headroom or uses the value that you specify in the HEADROOM attribute.

The default value is NIBTSG_VAL_TRUE.

AWGN_ENABLED = 38

Specifies whether to add additive white Gaussian noise (AWGN) to the baseband waveform.

The default value is NIBTSG_VAL_FALSE.

BANDWIDTH_BIT_PERIOD_PRODUCT = 101

Specifies the bandwidth bit period product of GFSK modulation for LE-CS packet type.

The default value is 0.5. The valid values are 0.5 and 2.0 .

BD_ADDRESS_LAP = 8

Specifies the 24-bit lower address part (LAP) of the Bluetooth device address.

The default value is 0.

BD_ADDRESS_NAP = 10

Specifies the 16-bit nonsignificant address part (NAP) of the Bluetooth device address.

The default value is 0.

BD_ADDRESS_UAP = 9

Specifies the 8-bit upper address part (UAP) of the Bluetooth device address.

The default value is 0.

BLOCK_SIZE = 113

Specifies the block size of each block specified by NUMBER_OF_BLOCKS.This property is valid only for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1 and FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE is set to NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_USER_DEFINED.

You must use “payload x” as the active channel string to configure this property.

The valid values are 32 to 511. The default value is 511.

BURST_START_LOCATIONS = 90

Returns an array of sample positions for the start of all bursts, within the waveform.

BURST_STOP_LOCATIONS = 91

Returns an array of sample positions for the end of all bursts, within the waveform.

CARRIER_FREQUENCY = 64

Specifies the carrier frequency. This value is expressed in Hz.

If you set the WHITENING_ENABLED attribute to NIBTSG_VAL_TRUE and the PACKET_TYPE attribute to any LE packets, you should set a value for the CARRIER_FREQUENCY attribute.

CARRIER_FREQUENCY_OFFSET = 37

Specifies the carrier frequency offset from the value that you specify as the center frequency of the RF signal generator. This value is expressed in Hz.

The default value is 0.

CARRIER_MODE = 1

Specifies whether the carrier is continuous or includes bursts.

If you set this attribute to NIBTSG_VAL_CARRIER_MODE_BURST, the BT Generation generates the burst signal by adding zeros at the end of the packet to create one or more complete slots, depending on the packet type. In this mode, the BT Generation also shapes the generated waveform to meet the burst ramp characteristics specified in the Bluetooth Test Purposes (TP) specification 1.2/2.0+EDR/2.1/2.1+EDR/3.0/3.0+HS. If you set this attribute to NIBTSG_VAL_CARRIER_MODE_CONTINUOUS, the BT Generation generates a phase continuous Bluetooth signal, which is used as an interference signal. This mode is useful to generate an interference signal with pseudorandom bits and continuous phase. In this mode, the NUMBER_OF_IDLE_SLOTS attribute is not used, and the number of idle slots is assumed be zero. In this mode, NI recommends you to leave the NUMBER_OF_UNIQUE_PACKETS, PAYLOAD_DATA_TYPE, and DIRTY_TX_ENABLED attributes at their default values. Refer to the Carrier Mode topic for more information about the CARRIER_MODE attribute.

The default value is NIBTSG_VAL_CARRIER_MODE_BURST.

CARRIER_TO_NOISE_RATIO = 39

Specifies the carrier-to-noise ratio (CNR)of the waveform generated. This value is expressed in dB. Noise bandwidth is equal to half the value of the IQ_RATE attribute. Configure the CARRIER_TO_NOISE_RATIO attribute only if you set the AWGN_ENABLED attribute to NIBTSG_VAL_TRUE.

The default value is 50.

CS_PACKET_FORMAT = 92

Specifies the channel sounding (CS) packet format. This property is applicable only when you set the packet type to either LE-CS-1M or LE-CS-2M. The default value is NIBTSG_VAL_PACKET_FORMAT_SYNC.

CS_PHASE_MEASUREMENT_PERIOD = 94

Specifies the phase measurement period in the generated CS packet. This property is applicable for all CS packet formats except NIBTSG_VAL_PACKET_FORMAT_SYNC. The default value is 10us. Valid values are 10 us, 20us and 40 us.

CS_SYNC_SEQUENCE = 93

Specifies whether the sounding sequence field is present in SYNC packet. This property is applicable for all CS Packet formats except CS Tone. The default value is NIBTSG_VAL_SYNC_SEQUENCE_SOUNDING_SEQUENCE.

CS_TONE_EXTENSION_SLOT_ENABLED = 98

Specifies whether CS tone extension slot is present in generated LE CS packets. This property is applicable for all CS packet formats except NIBTSG_VAL_PACKET_FORMAT_SYNC. The default value is NIBTSG_VAL_FALSE.

DATA_RATE = 102

Specifies the Higher Data Throughput (HDT) Bit Rate. This property is applicable only when you set the packet type to LE-HDT. The default value is 2000000. Valid values are 2000000, 3000000, 4000000, 6000000, 7500000.

DIRECTION_FINDING_ANTENNA_SWITCHING_DURATION = 87

Specifies the duration for which the transitions of phase and amplitude take place in the switching slots of the constant tone extension (CTE) portion of the low energy (LE) packet. This attribute is applicable only when the DIRECTION_FINDING_ANTENNA_SWITCHING_ENABLED attribute to NIBTSG_VAL_TRUE.

The default value is 500n.

DIRECTION_FINDING_ANTENNA_SWITCHING_DURATION_USED = 88

Returns the actual duration used to make the transitions of phase and amplitude in the switching slots of the constant tone extension (CTE) portion of low energy (LE) packet. This attribute is applicable only when you set the DIRECTION_FINDING_ANTENNA_SWITCHING_ENABLED attribute to NIBTSG_VAL_TRUE.

DIRECTION_FINDING_ANTENNA_SWITCHING_ENABLED = 86

Specifies whether antenna switching is enabled for the generated low energy (LE) packets. This attribute is valid only when you set the DIRECTION_FINDING_MODE attribute to NIBTSG_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_ARRIVAL or NIBTSG_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE.

The default value is NIBTSG_VAL_FALSE.

DIRECTION_FINDING_ANTENNA_SWITCHING_PATTERN = 85

Specifies the pattern in which the antennas switch in constant tone extension (CTE) portion of the low energy (LE) packet. The current definition always treats A0 as the reference antenna. A1, A2, A3…Am are all non-reference antennas. This attribute is applicable only when you set the DIRECTION_FINDING_ANTENNA_SWITCHING_ENABLED to NIBTSG_VAL_TRUE.

DIRECTION_FINDING_CONSTANT_TONE_EXTENSION_LENGTH = 77

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 attribute to either NIBTSG_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_ARRIVAL or NIBTSG_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE.

The default value is 0.00016.

DIRECTION_FINDING_CONSTANT_TONE_EXTENSION_SLOT_DURATION = 78

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. Valid values are 1 us and 2 us.

DIRECTION_FINDING_MODE = 75

Specifies the mode for direction finding. The attribute is valid only for LE-TP, LE-TP EXT, LE-Enhanced and LE-HDT packet type.

The default value is NIBTSG_VAL_DIRECTION_FINDING_MODE_DISABLE.

DIRECTION_FINDING_NUMBER_OF_ANTENNAS = 82

Specifies the number of antennas used to transmit or receive the constant tone extension (CTE) portion of low energy (LE) packet. This attribute is applicable only when you set the DIRECTION_FINDING_ANTENNA_SWITCHING_ENABLED to NIBTSG_VAL_TRUE.

DIRTY_TX_CARRIER_FREQUENCY_OFFSET_SET = 57

Specifies the offset value of each of the impairment set that you enable in the DIRTY_TX_PARAMETERS_ENABLED_SET attribute. This attribute is applicable with you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_USER_DEFINED. The BT Generation ignores this attribute if you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_STANDARD.

DIRTY_TX_ENABLED = 30

Specifies whether to enable the dirty transmitter.

The default value is NIBTSG_VAL_FALSE.

DIRTY_TX_MODE = 55

Specifies whether to enable the dirty transmitter with the standard settings, the user-defined settings or the frequency drift.

The default value is NIBTSG_VAL_DIRTY_TX_MODE_STANDARD.

DIRTY_TX_MODULATION_INDEX_SET = 58

Specifies the modulation index value of each of the impairment set that you enable in the DIRTY_TX_PARAMETERS_ENABLED_SET attribute.

This attribute is applicable when you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_USER_DEFINED. The BT Generation ignores this attribute if you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_STANDARD.

Valid values are 0.28 to 0.4 for Basic Rate and EDR packets and 0.45 to 0.55 for LE packets, inclusive. The valid values are 0.495 to 0.505, inclusive, for LE packets when you set the DIRTY_TX_MODULATION_INDEX_TYPE attribute to NIBTSG_VAL_DIRTY_TX_MODULATION_INDEX_TYPE_STABLE.

DIRTY_TX_MODULATION_INDEX_TYPE = 67

Specifies whether the modulation index type is NIBTSG_DIRTY_TX_MODULATION_INDEX_TYPE_STANDARD or NIBTSG_VAL_DIRTY_TX_MODULATION_INDEX_TYPE_STABLE. This attribute is valid only for LE packets. This attribute is applicable only if DIRTY_TX_ENABLED attribute is set to NIBTSG_VAL_TRUE. The default value is NIBTSG_DIRTY_TX_MODULATION_INDEX_TYPE_STANDARD.

DIRTY_TX_PARAMETERS_ENABLED_SET = 56

Specifies the impairment sets that you must enable out of the ten sets in LE and BR or the three sets in EDR. This attribute is applicable if you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_USER_DEFINED. The BT Generation ignores this attribute when the DIRTY_TX_MODE attribute is set to NIBTSG_VAL_DIRTY_TX_MODE_STANDARD.

DIRTY_TX_RESIDUAL_FM_DEVIATION = 62

Specifies the frequency of the modulated signal to provide the additional frequency drift. This value is expressed in Hz.

This attribute is applicable when you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_USER_DEFINED. The BT Generation ignores this attribute if you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_STANDARD.

The default value is 0.

DIRTY_TX_RESIDUAL_FM_FREQUENCY = 63

Specifies the frequency deviation of the modulated signal to provide the additional frequency drift. This value is expressed in Hz.

This attribute is applicable when you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_USER_DEFINED. The BT Generation ignores this attribute if you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_STANDARD.

The default value is 0.

DIRTY_TX_SYMBOL_TIMING_ERROR_SET = 59

Specifies the symbol timing error value of each of the impairment set that you enable in the DIRTY_TX_PARAMETERS_ENABLED_SET attribute.

This attribute is applicable with you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_USER_DEFINED. The BT Generation ignores this attribute if you set the DIRTY_TX_MODE attribute to NIBTSG_VAL_DIRTY_TX_MODE_STANDARD.

DV_VOICE_PAYLOAD_DATA_TYPE = 49

Specifies the type of payload for the data voice (DV) packet.

The default value is NIBTSG_VAL_PAYLOAD_DATA_TYPE_PN_SEQUENCE.

DV_VOICE_PAYLOAD_PN_ORDER = 46

Specifies the order (length of memory) of the pseudorandom bit sequence (PRBS) generator. If you set the DV_VOICE_PAYLOAD_DATA_TYPE attribute to NIBTSG_VAL_PAYLOAD_DATA_TYPE_USER_DEFINED_BITS, the BT Generation ignores the DV_VOICE_PAYLOAD_PN_ORDER attribute.

The default value is 9. Valid values are 5 to 31, inclusive.

DV_VOICE_PAYLOAD_PN_SEED = 47

Specifies the initialization seed used for the pseudorandom bit sequence (PRBS) generator. If you set the DV_VOICE_PAYLOAD_DATA_TYPE attribute to NIBTSG_VAL_PAYLOAD_DATA_TYPE_USER_DEFINED_BITS, the BT Generation ignores the DV_VOICE_PAYLOAD_PN_SEED attribute.

The default value is 497.

DV_VOICE_PAYLOAD_USER_DEFINED_BITS = 48

Specifies a bit pattern as an array of zeros and ones.

If the array length is greater than the required payload length, the BT Generation uses a subset of the required length from the beginning of the array for waveform generation. If the array length is less than the required payload length, the BT Generation repeats the bit pattern until the required length is achieved. If you set the DV_VOICE_PAYLOAD_DATA_TYPE attribute to NIBTSG_VAL_PAYLOAD_DATA_TYPE_PN_SEQUENCE, the BT Generation ignores the DV_VOICE_PAYLOAD_USER_DEFINED_BITS attribute.

FHS_PAYLOAD_BD_ADDRESS_LAP = 27

Specifies the 24-bit field in the frequency hop synchronization (FHS) packet payload. This field contains the lower address part (LAP) of the device that sends the FHS packet.

The default value is 0.

FHS_PAYLOAD_BD_ADDRESS_NAP = 29

Specifies the 16-bit field in the frequency hop synchronization (FHS) packet payload. This field contains the non-significant address part (NAP) of the device that sends the FHS packet. Refer to Section 6.5.1.4, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the NAP field.

The default value is 0.

FHS_PAYLOAD_BD_ADDRESS_UAP = 28

Specifies the 8-bit field in the frequency hop synchronization (FHS) packet payload. This field contains the upper address part (UAP) of the device that sends the FHS packet.

The default value is 0.

FHS_PAYLOAD_DEVICE_CLASS = 22

Specifies the 24-bit field in the frequency hop synchronization (FHS) packet payload. This field indicates the class of device of the device that sends the FHS packet. Refer to Section 6.5.1.4, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the device class field in the FHS packet payload.

The default value is 0. Valid values are 0 to 0xFFFFFF, inclusive.

FHS_PAYLOAD_DEVICE_CLOCK = 26

Specifies the 26-bit field in the frequency hop synchronization (FHS) packet payload. This field contains the value of the native clock of the device that sends the FHS packet. Refer to Section 6.5.1.4, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the device clock field of the FHS packet payload.

The default value is 0.

FHS_PAYLOAD_LT_ADDRESS = 21

Specifies the 3-bit logical transport (LT) address of the frequency hop synchronization (FHS) packet. Refer to Section 6.5.1.4, Part B, Volume 2 of the Bluetooth specification v2.1+EDR for more information about the LT address of the FHS packet.

The default value is 0. Valid values are 0 to 7, inclusive.

FHS_PAYLOAD_PAGE_SCAN_MODE = 25

Specifies the 3-bit field in the frequency hop synchronization (FHS) packet payload. This field indicates the default scan mode used by the sender of the FHS packet. Refer to Section 6.5.1.4, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the page scan mode field of the FHS packet payload.

The default value is 0. Valid values are 0 to 7, inclusive.

FHS_PAYLOAD_SCAN_REPETITION = 24

Specifies the 2-bit field in the frequency hop synchronization (FHS) packet payload. This field indicates the interval between two consecutive page scan windows. Refer to Section 6.5.1.4, Part B, Volume 2 of the Bluetooth specification v2.1+EDR for more information about the payload scan repetition field of the FHS packet payload.

The default value is 0. Valid values are 0 to 3, inclusive.

FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE = 110

Specifies the payload zone configuration mode for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1 and FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE is set to NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_USER_DEFINED.

The default value is NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_AUTO.

HDT_PACKET_FORMAT = 103

Specifies the Higher Data Throughput (HDT) packet format. This property is applicable only for LE HDT packet type. The default value is NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT0.

HDT_PHY_INTERVAL = 104

Specifies the physical layer intervals. This property is only valid for Format1 packet format. This value is expressed in seconds. The default value is 64us. Valid values are 64us, 128us, 192us and 256us.

HEADROOM = 4

Specifies the value for the headroom. This value is expressed in dB. The BT Generation uses this attribute for scaling the waveform when you set the AUTO_HEADROOM_ENABLED attribute to NIBTSG_VAL_FALSE.

The default value is 0.

IQ_GAIN_IMBALANCE = 33

Specifies the ratio of the mean amplitude of the in-phase (I) signal to the mean amplitude of the quadrature-phase (Q) signal. This value is expressed in dB.

For more information on IQ gain imbalance equations, refer to the IQ Gain Imbalance topic in RFmx BT Generation Help.

The default value is 0. Valid values are -6 to 6, inclusive.

IQ_RATE = 5

Returns the sample rate for generation. This value is expressed in samples per second (S/s). The symbol rate of the Bluetooth signal is 1 megasymbol per second. The sample rate of the generated signal is the product of the symbol rate and the oversampling factor. The BT Generation uses an oversampling factor of 8.

IQ_WAVEFORM_SIZE = 45

Returns the size, in complex samples, for a packet as specified by the PACKET_TYPE attribute and the number of idle slots specified by the NUMBER_OF_IDLE_SLOTS attribute.

I_DC_OFFSET = 35

Specifies the value of the DC offset in the in-phase (I) signal as a percentage of the peak magnitude of the complex I/Q signal.

The default value is 0. Valid values are -100 to 100, inclusive.

LAST_BLOCK_SIZE = 114

Specifies the block size of the last block. This property is valid only for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1 and FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE is set to NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_USER_DEFINED.

You must use “payload x” as the active channel string to configure this property.

The valid values are 1 to 8191. The default value is 526.

LE_ACCESS_ADDRESS = 61

Specifies the 32-bit LE access address.

The Bluetooth core specification recommends to use 0x71764129 as the LE access address for all test packets. The preamble of LE-TP/LE-TP-EXT packets is either 01010101b or 10101010b, depending on the LSB of the LE access address. If the LSB of the LE access address is 1, the preamble shall be 01010101b, otherwise the preamble shall be 10101010b. This will be 0101010101010101b, 1010101010101010b respectively for LE-Enhanced packets.

The default value is 0x71764129.

Note: This attribute is applicable for LE packets.

LE_TP_CORRUPT_ALTERNATE_CRC = 54

Specifies whether the BT Generation intentionally corrupts the cyclic redundancy check (CRC) portion of every alternate packet generated. Refer to Section 6.3.7 of the Bluetooth Low Energy RF PHY Test Specification 4.0.0. CRC corruption is done by toggling the seed used for CRC computation.

The default value is NIBTSG_VAL_FALSE.

Note: This attribute is applicable for LE packets.

LE_TP_PAYLOAD_TYPE = 50

Specifies the type of payload for the LE and LE CS packets.

The default value is NIBTSG_VAL_LE_TP_PAYLOAD_TYPE_PRBS9.

Note: This attribute is applicable for LE and LE CS packets.

MAXIMUM_HARDWARE_IQ_RATE = 69

Specifies the maximum I/Q rate that the NI RF vector signal generator supports.

This property will be set according to the device model in the rfsg_create_and_download_waveform() function.

MODULATION_INDEX = 68

Specifies the modulation index value for the Gaussian frequency shift keying modulation in Bluetooth packets.

Valid values are 0 to 1, excluding 0. The default value is -1. NI recommends you to set the value of this attribute to 0.32 for BR and EDR packets and 0.5 for LE packets.

NUMBER_OF_BLOCKS = 112

Specifies the number of blocks minus one that the payload is split into.This property is valid only for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1 and FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE is set to NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_USER_DEFINED.

You must use “payload x” as the active channel string to configure this property.

The default value is 15.

NUMBER_OF_BLOCK_REPETITION_SEQUENCES = 108

NUMBER_OF_IDLE_SLOTS = 52

Specifies the number of idle slots that the BT Generation appends at the end of each valid packet.

The default value is 0.

NUMBER_OF_PAYLOADS = 109

Specifies the number of payloads for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1. The valid values are 1 to 4.

The default value is 1.

NUMBER_OF_UNIQUE_PACKETS = 51

Specifies the number of unique packets for which the pseudonoise (PN) generator must run continuously. The BT Generation resets the PN generator after it reaches the number of packets that you specify in this attribute. For example, if you set this attribute to 1, the same payload is used for each packet, and if you set this attribute to 2, the same payload is used after every 2 packets. Configure this attribute only if you set the PAYLOAD_DATA_TYPE attribute to NIBTSG_VAL_PAYLOAD_DATA_TYPE_PN_SEQUENCE.

The value of this attribute must be the same as the value of the NIBTSG_BER_NUMBER_OF_UNIQUE_PACKETS attribute. Refer to Dirty Transmitter topic for details of the restrictions on the value of the NUMBER_OF_UNIQUE_PACKETS attribute.

The default value is 1.

OVERSAMPLING_FACTOR = 70

Specifies the number of times the Nyquist sample rate is increased to obtain the final sample rate of a signal.

The default value is 8.

PACKET_BIT_SEQUENCE_TRACE_ENABLED = 73

Specifies whether to enable the packet bit sequence trace.

The default value is NIBTSG_VAL_FALSE.

PACKET_HEADER_ARQN = 13

Specifies the value for the automatic repeat request number (ARQN) field in the packet header. This attribute controls the value for the 1-bit acknowledgement indicator, which indicates whether the data packet transfer is successful. Refer to sections 6.4.4 and 7.6, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the ARQN field.

The default value is NIBTSG_VAL_PACKET_HEADER_ARQN_NAK.

PACKET_HEADER_FLOW = 12

Specifies the value for the flow control field in the packet header. This field controls the 1-bit flow control parameter in the packet. Refer to Section 6.4.3, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the flow control field.

The default value is 0. Valid values are 0, which indicates a Stop condition, and 1, which indicates a Go condition.

PACKET_HEADER_LT_ADDRESS = 11

Specifies the 3-bit logical transport (LT) address of the packet. The LT address field indicates the destination slave for a packet in a master-to-slave transmission slot and indicates the source slave for a slave-to-master transmission slot. Refer to sections 6.4.1 and 6.4.2, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the LT address of a packet.

The default value is 0. Valid values are 0 to 7, inclusive.

PACKET_HEADER_SEQN = 14

Specifies the value for the sequential numbering scheme (SEQN) field in the packet header. This attribute controls the value for the 1-bit sequence bit, which allows you to provide a sequential numbering scheme to order the data packet scheme. Refer to sections 6.4.5, 7.6.2, and 7.6.5, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the SEQN field.

The default value is 0. Valid values are 0 and 1.

PACKET_TYPE = 7

Specifies the Bluetooth packet type.

The default value is NIBTSG_VAL_PACKET_TYPE_DH1.

PAYLOAD_CRC_SEED = 118

Specifies the 32 bit CRC initialization seed value. This property is applicable only when user set the Packet Type to LE-HDT and HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT0 or NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1.

The default value is 0x00000000. The valid values are 0x00000000 to 0xFFFFFFFF.

PAYLOAD_DATA_TYPE = 18

Specifies the type of payload for the packet.

The default value is NIBTSG_VAL_PAYLOAD_DATA_TYPE_PN_SEQUENCE.

PAYLOAD_HEADER_ENABLED = 66

Specifies whether to enable payload header in the Bluetooth packet to be generated. This is applicable only for LE packets.

For generating custom Bluetooth packets, set the value of this property to NIBTSG_VAL_FALSE. In this case, the header bits can be given as input to the PAYLOAD_USER_DEFINED_BITS property along with the payload bits. The default value is NIBTSG_VAL_TRUE.

PAYLOAD_HEADER_FLOW = 16

Specifies the value for the flow control bit in the payload header. This field controls the 1-bit flow control parameter in the packet.

The default value is 0. Valid values are 0, which indicates a Stop condition, and 1, which indicates a Go condition.

PAYLOAD_HEADER_LLID = 15

Specifies whether the payload is the start or continuation fragment of a logical link control and adaptation protocol (L2CAP) or link management protocol (LMP) message.

You must use “payload x” as the active channel string to configure this property for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1 and FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE is set to NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_USER_DEFINED.

The default value is 0. Valid values are 0, 1, 2, and 3.

PAYLOAD_LENGTH = 17

Specifies the payload length, in bytes. If the length exceeds the maximum permissible length mentioned in the Bluetooth specification, the BT Generation uses this maximum permissible length as the payload length. For LE-TP-EXT and LE-Enhanced packet types, typical LE packet is generated length up to 255 bytes, and Hyper Length LE packet is generated for length from 256 bytes to 8191 bytes. For LE HDT packet, Format0 supports payload length up to 510 bytes, whereas Format1 supports up to 8191 bytes per payload. In the case of LE HDT Format1, when the Payload Zone Configuration Mode is set to Auto and the Payload Length Mode is set to User Defined, you must specify “payload x” as the active channel string to configure this property.

The default value is 0.

PAYLOAD_LENGTH_MODE = 43

Specifies whether the BT Generation automatically sets the value of the LENGTH field in the payload header to the maximum permissible length or whether it uses the value that you specify in the PAYLOAD_LENGTH attribute.

The default value is NIBTSG_VAL_PAYLOAD_LENGTH_MODE_MAXIMUM_LENGTH.

PAYLOAD_PN_ORDER = 41

Specifies the order (length of memory) of the pseudorandom bit sequence (PRBS) generator. If you set the PAYLOAD_DATA_TYPE attribute to NIBTSG_VAL_PAYLOAD_DATA_TYPE_USER_DEFINED_BITS, the BT Generation ignores the PAYLOAD_PN_ORDER attribute.

The default value is 9. Valid values are 5 to 31, inclusive.

PAYLOAD_PN_SEED = 42

Specifies the initialization seed used for the pseudorandom bit sequence (PRBS) generator. If you set the PAYLOAD_DATA_TYPE attribute to NIBTSG_VAL_PAYLOAD_DATA_TYPE_USER_DEFINED_BITS, the BT Generation ignores the PAYLOAD_PN_SEED attribute.

The default value is 497.

PAYLOAD_USER_DEFINED_BITS = 20

Specifies a bit pattern as an array of zeros and ones.

If the array length is greater than the required payload length, the BT Generation uses a subset of the required length from the beginning of the array for waveform generation. If the array length is less than the required payload length, the BT Generation repeats the bit pattern until the required length is achieved. If you set the PAYLOAD_DATA_TYPE attribute to NIBTSG_VAL_PAYLOAD_DATA_TYPE_PN_SEQUENCE, the BT Generation ignores the PAYLOAD_USER_DEFINED_BITS attribute.

PAYLOAD_ZONE_LENGTH = 117

Returns the payload zone length of LE-HDT packets. The payload zone length has all payloads and each payload contains blocks followed by CRCs.

This property is valid only for the LE-HDT packet.

PHYSICAL_CHANNEL_ADDRESS = 106

Specifies the 40-bit physical channel address of Higher Data Throughput (HDT) packet. The default value is 0x9F15555555.

POWER_RAMP_SETTLING_TIME = 71

Specifies the settling time of the burst. The settling time is the time interval from the time when output power is 40 dB less than the final output power to the time when the output power is ±1 dB of the final output power. This value is expressed in seconds.

The default value is 4 microseconds. Valid values are from 1 microseconds to 20 microseconds, inclusive.

POWER_RAMP_TIME = 72

Specifies the ramp time of the burst. The settling time is the time interval from the time when output power (X dBm) is 40 dB less than the final output power to the time when the output power is ±1 dB of the final output power. This value is expressed in seconds. The default value is 2 microseconds. Valid values are from 1 microseconds to 10 microseconds, inclusive.

Note: The value of ramp time should not exceed the value of settling time.

QUADRATURE_SKEW = 34

Specifies the deviation in angle from 90 degrees between the in-phase (I) and quadrature-phase (Q) signals.

For more information on quadrature skew equations, refer to the IQ Gain Imbalance topic RFmx BT Generation Help.

The default value is 0. Valid values are -30 to 30, inclusive.

Q_DC_OFFSET = 36

Specifies the value of the DC offset in the quadrature-phase (Q) signal as percentage of the peak magnitude of the complex I/Q signal.

The default value is 0. Valid values are -100 to 100, inclusive.

RUN_TIME_SCALING = 79

SAMPLE_CLOCK_OFFSET = 99

Specifies the offset in the Sample Clock frequency from the sample frequency for CS packets. This value is expressed in parts per million (ppm).

The default value is 0.

SOUNDING_SEQUENCE_LENGTH = 95

Specifies sounding sequence length, in bits. This property is applicable only when you set the CS SYNC Sequence to Sounding Sequence. The default value is 32. Valid values are 32 and 96.

SOUNDING_SEQUENCE_MARKER_POSITIONS = 97

Specifies an array of sounding sequence marker positions at which sounding sequence marker signals are inserted. This property is applicable only when you set the CS SYNC Sequence to Sounding Sequence. When sounding sequence length property is set to 32, only the first element from the sounding sequence marker positions array is considered, and remaining elements are discarded. Valid values are from 0 to 28. When sounding sequence length property is set to 96, up to the first two elements from sounding sequence marker positions array are considered and remaining elements are discarded. Valid values for array index 0 are from 0 to 63 and for array index 1 are from 67 to 92. The default value is 0.

SOUNDING_SEQUENCE_MARKER_SIGNALS = 96

Specifies an array of sounding sequence marker signals. This property is applicable only when you set the CS SYNC Sequence to Sounding Sequence. When sounding sequence length property is set to 32, only the first element shall be inserted in the sounding sequence, and remaining elements shall be discarded. When sounding sequence length property is set to 96, up to the first two elements shall be inserted in the sounding sequence, and remaining elements shall be discarded. The default value is NIBTSG_VAL_SOUNDING_SEQUENCE_MARKER_SIGNALS_1100.

TIME_DELAY = 100

Specifies the time delay for CS packets This value is expressed in seconds.

The default value is 0.

TOOLKIT_COMPATIBILITY_VERSION = 40

Indicates the version of the BT Generation to which the current version of the BT Generation is compatible.

TXBLOCK_MAP = 115

Specifies the TxBlockMap field of Tx Portion of PDU Header. The TxBlockMap field is 8 or 16 bits depending on the value of TXLEN_SEQUENCE_NUMBER. It indicates which blocks are actually being transmitted in the packet, with bit b set to 1 if block b (counting from 0) is included and 0 if it is not. At least one bit shall be set. This property is valid only for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1 and FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE is set to NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_USER_DEFINED.

You must use “payload x” as the active channel string to configure this property.

The valid values are 1 to 0xFFFF. The default value is 0xFFFF.

TXLEN_SEQUENCE_NUMBER = 111

Specifies the value of TxLen SN field of Tx Portion of PDU Header. This property is valid only for the LE-HDT packet when HDT_PACKET_FORMAT is set to NIBTSG_VAL_HDT_PACKET_FORMAT_FORMAT1 and FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE is set to NIBTSG_VAL_FORMAT1_PAYLOAD_ZONE_CONFIGURATION_MODE_USER_DEFINED.

You must use “payload x” as the active channel string to configure this property.

The default value is NIBTSG_VAL_TXLEN_SEQUENCE_NUMBER_11.

VHDT_MODE_ENABLED = 107

WAVEFORM_FILE_VERSION = 81

WHITENING_CLOCK = 32

Specifies the 28-bit master Bluetooth device clock. This attribute is applicable only to BR and EDR packets. The BT Generation uses this attribute to initialize the linear feedback shift register used for calculating the whitening word. The BT Generation uses bits 1 to 6 for this purpose. Refer to sections 1.1 and 7.2, Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for more information about the Bluetooth device clock.

The default value is 0.

WHITENING_ENABLED = 31

Specifies whether to enable the whitening settings.

The default value is NIBTSG_VAL_FALSE.

If you set this attribute to NIBTSG_VAL_TRUE and the PACKET_TYPE attribute to any LE packets, you should set a value for the CARRIER_FREQUENCY attribute.

ZADOFF_CHU_INDEX = 105

Specifies Zadoff-Chu Index for the Long Training Sequence in the preamble. The default value is 7. Valid values are in the range of [1 - 16].