Package: qblox-instruments
Welcome to Qblox InstrumentsThe Qblox instruments package contains everything to get started with Qblox instruments (i.e. Python drivers,documention and tutorials).This software is free to use under the conditions specified in thelicense.For more information, please contactsupport@qblox.com.CreditsDevelopersQblox:Jordy Gloudemans <jgloudemans@qblox.com>Maria Garcia <mgarcia@qblox.com>Damaz de Jong <ddejong@qblox.com>Daniel Weigand <dweigand@qblox.com>Adithyan Radhakrishnan <adithyan@qblox.com>Gábor Oszkár Dénes <gdenes@qblox.com>External:Pieter Eendebak <pieter.eendebak@tno.nl>ContributorsNone yet. Why not be the first?History0.11.2 (27-10-2023)Changelog:Added support for new cluster firmware release.API changes:Add a method to get the maximum allowed attenuation for that specific board, use it to populate the respective range of the QCoDeS parameter.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.11.1.Pulsar QRM: compatible with device firmwarev0.11.1.Cluster: compatible with device firmwarev0.6.2.Note:You can also find this release on Gitlabhere.0.11.1 (15-09-2023)Changelog:Fixed compatibility with Python 3.7Fixedqblox-pnpunder MacOSAdded support for new cluster firmware release.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.11.1.Pulsar QRM: compatible with device firmwarev0.11.1.Cluster: compatible with device firmwarev0.6.1.Note:You can also find this release on Gitlabhere.0.11.0 (27-07-2023)Changelog:Added marker inversion functionality, for changing marker default voltage level. Previously it defaulted to LOW but now
user can use the marker inv parameters to select default value of HIGH.Made all the SystemStatusFlags more concise.Added ability for ADC’s inputs to be offset.Changed channel map to support real-mode waveform playback and make the parameters usage more intuitive.Fixed missing set/get parameters on dummy instrument.Fixed global divide-by-zero settings in numpy, moving it for local scope when is potentially possible.API changes:SystemStatusFlags regrouped PLL flags {CARRIER_PLL_UNLOCKED, FPGA_PLL_UNLOCKED, LO_PLL_UNLOCKED} -> {PLL_UNLOCKED}SystemStatusFlags regrouped Temp flags {FPGA_TEMPERATURE_OUT_OF_RANGE, CARRIER_TEMPERATURE_OUT_OF_RANGE,
AFE_TEMPERATURE_OUT_OF_RANGE, LO_TEMPERATURE_OUT_OF_RANGE, BACKPLANE_TEMPERATURE_OUT_OF_RANGE} -> {TEMPERATURE_OUT_OF_RANGE}SystemStatusFlags added flag {HARDWARE_COMPONENT_FAILED}QCoDeS parameter added for input offset : {in0_offset_path0, in0_offset_path1, in0_offset, in1_offset}QCoDeS parameter added for marker inversion: {marker0_inv_en, marker1_inv_en, marker2_inv_en, marker3_inv_en}QCoDeS parameters changed for channel map: channel_map_pathX_outY_en -> connect_outXQCoDeS parameters added for real-mode acquisition: {connect_acq_I, connect_acq_Q}Added utility methods for configuring the channel map: {disconnect_outputs, disconnect_inputs, connect_sequencer}Addedqblox-cfg describe -j/–json`to more explicitly expose the functionality currently only shown when verbosity is increasedDriver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.11.0.Pulsar QRM: compatible with device firmwarev0.11.0.Cluster: compatible with device firmwarev0.6.0.Note:You can also find this release on Gitlabhere.0.10.1 (17-07-2023)Changelog:Added support for new cluster firmware release.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.10.0.Pulsar QRM: compatible with device firmwarev0.10.0.Cluster: compatible with device firmwarev0.5.1.Note:You can also find this release on Gitlabhere.0.10.0 (01-05-2023)Changelog:Changed resolution of the sequencer’s real-time timegrid from 4 ns to 1 ns for all real-time instructions, except
for the instructions that operate on the NCOs (e.g. set_freq, reset_ph, set_ph, set_ph_delta). For now, the NCO
instructions still operate on the 4 ns timegrid.Added the option to control the brightness of the front-panel LEDs. The brightness can be set to four settings:
high, medium, low, off.Added a sequencer flag to indicate that input was out-of-range during an acquisition’s integration window.
Previously, the input out-of-range could only be detected by scope acquisitions. Now all acquisitions are able to
detect this.Changed the format with which sequencer and scope configurations are communicated between the instrument and
driver to JSON objects as a first step towards improving driver backwards compatibility.Improved handling of acquisitions in the dummy drivers.Added more detail to the HISTORY file.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.10.0.Pulsar QRM: compatible with device firmwarev0.10.0.Cluster: compatible with device firmwarev0.5.0.Note:You can also find this release on Gitlabhere.0.9.0 (28-02-2023)Changelog:Added new feedback functionality to allow sequencer-to-sequencer, module-to-module and Cluster-to-Cluster feedback.
To support this, new Q1ASM instructions are added to the instruction set. The wait_trigger instruction is also
changed accordingly with a new address argument.The external trigger input is now also connected to the new trigger network for feedback purposes and must be mapped
to this network using the associated parameters.QCoDeS parameter name change: discretization_threshold_acq -> thresholded_acq_thresholdQCoDeS parameter name change: phase_rotation_acq -> thresholded_acq_rotationImproved performance of the get_acquisitions method.Fixed ability to exclude sequencer.sequence readout when creating a snapshot through QCoDeS.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.9.0.Pulsar QRM: compatible with device firmwarev0.9.0.Cluster: compatible with device firmwarev0.4.0.Note:You can also find this release on Gitlabhere.0.8.2 (27-01-2023)Changelog:Add compatibility for Cluster release v0.3.1Improved scope mode data handling.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.8.0.Pulsar QRM: compatible with device firmwarev0.8.0.Cluster: compatible with device firmwarev0.3.1.Note:You can also find this release on Gitlabhere.0.8.1 (19-12-2022)Changelog:Removed Read the Docs files from repository and moved it tohttps://gitlab.com/qblox/packages/software/qblox_instruments_docs.Improved performance of the get_acquisitions method.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.8.0.Pulsar QRM: compatible with device firmwarev0.8.0.Cluster: compatible with device firmwarev0.3.0.Note:You can also find this release on Gitlabhere.0.8.0 (09-12-2022)Changelog:Added support for the redesigned NCO.Added support for the NCO phase compensation for propagation delays from output to input path.Increased NCO range from +/-300 MHz to +/-500 MHz.Added support for TTL trigger acqusitions.Improved error handling for sequence retrieval.Added support for attenuation control to dummy modules.Added support to set acquisition data in dummy modules.Updated the assemblers used by the dummy modules.Added and updated test cases for new features.Added NCO control tutorial notebook.Added TTL trigger acquisition tutorial notebook.Improved doc-strings.Updated documentation and tutorials.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.8.0.Pulsar QRM: compatible with device firmwarev0.8.0.Cluster: compatible with device firmwarev0.3.0.Note:You can also find this release on Gitlabhere.0.7.1 (23-01-2023)Changelog:Added support for new firmware release.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.7.3.Pulsar QRM: compatible with device firmwarev0.7.3.Cluster: compatible with device firmwarev0.2.3.Note:You can also find this release on Gitlabhere.0.7.0 (04-08-2022)Changelog:Added command clear acquisition dataSPI Rack driver was updated to always unlock it at startup, not initialize the span by default, change the code for
changing the span of the S4g and D5a and ensure no mismatch between the host computer and SPI rack on the span
value before doing a current/voltage set operation.Changed assembler character limit, and add code to strip the sequencer program from comments and unused information.Updated tutorials to make them independent of the device type (ie QRM or QCM) and to divide them in a Pulsar and a
Cluster section.Changed QRM output offset range to 1Vpp.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.7.2.Pulsar QRM: compatible with device firmwarev0.7.2.Cluster: compatible with device firmwarev0.2.2.Note:You can also find this release on Gitlabhere.0.6.1 (20-05-2022)Changelog:Added input and output attenuation control for RF-modules.Added the ability to disable LOs in RF-modules.Added a method to manually restart ADC calibration in QRM and QRM-RF modules. Be aware that this is a preliminary
method that might change in the near future.Changed the SPI Rack driver to eliminate unwanted voltage/current jumps by disabling the reset of
voltages/currents on initialization and adding checks to prevent the user to set a value outside of the currently
set span.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.7.1.Pulsar QRM: compatible with device firmwarev0.7.1.Cluster: compatible with device firmwarev0.2.1.Note:You can also find this release on Gitlabhere.0.6.0 (29-03-2022)This release introduces a significant refactor to Qblox Instruments as both a general restructure is introduced
and the preliminary Cluster driver is replaced by the definitive driver. Unfortunately, this means that this
release also introduces a few breaking changes. In exchange, we believe that this release prepares Qblox Instruments
for the future.Changelog:Renamed all classes to be compliant with PEP8’s capswords format.Restructured imports; all drivers are now imported directly fromqblox_instrumentsas follows:from qblox_instruments import Cluster, Pulsar, SpiRackfrom qblox_instruments.qcodes_drivers.spi_rack_modules import D5aModule, S4gModuleWith the new Cluster firmware release, the user now interacts with the Cluster as a single instrument instead
of a rack of instruments. The new Cluster driver reflects this. It detects where and which modules are in the rack
and automatically makes them accessible as an InstrumentChannel submodule accessible asCluster.module<x>, wherexis the slot index of the rack.The Pulsar QCM and Pulsar QRM drivers have been combined into a single Pulsar driver that covers the functionality
of both.The SPI Rack driver driver has been split into a native and QCoDeS layer to improve separation of functionality.Each sequencer’s parameters are now accessible through it’s own InstrumentChannel submodule. This means
that parameters are now accessible asmodule.sequencer<x>.parameter, wherexis the sequencer index.Renamedget_system_statustoget_system_stateto be inline with other state method names.The methodsget_system_stateandget_sequencer_statenow return namedtuples of typeSystemStateandSequencerStaterespectively to ease handling of the returned statuses and accompanying flags.Renamed the sequencer’swaveform_and_programsparameter tosequence.The way to configure the driver as a dummy has been changed to use enums for module type selection.Added keep alive pinging to the socket interface to keep the instrument connection from closing after
a platform dependant idle period.Fixed general code duplication problem between instruments.Introducedqblox-cfgas the new configuration management tool with which to update the Cluster and Pulsar
instruments. As of Pulsar firmware release v0.7.0 and Cluster firmware release v0.2.0, the configuration
management tool is no longer shipped with the release, but insteadqblox-cfgmust be used. This new tool provides
far more functionality and exposes the improved network configurability of the latest firmware releases.On top of the new configuration management tool,qblox-pnpis also instroduced as the new network debug tool.
This tool, in combination with the latest firmware releases, allows to easily find instruments in the network and
to potentially recover them in case of network/IP configuration problems.Improved unit test coverage.Updated the documentation on Read the Docs to reflect the changes.Added various improvements and fixes to the tutorials.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.7.0.Pulsar QRM: compatible with device firmwarev0.7.0.Cluster: compatible with device firmwarev0.2.0.Note:You can also find this release on Gitlabhere.0.5.4 (22-12-2021)Changelog:Cleaned code to improve unit test code coverage.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.6.3.Pulsar QRM: compatible with device firmwarev0.6.3.Cluster CMM: compatible with device firmware v0.1.1.Cluster CMM: compatible with device firmware v0.1.5.Cluster CMM: compatible with device firmware v0.1.5.Note:You can also find this release on Gitlabhere.0.5.3 (26-11-2021)Changelog:Improved __repr__ response from the QCoDeS drivers.Added tutorials for multiplexed sequencing, mixer correction, RF-control and Rabi experiments.Fixed empty acquisition list readout from dummy modules.Added RF-module support to dummy modules.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.6.2.Pulsar QRM: compatible with device firmwarev0.6.2.Cluster CMM: compatible with device firmware v0.1.0.Cluster CMM: compatible with device firmware v0.1.3.Cluster CMM: compatible with device firmware v0.1.3.Note:You can also find this release on Gitlabhere.0.5.2 (11-10-2021)Changelog:Device compatibility update.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.6.2.Pulsar QRM: compatible with device firmwarev0.6.2.Cluster CMM: compatible with device firmware v0.1.0.Cluster CMM: compatible with device firmware v0.1.3.Cluster CMM: compatible with device firmware v0.1.3.Note:You can also find this release on Gitlabhere.0.5.1 (07-10-2021)Changelog:Device compatibility update.Added channel map functionality to dummy layer.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.6.1.Pulsar QRM: compatible with device firmwarev0.6.1.Cluster CMM: compatible with device firmware v0.1.0.Cluster CMM: compatible with device firmware v0.1.2.Cluster CMM: compatible with device firmware v0.1.2.Note:You can also find this release on Gitlabhere.0.5.0 (05-10-2021)Changelog:Increased sequencer support to 6 sequencers per instrument.Added support for real-time mixer correction.Renamed Pulsar QRM input gain parameters to be inline with output offset parameter names.Updated the assemblers for the Pulsar QCM and QRM dummy drivers to support the phase reset instruction.Added preliminary driver for the Cluster.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.6.0.Pulsar QRM: compatible with device firmwarev0.6.0.Cluster CMM: compatible with device firmware v0.1.0.Cluster CMM: compatible with device firmware v0.1.1.Cluster CMM: compatible with device firmware v0.1.1.Note:You can also find this release on Gitlabhere.0.4.0 (21-07-2021)Changelog:Changed initial Pulsar QCM and QRM device instantiation timeout from 60 seconds to 3 seconds.Added support for the new Pulsar QRM acquisition path functionalities (i.e. real-time demodulation, integration, discretization, averaging, binning).Updated the assemblers for the Pulsar QCM and QRM dummy drivers.Switched from using a custom function to using functools in the QCoDeS parameters.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.5.2.Pulsar QRM: compatible with device firmwarev0.5.0.Note:You can also find this release on Gitlabhere.0.3.2 (21-04-2021)Changelog:Added QCoDeS driver for D5A SPI-rack module.Updated documentation on ReadTheDocs.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.5.1.Pulsar QRM: compatible with device firmwarev0.4.1.Note:You can also find this release on Gitlabhere.0.3.1 (09-04-2021)Changelog:Device compatibility update.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.5.1.Pulsar QRM: compatible with device firmwarev0.4.1.Note:You can also find this release on Gitlabhere.0.3.0 (25-03-2021)Changelog:Added preliminary internal LO support for development purposes.Added support for Pulsar QCM’s output offset DACs.Made IDN fields IEEE488.2 compliant.Added SPI-rack QCoDeS drivers.Fixed sequencer offset instruction in dummy assemblers.Changed acquisition out-of-range result implementation from per sample basis to per acquisition basis.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.5.0.Pulsar QRM: compatible with device firmwarev0.4.0.Note:You can also find this release on Gitlabhere.0.2.3 (03-03-2021)Changelog:Small improvements to tutorials.Small improvements to doc strings.Socket timeout is now set to 60s to fix timeout issues.The get_sequencer_state and get_acquisition_state functions now express their timeout in minutes iso seconds.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.4.0.Pulsar QRM: compatible with device firmwarev0.3.0.Note:You can also find this release on Gitlabhere.0.2.2 (25-01-2021)Changelog:Improved documentation on ReadTheDocs.Added tutorials to ReadTheDocs.Fixed bugs in Pulsar dummy classes.Fixed missing arguments on some function calls.Cleaned code after static analysis.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.4.0.Pulsar QRM: compatible with device firmwarev0.3.0.Note:You can also find this release on Gitlabhere.0.2.1 (01-12-2020)Changelog:Fixed get_awg_waveforms for Pulsar QCM.Renamed get_acquisition_status to get_acquisition_state.Added optional blocking behaviour and timeout to get_sequencer_state.Corrected documentation on Read The Docs.Added value mapping for reference_source and trigger mode parameters.Improved readability of version mismatch.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.4.0.Pulsar QRM: compatible with device firmwarev0.3.0.Note:You can also find this release on Gitlabhere.0.2.0 (21-11-2020)Changelog:Added support for floating point temperature readout.Renamed QCoDeS parameter sequencer#_nco_phase to sequencer#_nco_phase_offs.Added support for Pulsar QCM input gain control.Significantly improved documentation on Read The Docs.Driver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.4.0.Pulsar QRM: compatible with device firmwarev0.3.0.Note:You can also find this release on Gitlabhere.0.1.2 (22-10-2020)Changelog:Fixed Windows assembler for dummy PulsarFixed MacOS assembler for dummy PulsarDriver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.3.0.Pulsar QRM: compatible with device firmwarev0.2.0.Note:You can also find this release on Gitlabhere.0.1.1 (05-10-2020)Changelog:First release on PyPIDriver/firmware compatibility:Pulsar QCM: compatible with device firmwarev0.3.0.Pulsar QRM: compatible with device firmwarev0.2.0.Note:You can also find this release on Gitlabhere.