Command Line Interface#

sl_cli_arg_t#

sl_cli_arg_t

Enum of all the argument types.

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) )(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) )(char *arg_str, void *user)

Redirect command function.

sl_cli_input_type_t#

typedef uint8_t sl_cli_input_type_t

sl cli input type t

sl_cli_handle_t#

typedef sl_cli_t* sl_cli_handle_t

sl cli handle t

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.

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.

Returns

• Initialization status.

sl_cli_set_simple_password#

sl_status_t sl_cli_set_simple_password (char * new_password)

Set a new password.

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.

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.

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.

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.

Returns

• Status of the execution.

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 '\'.

Returns

• Status of the operation.

sl_cli_input_char#

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.

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.

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.

sl_cli_get_argument_hex#

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.

Returns

• A pointer to the value buffer.

sl_cli_clear#

void sl_cli_clear (sl_cli_handle_t handle)

Clear (reset) a CLI.

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.

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.

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.

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.

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.