Communications; Protocol - MOGlabs ARF021 Manual

3. Communications

3.1 Protocol

The ARF can be connected to a computer by
The software package mogrf (chapter 4) provides interactive func-
tionality, or communications can be integrated into existing control
software. Examples of controlling the
are provided in Appendix D.
Communication follows a query/response protocol, where the user
sends an ASCII string to the unit, and the unit sends an ASCII
response back. The list of possible commands is detailed in Ap-
pendix C. All messages are CRLF-terminated, requiring that any
communications must end with a carriage return ('\r' = ASCII 0x0D)
and new-line ('\n' = ASCII 0x0A). Most terminal applications and
drivers provide the ability to automatically append these characters
when configured appropriately.
Statements are either "commands" or "queries". A command is a
statement that causes some action to occur, and the unit will re-
spond with either "OK" or "ERR" depending on whether the command
succeeded or not. For example,
> FREQ,1,80MHz
< OK: CH1 freq now 80.00000009 MHz (0x147AE148)
> FREQ,1,10MHz
< ERR: Frequency 10.00 MHz out of range
The response describes the outcome of the command, such as the
achieved frequency taking into account discretisation by the
Queries are statements that return a value, which respond with the
value in physical units first where applicable, or an error message
beginning with "ERR". For example,
USB or ethernet (
in several languages
ARF/XRF
11
TCPIP ).
.
DDS