20
hivolt.de
GmbH & Co. KG
Oehleckerring
40
∙
D-22419
Hamburg
∙
Germany
∙
+49 40 537122-0
∙
+49 40 537122-99
∙
∙
www.hivolt.de
6
Command Interface
HA61 series high voltage amplifiers are equipped with one Ethernet (ETH) interface and one USB
(COM) interface. Both interfaces can be used to control and monitor the amplifier.
A simple command protocol (Level I Commands) with clear text ASCII commands using a request-
response structure is available to control and monitor the amplifier. Each command is followed by a
response.
Communication is alternatively via USB (COM) or ETH. The response is sent to the interface via which
the command was received.
Software download is is only possible via USB.
6.1
Command Structure
Request:
$<id><com>[pars]<cr>[<lf>]
Response: $<err><id>[pars]<cr><lf>
$
Start character: "$"
id
1AN
Sequence id: an alphanumeric character (not "$"); the id is returned with the
response for identification of the command sequence
com 3AN
Command: three alphanumeric characters
pars AN
Parameter:
[;par[;par[;...]]]; optional, depending on the command
.
Number format: [-]1234.56; leading zeros, decimal point and fractional digits
are optional.
Parameter separator: ";" (a semicolon is set preceding each parameter)
err 1N Error
number
<cr>
End of record: Carriage Return
<lf>
End of record: Line Feed (optional)
6.2
Examples
Request:
$1SRR<cr>
Shutdown Reset; id=1
Response:
$01<cr><lf>
no error; id=1
Request:
$ SV1;-2577.23<cr>
Set Output Voltage: -2577.23V; id=' '
Response:
$0 <cr><lf>
no error; id=' '
Request:
$5RAT<cr>
Read Temperatures; id=5
Response: $05;35.7;42.3;61.5;64.3;67.5<cr><lf> no error; id=5; 35.7°C (HV1), 42.3°C (HV2),
61.5°C (PA1), 64.3°C (PA2), 67.5°C (PA3)
Request:
$1XYZ<cr>
invalid command; id=1
Response:
$91<cr><lf>
unknown command; id=1
