iseg NHS Series Programmer's Manual
Scpi general instruction set to the hv power supply devices
Hide thumbs
Also See for NHS Series:
- Technical documentation manual (30 pages) ,
- User manual (20 pages) ,
- Programmer's manual (61 pages)
Related Manuals for iseg NHS Series
Summary of Contents for iseg NHS Series
- Page 1 Programmers guide Last changed on: 2020-11-10 iseg SCPI general instruction set Applies to the HV power supply devices • • • MICC • • •...
-
Page 2: Document History
Copyright © 2020 by iseg Spezialelektronik GmbH / Germany. All Rights Reserved. This document is under copyright of iseg Spezialelektronik GmbH, Germany. It is forbidden to copy, extract parts, duplicate for any kind of publication without a written permission of iseg Spezialelektronik GmbH. This information has been prepared for assisting operation and maintenance personnel to enable efficient use. -
Page 3: Safety
Advices marked as “Caution!” describe actions to avoid possible damages to property. CAUTION! INFORMATION Advices marked as “Information” give important information. INFORMATION Read the manual. Attention high voltage! Important information. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 3/63... -
Page 4: Intended Use
You may only put the product into operation after it has been established that the high-voltage device complies with • the country-specific regulations, safety regulations and standards of the application. The high-voltage power supply unit may only be installed by qualified personnel. • SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 4/63... - Page 5 When controlling the high voltage systems with software, make sure that nobody is near the high voltage or can be injured. CAUTION! INFORMATION Please check the compatibility with the devices used. INFORMATION SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 5/63...
-
Page 6: Table Of Contents
Output formats for voltage and current 7.1. Examples 7.1.1 Simple examples 7.1.2 Advanced examples 7.1.3 Commands for NHR and SHR Description of control, status, event, and mask registers SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 6/63... - Page 7 8.8. Module Event Mask 8.9. Module Control 8.10. Module Event Channel Status 8.11. Module Event Channel Mask iseg Terminal iseg SCPI Control ASCII character table References Manufacturer contact SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 7/63...
-
Page 8: General Information To High Voltage Devices
HPS is a series of industrial high voltage devices, typically with one output channel and power greater 300 W • FPS is a potential-free low voltage power device, typically with one channel and currents starting at 6 A • SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 8/63... -
Page 9: High Voltage Device Operation Modes
I . If I exceeds this tolerance in either direction, the bounds bounds meas Channel Status is Current Bounds is generated. (condition: no ramping) Table 1: Terminology SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 9/63... -
Page 10: Channel Operation Modes
ADC measurement values. ADC Sample Rate The ADC sample rate determines the resolution and noise of the measurement. Lower sample rates typically lead to better results but slower updating. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 10/63... -
Page 11: Status And Event Generation
This option can be added to devices NHS or NHR. An external temperature sensor allows a V correction according a VCT factor and the temperature difference. The VCT features can be accessed with the 5.2.1 Option VCT. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 11/63... -
Page 12: Introduction To Scpi Commands
Float: A floating point value with the format +1234.567E-6 (sign, mantissa, exponent). This is the format used for voltage • and current values. String: A character string like “ON” or “OFF”. These strings have to be given without quotes (“). • SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 12/63... - Page 13 1 2 3 . 4 5 6 V ; 1 . 2 3 4 5 E - 3 A < C R > < L F > SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 13/63...
- Page 14 1 . 1 2 3 4 E - 3 A , 1 . 2 3 4 5 E - 3 A , 1 . 3 4 5 6 E - 3 A < C R > < L F > SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com...
-
Page 15: Interfaces
Many devices have more interfaces, which are not covered by this document. For example, the CAN interface with EDCP / DCP command list is described in the manual CAN_EDCP_Programmers-Guide.pdf There are ready made applications to use the SCPI command set without programming, such as iseg Terminal (isegTerminal iseg SCPI Control... -
Page 16: Usb And Rs-232 Interface
4, 6, and 8 must be set up externally. Signal HV device Computer RS-232 D-SUB 9 Internal D-SUB 9 ┐ (bridged) ┤ (bridged) ┘ (bridged) Table 5: D-SUB 9 pin assignment SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 16/63... -
Page 17: Usb Interface
Female USB B at the front panel HPS ≥ 1.5 kW Female USB-B at the back panel Female USB-B at the front panel CDC-ACM, see chapter 12: References Table 6: USB hardware implementations SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 17/63... -
Page 18: Windows Usb Driver Installation
All devices get an USB Serial Port assigned in section Ports (COM & LPT), in this case COM3: Figure 1: Device Manager The connection to the device can be tested with isegTerminal, see chapter 12: References. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 18/63... -
Page 19: Linux Usb Driver Installation
[ 5 4 9 . 0 4 9 8 5 1 ] c d c _ a c m : U S B A b s t r a c t C o n t r o l M o d e l d r i v e r f o r U S B m o d e m s a n d I S D N a d a p t e r s SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com... - Page 20 NHR with the graphical Terminal program CuteCom. Download is at http://cutecom.sourceforge.net. To communicate with an iseg USB or serial device, the following settings are needed: D e v i c e / d e v / t t y U S B 0 ( o r o t h e r i n t e r f a c e , a c c o r d i n g t o d m e s g o u t p u t )
-
Page 21: Ethernet
The factory IP settings IP address HPS 300/800 W 192.168.16.13 All other devices 192.168.16.221 Netmask 255.255.255.0 Default gateway 192.168.16.1 Command TCP port 10001 (fixed) Table 8: Factory IP settings SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 21/63... -
Page 22: Ethernet Programming Example
Windows XP, but still works with recent compilers on newer Windows versions too. Make sure to adopt the device address, which is hard coded to 192.168.16.221 to your environment. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 22/63... - Page 23 / / p r i n t a n s w e r p r i n t f " % s \ n " a n s r e t u r n SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 23/63...
-
Page 24: Common Instruction Set
Example: *GTL *OPC? Query the operation complete status. The query returns “1” when all commands before this query have been processed. Example: :VOLT:ON,(@0);*OPC? Table 10: Common instruction set SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 24/63... -
Page 25: Nhr, Shr, Nhs And Micc
Example: :CURR:BOUNDS 100E-6,(@3) ˽ :EVent Clear the Channel Event Status register (8.3). ˽CLEAR,(@<Channel>) Example: :EVENT CLEAR,(@4) ˽ Set the Channel Event Mask register (8.4). :MASK˽<Word>,(@<Channel>) Example: :EVENT:MASK 65535,(@4) ˽ SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 25/63... - Page 26 Query the current output polarity. Example: :CONF:OUTPUT:POL? (@0) ˽ → n :LIST? (@ ˽ <Channel>) Query the available channel output polarities. Example: :CONF:OUTPUT:POL:LIST? (@0) ˽ → p, n SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 26/63...
- Page 27 Query channel current ramp speed minimum Example: :READ:RAMP:CURR:MIN? (@1) ˽ → 1.0000E-3A/s :MAX? (@ ˽ <Channel>) Query channel current ramp speed maximum Example: :READ:RAMP:CURR:MAX? (@1) ˽ → 6.0000E-3A/s SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 27/63...
- Page 28 Set the channel current ramp down speed in Ampere/second. Example: :CONF:RAMP:CURR:DOWN 1.5E-3,(@2) ˽ :DOwn? (@ ˽ <Channel>) Query the channel current ramp down speed in Ampere/second. Example: :CONF:RAMP:CURR:DOWN? (@2) ˽ → 1.50000E-3A/s SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 28/63...
- Page 29 Be careful when switching off the echo as there is no other possibility to synchronize the HV device with the computer (no hardware/software handshake). This mode is only available for compatibility reasons and without support. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 29/63...
- Page 30 :READ:MODULE:SUPPLY:N12V? → -12.1V :TEMPerature? Query the module temperature in degree Celsius. Example: :READ:MODULE:TEMPERATURE? → 31.9C :CHANnelnumber? Query the number of channels in the module. Example: :READ:MODULE:CHANNELNUMBER? → 4 SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 30/63...
- Page 31 SHR: Saves the changed output mode or polarity to icsConfig.xml. ˽ Example: :SYSTEM:USER:CONFIG SAVE Notes: Instruction for NHR or SHR only Instruction for SHR only Instruction for MICC only Instruction for NHS SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 31/63...
- Page 32 The MICC system is properly configured and the configuration is confirmed by this command. It is possible to switch on any of the HV channels afterwards. Example: :CONF:HVMICC HV_OK ˽ SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 32/63...
- Page 33 I Example: :SYS:USER:CURR:LIMIT 2.5E-3,(@0) ˽ :LIMit?˽(@<Channel>) Returns the channels nominal software limit in Ampere Example: :SYS:USER:CURR:LIMIT? (@0) ˽ → 2.5E-3A SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 33/63...
- Page 34 Example: :SYS:USER:CALIB WRITE, ˽ (@0) ˽ LOAD ,(@<Channel>) Read back the stored configuration, discarding all changed values since the last WRITE operation. Example: :SYS:USER:CALIB LOAD, ˽ (@0) SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 34/63...
-
Page 35: Hardware Options
Query the VCT coefficient in Volt/Kelvin Example: :CONF:VCT:COEFF?˽(@0) → 1.234V/K :READ :CHANnel Reads the temperature of the channels external temperature sensor in degree Celsius :TEMPerature? (@ ˽ <Channel>) Example: :READ:CHAN:TEMPERATURE?˽(@0) → 25.9C SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 35/63... -
Page 36: Hps And Fps
Set the Channel Event Mask register (8.4). Example: :EVENT:MASK˽12345 :MEASure :VOLTage? Query the measured voltage in Volt. Example: :MEAS:VOLT? → 1.23456E3V :CURRent? Query the measured current in Ampere. → Example: :MEAS:CURR? 2.34567E-3A SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 36/63... - Page 37 Set the devices IP gateway. Example: :CONF:ETH:GATE˽192.168.16.1 :GATEway? Query the devices IP gateway. Example: :CONF:ETH:GATE? → 192.168.16.1 :MAC? Query the devices MAC address. Example: :CONF:ETH:MAC? → 01:23:45:67:89:ab SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 37/63...
- Page 38 1 (Listening) it only turns to remote operation after receiving a set command. Example: :CONF:INTERFACE:MODE˽1 :LIST? Query the available interfaces in the device. Example: :CONF:INTERFACE:LIST? → CAN,USB,AIO SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 38/63...
- Page 39 Example: :SYS:USER:CONFIG 1234567 ˽ :CONFig˽0 Exit configuration mode Example: :SYS:USER:CONFIG 0 ˽ :CONFig? Returns 1 if configuration mode is enabled, otherwise 0. → Example: :SYS:USER:CONFIG? SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 39/63...
- Page 40 → 12345 :EVent :STATus? Query the Channel Event Status register (8.3). Example: :READ:CHAN:EVENT:STAT? → 23456 :MASK? Query the Channel Event Mask register (8.4). Example: :READ:CHAN:EVENT:MASK? → 34567 SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 40/63...
- Page 41 1) – only for HPS ≥ 1.5 kW and HPS compact (350 W) 2) – only for HPS ≥ 1.5 kW 3) – all “USER” command only for HPS compact 350 W 4) – only for HPS 300/800 W SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 41/63...
-
Page 42: Arc Management Configuration For Hps ≥ 1.5 Kw
All channel instructions described in section 6 can be applied to the different channels. Furthermore, commands for parametering the FPS devices exists. These are described in the next chapter. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 42/63... -
Page 43: Fps Heating And Emission Regulation Parameters
Therefore, these limits have to be choosen carefully. The minimum value must be small enough that barely emission occurrs, the maximum value however must be small enough that no damage can happen. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 43/63... -
Page 44: Output Formats For Voltage And Current
The current format is the same, but a second current measurement range with the corresponding exponent exists. • Depending on the range, the exponent is E-3 or E-6. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 44/63... -
Page 45: Examples
: R E A D : V O L T : M O D E ? ˽ ( @ 0 ) ; : R E A D : C U R R : M O D E ? ˽ ( @ 0 ) configured output mode: - 4 . 0 E 3 V , 3 . 0 E - 3 A SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 45/63... -
Page 46: Description Of Control, Status, Event, And Mask Registers
NHR and SHR only The Channel Status register describes the actual status. Depending on the current status of the channel the bits will be set or reset. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 46/63... - Page 47 An input error occurred (e.g. a parameter is out of range) Is Arc An electrical ARC has occurred recently Is Positive The channel has positive output polarity (0 is negative polarity) SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 47/63...
-
Page 48: Channel Event Status
After the high voltage is turned off, it cannot be turned on again • After either the event bit or the corresponding mask is cleared, the blocking is disabled again. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 48/63... - Page 49 The channel was switched off due to a blocking event (Voltage/Current Limit, Current Trip, External Inhibit or Emergency Off) Event Arc – An electrical ARC has occurred Event Input Error – An Input Error has occurred SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 49/63...
-
Page 50: Channel Event Mask
The event mask provides a mean to propagate a specific channel event to the global event register. They also block turning on or increasing the high voltage for some event bits. See section 8.3: Channel Event Status for more information. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 50/63... - Page 51 Mask Event On To Off Mask the Event On To Off Mask Event Arc Mask the Event Arc Mask Event Input Error Mask the Event Input Error SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 51/63...
-
Page 52: Channel Control
1 if the channel is set on by :VOLT ON or 0 if the channel is off. ˽ Set Emergency Off 1 if the channel is set to emergency off by :VOLT:EMCY OFF or 0 otherwise ˽ SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 52/63... -
Page 53: Module Status
Adjustment Notes: SHR only The Module Status register describes the actual status. Depending on the current status of the module the bits will be set or reset. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 53/63... - Page 54 Fine adjustment is enabled for all channels Is High Voltage On At least one channel is actively generating High Voltage or has a measured voltage greater 60 Volt. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 54/63...
-
Page 55: Module Event Status
Event Service A hardware failure of the HV module has been detected. The HV will be switched off without a possibility to switch on again. Consult the manufacturer. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 55/63... -
Page 56: Module Event Mask
Mask Event Safety Loop Not Good Mask the Event Safety Loop Not Good Mask Event Input Error Mask the Event Input Error Mask Event Service Mask the Event Service SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 56/63... -
Page 57: Module Control
Clear all event status registers of the module and the channels. This bit always reads as 0, the clear all events the command *CLS can be used. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 57/63... -
Page 58: Module Event Channel Status
If the n-th bit of the mask is set and the n-th channel has an active event in the Module Event Channel Status register, the bit Is Event Active in the Module Status register (section 8.6) is set. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 58/63... -
Page 59: Iseg Terminal
9 iseg Terminal iseg Terminal is a Windows or Linux program to control iseg devices with RS-232, USB, GPIB (IEEE-488) or Ethernet interface using their ASCII command sets. The latest version is available from the iseg website: https://iseg-hv.com/download/ ➜ Software ➜ ISEG Terminal ➜ Current ➜ “isegTerminal-x.x.x-Windows-x86.zip”... -
Page 60: Iseg Scpi Control
10 iseg SCPI Control iseg SCPI Control is a Windows or Linux program to control iseg devices with SCPI command set by the USB or Ethernet interface. All important data points will be displayed via a table and an input of new set value can be made via short cuts. The corresponding short cuts are displayed with the text entries of the menu bar. -
Page 61: Ascii Character Table
0x1B <ESC> 0x3B 0x5B 0x7B 0x1C <FS> 0x3C < 0x5C 0x7C 0x1D <GS> 0x3D 0x5D 0x7D 0x1E <RS> 0x3E > 0x5E 0x7E 0x1F <US> 0x3F 0x5F 0x7F SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 61/63... -
Page 62: References
SCPI Control https://iseg-hv.com/download/?dir=SOFTWARE/isegSCPIcontrol/current iseg Control https://iseg-hv.com/download/?dir=SOFTWARE/isegControl/current Option VCT https://iseg-hv.com The exact description can be found in the hardware manuals of the devices. For example SHR. SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 62/63... -
Page 63: Manufacturer Contact
13 Manufacturer contact iseg Spezialelektronik GmbH Bautzner Landstr. 23 01454 Radeberg / OT Rossendorf GERMANY FON: +49 351 26996-0 | FAX: +49 351 26996-21 www.iseg-hv.com info@iseg-hv.de sales@iseg-hv.de SCPI protocol common instruction set | Last changed on: 2020-11-10 | www.iseg-hv.com 63/63...
Need help?
Do you have a question about the NHS Series and is the answer not in the manual?
Questions and answers