Difference between revisions of "WorkMan HVS - IP Protocol"

From WorkManSoft Wiki
Jump to navigationJump to search
Line 29: Line 29:
 
| |WELCOME
 
| |WELCOME
 
|-
 
|-
| style="background-color:#ffffcc;" | '''Direction'''||HVS to HS
+
| style="background-color:#ffffcc;" | '''Direction'''||Server to client
 
|-
 
|-
| style="background-color:#ffffcc;" | '''Mandatory'''||No, only HVS in servermode sends this.
+
| style="background-color:#ffffcc;" | '''Mandatory'''||Yes
 
|-
 
|-
| style="background-color:#ffffcc;" | '''Structure'''||WELCOME;
+
| style="background-color:#ffffcc;" | '''Structure'''||WELCOME;<protocolversion>
 
|-
 
|-
| style="background-color:#ffffcc;" | '''Response'''||none
+
| style="background-color:#ffffcc;" | '''Response'''||OK;WELCOME
 
|-
 
|-
 
| style="background-color:#ffffcc;" | '''Example sender'''||WELCOME;1
 
| style="background-color:#ffffcc;" | '''Example sender'''||WELCOME;1
 
|-
 
|-
| style="background-color:#ffffcc;" | '''Example response'''||
+
| style="background-color:#ffffcc;" | '''Example response'''||OK;WELCOME
 
|-
 
|-
| style="background-color:#ffffcc;" | '''About'''||Sends a welcome from the HVS server to connecting client.
+
| style="background-color:#ffffcc;" | '''About'''||Sends a welcome from the server to connecting client.
 
|}
 
|}
  

Revision as of 13:42, 31 August 2012

About

This protocol is our own protocol and can be used if no other protocol is in place.

The protocol works over TCP/IP and is linebased with CR+LF (#13#10) as a end of command terminator. WorkMan HVS can work both as a client and as a server so it's up to the hotelsystem to decide which way they prefer.

HS = Hotel System HVS = Our system (Hotel Växel System)

Commands

The first parameter is always the name of the command and the response to it always follows the form OK;<name of command> where OK is considered the command. The server/client should only send one command at a time and then wait for a response. If an answer hasn't been received within 10 seconds the connection should be considered down and a reconnect should be made.

Example:

HVS sends a welcome to a HS client that is connecting

 WELCOME;1

The HS-client responds

 OK;WELCOME

List over commands

Welcome

Command WELCOME
Direction Server to client
Mandatory Yes
Structure WELCOME;<protocolversion>
Response OK;WELCOME
Example sender WELCOME;1
Example response OK;WELCOME
About Sends a welcome from the server to connecting client.

Keep-alive

Command ALIVE
Direction HVS to HS
Mandatory No, only HVS in clientmode sends this.
Structure ALIVE
Response OK;ALIVE
Example sender ALIVE
Example response OK;ALIVE
About Sends an ALIVE-signal to the server to see that connection is up.