Btooth

SCPI Commands :

[SOURce<HW>]:BB:BTOoth:BCRole
[SOURce<HW>]:BB:BTOoth:BCText
[SOURce<HW>]:BB:BTOoth:BMODe
[SOURce<HW>]:BB:BTOoth:CTYPe
[SOURce<HW>]:BB:BTOoth:DCYCle
[SOURce<HW>]:BB:BTOoth:DURation
[SOURce<HW>]:BB:BTOoth:HDRPphy
[SOURce<HW>]:BB:BTOoth:MFORmat
[SOURce<HW>]:BB:BTOoth:PFORmat
[SOURce<HW>]:BB:BTOoth:PRESet
[SOURce<HW>]:BB:BTOoth:PTYPe
[SOURce<HW>]:BB:BTOoth:SLENgth
[SOURce<HW>]:BB:BTOoth:STATe
[SOURce<HW>]:BB:BTOoth:STIMing
[SOURce<HW>]:BB:BTOoth:TMODe
[SOURce<HW>]:BB:BTOoth:UPTYpe
[SOURce<HW>]:BB:BTOoth:USLength
[SOURce<HW>]:BB:BTOoth:VERSion
class BtoothCls[source]

Btooth commands group definition. 382 total commands, 21 Subgroups, 18 group commands

get_bc_role() RsSmw.enums.BtoCtrlRol[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:BCRole
value: enums.BtoCtrlRol = driver.source.bb.btooth.get_bc_role()

Determines the controller role. Depending on the selected channel type different roles are assigned to the controller. For channel type ‘Data’, Central or Peripheral can be assigned. If channel type ‘Advertising’ is selected, the parameter is read only and displayed directly above the graph.

return

bc_role: CENTral| PERipheral| ADVertiser| SCANner| INITiator CENTral Selects Central as controller role. PERipheral Selects Peripheral as controller role. ADVertiser|SCANner|INITiator Assigned roles depending on the selected packet type of the respective channel type.

get_bc_text() str[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:BCText
value: str = driver.source.bb.btooth.get_bc_text()

Queries the state and controller role.

return

bc_text: string Connected (only data channel type) Advertiser (only advertising channel type) ADV_IND, ADV_DIRECT_IND, ADV_NONCONN_IND, ADV_SCAN_IND Within R&S SMW-K117 also ADV_EXT_IND, AUX_ADV_IND, AUX_SYNC_IND, AUX_CHAIN_IND Scanner (only advertising channel type) SCAN_REQ, SCAN_RSP Within R&S SMW-K117 also AUX_SCAN_REQ, AUX_SCAN_RSP Initiator (only advertising channel type) CONNECT_IND Within R&S SMW-K117 also AUX_CONNECT_REQ, AUX_CONNECT_RSP

get_bmode() RsSmw.enums.BtoMode[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:BMODe
value: enums.BtoMode = driver.source.bb.btooth.get_bmode()

Determines the Bluetooth mode.

return

bmode: BASic| BLENergy BASic Selects Bluetooth mode BR + EDR. BLENergy Selects Bluetooth LE.

get_ctype() RsSmw.enums.BtoChnnelType[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:CTYPe
value: enums.BtoChnnelType = driver.source.bb.btooth.get_ctype()

Determines the channel type. Advertising and data are available.

return

ctype: ADVertising| DATA ADVertising Selects channel type advertising. DATA Selects channel type data. Devices in a connected state transmit data channel packets in connection events with a start point and an interval.

get_dcycle() RsSmw.enums.LowHigh[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:DCYCle
value: enums.LowHigh = driver.source.bb.btooth.get_dcycle()

Specifies duty cycle for directed advertising (packet type ADV_DIRECT_IND) .

return

dcycle: LOW| HIGH

get_duration() float[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:DURation
value: float = driver.source.bb.btooth.get_duration()

Specifies the transmission duration of CONTINUOUS payload transmission. Command sets the values in ms. Query returns values in s.

return

duration: float Range: depending on modulation format, symbols per a bit and payload type , Unit: ms

get_hdrp_phy() RsSmw.enums.BtoHdrpPhy[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:HDRPphy
value: enums.BtoHdrpPhy = driver.source.bb.btooth.get_hdrp_phy()

No command help available

return

hdrp_phy: No help available

get_mformat() RsSmw.enums.PackFormat[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:MFORmat
value: enums.PackFormat = driver.source.bb.btooth.get_mformat()

Specifies the physical layer used for CONTINUOUS payload transmission.

return

mod_fmt: L1M| L2M| LCOD L1M: LE 1M L2M: LE 2M LCOD: LE coded

get_pformat() RsSmw.enums.BtoPackFormat[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:PFORmat
value: enums.BtoPackFormat = driver.source.bb.btooth.get_pformat()

Specifies the physical layer of LE signal.

return

pformat: L1M| L2M| LCOD L1M LE 1M L2M LE 2M LCOD LE coded

get_ptype() RsSmw.enums.BtoPckType[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:PTYPe
value: enums.BtoPckType = driver.source.bb.btooth.get_ptype()

The available packets depend on the selected transport mode. All packet types as defined in the Bluetooth specifications are supported.

return

ptype: ID| NULL| POLL| FHS| DM1| DH1| DM3| DH3| DM5| DH5| AUX1| ADH1| ADH3| ADH5| AEDH1| AEDH3| AEDH5| HV1| HV2| HV3| DV| EV3| EV4| EV5| EEV3| EEV5| EEEV3| EEEV5

get_slength() int[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:SLENgth
value: int = driver.source.bb.btooth.get_slength()

Sets the sequence length of the Bluetooth signal in number of frames. This signal is calculated in advance and output in the arbitrary waveform generator.

return

slength: integer Range: depends on the number of states in dirty transmitter test to dynamic

get_state() bool[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:STATe
value: bool = driver.source.bb.btooth.get_state()

Activates the standard and deactivates all the other digital standards and digital modulation modes in the same path.

return

state: 1| ON| 0| OFF

get_stiming() RsSmw.enums.BtoSlotTiming[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:STIMing
value: enums.BtoSlotTiming = driver.source.bb.btooth.get_stiming()

Selects the Rx slot timing mode.

return

slot_timing: TX| LOOPback

get_tmode() RsSmw.enums.BtoTranMode[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:TMODe
value: enums.BtoTranMode = driver.source.bb.btooth.get_tmode()

Selects the transport mode.

return

tmode: ACL| SCO| ESCO ACL Asynchronous connection-less mode used for a point-to-point multipoint link between a Central and all Peripherals. SCO Synchronous connection-oriented mode used for a point-to-point link between a Central and a specific Peripheral. ESCO Enhanced synchronous connection-oriented mode used for a symmetric or asymmetric point-to point link between a Central and a specific Peripheral.

get_up_type() RsSmw.enums.BtoUlpPckType[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:UPTYpe
value: enums.BtoUlpPckType = driver.source.bb.btooth.get_up_type()

Selects the packet type. The available packets depend on the selected channel type and installed options. The tables below provide an overview. For more information, see data sheet. R&S SMW-K60 packet/PDU types

Table Header: <UpType> / Packet/PDU type

  • AIND ADINd ANINd SREQ SRSP CREQ ADCind DATA CUReq CMReq TIND EREQ / ADV_IND ADV_DIRECT_IND ADV_NONCONN_IND SCAN_REQ SCAN_RSP CONNECT_IND ADV_SCAN_IND DATA LL_CONNECTION_UPDATE_IND LL_CHANNEL_MAP_IND LL_TERMINATE_IND LL_ENC_REQ

  • ERSP SEReq SERSp URSP FREQ FRSP TPACket PEReq PERSp VIND RIND / LL_ENC_RSP LL_START_ENC_REQ LL_START_ENC_RSP LL_UNKNONW_RSP LL_FEATURE_REQ LL_FEATURE_RSP TEST PACKET LL_PAUSE_ENC_REQ LL_PAUSE_ENC_RSP LL_VERSION_IND LL_REJECT_IND

R&S SMW-K117 packet/PDU types

Table Header: <UpType> / Packet/PDU type

  • PREQ PRSP PUIN LRSP SFR CPR CPRS REIN PIR PIRS AEINd AAINd ACINd / LL_PHY_REQ LL_PHY_RSP LL_PHY_UPDATE_IND LL_LENGTH_RSP LL_PERIPHERAL_FEATURE_REQ LL_CONNECTION_PARAM_REQ LL_CONNECTION_PARAM_RSP LL_REJECT_EXT_IND LL_PING_REQ LL_PING_RSP ADV_EXT_IND AUX_ADV_IND AUX_CHAIN_IND

  • ASINd ASReq ASPSp ACRSp ACReq MUCH CONT CTEQ CTEP PSIND CAReq CARSp / AUX_SYNC_IND AUX_SCAN_REQ AUX_SCAN_RSP AUX_CONNECT_RSP AUX_CONNECT_REQ LL_MIN_USED_CHANNELS_IND CONTINUOUS LL_CTE_REQ LL_CTE_RSP LL_PERIODIC_SYNC LL_CLOCK_ACCURACY_REQ LL_CLOCK_ACCURACY_RSP

return

up_type: AIND| ADINd| ANINd| SREQ| SRSP| CREQ| ADCind| DATA| CUReq| CMReq| TIND| EREQ| ERSP| SEReq| SERSp| URSP| FREQ| FRSP| TPACket| PEReq| PERSp| VIND| RIND| PREQ| PRSP| PUIN| LREQ| LRSP| SFR| CPR| CPRS| REIN| PIR| PIRS| AEINd| AAINd| ACINd| ASINd| ASReq| ASPSp| ACRSp| ACReq| MUCH| CONT| CTEQ| CTEP| PSINd| CAReq| CARSp

get_us_length() int[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:USLength
value: int = driver.source.bb.btooth.get_us_length()

Selects the number of frames or events depending on the packet type. The signal repeats after the specified number of frames/events. For SCAN_REQ and CONNECT_IND packet, the sequence length is expressed in ‘Frames’. For AUX_SCAN_REQ and AUX_CONNECT_REQ packet, the sequence length is expressed in ‘Frames’. For LL_TERMINATE_IND packets, a default value according to the specification is given: Central: PeripheralLatency + 6 Peripheral: 6 For all other packet types the sequence length is expressed in ‘Events’.

return

us_length: integer Range: depends on the number of states in dirty transmitter test to dynamic

get_version() str[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:VERSion
value: str = driver.source.bb.btooth.get_version()

Queries the version of the specification for Bluetooth wireless technology underlying the definitions.

return

version: string

preset() None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:PRESet
driver.source.bb.btooth.preset()

Sets the parameters of the digital standard to their default values (*RST values specified for the commands) . Not affected is the state set with the command SOURce<hw>:BB:BTOoth:STATe.

preset_with_opc(opc_timeout_ms: int = - 1) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:PRESet
driver.source.bb.btooth.preset_with_opc()

Sets the parameters of the digital standard to their default values (*RST values specified for the commands) . Not affected is the state set with the command SOURce<hw>:BB:BTOoth:STATe.

Same as preset, but waits for the operation to complete before continuing further. Use the RsSmw.utilities.opc_timeout_set() to set the timeout value.

param opc_timeout_ms

Maximum time to wait in milliseconds, valid only for this call.

set_bc_role(bc_role: RsSmw.enums.BtoCtrlRol) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:BCRole
driver.source.bb.btooth.set_bc_role(bc_role = enums.BtoCtrlRol.ADVertiser)

Determines the controller role. Depending on the selected channel type different roles are assigned to the controller. For channel type ‘Data’, Central or Peripheral can be assigned. If channel type ‘Advertising’ is selected, the parameter is read only and displayed directly above the graph.

param bc_role

CENTral| PERipheral| ADVertiser| SCANner| INITiator CENTral Selects Central as controller role. PERipheral Selects Peripheral as controller role. ADVertiser|SCANner|INITiator Assigned roles depending on the selected packet type of the respective channel type.

set_bmode(bmode: RsSmw.enums.BtoMode) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:BMODe
driver.source.bb.btooth.set_bmode(bmode = enums.BtoMode.BASic)

Determines the Bluetooth mode.

param bmode

BASic| BLENergy BASic Selects Bluetooth mode BR + EDR. BLENergy Selects Bluetooth LE.

set_ctype(ctype: RsSmw.enums.BtoChnnelType) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:CTYPe
driver.source.bb.btooth.set_ctype(ctype = enums.BtoChnnelType.ADVertising)

Determines the channel type. Advertising and data are available.

param ctype

ADVertising| DATA ADVertising Selects channel type advertising. DATA Selects channel type data. Devices in a connected state transmit data channel packets in connection events with a start point and an interval.

set_dcycle(dcycle: RsSmw.enums.LowHigh) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:DCYCle
driver.source.bb.btooth.set_dcycle(dcycle = enums.LowHigh.HIGH)

Specifies duty cycle for directed advertising (packet type ADV_DIRECT_IND) .

param dcycle

LOW| HIGH

set_duration(duration: float) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:DURation
driver.source.bb.btooth.set_duration(duration = 1.0)

Specifies the transmission duration of CONTINUOUS payload transmission. Command sets the values in ms. Query returns values in s.

param duration

float Range: depending on modulation format, symbols per a bit and payload type , Unit: ms

set_hdrp_phy(hdrp_phy: RsSmw.enums.BtoHdrpPhy) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:HDRPphy
driver.source.bb.btooth.set_hdrp_phy(hdrp_phy = enums.BtoHdrpPhy.HDRP4)

No command help available

param hdrp_phy

No help available

set_mformat(mod_fmt: RsSmw.enums.PackFormat) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:MFORmat
driver.source.bb.btooth.set_mformat(mod_fmt = enums.PackFormat.L1M)

Specifies the physical layer used for CONTINUOUS payload transmission.

param mod_fmt

L1M| L2M| LCOD L1M: LE 1M L2M: LE 2M LCOD: LE coded

set_pformat(pformat: RsSmw.enums.BtoPackFormat) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:PFORmat
driver.source.bb.btooth.set_pformat(pformat = enums.BtoPackFormat.BLE4M)

Specifies the physical layer of LE signal.

param pformat

L1M| L2M| LCOD L1M LE 1M L2M LE 2M LCOD LE coded

set_ptype(ptype: RsSmw.enums.BtoPckType) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:PTYPe
driver.source.bb.btooth.set_ptype(ptype = enums.BtoPckType.ADH1)

The available packets depend on the selected transport mode. All packet types as defined in the Bluetooth specifications are supported.

param ptype

ID| NULL| POLL| FHS| DM1| DH1| DM3| DH3| DM5| DH5| AUX1| ADH1| ADH3| ADH5| AEDH1| AEDH3| AEDH5| HV1| HV2| HV3| DV| EV3| EV4| EV5| EEV3| EEV5| EEEV3| EEEV5

set_slength(slength: int) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:SLENgth
driver.source.bb.btooth.set_slength(slength = 1)

Sets the sequence length of the Bluetooth signal in number of frames. This signal is calculated in advance and output in the arbitrary waveform generator.

param slength

integer Range: depends on the number of states in dirty transmitter test to dynamic

set_state(state: bool) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:STATe
driver.source.bb.btooth.set_state(state = False)

Activates the standard and deactivates all the other digital standards and digital modulation modes in the same path.

param state

1| ON| 0| OFF

set_stiming(slot_timing: RsSmw.enums.BtoSlotTiming) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:STIMing
driver.source.bb.btooth.set_stiming(slot_timing = enums.BtoSlotTiming.LOOPback)

Selects the Rx slot timing mode.

param slot_timing

TX| LOOPback

set_tmode(tmode: RsSmw.enums.BtoTranMode) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:TMODe
driver.source.bb.btooth.set_tmode(tmode = enums.BtoTranMode.ACL)

Selects the transport mode.

param tmode

ACL| SCO| ESCO ACL Asynchronous connection-less mode used for a point-to-point multipoint link between a Central and all Peripherals. SCO Synchronous connection-oriented mode used for a point-to-point link between a Central and a specific Peripheral. ESCO Enhanced synchronous connection-oriented mode used for a symmetric or asymmetric point-to point link between a Central and a specific Peripheral.

set_up_type(up_type: RsSmw.enums.BtoUlpPckType) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:UPTYpe
driver.source.bb.btooth.set_up_type(up_type = enums.BtoUlpPckType.AAINd)

Selects the packet type. The available packets depend on the selected channel type and installed options. The tables below provide an overview. For more information, see data sheet. R&S SMW-K60 packet/PDU types

Table Header: <UpType> / Packet/PDU type

  • AIND ADINd ANINd SREQ SRSP CREQ ADCind DATA CUReq CMReq TIND EREQ / ADV_IND ADV_DIRECT_IND ADV_NONCONN_IND SCAN_REQ SCAN_RSP CONNECT_IND ADV_SCAN_IND DATA LL_CONNECTION_UPDATE_IND LL_CHANNEL_MAP_IND LL_TERMINATE_IND LL_ENC_REQ

  • ERSP SEReq SERSp URSP FREQ FRSP TPACket PEReq PERSp VIND RIND / LL_ENC_RSP LL_START_ENC_REQ LL_START_ENC_RSP LL_UNKNONW_RSP LL_FEATURE_REQ LL_FEATURE_RSP TEST PACKET LL_PAUSE_ENC_REQ LL_PAUSE_ENC_RSP LL_VERSION_IND LL_REJECT_IND

R&S SMW-K117 packet/PDU types

Table Header: <UpType> / Packet/PDU type

  • PREQ PRSP PUIN LRSP SFR CPR CPRS REIN PIR PIRS AEINd AAINd ACINd / LL_PHY_REQ LL_PHY_RSP LL_PHY_UPDATE_IND LL_LENGTH_RSP LL_PERIPHERAL_FEATURE_REQ LL_CONNECTION_PARAM_REQ LL_CONNECTION_PARAM_RSP LL_REJECT_EXT_IND LL_PING_REQ LL_PING_RSP ADV_EXT_IND AUX_ADV_IND AUX_CHAIN_IND

  • ASINd ASReq ASPSp ACRSp ACReq MUCH CONT CTEQ CTEP PSIND CAReq CARSp / AUX_SYNC_IND AUX_SCAN_REQ AUX_SCAN_RSP AUX_CONNECT_RSP AUX_CONNECT_REQ LL_MIN_USED_CHANNELS_IND CONTINUOUS LL_CTE_REQ LL_CTE_RSP LL_PERIODIC_SYNC LL_CLOCK_ACCURACY_REQ LL_CLOCK_ACCURACY_RSP

param up_type

AIND| ADINd| ANINd| SREQ| SRSP| CREQ| ADCind| DATA| CUReq| CMReq| TIND| EREQ| ERSP| SEReq| SERSp| URSP| FREQ| FRSP| TPACket| PEReq| PERSp| VIND| RIND| PREQ| PRSP| PUIN| LREQ| LRSP| SFR| CPR| CPRS| REIN| PIR| PIRS| AEINd| AAINd| ACINd| ASINd| ASReq| ASPSp| ACRSp| ACReq| MUCH| CONT| CTEQ| CTEP| PSINd| CAReq| CARSp

set_us_length(us_length: int) None[source]
# SCPI: [SOURce<HW>]:BB:BTOoth:USLength
driver.source.bb.btooth.set_us_length(us_length = 1)

Selects the number of frames or events depending on the packet type. The signal repeats after the specified number of frames/events. For SCAN_REQ and CONNECT_IND packet, the sequence length is expressed in ‘Frames’. For AUX_SCAN_REQ and AUX_CONNECT_REQ packet, the sequence length is expressed in ‘Frames’. For LL_TERMINATE_IND packets, a default value according to the specification is given: Central: PeripheralLatency + 6 Peripheral: 6 For all other packet types the sequence length is expressed in ‘Events’.

param us_length

integer Range: depends on the number of states in dirty transmitter test to dynamic

Cloning the Group

# Create a clone of the original group, that exists independently
group2 = driver.source.bb.btooth.clone()

Subgroups