0.01.00
cli.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2016, The OpenThread Authors.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  * 1. Redistributions of source code must retain the above copyright
8  * notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  * notice, this list of conditions and the following disclaimer in the
11  * documentation and/or other materials provided with the distribution.
12  * 3. Neither the name of the copyright holder nor the
13  * names of its contributors may be used to endorse or promote products
14  * derived from this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
17  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
20  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26  * POSSIBILITY OF SUCH DAMAGE.
27  */
28 
35 #ifndef CLI_H_
36 #define CLI_H_
37 
38 #include <stdint.h>
39 #include <stdarg.h>
40 #include <openthread/types.h>
41 
42 #ifdef __cplusplus
43 extern "C" {
44 #endif
45 
50 typedef struct otCliCommand
51 {
52  const char *mName;
53  void (*mCommand)(int argc, char *argv[]);
54 } otCliCommand;
55 
76 typedef int (*otCliConsoleOutputCallback)(const char *aBuf,
77  uint16_t aBufLength, void *aContext);
78 
87 void otCliConsoleInit(otInstance *aInstance, otCliConsoleOutputCallback aCallback, void *aContext);
88 
96 void otCliConsoleInputLine(char *aBuf, uint16_t aBufLength);
97 
104 void otCliUartInit(otInstance *aInstance);
105 
112 void otCliUartSetUserCommands(const otCliCommand *aUserCommands, uint8_t aLength);
113 
120 void otCliUartOutputBytes(const uint8_t *aBytes, uint8_t aLength);
121 
128 void otCliUartOutputFormat(const char *aFmt, ...);
129 
135 void otCliUartAppendResult(otError aError);
136 
145 void otCliPlatLogv(otLogLevel aLogLevel, otLogRegion aLogRegion, const char *aFormat, va_list ap);
146 
152 #ifdef __cplusplus
153 } // extern "C"
154 #endif
155 
156 #endif
This type represents all the static / global variables used by OpenThread allocated in one place...
Definition: openthread-instance.h:59
This file defines the types and structures used in the OpenThread library API.
const char * mName
A pointer to the command string.
Definition: cli.h:52
uint8_t otLogLevel
Log levels.
Definition: types.h:1182
void otCliConsoleInputLine(char *aBuf, uint16_t aBufLength)
This method is called to feed in a console input line.
Definition: cli_console.cpp:58
struct otCliCommand otCliCommand
This structure represents a CLI command.
void otCliUartAppendResult(otError aError)
Write error code the CLI console.
Definition: cli_uart.cpp:88
This structure represents a CLI command.
Definition: cli.h:50
void otCliUartInit(otInstance *aInstance)
Initialize the CLI UART module.
Definition: cli_uart.cpp:65
void otCliUartOutputBytes(const uint8_t *aBytes, uint8_t aLength)
Write a number of bytes to the CLI console as a hex string.
Definition: cli_uart.cpp:75
void otCliUartSetUserCommands(const otCliCommand *aUserCommands, uint8_t aLength)
Set a user command table.
Definition: cli_uart.cpp:70
void(* mCommand)(int argc, char *argv[])
A function pointer to process the command.
Definition: cli.h:53
void otCliPlatLogv(otLogLevel aLogLevel, otLogRegion aLogRegion, const char *aFormat, va_list ap)
Callback to write the OpenThread Log to the CLI console.
Definition: cli_uart.cpp:295
otLogRegion
This enum represents log regions.
Definition: types.h:1188
int(* otCliConsoleOutputCallback)(const char *aBuf, uint16_t aBufLength, void *aContext)
This function pointer is called to notify about Console output.
Definition: cli.h:76
void otCliConsoleInit(otInstance *aInstance, otCliConsoleOutputCallback aCallback, void *aContext)
Initialize the CLI CONSOLE module.
Definition: cli_console.cpp:51
otError
This enumeration represents error codes used throughout OpenThread.
Definition: types.h:107
void otCliUartOutputFormat(const char *aFmt,...)
Write formatted string the CLI console.
Definition: cli_uart.cpp:80