L&G Toccata protocol

Supported device types and versions
Communication line configuration
Communication station configuration
I/O tag configuration
Changes and modifications
Document revisions

Supported device types and versions

This protocol supports the following Landis&Gyr devices:

Table 1

Device typeThe version of the software in the deviceProtocol version
PRU1.64, RWP80
PRU1.64, RWP80
PRU10.64, PRV2.128
RWP80 AZA v. 07.10TOCCATA1 V.2

Communication line configuration

  • Baud rate and transmission parameters according to a type of communication.
  • 2400 Bd, 8 data bits, no parity, 1 stop bit in direct connection point-point (TOCCATA1 V.0 and V1).
  • 9600 Bd, 8 data bits, no parity, 1 stop bit in direct connection point-point (TOCCATA2 V.0).
  • If devices communicate via the communication concentrators (KPX, radio modems), the transmission parameters depend on the particular case.

Communication station configuration

  • Communication protocol: L&G TOCCATA
  • The station address is in the range of 0 up to 255 in decimal format. It is used only when communicating via communication concentrators. In the case of direct communication, the address is ignored.

Station protocol parameters

You can define the following parameters:

Table 2

KeywordFull nameMeaningUnitImplicit value
Retry CountThe number of request retries if the communication error occurs.-1
Retry TimeoutThe delay between repeating the request if the communication error occurs.ms1000 millisec.
Wait First TimeoutThe first waiting before reading the response after the request is sent.ms300 millisec.
Wait TimeoutThe delay between response readings until the response is completed.ms300 millisec.
Max Wait RetryThe number of response reading retries until the response is completed.-12
Wait Before RequestThe delay that is used before each request.ms0
KPX RouteThe communication via the communication concentrator. The station address is used.YES/NONO
Maximum PA ItemsThe maximum number of PA data in one data block. You must always define an even number. If communicating via concentrator, the maximum number is 10, otherwise, it is 24.-10
Log EventsIt allows saving the text messages to TRACE.LOG from the device. This file is in the current working directory of the communication process.YES/NONO
KL Read DelayThe time period to obtain the values of KL data. KL data are read when starting the communication process and again after elapsing of the KLRD period.min30 minutes
Send ACKSending ACK message (DLE-ACK) after the D2000 KOM receives the proper packet. A direct connection requires to set YES. Connection via concentrator (KPX=YES) requires to set NO (speeding up of communication).YES/NOYES
Send Enhanced ACKSending enhanced ACK message with station address (DLE-ACK-CR-LF-StationAddress-CR-LF) after the D2000 KOM receives the proper packet.YES/NONO
PRU VersionTOCCATA protocol:
  • value 0: TOCCATA1 V.0
  • value 1: TOCCATA1 V.1
  • value 2: TOCCATA2 V.0
  • value 3: TOCCATA1 V.2
0, 1, 2, 30
PA FirstAt starting the communication, it gives priority to reading the PA instead of KL parameters. KL parameters will be read after PA ones are received from all stations.YES/NONO
Full DebugActivation of the debug information about received values.YES/NONO

A string containing the protocol parameters is defined as follows:

Key_word=value;Key_word=value; ...



If there is used a keyword with an invalid value in the initialization string, there will be used corresponding default value according to the table 1.

I/O tag configuration

I/O tags: AI, AO, CI, CO, DI, DO, TIR, TOR, TIA, TOA.

In the configuration you must define the following parameters:

  • point type PA or KL
  • address (for KL it is a physical address in the device)
  • size of the data block of a given point (for PA it is always 0)



Changes and modifications

  • March 1999 - Completing the protocol TOCCATA2 V.0.
  • April 1999 - Debugging the TOCCATA2 V.0.
  • April 2002 - Added the version TOCCATA1 V.2.
  • May 7, 2002 - change of behavior of KL points, size 2 bytes, types TiR and ToR - canceled the internal multiplication of received value *60, it is supposed that the input value is in seconds.

Document revisions

  • Ver. 1.2 – February 8, 2000 – Update for version 4.07 and 4.10
  • Ver. 1.3 – May 22, 2000 – Added parameter of protocol WFT.
  • Ver. 1.4 – July 21, 2000 – Added parameter of protocol SACK.
  • Ver. 1.5 - November 26, 2001 - Added parameter of protocol PAF.
  • Ver. 1.6 - April 5, 2002 - Added version TOCCATA1 V.2.
Write a comment...