Connection/Handshake

To begin using REA-PI with a REA JET Controller, open a TCP socket connection on port 22171. Upon connection, the REA JET Controller will respond with the handshake message. To complete the handshake, the same message must be sent back to the REA JET Controller by the client in less than 2 seconds. Otherwise, the REA JET Controller will close the connection.

Spaces added for readability

0x02 REA-PI 0x03 0x0A
0x02 REA-PI 0x03 0x0A

Once the handshake message is received by the REA JET Controller, it will send the version selection message. The client must respond with the version select message.

<?xml version="1.0" encoding="UTF-8"?>
<REA-JET>
    <REA-PI>
        <Welcome>
            <Version>1.6</Version>
            <Version>1.7</Version>
            <Version>1.8</Version>
            <Version>2.0</Version>
            <Version>2.1</Version>
            <Version>3.0</Version>
            <Version>3.1</Version>
            <Version>3.2</Version>
            <Version>3.3</Version>
            <Version>3.4</Version>
            <Version>3.5</Version>
            <Version>3.6</Version>
            <Version>3.8</Version>
            <Version>3.9</Version>
        </Welcome>
    </REA-PI>
</REA-JET>

Content-Length: 89

<REA-JET>
    <REA-PI>
        <VersionSelect>
            <Version>3.9</Version>
        </VersionSelect>
    </REA-PI>
</REA-JET>

The REA JET Controller will respond with a version selection confirmation message. The handshake is now complete, and commands/event messages can be sent.

<?xml version="1.0" encoding="UTF-8"?>
<REA-JET>
    <REA-PI>
        <VersionSelection>
            <Version>3.9</Version>
        </VersionSelection>
    </REA-PI>
</REA-JET>

Connection Details

The connection to the REA JET Controller does not time-out; it will remain open indefinitely.