/

Keysight

/

Keysight N5749A

SCPI COMMAND REFERENCE

Keysight N5749A

Keysight N5749A

The Keysight N5749A is Keysight's power supply in the N5700 Series System DC Power Supply family. Its SCPI remote-control interface exposes 85 commands across 17 subsystems - 48 settable and 37 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.

85

Commands

48

Settable

37

Queries

17

Subsystems

SCPI

Verified

2026-07-16

All commands

Sets the negative transition filter for the operation status register.

NameTypeValuesDescription
NRfinteger0Value used to set the negative transition filter.

Sets the positive transition filter for the operation status register. This command writes the specified bit mask to the :STATus:OPERation register.

NameTypeValuesDescription
NRfinteger0Bit mask used to set the positive transition filter.

Sets the negative transition filter for the questionable status register.

NameTypeValuesDescription
<NRf>integer0 - 4294967295Specific bits to enable in the status register.

Sets the positive transition filter for the questionable status register. It is a setter command and accepts an <NRf> value.

NameTypeValuesDescription
NRfnumeric-Bit mask for the positive transition filter.

Returns the value of the Operation Condition register. This is a read-only register that holds the live, unlatched operational status of the power supply.

integer - Value of the Operation Condition register.

Sets and reads the value of the Operational Enable register. This register masks Operation Event bits to set the operation summary bit (OPER) of the Status Byte register.

NameTypeValuesDescription
valueinteger0 - 0Value to load into the Operational Enable register.

Sets or reads the value of the Operational Enable register. This register masks Operation Event bits to determine the operation summary bit (OPER) in the Status Byte register; the preset value is 0.

integer - Returns the value of the Operational Enable register.

Returns the value of the Operation Event register. Reading the read-only Event register clears it.

integer - The value of the Operation Event register.
:STATus:PRESetset / query

Sets all defined bits in the Operation and Questionable PTR registers. It also clears all defined bits in the Operation and Questionable NTR and Enable registers.

Returns the value of the Operation NTR register. The register acts as a Negative-Transition polarity filter between the Operation Condition and Operation Event registers.

integer - The current value of the Operation NTR register.

Returns the value of the Operation PTR (Positive-Transition) register. This read-only register serves as a polarity filter between the Operation Condition and Operation Event registers.

integer - The value of the Operation PTR register.

Returns the value of the Questionable Condition register. This read-only register holds the real-time, unlatched questionable status of the power supply.

integer - The value of the Questionable Condition register.

Returns the value of the Questionable Event register. Reading the register clears it.

integer - The value of the Questionable Event register.

Sets and reads the value of the Questionable Enable register. This register masks bits from the Questionable Event register to set the questionable summary bit (QUES) of the Status Byte register.

NameTypeValuesDescription
valueinteger0 - 32767Value of the Questionable Enable register.
integer - Returns the value of the Questionable Enable register.

Sets or reads the value of the Questionable Enable register. This register masks bits from the Questionable Event register to set the questionable summary bit (QUES) of the Status Byte register.

integer - Returns the value of the Questionable Enable register.

Sets or reads the value of the Questionable NTR (Negative-Transition) register. The register acts as a polarity filter between the Questionable Condition and Questionable Event registers.

integer - Returns the value of the Questionable NTR register.

Sets or reads the value of the Questionable PTR (Positive-Transition) register. This register acts as a polarity filter between the Questionable Condition and Questionable Event registers.

integer - Returns the Questionable PTR register value.

Initiates calibration of the output current.

NameTypeValuesDescription
leveloptenumP1 | P2Selects the next point in the calibration sequence.
:CALibrate:DATAset / query

Enters a calibration value obtained by reading an external meter. You must first select a calibration level with CALibrate:LEVel, and the value is entered in volts or amperes depending on the function being calibrated.

NameTypeValuesDescription
valuerealV/ACalibration value obtained from an external meter.
:CALibrate:DATEset / query

Stores the date the unit was last calibrated. The date must be entered in numeric format yyyy/mm/dd; the query returns the date.

NameTypeValuesDescription
datestring-Date the unit was last calibrated, in numeric format yyyy/mm/dd.
:CALibrate:LEVelset / query

Selects the next point in the calibration sequence. P1 is the first calibration point and P2 is the second calibration point.

NameTypeValuesDescription
modeenumP1 | P2Next calibration point to select.

Changes the calibration password. A password of 0 removes password protection and makes calibration mode unrestricted; the default password is 0.

NameTypeValuesDescription
passwordstring-New calibration password.
:CALibrate:STATeset / query

Enables or disables calibration mode. Calibration mode must be enabled before the power supply accepts other calibration commands; the query returns only the state, not the password.

NameTypeValuesDescription
stateenumON | OFFEnabled or disabled state (On=1, Off=0).
passwordoptinteger-Password required when enabling calibration mode if the existing password is not 0.
enum - Returns the calibration mode state only.

Performs a measurement and returns the DC output current in amperes. Measure commands acquire new data before returning the reading.

real (A) - Returns the DC output current in amperes.

Performs a measurement and returns the DC output voltage in volts. MEASure commands acquire new data before returning the reading; measurement overflows return 9.91E+37.

real (V) - DC output voltage measurement.

Determines whether the power-on state is set by the reset state or by the settings saved when the unit was turned off. The setting is stored in non-volatile memory.

NameTypeValuesDescription
stateenumRST | AUTOSelects the power-on state mode.

Clears the latched signals that have disabled the output. The output is restored to the state it was in before the fault condition occurred after the fault source is removed.

:OUTPut[:STATe]set / query

Enables or disables the specified output. The enabled state is On (1) and the disabled state is Off (0).

NameTypeValuesDescription
stateenumON | OFFSets the output state.
OUTPut[:STATe] ON|OFF
OUTPut[:STATe]?

Enables or disables the over-current protection (OCP) function. The enabled state is On (1) and the disabled state is Off (0).

NameTypeValuesDescription
stateenumON | OFFTurns the over-current protection function on or off.
enum - Returns the current over-current protection state as On or Off.

Enables or disables the over-current protection (OCP) function. The enabled state is On (1); the disabled state is Off (0).

NameTypeValuesDescription
stateenumON | OFFEnables or disables over-current protection.
enum - Returns the present OCP state, where On is 1 and Off is 0.

Sets the triggered output current level. The value is programmed in amperes; at *RST the immediate and triggered current values are 0.

NameTypeValuesDescription
valuereal0 - 0Triggered current level to program.
qualifieroptenumMIN | MAXSets the value to the minimum or maximum allowed current level.

Returns the triggered current level. The value is programmed in amperes, and the query accepts optional MIN or MAX to return the corresponding limit value.

real (A) - The triggered output current level in amperes, or the minimum/maximum allowed level when queried with MIN or MAX.

Sets the immediate output current level. The value is programmed in amperes; the immediate level is the output current setting.

NameTypeValuesDescription
valuereal0 - MAXImmediate output current level.
qualifieroptenumMIN | MAXReturns or sets the minimum or maximum allowed current level.

Sets or queries the immediate output current level. The values are programmed in amperes; at *RST, the immediate current value is 0.

real (A) - Returns the immediate output current level in amperes.

Sets the triggered output voltage level. The value is programmed in volts, and the allowed range depends on the model and is coupled with the voltage protection and voltage limit low settings.

NameTypeValuesDescription
valuereal0 - 628.5Triggered output voltage level to program.
qualifieroptenumMIN | MAXSets the value to the minimum or maximum allowed voltage level.

Sets the triggered output voltage level. The value is programmed in volts, and the allowed range depends on the model rating and on the voltage protection/low-voltage settings.

NameTypeValuesDescription
voltagereal0 - 6.3Triggered output voltage level to program.
qualifieroptenumMIN | MAXSets the voltage level to the minimum or maximum allowed value.

Sets the immediate voltage level. The value is programmed in volts, and the command also accepts MIN and MAX keywords; the programmed range depends on the model and on the voltage protection/limit low settings.

NameTypeValuesDescription
valuereal0 - 628.5Immediate output voltage level to program.
qualifieroptenumMIN | MAXSelects the minimum or maximum allowable voltage level.

Sets or queries the immediate output voltage level. The values are programmed in volts, and the immediate level is the output voltage setting.

real (V) - Returns the immediate output voltage level.

Sets the low voltage limit of the output. When set, the instrument ignores programming commands that would set the output voltage below this limit.

NameTypeValuesDescription
valuereal0 - 570Low voltage limit to program.
qualifieroptenumMIN | MAXSets the limit to the minimum or maximum allowed value.

Queries the present low voltage limit of the output. The query also accepts the optional qualifiers MIN or MAX to request the minimum or maximum low limit.

NameTypeValuesDescription
qualifieroptenumMIN | MAXSelects the minimum or maximum low voltage limit value to return.
real (V) - Returns the present low voltage limit, or the minimum/maximum low limit when MIN or MAX is specified.

Sets the over-voltage protection (OVP) level of the output. If the output voltage exceeds the OVP level, the output is disabled and OV is set in the Questionable Condition status register.

NameTypeValuesDescription
valuereal0.5 - 660OVP level in volts.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowed OVP level.
real (V) - Returns the present over-voltage protection level in volts, or the minimum/maximum limit when queried with a qualifier.

*SRE?query

Sets the Service Request Enable Register. The query returns the current state of *SRE.

integer - Returns the current state of the Service Request Enable Register.
*TRGset / query

Generates a trigger when the trigger source is set to BUS. It has the same effect as the Group Execute Trigger (<GET>) command.

*OPC?query

Synchronizes with command completion. The instrument responds when all pending operations are complete, and the response must be read each time the query is sent.

boolean - Returns 1 when all pending operations are complete.
*ESE?query

Queries the accumulated status (ASTS). The response represents the sum of the binary weights of the ASTS register bits. The ASTS register is set to the present status after being queried.

integer - The sum of the binary weights of the ASTS register bits.
*SRQset / query

Generates error 203; the power supply's service request capability is only supported using the SCPI commands.

NameTypeValuesDescription
settinginteger-Setting to apply.
*SRQ?query

Always returns 0.

integer - Returns 0.
*TST?query

Always returns 0.

integer - Always returns 0.
*CLSset / query

Clears the status data structures and the error queue.

*ESEset / query

Sets the Standard Event Status Enable Register bits. This is one of the IEEE 488.2 common commands listed in the command summary.

NameTypeValuesDescription
valueinteger0 - 255Bits to be written to the Standard Event Status Enable Register.
*ESR?query

Returns the event status register value. The register is read and then cleared.

integer - The current event status register value.
*IDN?query

Returns the instrument identification string.

string - Returns a comma-separated identification string containing the manufacturer, model, serial number, and firmware revision.
*OPCset / query

Sets the operation complete bit in the event status register when all pending operations are finished. This command is typically used for command synchronization.

*OPT?query

Returns the model option code or identifier. This is a query command.

string - The option code or identifier for the instrument model.
*RCLset / query

Recalls a setup from nonvolatile memory.

NameTypeValuesDescription
stateinteger0 - 9Location number of the setup to recall.
*RSTset / query

Resets the instrument to its default state.

*SAVset / query

Saves the present instrument state to a nonvolatile storage location for later recall.

*SREset / query

Sets the IEEE 488.2 service request enable register. The enabled bits are logically ANDed with the status byte register to generate a service request.

NameTypeValuesDescription
valueinteger0 - 255Bit mask for the service request enable register.
*STB?query

Returns the value of the status byte register. This is a common command.

integer - The value of the status byte register.
*TSTset / query

Performs a self-test of the instrument. The query form returns the self-test result.

integer - Returns the self-test result.
*WAIset / query

Waits until all previously received overlapped commands have completed. This is a synchronization command and does not return a response.

Configures the instrument's remote/local state. The setting can be LOCal, REMote, or RWLock; at power-on the communications setting returns to LOCal.

NameTypeValuesDescription
stateenumLOCal | REMote | RWLockRemote/local state to set.
enum - Returns the current remote/local state.

Returns the current remote/local state of the instrument. The state can be LOCal, REMote, or RWLock, and at power-on it returns to LOCal.

enum - The current remote/local state of the instrument.

Returns the control connection port number used to open a control socket connection to the instrument.

integer - The control connection port number.

Returns the next error number and its corresponding message string from the error queue. Each read removes the error from the FIFO queue; when the queue is empty, the query returns 0, NO ERROR.

string - The next error number and its corresponding message string from the error queue, or 0, NO ERROR when the queue is empty.

This query returns the SCPI version number to which the instrument complies. The returned value is of the form YYYY.V, where YYYY is the year and V is the revision number for that year.

string - SCPI version number in the form YYYY.V.

:ABORtset / query

Cancels any trigger actions in progress and returns the trigger system to the IDLE state, unless INIT:CONT is enabled. It also resets the WTG bit in the Status Operation Condition register.

This command continuously initiates output triggers. When disabled, the trigger system must be initiated for each trigger with the INITiate command.

NameTypeValuesDescription
stateenumON | OFFEnables or disables continuous initiation of output triggers.

Continuously initiates output triggers. When disabled, the trigger system must be initiated for each trigger with the INITiate command.

enum - Returns the continuous initiate state, with On as 1 and Off as 0.

Controls the enabling of output triggers. When a trigger is enabled, a trigger causes the specified triggering action to occur; if the trigger system is not enabled, all triggers are ignored.

:TRIGger:SOURceset / query

Selects the trigger source for the output trigger system. Only BUS can be selected as the trigger source.

NameTypeValuesDescription
sourceenumBUSTrigger source for the output trigger system.

Returns the trigger source for the output trigger system. Only BUS can be selected as the trigger source.

enum - The trigger source for the output trigger system.

If the trigger system has been initiated, this command generates an immediate output trigger. The output trigger initiates the configured output change and clears the WTG bits after the trigger action has completed.

:CAL:CURRset / query

Sets the instrument to voltage programming and measurement calibration mode.

CAL:VOLT
:CAL:VOLTset / query

Selects voltage calibration mode.

CAL:VOLT

:CURR:PROT:STATset / query

Queries the OCP setting. The response is FOLD 2.

enum - Returns the current overcurrent protection setting as FOLD 2.

Queries the OCP setting. The response is FOLD 2.

enum - Returns FOLD 2.
:CURR:TRIGset / query

Sets the current trigger value. This compatibility function is held until a trigger occurs when HOLD 1 is active.

:VOLT:TRIGset / query

Sets the trigger voltage setting used by the compatibility functions. This applies to the compatibility functions, not the SCPI functions.

:VOLT:PROT:LEVset / query

Sets the over-voltage trip point.

NameTypeValuesDescription
levelreal-Over-voltage trip point.

Queries the present over-voltage setting. The response is a real number.

real - The present over-voltage setting.

Queries the present output state.

enum - Returns the present output state.

:TRGset / query

Defines a trigger command used as part of the trigger subsystem. The manual index lists it under trigger commands.

TRG