The Command Line Interface (CLI) allows a human to enter commands and read output from the mote. This data is transferred over a dedicated serial port, different from the UART serial port detailed in UART (HDLC). This results in a terminal-like environment.

The 

 provides high-level functions to build a CLI interface.

The CLI interface is always active, and used by the 

 to provide the following default CLI commands:

Each starts with an "m", indicating that these are terminated by the "mote", rather than the application.

Your application can augment this list by registering additional commands.  The mote has capacity for a total of 32 CLI commands.  The list of built-in commands above uses 10 of those 32 available, meaning you can add up to 22 additional commands. A handler function needs to be defined for each command; it will be called when the user enters the corresponding command. The 

 takes care of dispatching the entered commands to the right handler. When a command is entered, the corresponding handler is given the full string entered by the user, allowing the handler to parse the string for arguments, and take appropriate action.  The command string itself (the string that a person will type) must be short, up to 10 characters in length.  For example: toggleOutput won't work, but togOut will work.  Your handler is responsible for determining if the number and format of the passed arguments are correct.  The handler may return DN_ERR_INVALID if validation fails, which will result in an "invalid argument(s)" error message being printed by the stack, in addition to any error messages your handler might generate. 

The 03-module_cli sample application registers the extra command sum. Once the command is registered, it appears in the help menu:

The handler corresponding to the sum command parses the input string. If two integers are passed as parameters to the command, the handler calculates and prints the sum of the two. It returns an error if only one parameter is specified. 

Each CLI command has an associated access level. By changing the active level of the CLI device, you change the subset of commands the user has access to. The table below lists the available access levels.

The default access level is DN_CLI_ACCESS_LOGIN. Use dnm_ucli_changeAccessLevel() to change the active access level.

The 03-cli_accesslevel sample application shows how to use the access level. Internally, it defines the following dummy CLI commands:

It also defines a level command which allows you to switch the current user level.

Load the firmware on your device, type "help":

Calling a command that is not enabled results in an error:

Change the active level to DN_CLI_ACCESS_VIEWER (value 2). The CLI output of the "help" command now also include the cviewer.

You can repeat the same operation for levels DN_CLI_ACCESS_USER (value 3) and DN_CLI_ACCESS_DUST (level 4).