ZAURA Datasheet, PDF (75/99 Pages) –

ZAURA RF Wireless Library
Programmer’s Reference Manual
63
the remaining three tokens reference the parameters 1, 2 and 3, respec-
tively. If a parameter must contain spaces, enclose the parameter within
spaces. The command line test "this is one token" 2 3 also
contains 4 tokens, with the first parameter being this is one token.
After parsing the command line into tokens, ZAURA_RF_ProcessCmdLine
API compares the name command submitted (referenced by
pZAURA_RF_Tokens[0]) to the current set of Shell commands. If a match
is found, the corresponding function pointer is called. Otherwise, an error
message is displayed on the console.
If the entered shell command corresponds to a user-defined function, then
the application is responsible for processing the command. Exactly how
the application processes this command is application-dependent. The
remainder of this section describes the ZAURA RF Shell global variables
and API functions available to user-defined shell commands.
Console Global Variables
Table 13 describes the types of console variables employed by the
ZAURA RF Wireless Shell API.
Table 13. Console Global Variables
Variable Name
ZAURA_RF_NumTokens
Type
UINT8
pZAURA_RF_Token[MAX_T char *
OKENS]
Description
Used by shell routines to determine the number of space-
separated strings (i.e., tokens) within the console
command. For example, the command line MyCmd has
3 parameters contains 4 tokens. If a token must
include spaces, enclose it in quotation marks. The line
This is a single token contains just one token.
The maximum number of tokens that can be supported is
ZAURA_RF_SHELL_MAX_TOKENS (currently defined
as 5).
An array of pointers referencing the NULL-terminated
string of characters comprising the token.
RM006003-1011
Console Global Variables