Command Line Interface

Description

The Command Line Interface (CLI) software component simplifies creating command line user interfaces for programs. It handles tasks such as receiving keyboard input, parsing the input strings for commands and arguments, and finally calling the proper C function with decoded and validated arguments. Functions can use standard output functions such as printf to write information to the console. Many modules of the SDK have built-in commands that are provided via CLI, users can even add the custom commands if required.

The Command Line Interface (CLI) depends on I/O Stream for reading and writing bytes. You can set the I/O stream instance in the CLI instance configuration.

Modules

CLI Commands in NVM3
Support for CLI commands stored in and executed from NVM3.
 
CLI Commands in RAM
Support for CLI commands stored in and executed from RAM.
 
CLI Delay
CLI Delay.
 

Data Structures

struct  sl_cli_command_arg_t
 Command arguments data type.
 
struct  sl_cli_command_info_t
 Command struct representing a command and its variable types.
 
struct  sl_cli_command_entry_t
 Struct associating a command with a string.
 
struct  sl_cli_command_group_t
 Struct representing a command group.
 
struct  sl_cli
 Struct representing an instance of the CLI.
 
struct  sl_cli_instance_parameters_t
 The structure defining the parameters for creating a CLI instance.
 

Functions

uint8_t * sl_cli_get_argument_hex (sl_cli_command_arg_t *a, size_t n, size_t *l)
 Get the hex argument length and value.
 
void sl_cli_clear (sl_cli_handle_t handle)
 Clear (reset) a CLI.
 
void sl_cli_redirect_command (sl_cli_handle_t handle, sl_cli_command_function_t command_function, const char *prompt, void *aux)
 Redirect user input.
 
sl_status_t sl_cli_handle_input (sl_cli_handle_t handle, char *string)
 Handle input.
 
sl_status_t sl_cli_instance_init (sl_cli_handle_t handle, sl_cli_instance_parameters_t *parameters)
 Initialize a CLI instance.
 
bool sl_cli_is_ok_to_sleep (sl_cli_handle_t handle)
 Check if the CLI instance can allow sleep.
 
void sl_cli_tick_instance (sl_cli_handle_t handle)
 The bare metal tick function.
 
sl_status_t sl_cli_tokenize (char input[], int *token_c, char *token_v[])
 Split a C-string on space, ignoring sections in {} or "".
 
bool sl_cli_input_char (sl_cli_handle_t handle, char c)
 Handle new input char from the terminal, both in terms of writing back to terminal and writing to the input buffer.
 
void sl_cli_input_clear (sl_cli_handle_t handle)
 Empty the input buffer.
 
sl_status_t sl_cli_simple_password_init (void)
 Initialize module.
 
sl_status_t sl_cli_simple_password_logout (sl_cli_handle_t handle)
 Logout connected user from an instance.
 
sl_status_t sl_cli_set_simple_password (char *new_password)
 Set a new password.
 
sl_status_t sl_cli_simple_password_destroy_key (void)
 Destroy password key and force to configure a new password.
 
sl_status_t sl_cli_reset_security_warning_flag (void)
 Reset security warning flag.
 
bool sl_cli_command_add_command_group (sl_cli_handle_t handle, sl_cli_command_group_t *command_group)
 Add a new command group.
 
bool sl_cli_command_remove_command_group (sl_cli_handle_t handle, sl_cli_command_group_t *command_group)
 Remove a command group.
 
const sl_cli_command_entry_tsl_cli_command_find (sl_cli_handle_t handle, int *token_c, char *token_v[], int *arg_ofs, bool *single_flag, bool *help_flag)
 Find a command given the command groups and input arguments.
 
sl_status_t sl_cli_command_execute (sl_cli_handle_t handle, char *input)
 Find and execute a command given the string input and the command table.
 

Macros

#define SL_CLI_ARG_UINT8   (0x00U)
 UINT8 argument type.
 
#define SL_CLI_ARG_UINT16   (0x01U)
 UINT16 argument type.
 
#define SL_CLI_ARG_UINT32   (0x02U)
 UINT32 argument type.
 
#define SL_CLI_ARG_INT8   (0x03U)
 INT8 argument type.
 
#define SL_CLI_ARG_INT16   (0x04U)
 INT16 argument type.
 
#define SL_CLI_ARG_INT32   (0x05U)
 INT32 argument type.
 
#define SL_CLI_ARG_STRING   (0x06U)
 STRING argument type.
 
#define SL_CLI_ARG_HEX   (0x07U)
 HEX argument type.
 
#define SL_CLI_ARG_UINT8OPT   (0x10U)
 Optional UINT8 argument type.
 
#define SL_CLI_ARG_UINT16OPT   (0x11U)
 Optional UINT16 argument type.
 
#define SL_CLI_ARG_UINT32OPT   (0x12U)
 Optional UINT32 argument type.
 
#define SL_CLI_ARG_INT8OPT   (0x13U)
 Optional INT8 argument type.
 
#define SL_CLI_ARG_INT16OPT   (0x14U)
 Optional INT16 argument type.
 
#define SL_CLI_ARG_INT32OPT   (0x15U)
 Optional INT32 argument type.
 
#define SL_CLI_ARG_STRINGOPT   (0x16U)
 Optional STRING argument type.
 
#define SL_CLI_ARG_HEXOPT   (0x17U)
 Optional HEX argument type.
 
#define SL_CLI_ARG_ADDITIONAL   (0x20U)
 ADDITIONAL argument type.
 
#define SL_CLI_ARG_WILDCARD   (0x21U)
 WILDCARD argument type.
 
#define SL_CLI_ARG_GROUP   (0xFEU)
 GROUP argument type.
 
#define SL_CLI_ARG_END   (0xFFU)
 END argument type.
 
#define sl_cli_get_argument_count(a)   ((int)((a)->argc - (a)->arg_ofs))
 Obtain the number of command arguments.
 
#define sl_cli_get_argument_type(a, n)   ((sl_cli_arg_t)((a)->arg_type_list[(n)]))
 Obtain the type of argument.
 
#define sl_cli_get_argument_int8(a, n)   (*(int8_t *)((a)->argv[(a)->arg_ofs + (n)]))
 Obtain int8 arguments.
 
#define sl_cli_get_argument_int16(a, n)   (*(int16_t *)((a)->argv[(a)->arg_ofs + (n)]))
 Obtain int16 arguments.
 
#define sl_cli_get_argument_int32(a, n)   (*(int32_t *)((a)->argv[(a)->arg_ofs + (n)]))
 Obtain int32 arguments.
 
#define sl_cli_get_argument_uint8(a, n)   (*(uint8_t *)((a)->argv[(a)->arg_ofs + (n)]))
 Obtain uint8 arguments.
 
#define sl_cli_get_argument_uint16(a, n)   (*(uint16_t *)((a)->argv[(a)->arg_ofs + (n)]))
 Obtain uint16 arguments.
 
#define sl_cli_get_argument_uint32(a, n)   (*(uint32_t *)((a)->argv[(a)->arg_ofs + (n)]))
 Obtain uint32 arguments.
 
#define sl_cli_get_argument_string(a, n)   ((char *)((a)->argv[(a)->arg_ofs + (n)]))
 Obtain string arguments.
 
#define sl_cli_get_command_count(a)   ((int)((a)->arg_ofs))
 Obtain the number of command strings.
 
#define sl_cli_get_command_string(a, n)   ((char *)((a)->argv[(n)]))
 Obtain the command string(s).
 
#define SL_CLI_NVM3_KEY_COUNT   (0x100)
 
#define SL_CLI_NVM3_KEY_BEGIN   (0x3000)
 
#define SL_CLI_NVM3_KEY_END   (SL_CLI_NVM3_KEY_BEGIN + SL_CLI_NVM3_KEY_COUNT)
 
#define SL_CLI_INPUT_ORDINARY   (0U)
 
#define SL_CLI_INPUT_RETURN   (1U)
 
#define SL_CLI_INPUT_ESCAPE   (2U)
 
#define SL_CLI_INPUT_ARROW   (3U)
 
#define SL_CLI_INPUT_DIRECTION_UP   (1)
 MACROS ************************************.
 
#define SL_CLI_INPUT_DIRECTION_DOWN   (-1)
 Define the DOWN-direction.
 
#define SL_CLI_COMMAND(function, help_text, arg_help, ...)
 A macro, which is used to create commands.
 
#define SL_CLI_COMMAND_GROUP(group_table, help_text)
 A macro, which is used to create command groups.
 

Typedefs

typedef uint8_t sl_cli_argument_type_t
 Argument type typedef.
 
typedef void(* sl_cli_command_func_t) (sl_cli_command_arg_t *arguments)
 Command handler data type.
 
typedef void(* sl_cli_command_function_t) (char *arg_str, void *user)
 Redirect command function.
 
typedef uint8_t sl_cli_input_type_t
 
typedef sl_cli_t * sl_cli_handle_t
 

Enumerations

enum  sl_cli_arg {
  sl_cli_arg_uint8 = SL_CLI_ARG_UINT8,
  sl_cli_arg_uint16 = SL_CLI_ARG_UINT16,
  sl_cli_arg_uint32 = SL_CLI_ARG_UINT32,
  sl_cli_arg_int8 = SL_CLI_ARG_INT8,
  sl_cli_arg_int16 = SL_CLI_ARG_INT16,
  sl_cli_arg_int32 = SL_CLI_ARG_INT32,
  sl_cli_arg_string = SL_CLI_ARG_STRING,
  sl_cli_arg_hex = SL_CLI_ARG_HEX,
  sl_cli_arg_uint8opt = SL_CLI_ARG_UINT8OPT,
  sl_cli_arg_uint16opt = SL_CLI_ARG_UINT16OPT,
  sl_cli_arg_uint32opt = SL_CLI_ARG_UINT32OPT,
  sl_cli_arg_int8opt = SL_CLI_ARG_INT8OPT,
  sl_cli_arg_int16opt = SL_CLI_ARG_INT16OPT,
  sl_cli_arg_int32opt = SL_CLI_ARG_INT32OPT,
  sl_cli_arg_stringopt = SL_CLI_ARG_STRINGOPT,
  sl_cli_arg_hexopt = SL_CLI_ARG_HEXOPT,
  sl_cli_arg_additionnal = SL_CLI_ARG_ADDITIONAL,
  sl_cli_arg_wildcard = SL_CLI_ARG_WILDCARD,
  sl_cli_arg_group = SL_CLI_ARG_GROUP,
  sl_cli_arg_end = SL_CLI_ARG_END
}
 Enum of all the argument types.
 

Variables

sl_cli_handle_t sl_cli_default_handle
 The default CLI handle.
 
sl_cli_command_group_tsl_cli_default_command_group
 The default CLI command group.
 

Function Documentation

◆ sl_cli_get_argument_hex()

uint8_t* sl_cli_get_argument_hex ( sl_cli_command_arg_t a,
size_t  n,
size_t * 
)

Get the hex argument length and value.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is number 0, the next 1, etc.
[in]lA pointer to the variable that receives the argument value length. Note: The length is stored in a 2 byte variable. Valid lengths are in the range 0 .. 65535.
Returns
A pointer to the value buffer.

◆ sl_cli_clear()

void sl_cli_clear ( sl_cli_handle_t  handle)

Clear (reset) a CLI.

Parameters
[in]handleA handle to the CLI that will be cleared.

◆ sl_cli_redirect_command()

void sl_cli_redirect_command ( sl_cli_handle_t  handle,
sl_cli_command_function_t  command_function,
const char *  prompt,
void *  aux 
)

Redirect user input.

Normally, an input string is passed to the CLI command handler for execution, but with the redirect function the input string will be passed to the alternative function. If the alternative input function should not to be used, this function can be called with NULL in the command_function, prompt and aux.

Parameters
[in]handleA handle to the CLI.
[in]command_functionA pointer to the function that will receive user input when the re-direct is active. NULL to stop the redirect.
[in]promptA pointer to a string that will be used as command prompt in the redirect function. NULL to stop the redirect.
[in]auxA pointer that will be added to the redirect function arguments. NULL to stop the redirect.

◆ sl_cli_handle_input()

sl_status_t sl_cli_handle_input ( sl_cli_handle_t  handle,
char *  string 
)

Handle input.

Execute a complete command line with command and arguments.

Parameters
[in]handleA handle to the CLI.
[in]stringA pointer to the string containing the command line that shall be executed.
Returns
Execution status. Note: If the command is redirected, the function will always return SL_STATUS_OK.

◆ sl_cli_instance_init()

sl_status_t sl_cli_instance_init ( sl_cli_handle_t  handle,
sl_cli_instance_parameters_t parameters 
)

Initialize a CLI instance.

Parameters
[in]handleA handle to the CLI.
[in]parametersA pointer to the structure containing instance parameters.
Returns
Initialization status.

◆ sl_cli_is_ok_to_sleep()

bool sl_cli_is_ok_to_sleep ( sl_cli_handle_t  handle)

Check if the CLI instance can allow sleep.

This function is available in a bare metal configuration only.

Parameters
[in]handleA handle to the CLI instance.
Returns
A boolean that is true if the CLI allows sleep, else false.

◆ sl_cli_tick_instance()

void sl_cli_tick_instance ( sl_cli_handle_t  handle)

The bare metal tick function.

Parameters
[in]handleA handle to the CLI instance.

◆ sl_cli_tokenize()

sl_status_t sl_cli_tokenize ( char  input[],
int *  token_c,
char *  token_v[] 
)

Split a C-string on space, ignoring sections in {} or "".

Note
This function modifies the content of the input string, and points the pointers in tokens to addresses in the input string. In quote strings ("") or curly braces ({}), the string will not be split, The quotes will be removed, but curly braces are kept for validation. To avoid '"' being interpreted as start/end of quote string, it may be escaped using '\"', both within and outside of "...". '{' may be escaped using * '\{'. There is no need for escaping '}', since only hex digits are allowed within {...}. Backslash also needs be be escaped, as '\'.
Parameters
[in,out]inputThe C-string to be split. Must be '\0'-terminated. Will be modified, even if an error occurs.
[out]token_cThe number of tokens put in the token_v array.
[out]token_vAn array containing the tokens obtained from splitting.
Returns
Status of the operation.

◆ sl_cli_input_char()

bool sl_cli_input_char ( sl_cli_handle_t  handle,
char 
)

Handle new input char from the terminal, both in terms of writing back to terminal and writing to the input buffer.

This function should be called every time new input is detected. The behavior of the function is highly configurable through settings in cli_config.h.

Parameters
[in,out]handleA handle to a CLI instance.
[in]cInput char to be processed by the function.
Returns
Returns true if newline or return is detected, false otherwise.

◆ sl_cli_input_clear()

void sl_cli_input_clear ( sl_cli_handle_t  handle)

Empty the input buffer.

This function should be called after newline has been detected and the information in the buffer has been processed.

Parameters
[in,out]handleA handle to a CLI instance.

◆ sl_cli_simple_password_init()

sl_status_t sl_cli_simple_password_init ( void  )

Initialize module.

Returns
Initialization status .

◆ sl_cli_simple_password_logout()

sl_status_t sl_cli_simple_password_logout ( sl_cli_handle_t  handle)

Logout connected user from an instance.

Parameters
[in]handleA handle to the CLI.
Returns
Initialization status.

◆ sl_cli_set_simple_password()

sl_status_t sl_cli_set_simple_password ( char *  new_password)

Set a new password.

Parameters
[in]new_passwordPassword string
Returns
Operation status.

◆ sl_cli_simple_password_destroy_key()

sl_status_t sl_cli_simple_password_destroy_key ( void  )

Destroy password key and force to configure a new password.

Returns
Operation status.

◆ sl_cli_reset_security_warning_flag()

sl_status_t sl_cli_reset_security_warning_flag ( void  )

Reset security warning flag.

Returns
Operation status.

◆ sl_cli_command_add_command_group()

bool sl_cli_command_add_command_group ( sl_cli_handle_t  handle,
sl_cli_command_group_t command_group 
)

Add a new command group.

Parameters
[in,out]handleA handle to a CLI instance.
[in]command_groupA pointer to a command group structure. Note that the structure must initially have NULL in all elements except the command_table.
Returns
Returns true if the command_group could be added, false otherwise.

◆ sl_cli_command_remove_command_group()

bool sl_cli_command_remove_command_group ( sl_cli_handle_t  handle,
sl_cli_command_group_t command_group 
)

Remove a command group.

Parameters
[in,out]handleA handle to a CLI instance.
[in]command_groupA pointer to a command group structure.
Returns
Returns true if the command_group could be removed, false otherwise.

◆ sl_cli_command_find()

const sl_cli_command_entry_t* sl_cli_command_find ( sl_cli_handle_t  handle,
int *  token_c,
char *  token_v[],
int *  arg_ofs,
bool *  single_flag,
bool *  help_flag 
)

Find a command given the command groups and input arguments.

Parameters
[in,out]handleA handle to a CLI instance.
[in]token_cA number of arguments given.
[in]token_vAn array containing the token_v obtained from tokenization.
[out]arg_ofsAn integer that will get the index to the first command argument. Whether the command is in a group or not will affect the arg_ofs value.
[out]single_flagBoolean that is set to true if a specific command is detected. For help, the function may return a pointer to a command entry table or NULL, and in these cases the single_flag is set to false.
[out]help_flagBoolean that is set to true if "help" is detected, else set to false.
Returns
A pointer to a command entry for the given command. If the command is not found, the returned value can be NULL. If a help command is issued, the returned value may point to a command entry table.

◆ sl_cli_command_execute()

sl_status_t sl_cli_command_execute ( sl_cli_handle_t  handle,
char *  input 
)

Find and execute a command given the string input and the command table.

Note
The input string will be modified in-place.
Parameters
[in,out]handleA handle to a CLI instance.
[in,out]inputC-string containing the user input. Must be '\0'-terminated.
Returns
Status of the execution.

Macro Definition Documentation

◆ SL_CLI_ARG_UINT8

#define SL_CLI_ARG_UINT8   (0x00U)

UINT8 argument type.

◆ SL_CLI_ARG_UINT16

#define SL_CLI_ARG_UINT16   (0x01U)

UINT16 argument type.

◆ SL_CLI_ARG_UINT32

#define SL_CLI_ARG_UINT32   (0x02U)

UINT32 argument type.

◆ SL_CLI_ARG_INT8

#define SL_CLI_ARG_INT8   (0x03U)

INT8 argument type.

◆ SL_CLI_ARG_INT16

#define SL_CLI_ARG_INT16   (0x04U)

INT16 argument type.

◆ SL_CLI_ARG_INT32

#define SL_CLI_ARG_INT32   (0x05U)

INT32 argument type.

◆ SL_CLI_ARG_STRING

#define SL_CLI_ARG_STRING   (0x06U)

STRING argument type.

◆ SL_CLI_ARG_HEX

#define SL_CLI_ARG_HEX   (0x07U)

HEX argument type.

◆ SL_CLI_ARG_UINT8OPT

#define SL_CLI_ARG_UINT8OPT   (0x10U)

Optional UINT8 argument type.

◆ SL_CLI_ARG_UINT16OPT

#define SL_CLI_ARG_UINT16OPT   (0x11U)

Optional UINT16 argument type.

◆ SL_CLI_ARG_UINT32OPT

#define SL_CLI_ARG_UINT32OPT   (0x12U)

Optional UINT32 argument type.

◆ SL_CLI_ARG_INT8OPT

#define SL_CLI_ARG_INT8OPT   (0x13U)

Optional INT8 argument type.

◆ SL_CLI_ARG_INT16OPT

#define SL_CLI_ARG_INT16OPT   (0x14U)

Optional INT16 argument type.

◆ SL_CLI_ARG_INT32OPT

#define SL_CLI_ARG_INT32OPT   (0x15U)

Optional INT32 argument type.

◆ SL_CLI_ARG_STRINGOPT

#define SL_CLI_ARG_STRINGOPT   (0x16U)

Optional STRING argument type.

◆ SL_CLI_ARG_HEXOPT

#define SL_CLI_ARG_HEXOPT   (0x17U)

Optional HEX argument type.

◆ SL_CLI_ARG_ADDITIONAL

#define SL_CLI_ARG_ADDITIONAL   (0x20U)

ADDITIONAL argument type.

◆ SL_CLI_ARG_WILDCARD

#define SL_CLI_ARG_WILDCARD   (0x21U)

WILDCARD argument type.

◆ SL_CLI_ARG_GROUP

#define SL_CLI_ARG_GROUP   (0xFEU)

GROUP argument type.

◆ SL_CLI_ARG_END

#define SL_CLI_ARG_END   (0xFFU)

END argument type.

◆ sl_cli_get_argument_count

#define sl_cli_get_argument_count (   a)    ((int)((a)->argc - (a)->arg_ofs))

Obtain the number of command arguments.

Users obtain the number of command arguments with this macro.

Parameters
[in]aA pointer to the command arguments.
Returns
The number of command arguments.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the number of arguments (after the command strings).
int arg_count = sl_cli_get_argument_count(args); // arg_count = 4
}

◆ sl_cli_get_argument_type

#define sl_cli_get_argument_type (   a,
 
)    ((sl_cli_arg_t)((a)->arg_type_list[(n)]))

Obtain the type of argument.

Users obtain the type of the argument with this macro.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is the number 0, the next 1, etc.
Returns
enum of the argument type.

For auto-generated commands, it could be useful in the handler to know the type of the argument.

◆ sl_cli_get_argument_int8

#define sl_cli_get_argument_int8 (   a,
 
)    (*(int8_t *)((a)->argv[(a)->arg_ofs + (n)]))

Obtain int8 arguments.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is the number 0, the next 1, etc.
Returns
The argument value.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the arguments (after the command strings).
char *text_ptr = sl_cli_get_argument_string(args, 0); // char ptr to
// "hello"
uint8_t num1_u8 = sl_cli_get_argument_uint8(args, 1); // num1_u8 = 255
int16_t num2_i16 = sl_cli_get_argument_int16(args, 2); // num2_i16 = -100
size_t hex_array_size;
uint8_t *hex_array_ptr = sl_cli_get_argument_hex(args, 3, &hex_array_size);
// uint8_t ptr to {0xAA, 0xBB, 0xCC}, hex_array_size = 3
}

◆ sl_cli_get_argument_int16

#define sl_cli_get_argument_int16 (   a,
 
)    (*(int16_t *)((a)->argv[(a)->arg_ofs + (n)]))

Obtain int16 arguments.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is the number 0, the next 1, etc.
Returns
The argument value.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the arguments (after the command strings).
char *text_ptr = sl_cli_get_argument_string(args, 0); // char ptr to
// "hello"
uint8_t num1_u8 = sl_cli_get_argument_uint8(args, 1); // num1_u8 = 255
int16_t num2_i16 = sl_cli_get_argument_int16(args, 2); // num2_i16 = -100
size_t hex_array_size;
uint8_t *hex_array_ptr = sl_cli_get_argument_hex(args, 3, &hex_array_size);
// uint8_t ptr to {0xAA, 0xBB, 0xCC}, hex_array_size = 3
}

◆ sl_cli_get_argument_int32

#define sl_cli_get_argument_int32 (   a,
 
)    (*(int32_t *)((a)->argv[(a)->arg_ofs + (n)]))

Obtain int32 arguments.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is the number 0, the next 1, etc.
Returns
The argument value.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the arguments (after the command strings).
char *text_ptr = sl_cli_get_argument_string(args, 0); // char ptr to
// "hello"
uint8_t num1_u8 = sl_cli_get_argument_uint8(args, 1); // num1_u8 = 255
int16_t num2_i16 = sl_cli_get_argument_int16(args, 2); // num2_i16 = -100
size_t hex_array_size;
uint8_t *hex_array_ptr = sl_cli_get_argument_hex(args, 3, &hex_array_size);
// uint8_t ptr to {0xAA, 0xBB, 0xCC}, hex_array_size = 3
}

◆ sl_cli_get_argument_uint8

#define sl_cli_get_argument_uint8 (   a,
 
)    (*(uint8_t *)((a)->argv[(a)->arg_ofs + (n)]))

Obtain uint8 arguments.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is the number 0, the next 1, etc.
Returns
The argument value.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the arguments (after the command strings).
char *text_ptr = sl_cli_get_argument_string(args, 0); // char ptr to
// "hello"
uint8_t num1_u8 = sl_cli_get_argument_uint8(args, 1); // num1_u8 = 255
int16_t num2_i16 = sl_cli_get_argument_int16(args, 2); // num2_i16 = -100
size_t hex_array_size;
uint8_t *hex_array_ptr = sl_cli_get_argument_hex(args, 3, &hex_array_size);
// uint8_t ptr to {0xAA, 0xBB, 0xCC}, hex_array_size = 3
}

◆ sl_cli_get_argument_uint16

#define sl_cli_get_argument_uint16 (   a,
 
)    (*(uint16_t *)((a)->argv[(a)->arg_ofs + (n)]))

Obtain uint16 arguments.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is the number 0, the next 1, etc.
Returns
The argument value.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the arguments (after the command strings).
char *text_ptr = sl_cli_get_argument_string(args, 0); // char ptr to
// "hello"
uint8_t num1_u8 = sl_cli_get_argument_uint8(args, 1); // num1_u8 = 255
int16_t num2_i16 = sl_cli_get_argument_int16(args, 2); // num2_i16 = -100
size_t hex_array_size;
uint8_t *hex_array_ptr = sl_cli_get_argument_hex(args, 3, &hex_array_size);
// uint8_t ptr to {0xAA, 0xBB, 0xCC}, hex_array_size = 3
}

◆ sl_cli_get_argument_uint32

#define sl_cli_get_argument_uint32 (   a,
 
)    (*(uint32_t *)((a)->argv[(a)->arg_ofs + (n)]))

Obtain uint32 arguments.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is the number 0, the next 1, etc.
Returns
The argument value.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the arguments (after the command strings).
char *text_ptr = sl_cli_get_argument_string(args, 0); // char ptr to
// "hello"
uint8_t num1_u8 = sl_cli_get_argument_uint8(args, 1); // num1_u8 = 255
int16_t num2_i16 = sl_cli_get_argument_int16(args, 2); // num2_i16 = -100
size_t hex_array_size;
uint8_t *hex_array_ptr = sl_cli_get_argument_hex(args, 3, &hex_array_size);
// uint8_t ptr to {0xAA, 0xBB, 0xCC}, hex_array_size = 3
}

◆ sl_cli_get_argument_string

#define sl_cli_get_argument_string (   a,
 
)    ((char *)((a)->argv[(a)->arg_ofs + (n)]))

Obtain string arguments.

Parameters
[in]aA pointer to the command arguments.
[in]nThe argument number. The first argument is the number 0, the next 1, etc.
Returns
The argument value. For hex arguments, the return value is a pointer to a buffer containing decoded values. For string arguments, the return value is a pointer to the string.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the arguments (after the command strings).
char *text_ptr = sl_cli_get_argument_string(args, 0); // char ptr to
// "hello"
uint8_t num1_u8 = sl_cli_get_argument_uint8(args, 1); // num1_u8 = 255
int16_t num2_i16 = sl_cli_get_argument_int16(args, 2); // num2_i16 = -100
size_t hex_array_size;
uint8_t *hex_array_ptr = sl_cli_get_argument_hex(args, 3, &hex_array_size);
// uint8_t ptr to {0xAA, 0xBB, 0xCC}, hex_array_size = 3
}

◆ sl_cli_get_command_count

#define sl_cli_get_command_count (   a)    ((int)((a)->arg_ofs))

Obtain the number of command strings.

Users obtain the number of command strings with this macro.

Parameters
[in]aThe number of command strings.
Returns
The number of command strings.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the number of command strings (before the arguments).
int cmd_count = sl_cli_get_command_count(args); // cmd_count = 2
// (first string being "example_sub_menu" and second "example_command")
}

◆ sl_cli_get_command_string

#define sl_cli_get_command_string (   a,
 
)    ((char *)((a)->argv[(n)]))

Obtain the command string(s).

Users get the command string with this macro. If the command is used in a group, both the group string(s) and command string can be obtained. The total number of command strings is available in the command argument arg_ofs variable.

Parameters
[in]aA pointer to the command arguments.
[in]nThe command string number. The first string is number 0, the next 1, etc.

An example could be the CLI input of example_sub_menu example_command hello 255 -100 {AA BB CC} with corresponding C code of:

void example_command(sl_cli_command_arg_t *args)
{
// Get the command strings (before the arguments).
char *cmd1_ptr = sl_cli_get_command_string(args, 0); // char ptr to
// "example_sub_menu"
char *cmd2_ptr = sl_cli_get_command_string(args, 1); // char ptr to
// "example_command"
}

◆ SL_CLI_INPUT_DIRECTION_UP

#define SL_CLI_INPUT_DIRECTION_UP   (1)

MACROS ************************************.

Define the UP-direction.

◆ SL_CLI_INPUT_DIRECTION_DOWN

#define SL_CLI_INPUT_DIRECTION_DOWN   (-1)

Define the DOWN-direction.

◆ SL_CLI_COMMAND

#define SL_CLI_COMMAND (   function,
  help_text,
  arg_help,
  ... 
)
Value:
{ \
(function), /* Pointer to command function */ \
__VA_ARGS__ /* Argument list*/ \
}

A macro, which is used to create commands.

◆ SL_CLI_COMMAND_GROUP

#define SL_CLI_COMMAND_GROUP (   group_table,
  help_text 
)
Value:
{ \
((sl_cli_command_func_t)(group_table)), /* Group pointer */ \
{ SL_CLI_ARG_GROUP, } /* Group indicator */ \
}

A macro, which is used to create command groups.

Typedef Documentation

◆ sl_cli_argument_type_t

typedef uint8_t sl_cli_argument_type_t

Argument type typedef.

◆ sl_cli_command_func_t

typedef void(* sl_cli_command_func_t) (sl_cli_command_arg_t *arguments)

Command handler data type.

◆ sl_cli_command_function_t

typedef void(* sl_cli_command_function_t) (char *arg_str, void *user)

Redirect command function.

Enumeration Type Documentation

◆ sl_cli_arg

enum sl_cli_arg

Enum of all the argument types.

Enumerator
sl_cli_arg_uint8 

UINT8 argument type.

sl_cli_arg_uint16 

UINT16 argument type.

sl_cli_arg_uint32 

UINT32 argument type.

sl_cli_arg_int8 

INT8 argument type.

sl_cli_arg_int16 

INT16 argument type.

sl_cli_arg_int32 

INT32 argument type.

sl_cli_arg_string 

STRING argument type.

sl_cli_arg_hex 

HEX argument type.

sl_cli_arg_uint8opt 

Optional UINT8 argument type.

sl_cli_arg_uint16opt 

Optional UINT16 argument type.

sl_cli_arg_uint32opt 

Optional UINT32 argument type.

sl_cli_arg_int8opt 

Optional INT8 argument type.

sl_cli_arg_int16opt 

Optional INT16 argument type.

sl_cli_arg_int32opt 

Optional INT32 argument type.

sl_cli_arg_stringopt 

Optional STRING argument type.

sl_cli_arg_hexopt 

Optional HEX argument type.

sl_cli_arg_additionnal 

ADDITIONAL argument type.

sl_cli_arg_wildcard 

WILDCARD argument type.

sl_cli_arg_group 

GROUP argument type.

sl_cli_arg_end 

END argument type.

Variable Documentation

◆ sl_cli_default_handle

sl_cli_handle_t sl_cli_default_handle

The default CLI handle.

◆ sl_cli_default_command_group

sl_cli_command_group_t* sl_cli_default_command_group

The default CLI command group.