"""Qblox Cluster QCM-RF driver."""
import json
from qblox_instruments.native.generic_func import SequencerStates
from qblox_instruments.qcodes_drivers.cluster import Cluster
from qblox_instruments.qcodes_drivers.module import Module
from qibo.config import log
from qibolab.instruments.qblox.module import ClusterModule
from qibolab.instruments.qblox.q1asm import (
Block,
Register,
convert_phase,
loop_block,
wait_block,
)
from qibolab.instruments.qblox.sequencer import Sequencer, WaveformsBuffer
from qibolab.instruments.qblox.sweeper import QbloxSweeper, QbloxSweeperType
from qibolab.pulses import Pulse, PulseSequence, PulseType
from qibolab.sweeper import Parameter, Sweeper, SweeperType
[docs]class QcmRf(ClusterModule):
"""Qblox Cluster Qubit Control Module RF driver.
Qubit Control Module RF (QCM-RF) is an instrument that integrates an arbitratry
wave generator, with a local oscillator and a mixer. It has two output ports
Each port has a path0 and path1 for the i(in-phase) and q(quadrature) components
of the RF signal. The sampling rate of its ADC/DAC is 1 GSPS.
https://www.qblox.com/cluster
The class aims to simplify the configuration of the instrument, exposing only
those parameters most frequencly used and hiding other more complex components.
A reference to the underlying `qblox_instruments.qcodes_drivers.qcm_qrm.QRM_QCM`
object is provided via the attribute `device`, allowing the advanced user to gain
access to the features that are not exposed directly by the class.
In order to accelerate the execution, the instrument settings are cached, so that
the communication with the instrument only happens when the parameters change.
This caching is done with the method `_set_device_parameter(target, *parameters, value)`.
.. code-block:: text
ports:
o1: # output port settings
channel : L3-11
attenuation : 24 # (dB) 0 to 60, must be multiple of 2
lo_enabled : true
lo_frequency : 4_042_590_000 # (Hz) from 2e9 to 18e9
gain : 0.17 # for path0 and path1 -1.0<=v<=1.0
o2:
channel : L3-12
attenuation : 24 # (dB) 0 to 60, must be multiple of 2
lo_enabled : true
lo_frequency : 5_091_155_529 # (Hz) from 2e9 to 18e9
gain : 0.28 # for path0 and path1 -1.0<=v<=1.0
Attributes:
name (str): A unique name given to the instrument.
address (str): IP_address:module_number (the IP address of the cluster and
the module number)
device (QcmQrm): A reference to the underlying
`qblox_instruments.qcodes_drivers.qcm_qrm.QcmQrm` object. It can be used to access other
features not directly exposed by this wrapper.
https://qblox-qblox-instruments.readthedocs-hosted.com/en/master/api_reference/qcm_qrm.html
ports = A dictionary giving access to the output ports objects.
- ports['o1']
- ports['o2']
- ports['o1'].channel (int | str): the id of the refrigerator channel the port is connected to.
- ports['o1'].attenuation (int): (mapped to qrm.out0_att) Controls the attenuation applied to
the output port. Must be a multiple of 2
- ports['o1'].lo_enabled (bool): (mapped to qrm.out0_in0_lo_en) Enables or disables the
local oscillator.
- ports['o1'].lo_frequency (int): (mapped to qrm.out0_in0_lo_freq) Sets the frequency of the
local oscillator.
- ports['o1'].gain (float): (mapped to qrm.sequencers[0].gain_awg_path0 and qrm.sequencers[0].gain_awg_path1)
Sets the gain on both paths of the output port.
- ports['o1'].hardware_mod_en (bool): (mapped to qrm.sequencers[0].mod_en_awg) Enables pulse
modulation in hardware. When set to False, pulse modulation is done at the host computer
and a modulated pulse waveform should be uploaded to the instrument. When set to True,
the envelope of the pulse should be uploaded to the instrument and it modulates it in
real time by its FPGA using the sequencer nco (numerically controlled oscillator).
- ports['o1'].nco_freq (int): (mapped to qrm.sequencers[0].nco_freq) # TODO mapped, but not configurable from the runcard
- ports['o1'].nco_phase_offs = (mapped to qrm.sequencers[0].nco_phase_offs) # TODO mapped, but not configurable from the runcard
- ports['o2'].channel (int | str): the id of the refrigerator channel the port is connected to.
- ports['o2'].attenuation (int): (mapped to qrm.out1_att) Controls the attenuation applied to
the output port. Must be a multiple of 2
- ports['o2'].lo_enabled (bool): (mapped to qrm.out1_lo_en) Enables or disables the
local oscillator.
- ports['o2'].lo_frequency (int): (mapped to qrm.out1_lo_freq) Sets the frequency of the
local oscillator.
- ports['o2'].gain (float): (mapped to qrm.sequencers[1].gain_awg_path0 and qrm.sequencers[0].gain_awg_path1)
Sets the gain on both paths of the output port.
- ports['o2'].hardware_mod_en (bool): (mapped to qrm.sequencers[1].mod_en_awg) Enables pulse
modulation in hardware. When set to False, pulse modulation is done at the host computer
and a modulated pulse waveform should be uploaded to the instrument. When set to True,
the envelope of the pulse should be uploaded to the instrument and it modulates it in
real time by its FPGA using the sequencer nco (numerically controlled oscillator).
- ports['o2'].nco_freq (int): (mapped to qrm.sequencers[1].nco_freq) # TODO mapped, but not configurable from the runcard
- ports['o2'].nco_phase_offs = (mapped to qrm.sequencers[1].nco_phase_offs) # TODO mapped, but not configurable from the runcard
- Sequencer 0 is always the first sequencer used to synthesise pulses on port o1.
- Sequencer 1 is always the first sequencer used to synthesise pulses on port o2.
- Sequencer 2 to 6 are used as needed to sinthesise simultaneous pulses on the same channel
or when the memory of the default sequencers rans out.
channels (list): A list of the channels to which the instrument is connected.
"""
DEFAULT_SEQUENCERS = {"o1": 0, "o2": 1}
FREQUENCY_LIMIT = 500e6
def __init__(self, name: str, address: str):
"""Initialize a Qblox QCM-RF module.
Parameters:
- name: An arbitrary name to identify the module.
- address: The network address of the instrument, specified as "cluster_IP:module_slot_idx".
- cluster: The Cluster object to which the QCM-RF module is connected.
Example:
To create a QcmRf instance named 'qcm_rf' connected to slot 2 of a Cluster at address '192.168.0.100':
>>> cluster_instance = Cluster("cluster","192.168.1.100", settings)
>>> qcm_module = QcmRf(name="qcm_rf", address="192.168.1.100:2", cluster=cluster_instance)
"""
super().__init__(name, address)
self.device: Module = None
self.settings = {}
self._debug_folder: str = ""
self._sequencers: dict[Sequencer] = {}
self.channel_map: dict = {}
self._device_num_output_ports = 2
self._device_num_sequencers: int
self._free_sequencers_numbers: list[int] = []
self._used_sequencers_numbers: list[int] = []
self._unused_sequencers_numbers: list[int] = []
def _set_default_values(self):
# disable all sequencer connections
self.device.disconnect_outputs()
# set I (path0) and Q (path1) offset to zero on output port 0 and 1. Default values after reboot = 7.625
for i in range(2):
[self.device.set(f"out{i}_offset_path{j}", 0) for j in range(2)]
# initialise the parameters of the default sequencers to the default values,
# the rest of the sequencers are disconnected but will be configured
# with the same parameters as the default in process_pulse_sequence()
default_sequencers = [
self.device.sequencers[i] for i in self.DEFAULT_SEQUENCERS.values()
]
for target in default_sequencers:
for name, value in self.DEFAULT_SEQUENCERS_VALUES.items():
target.set(name, value)
# connect the default sequencers to the out port
self.device.sequencers[self.DEFAULT_SEQUENCERS["o1"]].set("connect_out0", "IQ")
self.device.sequencers[self.DEFAULT_SEQUENCERS["o1"]].set("connect_out1", "off")
self.device.sequencers[self.DEFAULT_SEQUENCERS["o2"]].set("connect_out1", "IQ")
self.device.sequencers[self.DEFAULT_SEQUENCERS["o2"]].set("connect_out0", "off")
[docs] def connect(self, cluster: Cluster = None):
"""Connects to the instrument using the instrument settings in the
runcard.
Once connected, it creates port classes with properties mapped
to various instrument parameters, and initialises the the
underlying device parameters. It uploads to the module the port
settings loaded from the runcard.
"""
if self.is_connected:
return
elif cluster is not None:
self.device = cluster.modules[int(self.address.split(":")[1]) - 1]
# test connection with module
if not self.device.present():
raise ConnectionError(
f"Module {self.device.name} not connected to cluster {cluster.name}"
)
# once connected, initialise the parameters of the device to the default values
self._device_num_sequencers = len(self.device.sequencers)
self._set_default_values()
# then set the value loaded from the runcard
try:
for port in self.settings:
self._sequencers[port] = []
if self.settings[port]["lo_frequency"]:
self._ports[port].lo_enabled = True
self._ports[port].lo_frequency = self.settings[port][
"lo_frequency"
]
self._ports[port].attenuation = self.settings[port]["attenuation"]
self._ports[port].hardware_mod_en = True
self._ports[port].nco_freq = 0
self._ports[port].nco_phase_offs = 0
except Exception as error:
raise RuntimeError(
f"Unable to initialize port parameters on module {self.name}: {error}"
)
self.is_connected = True
[docs] def setup(self, **settings):
"""Cache the settings of the runcard and instantiate the ports of the
module.
Args:
**settings: dict = A dictionary of settings loaded from the runcard:
- settings['o1']['attenuation'] (int): [0 to 60 dBm, in multiples of 2] attenuation at the output.
- settings['o1']['lo_frequency'] (int): [2_000_000_000 to 18_000_000_000 Hz] local oscillator frequency.
- settings['o1']['hardware_mod_en'] (bool): enables Hardware Modulation. In this mode, pulses are modulated to the intermediate frequency
using the numerically controlled oscillator within the fpga. It only requires the upload of the pulse envelope waveform.
At the moment this param is not loaded but is always set to True.
- settings['o2']['attenuation'] (int): [0 to 60 dBm, in multiples of 2] attenuation at the output.
- settings['o2']['lo_frequency'] (int): [2_000_000_000 to 18_000_000_000 Hz] local oscillator frequency.
- settings['o2']['hardware_mod_en'] (bool): enables Hardware Modulation. In this mode, pulses are modulated to the intermediate frequency
using the numerically controlled oscillator within the fpga. It only requires the upload of the pulse envelope waveform.
At the moment this param is not loaded but is always set to True.
"""
self.settings = settings if settings else self.settings
def _get_next_sequencer(self, port, frequency, qubit: None):
"""Retrieves and configures the next avaliable sequencer.
The parameters of the new sequencer are copied from those of the default sequencer, except for the
intermediate frequency and classification parameters.
Args:
port (str):
frequency ():
qubit ():
Raises:
Exception = If attempting to set a parameter without a connection to the instrument.
"""
# select a new sequencer and configure it as required
next_sequencer_number = self._free_sequencers_numbers.pop(0)
if next_sequencer_number != self.DEFAULT_SEQUENCERS[port]:
for parameter in self.device.sequencers[
self.DEFAULT_SEQUENCERS[port]
].parameters:
# exclude read-only parameter `sequence`
if parameter not in ["sequence"]:
value = self.device.sequencers[self.DEFAULT_SEQUENCERS[port]].get(
param_name=parameter
)
if value:
target = self.device.sequencers[next_sequencer_number]
target.set(parameter, value)
# if hardware modulation is enabled configure nco_frequency
if self._ports[port].hardware_mod_en:
self.device.sequencers[next_sequencer_number].set("nco_freq", frequency)
# Assumes all pulses in non_overlapping_pulses set
# have the same frequency. Non-overlapping pulses of different frequencies on the same
# qubit channel with hardware_demod_en would lead to wrong results.
# TODO: Throw error in that event or implement for non_overlapping_same_frequency_pulses
# Even better, set the frequency before each pulse is played (would work with hardware modulation only)
# create sequencer wrapper
sequencer = Sequencer(next_sequencer_number)
sequencer.qubit = qubit
return sequencer
[docs] def get_if(self, pulse):
"""Returns the intermediate frequency needed to synthesise a pulse
based on the port lo frequency."""
_rf = pulse.frequency
_lo = self.channel_map[pulse.channel].lo_frequency
_if = _rf - _lo
if abs(_if) > self.FREQUENCY_LIMIT:
raise Exception(
f"""
Pulse frequency {_rf:_} cannot be synthesised with current lo frequency {_lo:_}.
The intermediate frequency {_if:_} would exceed the maximum frequency of {self.FREQUENCY_LIMIT:_}
"""
)
return _if
[docs] def process_pulse_sequence(
self,
qubits: dict,
instrument_pulses: PulseSequence,
navgs: int,
nshots: int,
repetition_duration: int,
sweepers=None,
):
"""Processes a sequence of pulses and sweepers, generating the
waveforms and program required by the instrument to synthesise them.
The output of the process is a list of sequencers used for each port, configured with the information
required to play the sequence.
The following features are supported:
- overlapping pulses
- hardware modulation
- software modulation, with support for arbitrary pulses
- real-time sweepers of
- pulse frequency (requires hardware modulation)
- pulse relative phase (requires hardware modulation)
- pulse amplitude
- pulse start
- pulse duration
- port gain
- port offset
- sequencer memory optimisation (waveforms cache)
- extended waveform memory with the use of multiple sequencers
- pulses of up to 8192 pairs of i, q samples
- intrument parameters cache
Args:
instrument_pulses (PulseSequence): A collection of Pulse objects to be played by the instrument.
navgs (int): The number of times the sequence of pulses should be executed averaging the results.
nshots (int): The number of times the sequence of pulses should be executed without averaging.
repetition_duration (int): The total duration of the pulse sequence execution plus the reset/relaxation time.
sweepers (list(Sweeper)): A list of Sweeper objects to be implemented.
"""
if sweepers is None:
sweepers = []
sequencer: Sequencer
sweeper: Sweeper
self._free_sequencers_numbers = list(range(len(self._ports), 6))
# process the pulses for every port
for port in self._ports:
# split the collection of instruments pulses by ports
port_channel = [
chan.name
for chan in self.channel_map.values()
if chan.port.name == port
]
port_pulses: PulseSequence = instrument_pulses.get_channel_pulses(
*port_channel
)
# initialise the list of sequencers required by the port
self._sequencers[port] = []
if not port_pulses.is_empty:
# initialise the list of free sequencer numbers to include the default for each port {'o1': 0, 'o2': 1}
self._free_sequencers_numbers = [
self.DEFAULT_SEQUENCERS[port]
] + self._free_sequencers_numbers
# split the collection of port pulses in non overlapping pulses
non_overlapping_pulses: PulseSequence
for non_overlapping_pulses in port_pulses.separate_overlapping_pulses():
# each set of not overlapping pulses will be played by a separate sequencer
# check sequencer availability
if len(self._free_sequencers_numbers) == 0:
raise Exception(
f"The number of sequencers requried to play the sequence exceeds the number available {self._device_num_sequencers}."
)
# get next sequencer
sequencer = self._get_next_sequencer(
port=port,
frequency=self.get_if(non_overlapping_pulses[0]),
qubit=non_overlapping_pulses[0].qubit,
)
# add the sequencer to the list of sequencers required by the port
self._sequencers[port].append(sequencer)
# make a temporary copy of the pulses to be processed
pulses_to_be_processed = non_overlapping_pulses.shallow_copy()
while not pulses_to_be_processed.is_empty:
pulse: Pulse = pulses_to_be_processed[0]
# attempt to save the waveforms to the sequencer waveforms buffer
try:
sequencer.waveforms_buffer.add_waveforms(
pulse, self._ports[port].hardware_mod_en, sweepers
)
sequencer.pulses.add(pulse)
pulses_to_be_processed.remove(pulse)
# if there is not enough memory in the current sequencer, use another one
except WaveformsBuffer.NotEnoughMemory:
if (
len(pulse.waveform_i) + len(pulse.waveform_q)
> WaveformsBuffer.SIZE
):
raise NotImplementedError(
f"Pulses with waveforms longer than the memory of a sequencer ({WaveformsBuffer.SIZE // 2}) are not supported."
)
if len(self._free_sequencers_numbers) == 0:
raise Exception(
f"The number of sequencers requried to play the sequence exceeds the number available {self._device_num_sequencers}."
)
# get next sequencer
sequencer = self._get_next_sequencer(
port=port,
frequency=self.get_if(non_overlapping_pulses[0]),
qubit=non_overlapping_pulses[0].qubit,
)
# add the sequencer to the list of sequencers required by the port
self._sequencers[port].append(sequencer)
# update the lists of used and unused sequencers that will be needed later on
self._used_sequencers_numbers = []
for port in self._ports:
for sequencer in self._sequencers[port]:
self._used_sequencers_numbers.append(sequencer.number)
self._unused_sequencers_numbers = []
for n in range(self._device_num_sequencers):
if not n in self._used_sequencers_numbers:
self._unused_sequencers_numbers.append(n)
# generate and store the Waveforms dictionary, the Acquisitions dictionary, the Weights and the Program
for port in self._ports:
for sequencer in self._sequencers[port]:
pulses = sequencer.pulses
program = sequencer.program
## pre-process sweepers ##
# TODO: move qibolab sweepers preprocessing to qblox controller
# attach a sweeper attribute to the pulse so that it is easily accesible by the code that generates
# the pseudo-assembly program
pulse = None
for pulse in pulses:
pulse.sweeper = None
pulse_sweeper_parameters = [
Parameter.frequency,
Parameter.amplitude,
Parameter.duration,
Parameter.relative_phase,
Parameter.start,
]
for sweeper in sweepers:
if sweeper.parameter in pulse_sweeper_parameters:
# check if this sequencer takes an active role in the sweep
if sweeper.pulses and set(sequencer.pulses) & set(
sweeper.pulses
):
# plays an active role
reference_value = None
if (
sweeper.parameter == Parameter.frequency
and sequencer.pulses
):
reference_value = self.get_if(sequencer.pulses[0])
if sweeper.parameter == Parameter.amplitude:
for pulse in pulses:
if pulse in sweeper.pulses:
reference_value = (
pulse.amplitude
) # uses the amplitude of the first pulse
if (
sweeper.parameter == Parameter.duration
and pulse in sweeper.pulses
):
# for duration sweepers bake waveforms
sweeper.qs = QbloxSweeper(
program=program,
type=QbloxSweeperType.duration,
rel_values=pulse.idx_range,
)
else:
# create QbloxSweepers and attach them to qibolab sweeper
if (
sweeper.type == SweeperType.OFFSET
and reference_value
):
sweeper.qs = QbloxSweeper.from_sweeper(
program=program,
sweeper=sweeper,
add_to=reference_value,
)
elif (
sweeper.type == SweeperType.FACTOR
and reference_value
):
sweeper.qs = QbloxSweeper.from_sweeper(
program=program,
sweeper=sweeper,
multiply_to=reference_value,
)
else:
sweeper.qs = QbloxSweeper.from_sweeper(
program=program, sweeper=sweeper
)
# finally attach QbloxSweepers to the pulses being swept
sweeper.qs.update_parameters = True
pulse.sweeper = sweeper.qs
else:
# does not play an active role
sweeper.qs = QbloxSweeper(
program=program,
type=QbloxSweeperType.number,
rel_values=range(len(sweeper.values)),
name=sweeper.parameter.name,
)
else:
# does not play an active role
sweeper.qs = QbloxSweeper(
program=program,
type=QbloxSweeperType.number,
rel_values=range(len(sweeper.values)),
name=sweeper.parameter.name,
)
# # FIXME: for qubit sweepers (Parameter.bias, Parameter.attenuation, Parameter.gain), the qubit
# # information alone is not enough to determine what instrument parameter is to be swept.
# # For example port gain, both the drive and readout ports have gain parameters.
# # Until this is resolved, and since bias is only implemented with QCMs offset, this instrument will
# # never take an active role in those sweeps.
# Waveforms
for index, waveform in enumerate(
sequencer.waveforms_buffer.unique_waveforms
):
sequencer.waveforms[waveform.serial] = {
"data": waveform.data.tolist(),
"index": index,
}
# Program
minimum_delay_between_instructions = 4
sequence_total_duration = (
pulses.finish
) # the minimum delay between instructions is 4ns
time_between_repetitions = repetition_duration - sequence_total_duration
assert time_between_repetitions > minimum_delay_between_instructions
# TODO: currently relaxation_time needs to be greater than acquisition_hold_off
# so that the time_between_repetitions is equal to the sequence_total_duration + relaxation_time
# to be compatible with th erest of the platforms, change it so that time_between_repetitions
# is equal to pulsesequence duration + acquisition_hold_off if relaxation_time < acquisition_hold_off
# create registers for key variables
# nshots is used in the loop that iterates over the number of shots
nshots_register = Register(program, "nshots")
# navgs is used in the loop of hardware averages
navgs_register = Register(program, "navgs")
header_block = Block("setup")
body_block = Block()
body_block.append(f"wait_sync {minimum_delay_between_instructions}")
if self._ports[port].hardware_mod_en:
body_block.append("reset_ph")
body_block.append_spacer()
pulses_block = Block("play")
# Add an initial wait instruction for the first pulse of the sequence
initial_wait_block = wait_block(
wait_time=pulses[0].start,
register=Register(program),
force_multiples_of_four=False,
)
pulses_block += initial_wait_block
for n in range(pulses.count):
if (
pulses[n].sweeper
and pulses[n].sweeper.type == QbloxSweeperType.start
):
pulses_block.append(f"wait {pulses[n].sweeper.register}")
if self._ports[port].hardware_mod_en:
# # Set frequency
# _if = self.get_if(pulses[n])
# pulses_block.append(f"set_freq {convert_frequency(_if)}", f"set intermediate frequency to {_if} Hz")
# Set phase
if (
pulses[n].sweeper
and pulses[n].sweeper.type
== QbloxSweeperType.relative_phase
):
pulses_block.append(f"set_ph {pulses[n].sweeper.register}")
else:
pulses_block.append(
f"set_ph {convert_phase(pulses[n].relative_phase)}",
comment=f"set relative phase {pulses[n].relative_phase} rads",
)
# Calculate the delay_after_play that is to be used as an argument to the play instruction
if len(pulses) > n + 1:
# If there are more pulses to be played, the delay is the time between the pulse end and the next pulse start
delay_after_play = pulses[n + 1].start - pulses[n].start
else:
delay_after_play = sequence_total_duration - pulses[n].start
if delay_after_play < minimum_delay_between_instructions:
raise Exception(
f"The minimum delay between the start of two pulses in the same channel is {minimum_delay_between_instructions}ns."
)
if (
pulses[n].sweeper
and pulses[n].sweeper.type == QbloxSweeperType.duration
):
RI = pulses[n].sweeper.register
if pulses[n].type == PulseType.FLUX:
RQ = pulses[n].sweeper.register
else:
RQ = pulses[n].sweeper.aux_register
pulses_block.append(
f"play {RI},{RQ},{delay_after_play}", # FIXME delay_after_play won't work as the duration increases
comment=f"play pulse {pulses[n]} sweeping its duration",
)
else:
# Prepare play instruction: play wave_i_index, wave_q_index, delay_next_instruction
pulses_block.append(
f"play {sequencer.waveforms_buffer.unique_waveforms.index(pulses[n].waveform_i)},{sequencer.waveforms_buffer.unique_waveforms.index(pulses[n].waveform_q)},{delay_after_play}",
comment=f"play waveforms {pulses[n]}",
)
body_block += pulses_block
body_block.append_spacer()
final_reset_block = wait_block(
wait_time=time_between_repetitions,
register=Register(program),
force_multiples_of_four=False,
)
body_block += final_reset_block
footer_block = Block("cleanup")
footer_block.append(f"stop")
# wrap pulses block in sweepers loop blocks
for sweeper in sweepers:
body_block = sweeper.qs.block(inner_block=body_block)
nshots_block: Block = loop_block(
start=0,
stop=nshots,
step=1,
register=nshots_register,
block=body_block,
)
navgs_block = loop_block(
start=0,
stop=navgs,
step=1,
register=navgs_register,
block=nshots_block,
)
program.add_blocks(header_block, navgs_block, footer_block)
sequencer.program = repr(program)
[docs] def upload(self):
"""Uploads waveforms and programs of all sequencers and arms them in
preparation for execution.
This method should be called after `process_pulse_sequence()`.
It configures certain parameters of the instrument based on the
needs of resources determined while processing the pulse
sequence.
"""
# Setup
for sequencer_number in self._used_sequencers_numbers:
target = self.device.sequencers[sequencer_number]
target.set("sync_en", True)
target.set("marker_ovr_en", True)
target.set("marker_ovr_value", 15) # Default after reboot = 0
for sequencer_number in self._unused_sequencers_numbers:
target = self.device.sequencers[sequencer_number]
target.set("marker_ovr_value", 0) # Default after reboot = 0
target.set("marker_ovr_en", True) # Default after reboot = False
target.set("sync_en", False)
if sequencer_number >= 2: # Never disconnect default sequencers
target.set("connect_out0", "off")
target.set("connect_out1", "off")
# Upload waveforms and program
qblox_dict = {}
sequencer: Sequencer
for port in self._ports:
for sequencer in self._sequencers[port]:
# Add sequence program and waveforms to single dictionary
qblox_dict[sequencer] = {
"waveforms": sequencer.waveforms,
"weights": sequencer.weights,
"acquisitions": sequencer.acquisitions,
"program": sequencer.program,
}
# Upload dictionary to the device sequencers
self.device.sequencers[sequencer.number].sequence(qblox_dict[sequencer])
# DEBUG: QCM RF Save sequence to file
if self._debug_folder != "":
filename = (
self._debug_folder
+ f"Z_{self.name}_sequencer{sequencer.number}_sequence.json"
)
with open(filename, "w", encoding="utf-8") as file:
json.dump(qblox_dict[sequencer], file, indent=4)
file.write(sequencer.program)
# Arm sequencers
for sequencer_number in self._used_sequencers_numbers:
self.device.arm_sequencer(sequencer_number)
# DEBUG: QCM RF Print Readable Snapshot
# print(self.name)
# self.device.print_readable_snapshot(update=True)
# DEBUG: QCM RF Save Readable Snapshot
from qibolab.instruments.qblox.debug import print_readable_snapshot
if self._debug_folder != "":
filename = self._debug_folder + f"Z_{self.name}_snapshot.json"
with open(filename, "w", encoding="utf-8") as file:
print_readable_snapshot(self.device, file, update=True)
[docs] def play_sequence(self):
"""Plays the sequence of pulses.
Starts the sequencers needed to play the sequence of pulses.
"""
for sequencer_number in self._used_sequencers_numbers:
# Start used sequencers
self.device.start_sequencer(sequencer_number)
[docs] def disconnect(self):
"""Stops all sequencers, disconnect all the outputs from the AWG paths
of the sequencers."""
if not self.is_connected:
return
for sequencer_number in self._used_sequencers_numbers:
status = self.device.get_sequencer_status(sequencer_number)
if status.state is not SequencerStates.STOPPED:
log.warning(
f"Device {self.device.sequencers[sequencer_number].name} did not stop normally\nstate: {status}"
)
self.device.stop_sequencer()
self.device.disconnect_outputs()
self.is_connected = False
self.device = None