Simple embedded shell with runtime pluggable commands.
Implements a simple unix-like shell for embedded systems with a pluggable command architecture.
SimpleShell.h@23:b1e49cfcaef6, 2018-12-24 (annotated)
- Committer:
- shimniok
- Date:
- Mon Dec 24 18:35:29 2018 +0000
- Revision:
- 23:b1e49cfcaef6
- Parent:
- 22:b0e6d416ce99
- Child:
- 25:9340833d92c0
add send command
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
shimniok | 22:b0e6d416ce99 | 1 | #ifndef __SIMPLESHELL_H |
shimniok | 22:b0e6d416ce99 | 2 | #define __SIMPLESHELL_H |
shimniok | 22:b0e6d416ce99 | 3 | |
shimniok | 22:b0e6d416ce99 | 4 | #include "mbed.h" |
shimniok | 22:b0e6d416ce99 | 5 | |
shimniok | 22:b0e6d416ce99 | 6 | /** SimpleShell |
shimniok | 22:b0e6d416ce99 | 7 | * A simple, flexible, embedded shell with dynamically added shell commands. |
shimniok | 22:b0e6d416ce99 | 8 | * Shell commands must be void(). |
shimniok | 22:b0e6d416ce99 | 9 | * @code |
shimniok | 22:b0e6d416ce99 | 10 | * #include "SimpleShell.h" |
shimniok | 22:b0e6d416ce99 | 11 | * |
shimniok | 22:b0e6d416ce99 | 12 | * void helloworld() { printf("Hello world!\n"); } |
shimniok | 22:b0e6d416ce99 | 13 | * |
shimniok | 22:b0e6d416ce99 | 14 | * int main() { |
shimniok | 22:b0e6d416ce99 | 15 | * SimpleShell sh; |
shimniok | 22:b0e6d416ce99 | 16 | * sh.attach(helloworld, "test"); |
shimniok | 22:b0e6d416ce99 | 17 | * sh.run(); |
shimniok | 22:b0e6d416ce99 | 18 | * } |
shimniok | 22:b0e6d416ce99 | 19 | * @endcode |
shimniok | 22:b0e6d416ce99 | 20 | */ |
shimniok | 22:b0e6d416ce99 | 21 | class SimpleShell { |
shimniok | 22:b0e6d416ce99 | 22 | public: |
shimniok | 22:b0e6d416ce99 | 23 | |
shimniok | 22:b0e6d416ce99 | 24 | /// Callback type used for shell commands |
shimniok | 22:b0e6d416ce99 | 25 | typedef Callback<void(int, char**)> callback_t; |
shimniok | 22:b0e6d416ce99 | 26 | |
shimniok | 22:b0e6d416ce99 | 27 | /// Create a new shell instance |
shimniok | 22:b0e6d416ce99 | 28 | SimpleShell(); |
shimniok | 22:b0e6d416ce99 | 29 | |
shimniok | 22:b0e6d416ce99 | 30 | /** Call this to run the shell. |
shimniok | 22:b0e6d416ce99 | 31 | * @note The shell can be run in a new thread. |
shimniok | 22:b0e6d416ce99 | 32 | * @code |
shimniok | 22:b0e6d416ce99 | 33 | * SimpleShell sh; |
shimniok | 22:b0e6d416ce99 | 34 | * sh.run(); |
shimniok | 22:b0e6d416ce99 | 35 | * thread.start(callback(&sh, &SimpleShell::run)); |
shimniok | 22:b0e6d416ce99 | 36 | * @endcode |
shimniok | 22:b0e6d416ce99 | 37 | */ |
shimniok | 22:b0e6d416ce99 | 38 | void run(); |
shimniok | 22:b0e6d416ce99 | 39 | |
shimniok | 22:b0e6d416ce99 | 40 | /** Attaches a shell command |
shimniok | 22:b0e6d416ce99 | 41 | * @param cb is the callback function that implements the command |
shimniok | 22:b0e6d416ce99 | 42 | * @param command is the string used to invoke the command in the shell |
shimniok | 22:b0e6d416ce99 | 43 | * @code |
shimniok | 22:b0e6d416ce99 | 44 | * sh.attach(helloworld, "test"); |
shimniok | 22:b0e6d416ce99 | 45 | * @endcode |
shimniok | 22:b0e6d416ce99 | 46 | */ |
shimniok | 22:b0e6d416ce99 | 47 | void attach(callback_t cb, char *command); |
shimniok | 22:b0e6d416ce99 | 48 | |
shimniok | 22:b0e6d416ce99 | 49 | |
shimniok | 22:b0e6d416ce99 | 50 | private: |
shimniok | 22:b0e6d416ce99 | 51 | /// Maximum number of commands |
shimniok | 22:b0e6d416ce99 | 52 | static const int MAXLOOKUP=16; |
shimniok | 22:b0e6d416ce99 | 53 | |
shimniok | 22:b0e6d416ce99 | 54 | /// Maximum command line buffer size |
shimniok | 22:b0e6d416ce99 | 55 | static const int MAXBUF=64; |
shimniok | 22:b0e6d416ce99 | 56 | |
shimniok | 22:b0e6d416ce99 | 57 | /// internal struct to contain a single command |
shimniok | 22:b0e6d416ce99 | 58 | typedef struct { |
shimniok | 22:b0e6d416ce99 | 59 | char *command; |
shimniok | 22:b0e6d416ce99 | 60 | callback_t cb; |
shimniok | 22:b0e6d416ce99 | 61 | } command_entry_t; |
shimniok | 22:b0e6d416ce99 | 62 | |
shimniok | 22:b0e6d416ce99 | 63 | /// canonicalize path |
shimniok | 22:b0e6d416ce99 | 64 | char *canon(char *path); |
shimniok | 22:b0e6d416ce99 | 65 | |
shimniok | 23:b1e49cfcaef6 | 66 | /// return basename of path |
shimniok | 23:b1e49cfcaef6 | 67 | char *basename(char *path); |
shimniok | 23:b1e49cfcaef6 | 68 | |
shimniok | 22:b0e6d416ce99 | 69 | /** finds and eturns the callback for a command |
shimniok | 22:b0e6d416ce99 | 70 | * @return Callback to a function returning void |
shimniok | 22:b0e6d416ce99 | 71 | */ |
shimniok | 22:b0e6d416ce99 | 72 | callback_t findCommand(); |
shimniok | 22:b0e6d416ce99 | 73 | |
shimniok | 22:b0e6d416ce99 | 74 | /// Built-in shell command to display list of commands |
shimniok | 22:b0e6d416ce99 | 75 | void help(int argc, char **argv); |
shimniok | 22:b0e6d416ce99 | 76 | |
shimniok | 22:b0e6d416ce99 | 77 | /// Change current directory |
shimniok | 22:b0e6d416ce99 | 78 | void cd(int argc, char **argv); |
shimniok | 22:b0e6d416ce99 | 79 | |
shimniok | 22:b0e6d416ce99 | 80 | /// Built-in shell command to print working directory |
shimniok | 22:b0e6d416ce99 | 81 | void pwd(int argc, char **argv); |
shimniok | 22:b0e6d416ce99 | 82 | |
shimniok | 22:b0e6d416ce99 | 83 | /// Built-in shell command to list files in directory |
shimniok | 22:b0e6d416ce99 | 84 | void ls(int argc, char **argv); |
shimniok | 22:b0e6d416ce99 | 85 | |
shimniok | 22:b0e6d416ce99 | 86 | /// Built-in shell command to remove a file |
shimniok | 22:b0e6d416ce99 | 87 | void rm(int argc, char **argv); |
shimniok | 22:b0e6d416ce99 | 88 | |
shimniok | 22:b0e6d416ce99 | 89 | /// Built-in shell command to create a file |
shimniok | 22:b0e6d416ce99 | 90 | void touch(int argc, char **argv); |
shimniok | 22:b0e6d416ce99 | 91 | |
shimniok | 22:b0e6d416ce99 | 92 | /// Built-in shell command to display contents of file |
shimniok | 22:b0e6d416ce99 | 93 | void cat(int argc, char **argv); |
shimniok | 23:b1e49cfcaef6 | 94 | |
shimniok | 23:b1e49cfcaef6 | 95 | /// Built-in shell command to display contents of file |
shimniok | 23:b1e49cfcaef6 | 96 | void send(int argc, char **argv); |
shimniok | 22:b0e6d416ce99 | 97 | |
shimniok | 22:b0e6d416ce99 | 98 | /// Prints command prompt |
shimniok | 22:b0e6d416ce99 | 99 | void printPrompt(void); |
shimniok | 22:b0e6d416ce99 | 100 | |
shimniok | 22:b0e6d416ce99 | 101 | /// Reads a command from the prompt (with editing) |
shimniok | 22:b0e6d416ce99 | 102 | void readCommand(); |
shimniok | 22:b0e6d416ce99 | 103 | |
shimniok | 22:b0e6d416ce99 | 104 | /// Command lookup table |
shimniok | 22:b0e6d416ce99 | 105 | command_entry_t lookup[MAXLOOKUP]; |
shimniok | 22:b0e6d416ce99 | 106 | |
shimniok | 22:b0e6d416ce99 | 107 | /// Current end of lookup table |
shimniok | 22:b0e6d416ce99 | 108 | int lookupEnd; |
shimniok | 22:b0e6d416ce99 | 109 | |
shimniok | 22:b0e6d416ce99 | 110 | /// Maximum number of arguments |
shimniok | 22:b0e6d416ce99 | 111 | static const int MAXARGS=3; |
shimniok | 22:b0e6d416ce99 | 112 | |
shimniok | 22:b0e6d416ce99 | 113 | /// Command and arguments |
shimniok | 22:b0e6d416ce99 | 114 | char *argv[MAXARGS]; |
shimniok | 22:b0e6d416ce99 | 115 | |
shimniok | 22:b0e6d416ce99 | 116 | /// Size of argv |
shimniok | 22:b0e6d416ce99 | 117 | int argc; |
shimniok | 22:b0e6d416ce99 | 118 | |
shimniok | 22:b0e6d416ce99 | 119 | /// Current working directory |
shimniok | 22:b0e6d416ce99 | 120 | char _cwd[MAXBUF]; |
shimniok | 22:b0e6d416ce99 | 121 | |
shimniok | 22:b0e6d416ce99 | 122 | /// shell command history |
shimniok | 22:b0e6d416ce99 | 123 | |
shimniok | 22:b0e6d416ce99 | 124 | |
shimniok | 22:b0e6d416ce99 | 125 | }; // class |
shimniok | 22:b0e6d416ce99 | 126 | |
shimniok | 22:b0e6d416ce99 | 127 | #endif |