Programming interface
3.3 RPC calls
SIMATIC RTLS4084T
16
Operating Instructions, 04/2021, C79000-G8976-C626-02
Since the commands to be transmitted in the wireless network do not reach the transponder
or reach it incompletely, no event message is generated in this case.
If an RPC call sets a field form to a value that is already set, an event message is sent
immediately. This happens during or very shortly after the RPC call. Event messages are sent
when a situation is reached.
If a field content still to be transmitted is overwritten again before the previous value could
be sent to the transponder, only the value set last is transmitted to the transponder. In this
case, only the writing of the last value is acknowledged by an event message.
The transmission of background images, fonts and theme files is given higher priority and
temporarily interrupts the transmission of text content.
3.3
RPC calls
Parameters of the RPC calls
The following parameters can be used for RPC calls via the programming interface:
Parameter
Description
TransponderID
48-bit ID according to IEEE EUI-48
The network address in decimal notation contains the transponder ID:
•
17:b4:1
a:bb:cc:e2
•
17:b4:1
0:00:00:07
•
17:b4:1
1:23:45:67
•
180079842
•
7
•
19088743
ThemeID
The number of the displayed theme
The value range depends on the type and version of the transponder.
FieldID
The number of the text field
The value range depends on the type and version of the transponder.
Text
Permitted characters: all printable ASCII characters and German umlauts
Result
Sends the return value
Return values for RPC calls
The following return values are possible for RPC calls via the programming interface:
Code
Description
0x0000
No error was detected.
0x0011
The "TransponderID" parameter is invalid.
0x0012
The "ThemeID" parameter is invalid.
0x0013
The "FieldID" parameter is invalid.
0x0101
The text length is invalid.
0x0102
The text contains invalid characters or the characters are not supported.