avr/command_tbl.c

   1 /*
   2  * (C) Copyright 2014 Leo C. <erbl259-lmu@yahoo.de>
   3  *
   4  * SPDX-License-Identifier:     GPL-2.0+
   5  */
   6
   7 #include "common.h"
   8 #include "command.h"
   9 #include "cmd_mem.h"
  10
  11 extern command_ret_t do_help(cmd_tbl_t *, int, int, char * const []);
  12 extern command_ret_t do_echo(cmd_tbl_t *, int, int, char * const []);
  13 extern command_ret_t do_sleep(cmd_tbl_t *, int, int, char * const []);
  14 extern command_ret_t do_env_print(cmd_tbl_t *, int, int, char * const []);
  15 extern command_ret_t do_env_default(cmd_tbl_t *, int, int, char * const []);
  16 extern command_ret_t do_env_set(cmd_tbl_t *, int, int, char * const []);
  17 extern command_ret_t do_env_save(cmd_tbl_t *, int, int, char * const []);
  18 extern command_ret_t do_loadf(cmd_tbl_t *, int, int, char * const []);
  19 extern command_ret_t do_loadcpm3(cmd_tbl_t *, int, int, char * const []);
  20 extern command_ret_t do_loadihex(cmd_tbl_t *, int, int, char * const []);
  21 extern command_ret_t do_go(cmd_tbl_t *, int, int, char * const []);
  22 extern command_ret_t do_restart(cmd_tbl_t *, int, int, char * const []);
  23 extern command_ret_t do_console(cmd_tbl_t *, int, int, char * const []);
  24 extern command_ret_t do_dump_mem(cmd_tbl_t *, int, int, char * const []);
  25 extern command_ret_t do_eep_cp(cmd_tbl_t *, int, int, char * const []);
  26 extern command_ret_t do_busreq_pulse(cmd_tbl_t *, int, int, char * const []);
  27 extern command_ret_t do_date(cmd_tbl_t *, int, int, char * const []);
  28 extern command_ret_t do_gpio(cmd_tbl_t *, int, int, char * const []);
  29 extern command_ret_t do_sd(cmd_tbl_t *, int, int, char * const []);
  30 extern command_ret_t do_fat_stat(cmd_tbl_t *, int, int, char * const []);
  31 extern command_ret_t do_fat_ls(cmd_tbl_t *, int, int, char * const []);
  32 //extern command_ret_t do_fat_read(cmd_tbl_t *, int, int, char * const []);
  33 //extern command_ret_t do_fat_write(cmd_tbl_t *, int, int, char * const []);
  34 extern command_ret_t do_fat_rw(cmd_tbl_t *, int, int, char * const []);
  35
  36 #ifdef CONFIG_SYS_LONGHELP
  37 const FLASH char sd_help_text[] =
  38         "bla \t- do bla\n"
  39         ;
  40 #endif /* CONFIG_SYS_LONGHELP */
  41
  42
  43 cmd_tbl_t cmd_tbl[] = {
  44
  45 CMD_TBL_ITEM(
  46         date,   2,      1,      do_date,
  47         "get/set date & time",
  48         "[MMDDhhmm[[CC]YY][.ss]]\ndate reset\n"
  49         "  - without arguments: print date & time\n"
  50         "  - with numeric argument: set the system date & time\n"
  51 ),
  52
  53 #ifdef DEBUG
  54
  55 CMD_TBL_ITEM(
  56         !mdr,   3,      1,      do_dump_mem,
  57         "RAM dump",
  58         "address [count]"
  59 ),
  60 CMD_TBL_ITEM(
  61         !mde,   3,      1,      do_dump_mem,
  62         "EEPROM dump",
  63         "address [count]"
  64 ),
  65 CMD_TBL_ITEM(
  66         !cpe,   4,      0,      do_eep_cp,
  67         "EEPROM copy",
  68         "source target count"
  69 ),
  70 #endif
  71 CMD_TBL_ITEM(
  72         mstep,  2,      1,      do_busreq_pulse,
  73         "execute one M cycle",
  74         "[count]\n"
  75         "     - repeat count times"
  76 ),
  77 CMD_TBL_ITEM(
  78         echo,   CONFIG_SYS_MAXARGS,     1,      do_echo,
  79         "echo args to console",
  80         "[args..]\n"
  81         "     - echo args to console; \\c suppresses newline"
  82 ),
  83 CMD_TBL_ITEM(
  84         sleep ,    2,    1,     do_sleep,
  85         "delay execution for some time",
  86         "N[m][s]\n"
  87         "    - delay execution for decimal N (milli) seconds"
  88 ),
  89 CMD_TBL_ITEM_COMPLETE(
  90         run,    CONFIG_SYS_MAXARGS,     1,      do_run,
  91         "run commands in an environment variable",
  92         "var [...]\n"
  93         "    - run the commands in the environment variable(s) 'var'",
  94         var_complete
  95 ),
  96 CMD_TBL_ITEM_COMPLETE(
  97         printenv, CONFIG_SYS_MAXARGS,   1,      do_env_print,
  98         "print environment variables",
  99         "\n"
 100         "    - print values of all environment variables\n"
 101         "printenv name ...\n"
 102         "    - print value of environment variable 'name'",
 103         var_complete
 104 ),
 105 CMD_TBL_ITEM_COMPLETE(
 106         setenv, CONFIG_SYS_MAXARGS,     0,      do_env_set,
 107         "set environment variables",
 108         "name value ...\n"
 109         "    - set environment variable 'name' to 'value ...'\n"
 110         "setenv name\n"
 111         "    - delete environment variable 'name'",
 112         var_complete
 113 ),
 114 CMD_TBL_ITEM(
 115         saveenv,        1,      0,      do_env_save,
 116         "save environment variables to persistent storage",
 117         ""
 118 ),
 119 CMD_TBL_ITEM(
 120         defaultenv,     1,      0,      do_env_default,
 121         "set all environment variables to their default values",
 122         ""
 123 ),
 124
 125 CMD_TBL_ITEM(
 126         loadf,  1,      0,      do_loadf,
 127         "load srec_cat prepared image from controller flash",
 128         ""
 129 ),
 130 CMD_TBL_ITEM(
 131         loadcpm3, 3,    0,      do_loadcpm3,
 132         "load CPM3.SYS file",
 133         "[offset] [filename]\n"
 134         "    - Load CP/M 3 system file from FAT filesystem. This command makes\n"
 135         "      CPMLDR superfluous. Default filename is '"CONFIG_PATH_CPM3SYS"', but\n"
 136         "      uses environment variable '"ENV_PATH_CPM3SYS"', if set."
 137 ),
 138 CMD_TBL_ITEM(
 139         loadi,  2,      0,      do_loadihex,
 140         "load intel hex file over serial line",
 141         "[[-]offset]\n"
 142         "    - load Intel-Hex-Record file over serial line with offset 'offset'"
 143 ),
 144 CMD_TBL_ITEM(
 145         go,     2,      0,      do_go,
 146         "start application at address 'addr'",
 147         "addr\n"
 148         "    - start application at address 'addr'"
 149 //      "\n"
 150 //      "      passing 'arg' as arguments"
 151 ),
 152 CMD_TBL_ITEM(
 153         reset,  1,      0,      do_reset,
 154         "Keep CPU in RESET state",
 155         ""
 156 ),
 157 CMD_TBL_ITEM(
 158         restart, 1, 1,  do_restart,
 159         "Perform RESET of the CPU",
 160         ""
 161 ),
 162 CMD_TBL_ITEM(
 163         connect, 1, 0,  do_console,
 164         "Connect to CPU console i/o",
 165         ""
 166 ),
 167
 168 CMD_TBL_ITEM(
 169         pin, CONFIG_SYS_MAXARGS, 1,     do_gpio,
 170         "Set or query pin state",
 171         "[-s] [<pins>]\n"
 172         "    - print cofiguration and state or frequency of pins\n"
 173         "      print all pins, if argument is omitted\n"
 174         "pin <pins> h[igh]|l[ow]\n"
 175         "    - config pins as output and set to level high or low\n"
 176         "pin <pins> ts|i[n]|p[ullup]\n"
 177         "    - config pins as input/tristate or input with pullup\n"
 178         "pin <pins> value[K|M][Hz]\n"
 179         "    - output a clock on pins\n"
 180         "      value is system clock divider or frequency, if 'Hz' is appended\n"
 181         "      divider is rounded down to next possible value (depends on pin)\n"
 182         "\n"
 183         "<pins> is a comma separated list of numbers or ranges, i.e. \"0,9,3-6\"\n"
 184 ),
 185
 186 CMD_TBL_ITEM(
 187         md,     3,      1,      do_mem_md,
 188         "memory display",
 189         "address [# of objects]"
 190 ),
 191 CMD_TBL_ITEM(
 192         mm,     2,      1,      do_mem_mm,
 193         "memory modify (auto-incrementing address)",
 194         "address"
 195 ),
 196 CMD_TBL_ITEM(
 197         nm,     2,      1,      do_mem_nm,
 198         "memory modify (constant address)",
 199         "address"
 200 ),
 201 CMD_TBL_ITEM(
 202         mw,     4,      1,      do_mem_mw,
 203         "memory write (fill)",
 204         "address value [count]"
 205 ),
 206 CMD_TBL_ITEM(
 207         cp,     4,      1,      do_mem_cp,
 208         "memory copy",
 209         "source target count"
 210 ),
 211 CMD_TBL_ITEM(
 212         cmp,    4,      1,      do_mem_cmp,
 213         "memory compare",
 214         "addr1 addr2 count"
 215 ),
 216 CMD_TBL_ITEM(
 217         base,   2,      0,      do_mem_base,
 218         "print or set address offset",
 219         "\n"
 220         "    - print address offset for memory commands\n"
 221         "base offset\n"
 222         "    - set address offset for memory commands to 'offset'"
 223 ),
 224 CMD_TBL_ITEM(
 225         mloop,  3,      1,      do_mem_loop,
 226         "infinite loop on address range",
 227         "address number_of_bytes"
 228 ),
 229 CMD_TBL_ITEM(
 230         mloopw, 4,      1,      do_mem_loopw,
 231         "infinite write loop on address range",
 232         "address number_of_bytes data_to_write"
 233 ),
 234
 235 #ifdef CONFIG_CMD_MEMTEST
 236 CMD_TBL_ITEM(
 237         mtest,  4,      1,      do_mem_mtest,
 238         "simple RAM read/write test",
 239         "[start [end [iterations]]]"
 240 ),
 241 #endif  /* CONFIG_CMD_MEMTEST */
 242
 243 #ifdef CONFIG_MX_CYCLIC
 244 CMD_TBL_ITEM(
 245         mdc,    4,      1,      do_mem_mdc,
 246         "memory display cyclic",
 247         "address count delay(ms)"
 248 ),
 249 CMD_TBL_ITEM(
 250         mwc,    4,      1,      do_mem_mdc,
 251         "memory write cyclic",
 252         "address value delay(ms)"
 253 ),
 254 #endif /* CONFIG_MX_CYCLIC */
 255
 256 CMD_TBL_ITEM(
 257         sd,   CONFIG_SYS_MAXARGS, 1, do_sd,
 258         "SD/MMC card handling commands",
 259         "<subcommand> args ...\n"
 260         "sd help\n"
 261         "    - print help on subcommands"
 262 ),
 263
 264 CMD_TBL_ITEM(
 265         fatstat,        2,      1,      do_fat_stat,
 266         "Show logical drive status",
 267         "dev"
 268 ),
 269 CMD_TBL_ITEM(
 270         fatls,  2,      1,      do_fat_ls,
 271         "Directory listing",
 272         "path"
 273 ),
 274 CMD_TBL_ITEM(
 275         fatload,        5,      0,      do_fat_rw,
 276         "load binary file from a dos filesystem",
 277         "<d:/path/filename> <addr> [bytes [pos]]\n"
 278         "    - Load binary file 'path/filename' on logical drive 'd'\n"
 279         "      to address 'addr' from dos filesystem.\n"
 280         "      'pos' gives the file position to start loading from.\n"
 281         "      If 'pos' is omitted, 0 is used. 'pos' requires 'bytes'.\n"
 282         "      'bytes' gives the size to load. If 'bytes' is 0 or omitted,\n"
 283         "      the load stops on end of file."
 284 ),
 285 CMD_TBL_ITEM(
 286         fatwrite,       4,      0,      do_fat_rw,
 287         "write file into a dos filesystem",
 288         "<d:/path/filename> <addr> <bytes>\n"
 289         "    - Write file to 'path/filename' on logical drive 'd' from RAM\n"
 290         "      starting at address 'addr'. 'bytes' gives the size to load.\n"
 291         "      If 'bytes' is 0 or omitted, the load stops on end of file."
 292 ),
 293
 294 CMD_TBL_ITEM(
 295         help,   CONFIG_SYS_MAXARGS,     1,      do_help,
 296         "print command description/usage",
 297         "\n"
 298         "       - print brief description of all commands\n"
 299         "help command ...\n"
 300         "       - print detailed usage of 'command'"
 301 ),
 302
 303 /* This does not use the CMD_TBL_ITEM macro as ? can't be used in symbol names */
 304         {FSTR("?"),   CONFIG_SYS_MAXARGS, 1, do_help,
 305          FSTR("alias for 'help'"),
 306 #ifdef  CONFIG_SYS_LONGHELP
 307         FSTR(""),
 308 #endif /* CONFIG_SYS_LONGHELP */
 309 #ifdef CONFIG_AUTO_COMPLETE
 310         0,
 311 #endif
 312 },
 313 /* Mark end of table */
 314 { 0 },
 315 };