Statistics
| Branch: | Tag: | Revision:

amiro-os / core / inc / aos_shell.h @ 3940ba8a

History | View | Annotate | Download (11.1 KB)

1
/*
2
AMiRo-OS is an operating system designed for the Autonomous Mini Robot (AMiRo) platform.
3
Copyright (C) 2016..2019  Thomas Schöpping et al.
4

5
This program is free software: you can redistribute it and/or modify
6
it under the terms of the GNU General Public License as published by
7
the Free Software Foundation, either version 3 of the License, or
8
(at your option) any later version.
9

10
This program is distributed in the hope that it will be useful,
11
but WITHOUT ANY WARRANTY; without even the implied warranty of
12
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13
GNU General Public License for more details.
14

15
You should have received a copy of the GNU General Public License
16
along with this program.  If not, see <http://www.gnu.org/licenses/>.
17
*/
18

    
19
/**
20
 * @file    aos_shell.h
21
 * @brief   Shell macros and structures.
22
 *
23
 * @addtogroup aos_shell
24
 * @{
25
 */
26

    
27
#ifndef AMIROOS_SHELL_H
28
#define AMIROOS_SHELL_H
29

    
30
#include <amiroos.h>
31

    
32
#if (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true)
33

    
34
/******************************************************************************/
35
/* CONSTANTS                                                                  */
36
/******************************************************************************/
37

    
38
/**
39
 * @brief   Shell event flag that is emitted when the thread starts.
40
 */
41
#define AOS_SHELL_EVTFLAG_START                   ((eventflags_t)(1 << 0))
42

    
43
/**
44
 * @brief   Shell event flag that is emitted when a command is executed.
45
 */
46
#define AOS_SHELL_EVTFLAG_EXEC                    ((eventflags_t)(1 << 1))
47

    
48
/**
49
 * @brief   Shell event flag that is emitted when a command execution finished.
50
 */
51
#define AOS_SHELL_EVTFLAG_DONE                    ((eventflags_t)(1 << 2))
52

    
53
/**
54
 * @brief   Shell event flag that is emitted when the shread stops.
55
 */
56
#define AOS_SHELL_EVTFLAG_EXIT                    ((eventflags_t)(1 << 3))
57

    
58
/**
59
 * @brief   Shell event flag that is emitted when an I/O error occurred.
60
 */
61
#define AOS_SHELL_EVTFLAG_IOERROR                 ((eventflags_t)(1 << 4))
62

    
63
/**
64
 * @brief   Shell input configuration for replacing content by user input.
65
 */
66
#define AOS_SHELL_CONFIG_INPUT_OVERWRITE          (1 << 0)
67

    
68
/**
69
 * @brief   Shell prompt configuration print a minimalistic prompt.
70
 */
71
#define AOS_SHELL_CONFIG_PROMPT_MINIMAL           (1 << 1)
72

    
73
/**
74
 * @brief   Shell prompt configuration to additionally print the system uptime with the prompt.
75
 */
76
#define AOS_SHELL_CONFIG_PROMPT_UPTIME            (1 << 2)
77

    
78
/**
79
 * @brief   Shell prompt configuration to additionally print the date and time with the prompt.
80
 */
81
#define AOS_SHELL_CONFIG_PROMPT_DATETIME          (2 << 2)
82

    
83
/**
84
 * @brief   Shell prompt configuration to additionally print the system uptime with the prompt.
85
 */
86
#define AOS_SHELL_CONFIG_MATCH_CASE               (1 << 4)
87

    
88
/**
89
 * @brief   Shell I/O channel flag whether the channel is attached to a list.
90
 */
91
#define AOS_SHELLCHANNEL_ATTACHED                 (1 << 0)
92

    
93
/**
94
 * @brief   Shell I/O channel flag whether the channel is enabled as input.
95
 */
96
#define AOS_SHELLCHANNEL_INPUT_ENABLED            (1 << 1)
97

    
98
/**
99
 * @brief   Shell I/O channel flag whether the channel is enabled as output.
100
 */
101
#define AOS_SHELLCHANNEL_OUTPUT_ENABLED           (1 << 2)
102

    
103
/******************************************************************************/
104
/* SETTINGS                                                                   */
105
/******************************************************************************/
106

    
107
/******************************************************************************/
108
/* CHECKS                                                                     */
109
/******************************************************************************/
110

    
111
/******************************************************************************/
112
/* DATA STRUCTURES AND TYPES                                                  */
113
/******************************************************************************/
114

    
115
/**
116
 * @brief   AosShellChannel specific methods.
117
 */
118
#define _aos_shell_channel_methods                                          \
119
  _base_asynchronous_channel_methods
120

    
121
/**
122
 * @brief   AosShellChannel specific data.
123
 */
124
#define _aos_shell_channel_data                                             \
125
  /* pointer to a BaseAsynchronousChannel object */                         \
126
  BaseAsynchronousChannel* asyncchannel;                                    \
127
  /* event listener for the associated BaseAsynchronousChannel */           \
128
  event_listener_t listener;                                                \
129
  /* pointer to the next chennal in a AosShellStream */                     \
130
  struct aos_shellchannel* next;                                            \
131
  /* flags related to the channel */                                        \
132
  uint8_t flags;
133

    
134
/**
135
 * @extends BaseAsynchronousChannelVMT
136
 *
137
 * @brief   AosShellChannel virtual methods table.
138
 */
139
struct AosShellChannelVMT {
140
  _aos_shell_channel_methods
141
};
142

    
143
/**
144
 * @extends BaseAsynchronousChannel
145
 *
146
 * @brief   Shell channel class.
147
 * @details This class implements an asynchronous I/O channel.
148
 */
149
typedef struct aos_shellchannel {
150
  /** @brief Virtual Methods Table. */
151
  const struct AosShellChannelVMT* vmt;
152
  _aos_shell_channel_data
153
} AosShellChannel;
154

    
155
/**
156
 * @brief   AosShellStream methods.
157
 */
158
#define _aos_shellstream_methods                                            \
159
  _base_sequential_stream_methods
160

    
161
/**
162
 * @brief   AosShellStream data.
163
 */
164
#define _aos_shellstream_data                                               \
165
  /* Pointer to the first channel in a list. */                             \
166
  AosShellChannel* channel;
167

    
168
/**
169
 * @extends BaseSequentialStream
170
 *
171
 * @brief   AosShellStream virtual methods table.
172
 */
173
struct AosShellStreamVMT {
174
  _aos_shellstream_methods
175
};
176

    
177
/**
178
 * @extends BaseSequentialStream
179
 *
180
 * @brief   Shell Stream class.
181
 * @details This class implements an base sequential stream.
182
 * @todo    So far only output but no input is supported.
183
 */
184
typedef struct aos_shellstream {
185
  const struct AosShellStreamVMT* vmt;
186
  _aos_shellstream_data
187
} AosShellStream;
188

    
189
/**
190
 * @brief   Shell command calback type.
191
 */
192
typedef int (*aos_shellcmdcb_t)(BaseSequentialStream* stream, int argc, char* argv[]);
193

    
194
/**
195
 * @brief   Shell command structure.
196
 */
197
typedef struct aos_shellcommand {
198
  /**
199
   * @brief   Command name.
200
   */
201
  const char* name;
202

    
203
  /**
204
   * @brief   Callback function.
205
   */
206
  aos_shellcmdcb_t callback;
207

    
208
  /**
209
   * @brief   Pointer to next command in a singly linked list.
210
   */
211
  struct aos_shellcommand* next;
212

    
213
} aos_shellcommand_t;
214

    
215
/**
216
 * @brief   Execution status of a shell command.
217
 */
218
typedef struct aos_shellexecstatus {
219
  /**
220
   * @brief   Pointer to the command that was executed.
221
   */
222
  aos_shellcommand_t* command;
223

    
224
  /**
225
   * @brief   Return value of the executed command.
226
   */
227
  int retval;
228
} aos_shellexecstatus_t;
229

    
230
/**
231
 * @brief   Enumerator to encode shell actions.
232
 */
233
typedef enum aos_shellaction {
234
  AOS_SHELL_ACTION_NONE,
235
  AOS_SHELL_ACTION_READCHAR,
236
  AOS_SHELL_ACTION_AUTOFILL,
237
  AOS_SHELL_ACTION_SUGGEST,
238
  AOS_SHELL_ACTION_INSERTTOGGLE,
239
  AOS_SHELL_ACTION_DELETEFORWARD,
240
  AOS_SHELL_ACTION_DELETEBACKWARD,
241
  AOS_SHELL_ACTION_RECALLLAST,
242
  AOS_SHELL_ACTION_CLEAR,
243
  AOS_SHELL_ACTION_CURSOR2START,
244
  AOS_SHELL_ACTION_CURSOR2END,
245
  AOS_SHELL_ACTION_CURSORLEFT,
246
  AOS_SHELL_ACTION_CURSORRIGHT,
247
  AOS_SHELL_ACTION_EXECUTE,
248
  AOS_SHELL_ACTION_ESCSTART,
249
} aos_shellaction_t;
250

    
251
/**
252
 * @brief   Shell structure.
253
 */
254
typedef struct aos_shell {
255
  /**
256
   * @brief   Pointer to the thread object.
257
   */
258
  thread_t* thread;
259

    
260
  /**
261
   * @brief   Event source.
262
   */
263
  event_source_t eventSource;
264

    
265
  /**
266
   * @brief   Struct for OS related events
267
   */
268
  struct {
269
    /**
270
     * @brief   Pointer to the OS' event source.
271
     */
272
    event_source_t* eventSource;
273

    
274
    /**
275
     * @brief   Listener for OS related events.
276
     */
277
    event_listener_t eventListener;
278
  } os;
279

    
280
  /**
281
     * @brief   Pointer to the first I/O channel.
282
     */
283
  AosShellStream stream;
284

    
285
  /**
286
   * @brief   String to printed as prompt.
287
   */
288
  const char* prompt;
289

    
290
  /**
291
   * @brief   Pointer to the first element of the singly linked list of commands.
292
   * @details Commands are ordered alphabetically in the list.
293
   */
294
  aos_shellcommand_t* commands;
295

    
296
  /**
297
   * @brief   Execution status of the most recent command.
298
   */
299
  aos_shellexecstatus_t execstatus;
300

    
301
  /**
302
   * @brief   Input buffer.
303
   */
304
  char* line;
305

    
306
  /**
307
   * @brief   Size of the input buffer.
308
   */
309
  size_t linesize;
310

    
311
  /**
312
   * @brief   Structure containing data for internal input parsing.
313
   */
314
  struct {
315
    /**
316
     * @brief   The last action executed by the shell.
317
     */
318
    aos_shellaction_t lastaction;
319

    
320
    /**
321
     * @brief   Number of character in the current escape sequence.
322
     */
323
    uint8_t escp;
324

    
325
    /**
326
     * @brief   Buffer to store an escape sequence.
327
     */
328
    char escseq[5];
329

    
330
    /**
331
     * @brief   Current curso position.
332
     */
333
    size_t cursorpos;
334

    
335
    /**
336
     * @brief   Current line width.
337
     */
338
    size_t lineend;
339

    
340
    /**
341
     * @brief   Flag whether there was input since the prompt was printed the last time.
342
     */
343
    bool noinput;
344
  } inputdata;
345

    
346
  /**
347
   * @brief   Argument buffer.
348
   */
349
  char** arglist;
350

    
351
  /**
352
   * @brief   Size of the argument buffer.
353
   */
354
  size_t arglistsize;
355

    
356
  /**
357
   * @brief   Configuration flags.
358
   */
359
  uint8_t config;
360
} aos_shell_t;
361

    
362
/******************************************************************************/
363
/* MACROS                                                                     */
364
/******************************************************************************/
365

    
366
/******************************************************************************/
367
/* EXTERN DECLARATIONS                                                        */
368
/******************************************************************************/
369

    
370
#ifdef __cplusplus
371
extern "C" {
372
#endif
373
  void aosShellInit(aos_shell_t* shell, event_source_t* oseventsource, const char* prompt, char* line, size_t linesize, char** arglist, size_t arglistsize);
374
  void aosShellStreamInit(AosShellStream* stream);
375
  void aosShellChannelInit(AosShellChannel* channel, BaseAsynchronousChannel* asyncchannel);
376
  aos_status_t aosShellAddCommand(aos_shell_t* shell, aos_shellcommand_t* cmd);
377
  aos_status_t aosShellRemoveCommand(aos_shell_t* shell, char* cmd, aos_shellcommand_t** removed);
378
  unsigned int aosShellCountCommands(aos_shell_t* shell);
379
  void aosShellStreamAddChannel(AosShellStream* stream, AosShellChannel* channel);
380
  aos_status_t aosShellStreamRemoveChannel(AosShellStream* stream, AosShellChannel* channel);
381
  void aosShellChannelInputEnable(AosShellChannel* channel);
382
  void aosShellChannelInputDisable( AosShellChannel* channel);
383
  void aosShellChannelOutputEnable(AosShellChannel* channel);
384
  void aosShellChannelOutputDisable(AosShellChannel* channel);
385
  THD_FUNCTION(aosShellThread, shell);
386
#ifdef __cplusplus
387
}
388
#endif
389

    
390
/******************************************************************************/
391
/* INLINE FUNCTIONS                                                           */
392
/******************************************************************************/
393

    
394
#endif /* (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true) */
395

    
396
#endif /* AMIROOS_SHELL_H */
397

    
398
/** @} */