# Syntax

Navigation: Valve Firmware > Interface > RS232/485 > Command Structure > # Syntax |

•IC2 Command Set is always available independent from the setting Command Set.

•Commands and values are case sensitive.

•Acknowledgement within 10ms after reception of command (worst case).

•Wait for acknowledgement before sending a new command.

•Default command termination is CR and LF. This is adjustable.
CR = Carriage Return (0D hexadecimal), LF = Linefeed (0A hexadecimal).

•Same Syntax for Commands over Terminal in the CPA as over RS232 interface.

•All characters are in ASCII code

| Command | Response
GET | p: service parameter index | p: error service parameter index value
SET | p: service parameter index value | p: error service parameter index value

service | service code in hexadecimal, 2 digits
parameter | parameter ID in hexadecimal, 8 digits
error | error code in hexadecimal, 2 digits
index | array index, if parameter is not an array use 00, 2 digits
value | set or response value, digits depends on value format

Service

code | description
01 | Set a value to a parameter
0B | Get a value from a parameter

Parameter

The supported parameters is depending on the specific firmware version and the used hardware. This list of visible parameter can be exported by the CPA4 program directly. Please see chapter Export Parameters to Excel.

The parameter ID of a selected parameter is visible on the bottom left side of the parameter window.

By using right-click on the parameter ID, the corresponding command (Set or Get or the ID) is copied to the clipboard. If using a set-command, the command needs to be completed by the new value.

Error

code | error text | description
--- | --- | ---
00 | no error | no error
0C | wrong command length | wrong command length
1C | value too low | value out of range: lower then min limit
1D | value too high | value out of range: higher then max limit
20 | resulting zero adjust offset value out of range | resulting zero adjust offset value out of range
21 | not valid because no sensor enabled | not valid because no sensor enabled
50 | wrong access mode | wrong access mode
51 | time out |
6D | EEProm not ready |
6E | wrong parameter ID | wrong parameter ID
6F | set to default value not possible | set to default value not allowed
70 | parameter not settable | set value not allowed
71 | parameter not readable | get value not allowed
72 | set to initial value not possible | initial value not allowed
73 | wrong parameter index | wrong parameter ID index (array)
74 | initial value out of range | wrong initial value
76 | wrong value | wrong value within range
77 | wrong value, only reset possible | only value reset possible
78 | not allowed in this state | not allowed in this state
79 | Setting lock is active | configuration lock mode is active
7A | wrong service | service (action) not valid
7B | parameter not active | parameter is inactive
7C | parameter system error | parameter system error
7D | communication error | communication error (e.g. buffer overrun)
7E | unknown service |
7F | unexpected character |
80 | no access rights | wrong access mode
81 | no adequately hardware |
82 | wrong object state | example: wrong execution mode (DeviceNet)
84 | no slave command |
85 | command to unknown slave |
87 | command to master only |
88 | only G command allowed |
89 | not supported |
8A | Not allowed: Internal sequencer is running |
8F | Not allowed: Entry already exists |
A0 | function is disabled |
A1 | already done |

Examples:

Open valve:
command | response
p:010F020000004 | p:00010F020000004
|  | error | 00 (successfully)
service | 01 (set) | service | 01 (set)
parameter | 0F020000 | parameter | 0F020000
Index | 00 | index | 00
Value | 4 | value | 4
Close valve:
command | response
p:010F020000003 | p:00010F020000003
|  | error | 00 (successfully)
service | 01 (set) | service | 01 (set)
parameter | 0F020000 | parameter | 0F020000
Index | 00 | index | 00
Value | 3 | value | 3
Position control:
command | response
p:010F020000002 | p:00010F020000002
|  | error | 00 (successfully)
service | 01 (set) | service | 01 (set)
parameter | 0F020000 | parameter | 0F020000
Index | 00 | index | 00
Value | 2 | value | 2
Set Target Position:
command | response
p:01110200000070.0 | p:0001110200000070.0
|  | error | 00 (successfully)
service | 01 (set) | service | 01 (set)
parameter | 11020000 | parameter | 11020000
Index | 00 | index | 00
Value | 70.0 | value | 70.0
Pressure control:
command | response
p:010F020000005 | p:00010F020000005
|  | error | 00 (successfully)
service | 01 (set) | service | 01 (set)
parameter | 0F020000 | parameter | 0F020000
Index | 00 | index | 00
Value | 5 | value | 5

Note:

•Pressure and position range depend on scaling settings. See chapter CPA Scaling for USB Communication. Otherwhise the relevant interface: Example serial interface see RS232/485 Scaling