Zilog ZAURA868 - Manual (Page 7)

ZAURA RF Module Shell
User Manual
UM023502-0911 Shell Overview
1
Shell Overview
The ZAURA RF Wireless Module Shell is a command line interpreter
that can be used to control ZAURA RF Wireless nodes over an RS-232
(UART) connection. The Shell is preloaded on the ZAURA RF Wireless
Module when shipped from the factory.
Users interact with the Shell through a terminal emulator, such as Hyper-
Terminal, which should typically be configured with 57600 baud, no par-
ity, 1 stop bit, and no flow control. Users can control remote notes as well,
using the
REMOTE command (similar to telnet ).
The Shell is a part of the ZAURA RF Wireless Library and includes
application programming interfaces to implement the different Shell com-
mands. The Shell API provides six mandatory commands that will exist
on all substantiations. The Shell may contain an additional 24 commands
which may be employed either as built-in optional functions or as defined
by your application. For more information about how to implement and
incorporate the Shell into your application, please refer to the
ZAURA RF
Wireless Library Reference Manual (RM0060) .
The following sections cover the usage of each of the commands that are
built into to the Shell. Each command is shown along with a set of manda-
tory and optional parameters. Parameters are shown in italics, and
optional parameters are enclosed in angular brackets <like this>. Shell
command names are case-insensitive, so the commands
Addr , addr and
aDDr are equivalent. However, case sensitivity may apply to the parame-
ters. For example, the tx ff hello command will send a different
string than tx ff HELLO . Unless stated otherwise, all numeric parame-
ters passed to the shell must be specified in hexadecimal format. Simi-
larly, all numeric values returned from the shell are displayed as
hexadecimal values. For example, issuing the command
addr 23 sets the
node address of the ZAURA RF Module to the hexadecimal value 0x23
(35 decimal).