Вы находитесь на странице: 1из 75

INDEX

INDEX

1. GENERAL INFORMATION..................................................................................................................... 9
1.1. Introduction.................................................................................................................................... 9

1.2. Frame structure and basic syntax information............................................................................9

1.3. Frame structure using “challenge” code (optional)..................................................................10

1.4. Challenge code algorithm (optional)..........................................................................................11

1.5. Returned command execution tag..............................................................................................12

1.6. Summary of available data tags..................................................................................................12

1.7. Summary of available command tags........................................................................................14

2. OPEN COMMANDS............................................................................................................................. 19
2.1. Introduction.................................................................................................................................. 19

2.2. General commands...................................................................................................................... 19

<BAUD>......................................................................................................................................................... 19

<LOGIN>........................................................................................................................................................ 20

<LOGOUT>.................................................................................................................................................... 20

<REBOOT>.................................................................................................................................................... 21

<TEST>.......................................................................................................................................................... 21

2.3. <SYSLOCK=x;y> (manage system lock)....................................................................................22

<SYSLOCK=GETKEY>................................................................................................................................. 22

<SYSLOCK=SETTOKEN;…>........................................................................................................................ 23

<SYSLOCK=STATUS>.................................................................................................................................. 24

3. USER LEVEL COMMAND.................................................................................................................... 25


3.1. Introduction.................................................................................................................................. 25

3.2. <GETM=x;yyy> (get realtime meter data)...................................................................................25

<GETM=…;A15>........................................................................................................................................... 25

TE550|truckIII Communication protocol – Programmer’s manual 3


INDEX

<GETM=…;ATGRS>..................................................................................................................................... 26

<GETM=…;ATNET>...................................................................................................................................... 27

<GETM=…;ATWGH>.................................................................................................................................... 28

<GETM=…;BULK>........................................................................................................................................ 29

<GETM=…;D>............................................................................................................................................... 30

<GETM=…;D15>........................................................................................................................................... 31

<GETM=…;DAD>.......................................................................................................................................... 32

<GETM=…;DATE>........................................................................................................................................ 33

<GETM=…;DLVN>........................................................................................................................................ 34

<GETM=…;ERR>.......................................................................................................................................... 35

<GETM=…;FLW>.......................................................................................................................................... 36

<GETM=…;HOSE>........................................................................................................................................ 37

<GETM=…;LDLV>*....................................................................................................................................... 38

<GETM=…;NCMP>....................................................................................................................................... 40

<GETM=…;NCMPR>..................................................................................................................................... 41

<GETM=…;P>............................................................................................................................................... 42

<GETM=…;PAD>.......................................................................................................................................... 43

<GETM=…;PCCW>....................................................................................................................................... 44

<GETM=…;PCW>......................................................................................................................................... 45

<GETM=…;PERR>........................................................................................................................................ 46

<GETM=…;PGRS>........................................................................................................................................ 47

<GETM=…;PIN >........................................................................................................................................ 48

<GETM=…;PNET>........................................................................................................................................ 49

<GETM=…;PPRC>........................................................................................................................................ 50

<GETM=…;PRD>.......................................................................................................................................... 51

<GETM=…;PRST>........................................................................................................................................ 52

<GETM=…;PWGH>....................................................................................................................................... 53

TE550|truckIII Communication protocol – Programmer’s manual 4


INDEX

<GETM=…;RET>........................................................................................................................................... 54

<GETM=…;STS>........................................................................................................................................... 55

<GETM=…;T>................................................................................................................................................ 56

<GETM=…;TAD>........................................................................................................................................... 57

<GETM=…;TGRS>........................................................................................................................................ 58

<GETM=…;TIME>......................................................................................................................................... 59

<GETM=…;TNET>........................................................................................................................................ 60

<GETM=…;TWGH>....................................................................................................................................... 61

<GETM=…;UPRC>........................................................................................................................................ 62

3.3. <GETP=x;yyy> (get realtime product data)................................................................................63

<GETP=…;A15>............................................................................................................................................ 63

<GETP=…;D15>............................................................................................................................................ 64

<GETP=…;DLVN>......................................................................................................................................... 65

<GETP=…;UPRC>........................................................................................................................................ 66

<GETP=…;TGRS>........................................................................................................................................ 67

<GETP=…;TNET>......................................................................................................................................... 68

<GETP=…;TWGH>....................................................................................................................................... 69

4. ADMINISTRATOR LEVEL COMMAND................................................................................................ 70


4.1. Introduction.................................................................................................................................. 70

4.2. <GET=x> (get specific system data)...........................................................................................70

<GET=CODE;…>.......................................................................................................................................... 70

<GET=DATE>................................................................................................................................................ 71

<GET=DLV;…;…>*........................................................................................................................................ 72

<GET=FWCHK;…;…>................................................................................................................................... 74

<GET=FWCP>............................................................................................................................................... 75

<GET=FWIO>................................................................................................................................................ 76

<GET=FWLK>............................................................................................................................................... 77

TE550|truckIII Communication protocol – Programmer’s manual 5


INDEX

<GET=FWM1>............................................................................................................................................... 78

<GET=FWM2>............................................................................................................................................... 79

<GET=IEV>................................................................................................................................................... 80

<GET=IEVX>................................................................................................................................................. 81

<GET=IN>...................................................................................................................................................... 82

<GET=INV>................................................................................................................................................... 83

<GET=LEV>.................................................................................................................................................. 84

<GET=LNG>.................................................................................................................................................. 85

<GET=OUT>.................................................................................................................................................. 86

<GET=PAR;…>............................................................................................................................................. 87

<GET=PARVXY;…;…>.................................................................................................................................. 88

<GET=PTCOM>............................................................................................................................................ 89

<GET=QEV;…;…>*....................................................................................................................................... 90

<GET=SHFN>................................................................................................................................................ 91

<GET=SHFT>................................................................................................................................................ 92

<GET=SNCP>............................................................................................................................................... 93

<GET=SNIO>................................................................................................................................................. 94

<GET=SNLK>................................................................................................................................................ 95

<GET=SNM1>............................................................................................................................................... 96

<GET=SNM2>............................................................................................................................................... 97

<GET=TIME>................................................................................................................................................. 98

<GET=WDTEST>.......................................................................................................................................... 99

4.3. <HMI=x;y> (user interface commands).....................................................................................100

<HMI=…;GRAB>......................................................................................................................................... 100

<HMI=…;KEYB;…>..................................................................................................................................... 101

<HMI=…;LOCK>.......................................................................................................................................... 102

<HMI=…;MSG;…;…;…>.............................................................................................................................. 103

TE550|truckIII Communication protocol – Programmer’s manual 6


INDEX

<HMI=…;REFRESH>.................................................................................................................................. 104

<HMI=…;RPIN;…;…>.................................................................................................................................. 105

<HMI=…;UNLOCK>..................................................................................................................................... 106

<HMI=…;UNLOCKDLV>.............................................................................................................................. 107

4.4. <READ=x;y> (read raw data).....................................................................................................108

<READ=EV;…;…>*..................................................................................................................................... 108

4.5. <SET=x;y> (set general data commands)*...............................................................................120

<SET=CODE;…>*....................................................................................................................................... 120

<SET=DATE;…>*........................................................................................................................................ 121

<SET=INVC;…;…;…>*................................................................................................................................ 122

<SET=INVE>*.............................................................................................................................................. 123

<SET=INVI>*............................................................................................................................................... 124

<SET=MRKEV;…;…>*................................................................................................................................ 125

<SET=PARE>*............................................................................................................................................. 126

<SET=PARI>*.............................................................................................................................................. 127

<SET=PARV;…;…>*................................................................................................................................... 128

<SET=PTCOM;…>*..................................................................................................................................... 129

<SET=TIME;…>*......................................................................................................................................... 130

4.6. <SETM=x;y> (set meter data)....................................................................................................131

<SETM=…;BULK>....................................................................................................................................... 131

<SETM=…;HOSE>...................................................................................................................................... 132

<SETM=…;NCMP;…>................................................................................................................................. 133

<SETM=…;NRET;…>.................................................................................................................................. 134

<SETM=…;PRD;…>.................................................................................................................................... 135

<SETM=…;PRST;…>.................................................................................................................................. 136

<SETM=…;RET>......................................................................................................................................... 137

5. APPENDIX......................................................................................................................................... 138

TE550|truckIII Communication protocol – Programmer’s manual 7


INDEX

5.1. Document revision history........................................................................................................ 138

5.2. Contacts...................................................................................................................................... 138

TE550|truckIII Communication protocol – Programmer’s manual 8


GENERAL INFORMATION

1. GENERAL INFORMATION

1.1. INTRODUCTION

The following information are referred to the firmware versions (where “xx” can be any number):
AK-1-TRK-xx-47-xx

The communication protocol of TE550|truckIII is based on 3 types of commands:

 Open commands: that can be performed without authentication


 User commands: that requires an authentication with Level1 password
 Admin commands: that requires an authentication with Level2 password

The first group can be used for test activity, the second group can be used to read basic information from the system,
the third group can be used to read advanced information and to setup the unit from remote.

1.2. FRAME STRUCTURE AND BASIC SYNTAX INFORMATION

The protocol is based on handhsking: the master (e.g. PC) sends a command frame to the TruckIII (slave) that sends
back an answer frame within a maximum time of 1000 ms. It is recommended to send commands to the register with a
minimum interval time of about 2 seconds between frames.

The command (TX) and answer (RX) frames are based on ASCII characters, with reserved characters to mark the
beginning and the end of each frame. The default communication settings are: 57600 baud, 8 data bit, 1 stop bit, no
parity.

The TX frame has the following structure:

@Nodeaddress<Command1=Argument1;Argument2;..><Command2=Argument1;Argument2;..><Command3
=Argument1;Argument2;..><Command4=Argument1;Argument2;..><CHK=checksum>[0x0D]

@ Start character of TX frame


Nodeaddress (Optional) Nodeaddress of the register the frame is addressed to
< ... > Tag delimiter (max 4 tags in a single frame)
Command Command to be executed
Argument Additional argument to the command
CHK Checksum tag (ASCII representation of hexadecimal XOR of all bytes, excluding checksum TAG itself)
[0x0D] End character (CR)

The RX frame has a similar structure, but with a different start character (#):

#Nodeaddress<Command1=Argument1;Argument2;..><Command2=Argument1;Argument2;..><Command3
=Argument1;Argument2;..><Command4=Argument1;Argument2;..><CHK=checksum>[0x0D]

TE550|truckIII Communication protocol – Programmer’s manual 9


GENERAL INFORMATION

1.3. FRAME STRUCTURE USING “CHALLENGE” CODE (OPTIONAL)

To increase the security level of the communication, a challenge code can be added to the frame.
The challenge code is a numeric code (6 digits) that is recalculated on every TX or RX frame, using a special algorithm
(see related paragraph for details).

In case of challenge code, the system will check it before processing any new frame: if the code is incorrect an error
message is returned, otherwise the command is processed using privileges related to the access code (level1/leve2)
intrinsically used to calculate the challenge. In this way there is no need to use <LOGIN> / <LOGOUT> commands
(see related paragraph for details). Moreover, the access code will never be transmitted on the line (to make any
“fraudulent” sniffer software - in parallel on the serial communication - useless).

The TX frame, with challenge code, has the following structure:

@Nodeaddress~Challenge<Command1=Argument1;Argument2;..><Command2=Argument1;Argument2;..
><Command3=Argument1;Argument2;..><Command4=Argument1;Argument2;..><CHK=checksum>[0x0D]

@ Start character of TX frame


Nodeaddress (Optional) Nodeaddress of the register the frame is addressed to
~ (Optional) Challenge delimiter
Challenge (Optional) Challenge code that has to be recalculated accordingly to the specific algorithm
< ... > Tag delimiter (max 4 tags in a single frame)
Command Command to be executed
Argument Additional argument to the command
CHK Checksum tag (ASCII representation of hexadecimal XOR of all bytes, excluding checksum TAG itself)
[0x0D] End character (CR)

The RX frame has a similar structure, but with a different start character (#):

#Nodeaddress~Challenge<Command1=Argument1;Argument2;..><Command2=Argument1;Argument2;..
><Command3=Argument1;Argument2;..><Command4=Argument1;Argument2;..><CHK=checksum>[0x0D]

TE550|truckIII Communication protocol – Programmer’s manual 10


GENERAL INFORMATION

TE550|truckIII Communication protocol – Programmer’s manual 11


GENERAL INFORMATION

1.4. RETURNED COMMAND EXECUTION TAG

The answer frame always include a Command Execution Tag as a feedback:

<CMD_OK=command> Command successfully executed


<CMD_ERR=command> Command syntax error
<CMD_UKN=command> Command unknown
<CMD_DEN=command> Command execution denied (required higher access level credentials)
<CMD_EXPT=command> Exception occurred during command execution
<CNG_ERR> Challenge code is incorrect (frame will be discarded)
<CHK_ERR> Checksum error on command frame

1.5. SUMMARY OF AVAILABLE DATA TAGS

The answer frame always include several Data Tags.


The following table summarize available format:

<A15=x> Alpha @15°C value


<ADDR=x> TE550 logical address
<CMP=x;y;z> Compartment [x] data: product [yy] and quantity [zzzzzz]
<D=x> Current density
<D15=x> Density @ 15°C
<DAD=x> Density value on A/D converter
<DATE=xx/xx/xx> Current system date
<DLVN=x> Delivery number
<EDATE=xx/xx/xx> End date
<ERR=x> Running error number
<ETIME=xx:xx:xx> End time
<EV=x; [RAW]….[/RAW]> Event raw data (on location [xxxxxx])
<EVN=x> Event location number
<FLW=x> Current flow rate
<FAVG=x> Average flow rate of the delivery
<FMAX=x> Maximum flow rate of the delivery
<FMIN=x> Minimum flow rate of the delivery
<FSTB=x> Flow rate with highest stability rate

TE550|truckIII Communication protocol – Programmer’s manual 12


GENERAL INFORMATION

<FWCP=x> CPU firmware version


<FWIO=x> IO firmware version
<FWLK=x> LKI firmware version
<FWM1=x> CMOD1 firmware version
<FWM2=x> CMOD2 firmware version
<IEV=x;y> Event index information: event type [yy] on location [xxxxx]
<IN=x> Exadecimal status of system digital inputs
<INVN=x> Loading plan number
<LEV=x> Current login authorization level
<LNG=x> Current language ID
<MRKEV=x> Event marker flag (see QEV command)
<MTR=x> Meter number
<OUT=x> Exadecimal status of digital outputs
<P=x> Current pressure
<PAD=x> Current pressure on A/D converter
<PARA=x> Parameter access level
<PARC1=x> Number ID of clashed parameter #1
<PARC2=x> Number ID of clashed parameter #2
<PARN=x> Parameter number
<PART=x> Parameter type (exadecimal)
<PARV=x> Parameter value
<PCCW=x> Counterclockwise pulses counter
<PCW=x> Clockwise pulses counter
<PERR=x> Spurious pulses counter
<PEV=x> Current event location in use
<PGRS=x> Partial gross volume
<PIN=x> Meter PIN code (manually inserted by the user)
<PNET=x> Partial net volume
<PPRC=x> Final price of delivered quantity
<PRADDR=x> Address of PRODUCTS data structure (RAM memory)
<PRD=x> Product ID number
<PRDR=x> ID number of returned product (in case of "product return" delivery)
<PRNSTR=x> Number of string records used for PRINTER text
<PRST=x> Preset quantity
<PTCOM=x> COM-Passthrough status (1=on, 0=off)

TE550|truckIII Communication protocol – Programmer’s manual 13


GENERAL INFORMATION

<PWGH=x> Partial mass (weight)


<RET=x> Product return status (1=on, 0=off)
<SCREEN=x;[RAW] ….[/RAW]> Bitmap raw data of current LKI screen [x=meter screen number]
<SDATE=xx/xx/xx> Start date
<SHFN=x> Shift number
<SNCP=x> CPU serial number
<SNIO=x> IO serial number
<SNLK=x> LKI serial number
<SNM1=x> CMOD1 serial number
<SNM2=x> CMOD2 serial number
<STIME=xx:xx:xx> Start time
<STS=x> Meter status
<T=x> Current temperature
<TAD=x> Current temperature on A/D converter
<TGRS=x> Gross volume totalizer
<TIME=xx:xx:xx> System current time
<TNET=x> Net volume totalizer
<TSTB=x> Timer (duration in cycle) related to the flow rate with highest stability rate
<TWGH=x> Mass (weight) totalizer
<UPRC=x> Unit price

1.6. SUMMARY OF AVAILABLE COMMAND TAGS

The command frame can include up to 4 Command Tags.


The following table summarize available commands:

Open Commands

<BAUD=newbaud> Change baud rate setting


<LOGIN=user;password> System log-in with [user] and [password]
<LOGOUT> System log-out
<REBOOT> Reboot system

<SYSLOCK=…;…> command Commands to handle SYSLOCK status


Eg. <SYSLOCK=GETKEY> GETKEY Read SYSLOCK key + firmware

TE550|truckIII Communication protocol – Programmer’s manual 14


GENERAL INFORMATION

SETTOKEN Set SYSLOCK token to unlock the system


STATUS Read SYSLOCK status (1:locked, 0:unlocked)

User Level Commands


<GETM=meter;command> command
Eg. <GETM=1;A15> A15 Alpha@15°C of current meter product
BULK Bulk flag status
D Density of current meter product
D15 Density@15°C of current meter product
DAD Density on A/D converter of current meter product
DATE Current system date
DLVN Delivery number of current meter product
ERR Error number (in case of meter error)
FLW Meter flow rate
HOSE Hosereel flag status
LDLV Latest delivery data
NCMP Number of selected source compartment
NCMPR Number of selected return compartment
P Pressure
PAD Pressure on A/D converter
PCCW Counterclockwise pulses counter
PCW Clockwise pulses counter
PERR Spurious pulses counter
PGRS Partial gross volume of current meter product
PIN PIN Code
PNET Partial net volume of current meter product
PPRC Price of delivered quantity
PRD Product currently selected on the meter
PRST Preset quantity
PWGH Partial mass (weight) of current meter product
RET Return flag status
STS Meter status
T Temperature
TAD Temperature on A/D converter
TGRS Total gross volume of current meter product

TE550|truckIII Communication protocol – Programmer’s manual 15


GENERAL INFORMATION

TIME Current system time


TNET Total net volume of current meter product
TWGH Total mass (weight) of current meter product
UPRC Unit price of current meter product

<GETP=product;command> command
e.g. <GETP=1;TNET> A15 Alpha@15°C
D15 Density@15°C
DLVN Delivery number
UPRC Unit price
TGRS Total gross volume
TNET Total net volume
TWGH Total mass (weight)
Administrator Level Commands
<GET=command> command
e.g. <GET=CODE;1> DATE Current system date
DLV;prod;number Data related to delivery [number] of product [prod]
FWCP CPU firmware
FWIO IO firmware
FWLK LKI firmware
FWM1 CMOD1 firmware
FWM2 CMOD2 firmware
IEV Event index
IN Status of digital inputs
INV Current inventary data
LEV Current login authorization level
LNG Current language ID
OUT Status of digital outputs
PAR;number Parameter [number] value
PTCOM COM-Passthrough status
QEV Enquque oldest event with marker = 1
SHFN Shift number
SNCP CPU serial number
SNIO IO serial number
SNLK LKI serial number

TE550|truckIII Communication protocol – Programmer’s manual 16


GENERAL INFORMATION

SNM1 CMOD1 serial number


SNM2 CMOD2 serial number
TIME Current system time

<HMI=display;command> command
e.g. <HMI=1;GRAB> GRAB Meter screenshot
KEYB;key Simulate keypressed [key]
LOCK Lock screen
MSG;line1;line2;icon Show custom message
REFRESH Force screen refresh
RPIN;line1;line2 Ask PIN code, with custom message
UNLOCK Unlock screen
UNLOCKDLV Unlock screen and jump to delivery

<READ=command> command
e.g. <READ=EV;1> EV;[loc] Get raw data of event location [loc]

<SET=command> command
e.g. <SET=INVI> DATE;dd/mm/yy Set system date
INVC;comp;prod;qty Set inventory data
INVE Close inventory setup,
INVI Reset current inventory and start inventory setup
MRKEV;loc;mrk Set marker status [mrk] of selected event location
PARE Close parameters setup,
PARI Inizializate parameters setup
PARV;par;xxxxxxxxx Write parameter [par] value
TIME;hh:mm:ss Set system time

<SETM=meter;command> command
e.g. <SETM=1;PRS;1000> BULK Select BULK DELIVERY mode
HOSE Select HOSEREEL DELIVERY mode
NCMP;compartment Select source compartment (1..6)
NRET;compartment Select return compartment (1..6)
PRD;product Select meter product (1..6)
PRST;preset Set preset quantity

TE550|truckIII Communication protocol – Programmer’s manual 17


GENERAL INFORMATION

RET Select PRODUCT RETURN mode

TE550|truckIII Communication protocol – Programmer’s manual 18


USER LEVEL COMMANDS

2. OPEN COMMANDS

2.1. INTRODUCTION

This section describes all commands that can be performed even without log-in requirements. It includes commands
for basic communication test, and to get access to the system.

2.2. GENERAL COMMANDS

<BAUD>
Description:
change the communication line baudrate to the specified value

Syntax:

<BAUD=baudrate>

Arguments:

baudrate Communication baudrate:


1200
2400
4800
9600
19200
38400
57600
115200

Example:

@1<BAUD=1200><CHK=5F>
#1<CMD_OK=BAUD><CHK=2E>

TE550|truckIII Communication protocol – Programmer’s manual 19


USER LEVEL COMMANDS

<LOGIN>
Description:
perform system login using credentials passed through arguments

Syntax:

<LOGIN=level;password>

Arguments:

level Select access level (Lev1=User, Lev2=Administrator):


LEVEL1
LEVEL2
Password Password related to the specified access level.
(same code used to manually access to the system on the LKI unit)

Example:

@1<LOGIN=LEVEL2;222222><CHK=52>
#1<CMD_OK=LOGIN><CHK=7F>

<LOGOUT>
Description:
perform system logout

Syntax:

<LOGOUT>

Arguments:
none

Example:

@1<LOGOUT><CHK=79>
#1<CMD_OK=LOGOUT><CHK=36>

TE550|truckIII Communication protocol – Programmer’s manual 20


USER LEVEL COMMANDS

<REBOOT>
Description:
force a system reboot

Syntax:

<REBOOT>

Arguments:
none

Example:

@1<REBOOT><CHK=72>
#1<CMD_OK=REBOOT><CHK=6F>

<TEST>
Description:
test command to check communication line

Syntax:

<TEST>

Arguments:
none

Example:

@1<TEST><CHK=65>
#1<CMD_OK=TEST><CHK=2A>

TE550|truckIII Communication protocol – Programmer’s manual 21


USER LEVEL COMMANDS

2.3. <SYSLOCK=X;Y> (MANAGE SYSTEM LOCK)

<SYSLOCK=GETKEY>
Description:
Read error key in case of locked system due to multiple (eg. >3) errors on setup menu login (if enabled).
Please note that the error key is also printed on LKI screen.

See <SYSLOCK=SETTOKEN;…> for further details.

Syntax:

<SYSLOCK=GETKEY>

Arguments:

None

Answer tags:

Error key xxxxxxxxx (9 digits)


<SYSLOCK=KEY;xxxxx;yyyyy>
Firmware version yy-y-TRK-yy-yy-yy (17 digits)

Example:

@1<SYSLOCK=GETKEY> #1<SYSLOCK=KEY;026915401;AK-
1-TRK-00-29-35-12>

TE550|truckIII Communication protocol – Programmer’s manual 22


USER LEVEL COMMANDS

<SYSLOCK=SETTOKEN;…>
Description:
Set acknowledge token to restore the system in case of locked status due to multiple (eg. >3) errors on setup menu
login (if enabled). Please note that the token can be also manually inputted on LKI screen.

See <SYSLOCK=GETKEY> for further details.

Syntax:

<SYSLOCK=SETTOKEN;code>

Arguments:

code Acknowledge token calculated from the error key: xxxxxxxxx (9 digits)

Answer tags:

<SYSLOCK=TOKEN;result> Feedback related to token validation:


result = OK, token validated => system restored
result = ERR, token not valid => system locked

Example:

@1<SYSLOCK=SETTOKEN;055612231>
#1<SYSLOCK=TOKEN;OK>

TE550|truckIII Communication protocol – Programmer’s manual 23


USER LEVEL COMMANDS

<SYSLOCK=STATUS>
Description:
Check SYSLOCK status: if the system has been locked, then the SYSLOCK status is set to 1.
Standard value is stauts set to 0.

See <SYSLOCK=GETKEY> for further details.

Syntax:

<SYSLOCK=STATUS>

Arguments:
none

Answer tags:

<SYSLOCK=STATUS;result> Status of SYSLOCK:


0 = system is NOT locked, normal status
1 = system is LOCKED
2 = token correctly received, reboot system to UNLOCK

Example:

@1<SYSLOCK=STATUS>
#1<SYSLOCK=STATUS;0>

TE550|truckIII Communication protocol – Programmer’s manual 24


USER LEVEL COMMANDS

3. USER LEVEL COMMAND

3.1. INTRODUCTION

This section describes all commands that can be performed with User Level credential (see <LOGIN> command for
details). It includes commands to get realtime data related to meters and products.

3.2. <GETM=X;YYY> (GET REALTIME METER DATA)

<GETM=…;A15>
Description:
Read information about alpha coefficient @15°C of the product currently selected on the meter

Syntax:

<GETM=meter;A15>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<A15=x> Alpha coefficient @15°C

Example:

@1<GETM=1;A15><CHK=1A>
#1<MTR=1><A15=0.003><CHK=00>

TE550|truckIII Communication protocol – Programmer’s manual 25


USER LEVEL COMMANDS

<GETM=…;ATGRS>
Description:
Read accumulated gross volume total of the meter.
The accumulated totalizer is calculated summing relative totals of all products associated to the selected meter.

Syntax:

<GETM=meter; ATGRS>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<ATGRS=x> Accumulated gross volume total (same unit of measure used on display/ticket)

Example:

@1<GETM=1;ATGRS><CHK=4D>
#1<MTR=1><ATGRS=21003088.85><CHK=68>

TE550|truckIII Communication protocol – Programmer’s manual 26


USER LEVEL COMMANDS

<GETM=…;ATNET>
Description:
Read accumulated net volume total of the meter.
The accumulated totalizer is calculated summing relative totals of all products associated to the selected meter.

Syntax:

<GETM=meter; ATNET>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<ATNET=x> Accumulated net volume total (same unit of measure used on display/ticket)

Example:

@1<GETM=1;ATNET><CHK=4D>
#1<MTR=1><ATNET=21003088.85><CHK=68>

TE550|truckIII Communication protocol – Programmer’s manual 27


USER LEVEL COMMANDS

<GETM=…;ATWGH>
Description:
Read accumulated weight total of the meter.
The accumulated totalizer is calculated summing relative totals of all products associated to the selected meter.

Syntax:

<GETM=meter; ATWGH>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<ATWGH=x> Accumulated weight total (same unit of measure used on display/ticket)

Example:

@1<GETM=1;ATWGH><CHK=4D>
#1<MTR=1><ATWGH=21003088.85><CHK=68>

TE550|truckIII Communication protocol – Programmer’s manual 28


USER LEVEL COMMANDS

<GETM=…;BULK>
Description:
Read status of bulk delivery flag

Syntax:

<GETM=meter;BULK>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<BULK=x> Bulk flag status :
0 = bulk mode not selected
1 = bulk mode selected

Example:

@1<GETM=1;BULK><CHK=4F>
#1<MTR=1><BULK=0><CHK=48>

TE550|truckIII Communication protocol – Programmer’s manual 29


USER LEVEL COMMANDS

<GETM=…;D>
Description:
Read real-time density value of the product selected on the meter

Syntax:

<GETM=meter;D>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<D=x> Density of the product in kg/m3

Example:

@1<GETM=1;D><CHK=1B>
#1<MTR=1><D=765.00><CHK=36>

TE550|truckIII Communication protocol – Programmer’s manual 30


USER LEVEL COMMANDS

<GETM=…;D15>
Description:
Read density @15°C of the product selected on the meter

Syntax:

<GETM=meter;D15>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<D15=x> Density @15°C of the product in kg/m3

Example:

@1<GETM=1;D15><CHK=1F>
#1<MTR=1><D15=765.000><CHK=02>

TE550|truckIII Communication protocol – Programmer’s manual 31


USER LEVEL COMMANDS

<GETM=…;DAD>
Description:
Read raw data from the A/D converter connected to the density probe of the meter

Syntax:

<GETM=meter;DAD>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<DAD=x> Raw data (0.. 1024) from A/D converter

Example:

@1<GETM=1;DAD><CHK=1E>
#1<MTR=1><DAD=0000><CHK=29>

TE550|truckIII Communication protocol – Programmer’s manual 32


USER LEVEL COMMANDS

<GETM=…;DATE>
Description:
Read system date

Syntax:

<GETM=meter;DATE>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<DATE=x> System date (dd/mm/yy)

Example:

@1<GETM=1;DATE><CHK=4B>
#1<MTR=1><DATE=20/01/15><CHK=7B>

TE550|truckIII Communication protocol – Programmer’s manual 33


USER LEVEL COMMANDS

<GETM=…;DLVN>
Description:
Read delivery number of the latest/current delivery of the product selected on the meter

Syntax:

<GETM=meter;DLVN>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<DLVN=x> Delivery number of the product selected on the meter

Example:

@<GETM=1;DLVN><CHK=7E>
#1<MTR=1><DLVN=9><CHK=41>

TE550|truckIII Communication protocol – Programmer’s manual 34


USER LEVEL COMMANDS

<GETM=…;ERR>
Description:
Read error code (in case of errors detected on the meter)

Syntax:

<GETM=meter;ERR>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<ERR=x> Error code (x) - 0: no errors

Example:

@1<GETM=1;ERR><CHK=1A>
#1<MTR=1><ERR=0><CHK=1D>

TE550|truckIII Communication protocol – Programmer’s manual 35


USER LEVEL COMMANDS

<GETM=…;FLW>
Description:
Read meter flow rate

Syntax:

<GETM=meter;FLW>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<FLW=x> Flow rate value

Example:

@1<GETM=1;FLW><CHK=02>
#1<MTR=1><FLW=386><CHK=08>

TE550|truckIII Communication protocol – Programmer’s manual 36


USER LEVEL COMMANDS

<GETM=…;HOSE>
Description:
Read status of hosereel delivery flag

Syntax:

<GETM=meter;HOSE>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<HOSE=x> Hosereel delivery flag:
0: not selected
1: selected

Example:

@1<GETM=1;HOSE><CHK=4E>
#1<MTR=1><HOSE=1><CHK=48>

TE550|truckIII Communication protocol – Programmer’s manual 37


USER LEVEL COMMANDS

<GETM=…;LDLV>*
Description:
Read data related to latest delivery of the meter
(*) The execution of this command is denied in case of running deliveries

Syntax:

<GETM=meter;LDLV>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<EVN=x> Event number (memory location used to store the delivery)
<PRD=x> Product number
<RET=x> Product return flag:
0 = normal delivery
1 = product return delivery
<DLVN=x> Delivery number
<SDATE=x> Start date
<STIME=x> Start time
<EDATE=x> End date
<ETIME=x> End time
<PRST=x> Preset quantity
<PGRS=x> Partial delivery quantity - gross volume
<PNET=x> Partial delivery quantity – net volume
<PWGH=x> Partial delivery quantity – mass
<TGRS=x> Total – gross volume
<TNET=x> Total – net volume
<TWGH=x> Total – mass
<T=x> Average temperature
<D=x> Average density
<P=x> Average pressure
<SCMP=x> Compartment opening sequence (max 10 chars)
<FMIN=x> Flow rate statistics: minimum flow
<FAVG=x> Flow rate statistics: average flow

TE550|truckIII Communication protocol – Programmer’s manual 38


USER LEVEL COMMANDS

<FMAX=x> Flow rate statistics: maximum flow


<FSTB=x> Flow rate with the highest stability rate
<TSTB=x> Timer (duration in “cycles”, 1 cycle = about 0.7s) related to the flow rate with highest stability rate
<NSTO=x> Number of stops/poweroff occurred during the delivery (0xHL: H=poweroff, L=stops)
<DEND=x> In case of unexpected delivery stop, this field indicates the cause
1=spurious pulses
2=pulse timout
3=manual stop
4=power off
5= temperature error
6=hardware error
8=external permissive/alarm
9=deadman timeout

<PIN=x> PIN inserted by the operator before starting the delivery (if any)
<MARKEV=x> Event marker flag (see QEV command).
<LCS=x> Status of LCSound sensor at the end of the delivery (1=wet, 0=dry)

Example:

@1<GETM=1;LDLV><CHK=4D>
#1<MTR=1><EVN=44><MTR=1><PRD=1><RET=0><DLVN=10><SDATE=20/01/15><STIME=12:27:19><EDATE=2
0/01/15><ETIME=13:38:05><PRST=4000.00><PGRS=4000.65><TGRS=6088.06><PNET=3962.29><TNET=6
049.50><PWGH=3031.15><TWGH=4627.84><T=23.20><D=675.00><P=0><SCMP=224R><FMIN=10.2><FAVG=
240.30><FMAX=700.4><FSTB=695.3><TSTB=24><NSTO=02><DEND=4><PIN=0><MARKEV=0><LCS=1><CHK=0
8>

TE550|truckIII Communication protocol – Programmer’s manual 39


USER LEVEL COMMANDS

<GETM=…;NCMP>
Description:
Read number of selected source compartment for the meter

Syntax:

<GETM=meter;NCMP>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<NCMP=x> Number of selected compartment
(1-6): active compartment
100: no selected compartments

Example:

@1<GETM=1;NCMP><CHK=4F>
#1<MTR=1><NCMP=2><CHK=4A>

TE550|truckIII Communication protocol – Programmer’s manual 40


USER LEVEL COMMANDS

<GETM=…;NCMPR>
Description:
Read number of selected return compartment for the meter

Syntax:

<GETM=meter;NCMPR>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<NRET=x> Number of selected compartment for product return
(1-6): active compartment
100: no selected compartments

Example:

@1<GETM=1;NCMPR><CHK=1D>
#1<MTR=1><NCMPR=1><CHK=1B>

TE550|truckIII Communication protocol – Programmer’s manual 41


USER LEVEL COMMANDS

<GETM=…;P>
Description:
Read real-time pressure value from the pressure probe of the meter

Syntax:

<GETM=meter;P>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<P=x> Realtime pressure value (psig)

Example:

@1<GETM=1;P><CHK=0F>
#1<MTR=1><P=0.00><CHK=26>

TE550|truckIII Communication protocol – Programmer’s manual 42


USER LEVEL COMMANDS

<GETM=…;PAD>
Description:
Read raw data from the A/D converter connected to pressure probe (4-20mA) of the meter

Syntax:

<GETM=meter;PAD>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PAD=x> Raw data (0.. 1024) from A/D converter

Example:

@1<GETM=1;P><CHK=0F>
#1<MTR=1><P=0.00><CHK=26>

TE550|truckIII Communication protocol – Programmer’s manual 43


USER LEVEL COMMANDS

<GETM=…;PCCW>
Description:
Read counter-clockwise pulses counter of the meter

Syntax:

<GETM=meter; PCCW>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PCCW=x> Counter-clockwise pulses counter

Example:

@1<GETM=1;PCCW><CHK=58>
#1<MTR=1><PCCW=0><CHK=5F>

TE550|truckIII Communication protocol – Programmer’s manual 44


USER LEVEL COMMANDS

<GETM=…;PCW>
Description:
Read clockwise pulses counter of the meter

Syntax:

<GETM=meter; PCW>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PCW=x> Clockwise pulses counter

Example:

@1<GETM=1;PCW><CHK=1B>
#1<MTR=1><PCW=62629><CHK=15>

TE550|truckIII Communication protocol – Programmer’s manual 45


USER LEVEL COMMANDS

<GETM=…;PERR>
Description:
Read spurious/error pulses counter of the meter

Syntax:

<GETM=meter; PERR>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PERR=x> Spurious/Error pulses counter

Example:

@1<GETM=1;PERR><CHK=4A>
#1<MTR=1><PERR=0><CHK=4D>

TE550|truckIII Communication protocol – Programmer’s manual 46


USER LEVEL COMMANDS

<GETM=…;PGRS>
Description:
Read partial delivered gross volume of the meter

Syntax:

<GETM=meter; PGRS>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PGRS=x> Partial delivered gross volume (same unit of measure used on display/ticket)

Example:

@1<GETM=1;PGRS><CHK=49>
#1<MTR=1><PGRS=2012.70><CHK=56>

TE550|truckIII Communication protocol – Programmer’s manual 47


USER LEVEL COMMANDS

<GETM=…;PIN>
Description:
Read PIN code (if any) inserted on the display of the meter.
See command <HMI=...;RPIN;...;...> for further details.

Syntax:

<GETM=meter; PIN>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PIN=x> PIN code

Example:

@1<GETM=1;PIN><CHK=08>
#1<MTR=1><PIN=123456><CHK=38>

TE550|truckIII Communication protocol – Programmer’s manual 48


USER LEVEL COMMANDS

<GETM=…;PNET>
Description:
Read partial delivered net volume of the meter

Syntax:

<GETM=meter; PNET>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PNET=x> Partial delivered net volume (same unit of measure used on display/ticket)

Example:

@1<GETM=1;PNET><CHK=50>
#1<MTR=1><PNET=3973.28><CHK=4D>

TE550|truckIII Communication protocol – Programmer’s manual 49


USER LEVEL COMMANDS

<GETM=…;PPRC>
Description:
Read price of delivered quantity of the meter

Syntax:

<GETM=meter; PPRC>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PPRC=x> Price of delivered quantity

Example:

@1<GETM=1;PPRC><CHK=4E>
#1<MTR=1><PPRC=4000.79><CHK=5D>

TE550|truckIII Communication protocol – Programmer’s manual 50


USER LEVEL COMMANDS

<GETM=…;PRD>
Description:
Read number of product selected on the meter

Syntax:

<GETM=meter; PRD>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PRD=x> Number of selected product

Example:

@1<GETM=1;PRD><CHK=19>
#1<MTR=1><PRD=1><CHK=1F>

TE550|truckIII Communication protocol – Programmer’s manual 51


USER LEVEL COMMANDS

<GETM=…;PRST>
Description:
Read preset quantity of the meter

Syntax:

<GETM=meter; PRST>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PRST=x> Preset quantity (referred to the selected quantity as per TE550 configuration)

Example:

@1<GETM=1;PRST><CHK=5A>
#1<MTR=1><PRST=4000.00><CHK=47>

TE550|truckIII Communication protocol – Programmer’s manual 52


USER LEVEL COMMANDS

<GETM=…;PWGH>
Description:
Read partial delivered mass (weight) of the meter

Syntax:

<GETM=meter; PWGH>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<PWGH=x> Partial delivered mass/weight (same unit of measure used on display/ticket)

Example:

@1<GETM=1;PWGH><CHK=57>
#1<MTR=1><PWGH=3039.56><CHK=44>

TE550|truckIII Communication protocol – Programmer’s manual 53


USER LEVEL COMMANDS

<GETM=…;RET>
Description:
Read product return flag status of the meter

Syntax:

<GETM=meter; RET>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<RET=x> Product return delivery status:
0: product return not selected
1: product return selected

Example:

@1<GETM=1;RET><CHK=1C>
#1<MTR=1><RET=0><CHK=1B>

TE550|truckIII Communication protocol – Programmer’s manual 54


USER LEVEL COMMANDS

<GETM=…;STS>
Description:
Read status code of the meter

Syntax:

<GETM=meter; STS>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<STS=x> Meter statis:
0: system boot
1: delivery in progress – no pulses
2: delivery in progress – high flow
3: delivery in progress – low flow
4: error
5: delivery in progress – stop
6: delivery in progress – waiting for start
7: leakage
8: delivery in progress – pump start
9: alarm / permissive error
10: delivery in progress – closing valves / end of delivery
21: pin request
22: preset screen
23: ticket printing
27: inventory setup (loading phase)
30: system setup
40: locked

Example:

@1<GETM=1;STS><CHK=0B>
#1<MTR=1><STS=22><CHK=3C>

TE550|truckIII Communication protocol – Programmer’s manual 55


USER LEVEL COMMANDS

<GETM=…;T>
Description:
Read realtime temperature value of the meter

Syntax:

<GETM=meter; T>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<T=x> Realtime temperature value (same unit of measure used on display/ticket)

Example:

@1<GETM=1;T><CHK=0B>
#1<MTR=1><T=20.76><CHK=11>

TE550|truckIII Communication protocol – Programmer’s manual 56


USER LEVEL COMMANDS

<GETM=…;TAD>
Description:
Read raw data of A/D converter that get realtime temperature value of the meter

Syntax:

<GETM=meter; TAD>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<TAD=x> Raw data (0..1024) of temperature A/D

Example:

@1<GETM=1;TAD><CHK=0E>
#1<MTR=1><TAD=0000><CHK=39>

TE550|truckIII Communication protocol – Programmer’s manual 57


USER LEVEL COMMANDS

<GETM=…;TGRS>
Description:
Read gross volume total of the meter

Syntax:

<GETM=meter; TGRS>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<TGRS=x> Gross volume total (same unit of measure used on display/ticket)

Example:

@1<GETM=1;TGRS><CHK=4D>
#1<MTR=1><TGRS=10088.85><CHK=68>

TE550|truckIII Communication protocol – Programmer’s manual 58


USER LEVEL COMMANDS

<GETM=…;TIME>
Description:
Read system time

Syntax:

<GETM=meter; TIME>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<TIME=x> System time (hh:mm:ss)

Example:

@1<GETM=1;TIME><CHK=4A>
#1<MTR=1><TIME=18:42:16><CHK=75>

TE550|truckIII Communication protocol – Programmer’s manual 59


USER LEVEL COMMANDS

<GETM=…;TNET>
Description:
Read net volume total of the meter

Syntax:

<GETM=meter; TNET>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<TNET=x> Net volume total (same unit of measure used on display/ticket)

Example:

@1<GETM=1;TNET><CHK=54>
#1<MTR=1><TNET=10022.78><CHK=73>

TE550|truckIII Communication protocol – Programmer’s manual 60


USER LEVEL COMMANDS

<GETM=…;TWGH>
Description:
Read net volume total of the meter

Syntax:

<GETM=meter; TWGH>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<TWGH=x> Mass/weight total (same unit of measure used on display/ticket)

Example:

@1<GETM=1;TWGH><CHK=53>
#1<MTR=1><TWGH=7667.40><CHK=4E>

TE550|truckIII Communication protocol – Programmer’s manual 61


USER LEVEL COMMANDS

<GETM=…;UPRC>
Description:
Read price per unit of the product selected on the meter

Syntax:

<GETM=meter; UPRC>

Arguments:

meter Meter number:


1
2

Answer tags:

<MTR=x> Selected meter


<UPRC=x> Price per unit

Example:

@1<GETM=1;UPRC><CHK=4B>
#1<MTR=1><UPRC=1.000><CHK=53>

TE550|truckIII Communication protocol – Programmer’s manual 62


USER LEVEL COMMANDS

3.3. <GETP=X;YYY> (GET REALTIME PRODUCT DATA)

<GETP=…;A15>
Description:
Read information about alpha coefficient @15°C of the product

Syntax:

<GETP=product;A15>

Arguments:

product Product number: 1..6

Answer tags:

<PRD=x> Selected product number


<A15=x> Alpha coefficient @15°C

Example:

@1<GETP=1;A15><CHK=07>
#1<PRD=1><A15=0.003><CHK=0D>

TE550|truckIII Communication protocol – Programmer’s manual 63


USER LEVEL COMMANDS

<GETP=…;D15>
Description:
Read information about density@15°C of the product

Syntax:

<GETP=product;D15>

Arguments:

product Product number: 1..6

Answer tags:

<PRD=x> Selected product number


<D15=x> Density @15°C in kg/m3

Example:

@1<GETP=1;D15><CHK=02>
#1<PRD=1><D15=765.000><CHK=0F>

TE550|truckIII Communication protocol – Programmer’s manual 64


USER LEVEL COMMANDS

<GETP=…;DLVN>
Description:
Read number of latest performed delivery of the product

Syntax:

<GETP=product;DLVN>

Arguments:

product Product number: 1..6

Answer tags:

<PRD=x> Selected product number


<DLVN=x> Number of latest performed delivery

Example:

@1<GETP=1;DLVN><CHK=52>
#1<PRD=1><DLVN=11><CHK=75>

TE550|truckIII Communication protocol – Programmer’s manual 65


USER LEVEL COMMANDS

<GETP=…;UPRC>
Description:
Read price per unit of the product

Syntax:

<GETP=product;UPRC>

Arguments:

product Product number: 1..6

Answer tags:

<PRD=x> Selected product number


<UPRC=x> Price per unit of the product

Example:

@1<GETP=1;UPRC><CHK=56>
#1<PRD=1><UPRC=1.000><CHK=5E>

TE550|truckIII Communication protocol – Programmer’s manual 66


USER LEVEL COMMANDS

<GETP=…;TGRS>
Description:
Read total gross volume of the product

Syntax:

<GETP=product;TGRS>

Arguments:

product Product number: 1..6

Answer tags:

<PRD=x> Selected product number


<TGRS=x> Total gross volume of the product (same unit of measure used on display/ticket)

Example:

@1<GETP=1;TGRS><CHK=50>
#1<PRD=1><TGRS=10088.85><CHK=65>

TE550|truckIII Communication protocol – Programmer’s manual 67


USER LEVEL COMMANDS

<GETP=…;TNET>
Description:
Read total net volume of the product

Syntax:

<GETP=product;TNET>

Arguments:

product Product number: 1..6

Answer tags:

<PRD=x> Selected product number


<TNET=x> Total gross net of the product (same unit of measure used on display/ticket)

Example:

@1<GETP=1;TNET><CHK=49>
#1<PRD=1><TNET=10022.78><CHK=7E>

TE550|truckIII Communication protocol – Programmer’s manual 68


USER LEVEL COMMANDS

<GETP=…;TWGH>
Description:
Read total mass/weight of the product

Syntax:

<GETP=product;TWGH>

Arguments:

product Product number: 1..6

Answer tags:

<PRD=x> Selected product number


<TWGH=x> Total mass/weight t of the product (same unit of measure used on display/ticket)

Example:

@1<GETP=1;TWGH><CHK=4E>
#1<PRD=1><TWGH=7667.40><CHK=43>

TE550|truckIII Communication protocol – Programmer’s manual 69


ADMINISTRATOR LEVEL COMMANDS

4. ADMINISTRATOR LEVEL COMMAND

4.1. INTRODUCTION

This section describes all commands that can be performed with Admin Level credential (see <LOGIN> command for
details). It includes commands to read/write inventory data, configuration, log memory and remote presetting.

4.2. <GET=X> (GET SPECIFIC SYSTEM DATA)

<GET=CODE;…>
Description:
Get system password
(*) The execution of this command is denied in case of running deliveries

Syntax:

<GET=CODE;level>

Arguments:

Level Select password to be changed (1=Level1, 2=Level2)

Answer tags:

<CODE=level;password> Return [password] associated to [level]

Example:

@1<GET=CODE;1><CHK=B0>
#1<CODE=1;111111><CHK=7E>

TE550|truckIII Communication protocol – Programmer’s manual 70


ADMINISTRATOR LEVEL COMMANDS

<GET=DATE>
Description:
Read system date

Syntax:

<GET=DATE>

Arguments:

None

Answer tags:

<DATE=x> System date (dd/mm/yy)

Example:

@1<GET=DATE><CHK=0C>
#1<DATE=21/01/15><CHK=3F>

TE550|truckIII Communication protocol – Programmer’s manual 71


ADMINISTRATOR LEVEL COMMANDS

<GET=DLV;…;…>*
Description:
Read data related to a specific delivery (filtered by product and delivery number)
(*) The execution of this command is denied in case of running deliveries

Syntax:

<GET=DLV;product;number>

Arguments:

product Number of the delivered product


number Delivery number

Answer tags:

<MTR=x> Selected meter


<EVN=x> Event number (memory location used to store the delivery)
<PRD=x> Product number
<RET=x> Product return flag:
0 = normal delivery
1 = product return delivery
<DLVN=x> Delivery number
<SDATE=x> Start date
<STIME=x> Start time
<EDATE=x> End date
<ETIME=x> End time
<PRST=x> Preset quantity
<PGRS=x> Partial delivery quantity - gross volume
<PNET=x> Partial delivery quantity – net volume
<PWGH=x> Partial delivery quantity – mass
<TGRS=x> Total – gross volume
<TNET=x> Total – net volume
<TWGH=x> Total – mass
<T=x> Average temperature
<D=x> Average density
<P=x> Average pressure
<INVN=x> Loading plan number
<SCMP=x> Compartment opening sequence (max 10 chars)
<FMIN=x> Flow rate statistics: minimum flow
<FAVG=x> Flow rate statistics: average flow

TE550|truckIII Communication protocol – Programmer’s manual 72


ADMINISTRATOR LEVEL COMMANDS

<FMAX=x> Flow rate statistics: maximum flow


<FSTB=x> Flow rate with highest stability rate
<TSTB=x> Timer (duration in “cycles”, 1 cycle = about 0.7s) related to the flow rate with highest stability rate
<NSTO=x> Number of stops/poweroff occurred during the delivery (0xHL: H=poweroff, L=stops)
<DEND=x> In case of unexpected delivery stop, this field indicates the cause
1=spurious pulses
2=pulse timout
3=manual stop
4=power off
5= temperature error
6=hardware error
8=external permissive/alarm
9=deadman timeout

<PIN=x> PIN inserted by the operator before starting the delivery (if any)
<MARKEV=x> Event marker flag (see QEV command).

Example:

@1<GET=DLV;1;10><CHK=4D>
#1<MTR=1><EVN=44><MTR=1><PRD=1><RET=0><DLVN=10><SDATE=20/01/15><STIME=12:27:19><EDATE=2
0/01/15><ETIME=13:38:05><PRST=4000.00><PGRS=4000.65><TGRS=6088.06><PNET=3962.29><TNET=6
049.50><PWGH=3031.15><TWGH=4627.84><T=23.20><D=675.00><P=0><SCMP=224R><FMIN=10.2><FAVG=
240.30><FMAX=700.4><FSTB=696.4><TSTB=19><NSTO=02><DEND=4><PIN=0><MARKEV=0><CHK=08>

TE550|truckIII Communication protocol – Programmer’s manual 73


ADMINISTRATOR LEVEL COMMANDS

<GET=TIME>
Description:
Read system time

Syntax:

<GET=TIME>

Arguments:

None

Answer tags:

<TIME=x> System time

Example:

@1<GET=TIME><CHK=0D>
#1<TIME=17:20:09><CHK=35>

TE550|truckIII Communication protocol – Programmer’s manual 74


APPENDIX

TE550|truckIII Communication protocol – Programmer’s manual 75

Вам также может понравиться