Difference between revisions of "GeometryServiceNetworkProtocol"
From BRL-CAD
(Added in specifics about GSNet Header stufff. WIP still.) |
|||
| Line 1: | Line 1: | ||
| + | [[category:Geometry Service]] | ||
| + | [[category:GSNet Protocol]] | ||
| + | ---- | ||
| + | |||
The Geometry Service Network (GSNet) Protocol is a TCP/IP based protocol designed to facilitate socketed communications between Geometry Service Nodes on a network. A Geometry Service Node is defined as any softwares that supports communication via the GSNet Protocol. | The Geometry Service Network (GSNet) Protocol is a TCP/IP based protocol designed to facilitate socketed communications between Geometry Service Nodes on a network. A Geometry Service Node is defined as any softwares that supports communication via the GSNet Protocol. | ||
| + | |||
| + | <br /> | ||
| + | ---- | ||
| + | |||
| + | ==Visual GSNet Msg Breakdown== | ||
| + | [[Image:GSNetProtocol.png]] | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ==GSNet Msg== | ||
| + | ===Header=== | ||
| + | The header of the GSNet Msg contains the information necessary for quickly determining authenticity, type and length. Geometry Service's network library, libNetwork, is built upon BRL-CAD's networking library: libPKG. This causes the header byte layout to look like this: | ||
| + | |||
| + | {|border="1" | ||
| + | |width="180"|'''Element''' | ||
| + | |width="180"|'''Length''' | ||
| + | |width="180"|'''Value''' | ||
| + | |- | ||
| + | |Magic1 | ||
| + | |int16 (2 Bytes) | ||
| + | |Always 0x41FE | ||
| + | |- | ||
| + | |Magic2 | ||
| + | |int16 (2 Bytes) | ||
| + | |Always 0x5309 | ||
| + | |- | ||
| + | |MessageLength | ||
| + | |int32 (4 bytes) | ||
| + | | | ||
| + | |- | ||
| + | |MsgType | ||
| + | |int16 (2 bytes) | ||
| + | | | ||
| + | |- | ||
| + | |MessageUUID | ||
| + | |[[IBME_NETWORKPROTO_STRING|String (Variable bytes)]] | ||
| + | | | ||
| + | |- | ||
| + | |HasRegardingUUID | ||
| + | |Boolean (1 byte) | ||
| + | | | ||
| + | |- | ||
| + | |RegardingMessageUUID | ||
| + | |[[IBME_NETWORKPROTO_STRING|String (Variable bytes)]] | ||
| + | | | ||
| + | |} | ||
| + | |||
| + | |||
| + | ====libPKG Part==== | ||
| + | ====GSNet Part==== | ||
---- | ---- | ||
| + | ===Data=== | ||
| + | ---- | ||
| + | |||
List of [[NetMsgTypes]]. | List of [[NetMsgTypes]]. | ||
List of [[Common NetMsg Exchanges]] | List of [[Common NetMsg Exchanges]] | ||
Revision as of 08:54, 18 January 2011
The Geometry Service Network (GSNet) Protocol is a TCP/IP based protocol designed to facilitate socketed communications between Geometry Service Nodes on a network. A Geometry Service Node is defined as any softwares that supports communication via the GSNet Protocol.
Contents
Visual GSNet Msg Breakdown
GSNet Msg
Header
The header of the GSNet Msg contains the information necessary for quickly determining authenticity, type and length. Geometry Service's network library, libNetwork, is built upon BRL-CAD's networking library: libPKG. This causes the header byte layout to look like this:
| Element | Length | Value |
| Magic1 | int16 (2 Bytes) | Always 0x41FE |
| Magic2 | int16 (2 Bytes) | Always 0x5309 |
| MessageLength | int32 (4 bytes) | |
| MsgType | int16 (2 bytes) | |
| MessageUUID | String (Variable bytes) | |
| HasRegardingUUID | Boolean (1 byte) | |
| RegardingMessageUUID | String (Variable bytes) |
libPKG Part
GSNet Part
Data
List of NetMsgTypes.
List of Common NetMsg Exchanges
