Hostgreetings - Siemens SIMATIC RF650R Configuration Manual

10.3.1.1

hostGreetings

All communication with a reader must start with the "hostGreetings" command. This is how
the reader recognizes the user application connected to the XML interface. If commands are
sent without being preceded by the "hostGreetings" frame, the reader replies with the error
message "ERROR_INVALID_READER_STATUS".
The XML interface can support several "RFReader.XmlAPI" versions. In the "hostGreetings"
command, specify the API version of the XML interface you want to work with. The reply
frame of the reader then contains the version that the XML interface uses. The
RF650R/RF680R/RF685R readers use version V2.0.
Note that the reply frame of the reader can take up to 20 seconds.
Command
<frame>
<cmd>
</cmd>
</frame>
// opt → Optional: Line can be omitted.
Reply
<frame>
<reply>
</reply>
</frame>
The error codes for negative replies ("resultCode" ≠ 0) are described in the section "Negative
XML replies (Page 263)".
SIMATIC RF650R/RF680R/RF685R
Configuration Manual, 03/2018, C79000-G8976-C386-06
<id> value_id </id>
<hostGreetings>
<readerType> value readerType </readerType>
<supportedVersions>
<version> value_version </version>
<version> value_version </version>
...
</supportedVersions>
</hostGreetings>
<id> value_id </id>
<resultCode> 0 </resultCode>
<hostGreetings>
<returnValue>
<version> value_version </version>
<configID> value_configID </configID>
</returnValue>
</hostGreetings>
Programming via XML interface
10.3 XML commands
//opt
// opt
193