Aaronia Spectran V4, Руководство пользователя

Страница: 109 / 123

Protocol types
The protocols are defined as plain text protocols. Maybe we will change it into binary protocols in future.
Protocol seperator definitions
AP_CMD_SEP = : seperates different commands in the protocol
AP_FIELD_SEP = # seperates different fields in the protocol
AP_ARG_SEP = $ seperates arguments in the protocol
AP_PKG_SEP = \n seperates the different packages
AP_AUTH_SEP = & seperates user and password in authentication package
AINFO Information protocol
The AINFO protocol is a very simple protocol type. If clients request general information from the server, the
server answers with this package type.
Structure:
type command AP_CMD_SEP value AP_PKG_SEP
AINFO SPEC:INFO:SERIAL : 12345 \n
You can filter these messages by there beginning AINFO part.
ACMD - Spectran control command protocol
The ACMD protocol is used to handel device requests which read or write device variables directly.
Command types:
Unknown = 0, (Command has incompatible type)
Authentication = 1, (Type for sending / receving the authentication)
Server = 2, (Command is a server command)
SpectranInfo = 3, (Command type for reading device internal information, which are none measurement
parameter like serial, description, etc.)
SpectranControlVariable = 4,(Command type for measurement parameter like Spanfrequency etc.; the
variable is included with the unquine numeric value)
SpectranControlVariableText = 10, (Command type for measurement parameter like Spanfrequency etc.;
the variable is included with the name in text format)
SpectranCalculation = 5, (Command type for no device parameters which are calculated by the server)
RequiredCommand = 6, (Command type for special GPIB standard commands)
Structure:
type AP_CMD_SEP prot. version AP_CMD_SEP device id AP_CMD_SEP cmd type AP_CMD_SEP cmd id AP_CMD_SEP value AP_PKG_SEP
ACMD : 1.0 : 0001 : 0004 : spec-var_id : 233 \n
or with SpectranControlVariableText
type AP_CMD_SEP prot. version AP_CMD_SEP device id AP_CMD_SEP cmd type AP_CMD_SEP cmd id AP_CMD_SEP value AP_PKG_SEP
ACMD : 1.0 : 0001 : 0010 : spec-var_name : 233 \n
You can find the list of available command ids / SPECTRAN variable ids at the end of this page. In the protocols
you have to use the decimal value of the variable.