Skip to content

File wsh_shell.h

File List > src > wsh_shell.h

Go to the documentation of this file

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
#ifndef __WSH_SHELL_H
#define __WSH_SHELL_H

#include "wsh_shell_autocomplete.h"
#include "wsh_shell_cfg.h"
#include "wsh_shell_cmd.h"
#include "wsh_shell_cmd_def.h"
#include "wsh_shell_esc.h"
#include "wsh_shell_history.h"
#include "wsh_shell_interact.h"
#include "wsh_shell_io.h"
#include "wsh_shell_promptwait.h"
#include "wsh_shell_ps1_custom.h"
#include "wsh_shell_str.h"
#include "wsh_shell_types.h"
#include "wsh_shell_user.h"
#include "wsh_shell_version.h"

/* detect operating system name */
#if defined(__linux)
    #define OS_NAME "Linux"
#elif defined(__unix)
    #define OS_NAME "Unix"
#elif defined(__APPLE__)
    #define OS_NAME "Darwin"
#elif defined(_WIN32)
    #define OS_NAME "Windows"
#elif defined(tskKERNEL_VERSION_NUMBER)
    #define OS_NAME "FreeRTOS " tskKERNEL_VERSION_NUMBER
#else
    #define OS_NAME WSH_SHELL_TARGET_OS
#endif

/* detect compiler name and version */
#if defined(__clang__)
    #define COMPILER "clang " __clang_version__
#elif defined(__GNUC__)
    #define COMPILER "GCC " __VERSION__
#elif defined(_MSC_VER)
    #define COMPILER "MSVC"
#elif defined(__CC_ARM)
    #define COMPILER "ARMCC"
#elif defined(__ICCARM__)
    #define COMPILER "IAR"
#else
    #define COMPILER "Unknown Compiler"
#endif

#ifdef __cplusplus
extern "C" {
#endif

typedef void (*WshShell_ExtClbk_t)(void* pCtx);

typedef struct {
    WshShell_ExtClbk_t Auth;     
    WshShell_ExtClbk_t DeAuth;   
    WshShell_ExtClbk_t SymbolIn; 
} WshShell_ExtCallbacks_t;

typedef struct {
    WshShell_Char_t Login[WSH_SHELL_LOGIN_LEN]; 
    WshShell_Char_t Pass[WSH_SHELL_PASS_LEN];   
} WshShell_AuthCtx_t;

typedef struct {
    WshShell_Char_t* Version;                           
    WshShell_Char_t DeviceName[WSH_SHELL_DEV_NAME_LEN]; 
    WshShell_Char_t PS1[WSH_SHELL_PS1_MAX_LEN];         
    WshShell_Char_t PrevSym;                            
    WshShellIO_CommandLine_t CommandLine; 
    const WshShellUser_t* CurrUser;       
    WshShell_AuthCtx_t TmpAuth;           
    WshShellEsc_Storage_t EscStorage;     
    WshShellUser_Table_t Users;   
    WshShellCmd_Table_t Commands; 
    WshShellHistory_IO_t HistoryIO; 
    WshShell_Interact_t Interact;   
    WshShellPromptWait_t PromptWait;

    WshShell_ExtCallbacks_t ExtCallbacks; 
} WshShell_t;

WSH_SHELL_RET_STATE_t WshShell_Init(WshShell_t* pShell, const WshShell_Char_t* pcDevName,
                                    const WshShell_Char_t* pcCustomHeader,
                                    WshShell_ExtCallbacks_t* pExtClbks);

WshShell_Bool_t WshShell_Auth(WshShell_t* pShell, const WshShell_Char_t* pcLogin,
                              const WshShell_Char_t* pcPass);

WshShell_Bool_t WshShell_IsAuth(WshShell_t* pShell);

void WshShell_DeAuth(WshShell_t* pShell, const WshShell_Char_t* pcReason);

void WshShell_InsertChar(WshShell_t* pShell, const WshShell_Char_t symbol);

#ifdef __cplusplus
}
#endif

#endif /* __WSH_SHELL_H */