Ross openGear GPI-8941 Series, Руководство пользователя

Страница: 73 / 92

GPI-8941 User Guide (v9.0) RossTalk Protocol • 73
RossTalk Protocol
The GPI-8941 can be controlled from a remote editor or computer via RossTalk commands. These commands can
be sent to these openGear cards over an Ethernet connection (TCP/UDP) or via a serial port (RS-232/RS-485) on
the card’s rear module.
This chapter provides additional information on the RossTalk protocol used with the GPI-8941.
Before You Begin
Keep the following in mind when implementing the RossTalk protocol:
• All messages start with the command or message class, followed by one or more spaces, followed by a
command.
• All parameters are separated from the command and other parameters by zero or more spaces, followed by a
colon (:), followed by zero (0), or more spaces.
• All messages must end in an ASCII carriage return (0x0D), ASCII line feed (0x0A), or an ASCII null character
(0x00). A combination of these characters is acceptable, i.e. carriage return, line feed is okay.
• Commands and parameters are available in two forms, verbose and non-verbose (terse). For example, to
configure an asynchronous GPI report the verbose command is “
ConfigStatusMsg
” and the terse command is
“
C
”.
• All commands and parameters can be sent using the verbose or terse form. The commands and parameters are
not case sensitive.
• Reports and status messages from the GPI can be due to an Event (e.g. a GPI state has changed), a Request (e.g.
a GPI has been queried for its status), or a Config report command.
Examples
Gets all module status using verbose parameters. Verbose message return is on.
Commands and parameters are not case sensitive; spaces around the colons are optional. Thus the following are all
equivalent:
Command:
GPI ModuleQuery :AllInfo
Response:
GPI ModuleStatus:Type:GPI-8941
GPI ModuleStatus:Inputs:16
GPI ModuleStatus:Outputs:16
Command:
GPI ModuleQuery : AllInfo
gpi modulequery : allinfo
GPI ModuleQuery:AllInfo
gpi modulequery:allinfo
GPI MODULEQUERY: ALLINFO
Response:
GPI ModuleStatus:Type:GPI-8941
GPI ModuleStatus:Inputs:16
GPI ModuleStatus:Outputs:16