16
hivolt.de
GmbH & Co. KG
Oehleckerring
40
∙
D-22419
Hamburg
∙
Germany
∙
+49 40 537122-0
∙
+49 40 537122-99
∙
∙
www.hivolt.de
5.2
Command Interface
A simple command interface with recognizable ASCII commands using a request-response structure
has been implemented to control and monitor the amplifier. Each command is followed by a response.
Coding format:
Request:
$<id><com>[pars]<cr>[<lf>]
Response: $<err><id>[pars]<cr><lf>
$
Start character: "$"
id
1AN
Sequence Id: a free alphanumeric character (not "$"); the id is returned with
the response for identification of the command sequence
com 2A
Command: two alpha characters
pars AN
Parameter:
[par[;par[;...]]]; optional, depending on the command
.
Number format: [-]1234.56; leading zeros, decimal point and decimal places
optional.
Parameter separator: ";"
err 1N Error
number
<cr>
End of record: Carriage Return
<lf>
End of record: Line Feed (optional)
Examples:
Request:
$1SR<cr>
Shutdown Reset; id=1
Response:
$01<cr><lf>
no error; id=1
Request:
$2SV-2577.23<cr>
Set Output Voltage: -2577.23V; id=2
Response:
$02<cr><lf>
no error; id=1
Request:
$ GI<cr>
Read General Purpose Inputs; id=" "
Response:
$0 12<cr><lf>
no error; id=" "; Input Pattern: 12 (0x0c)
Request:
$5rt<cr>
Read Temperatures; id=5
Response:
$05357;423;615<cr><lf>
no error; id=5; 35,7°C (PA1), 42,3°C (PA2), 61,5°C (DC)
Request:
$1XY<cr>
invalid command; id=1
Response:
$91<cr><lf>
unknown command; id=1
Error numbers:
9 unknown
command
8
wrong number format
7
parameter too high
6
parameter too low
0 no
error
