avr/command_tbl.c

   1 /*
   2  * (C) Copyright 2014-2016 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 #if defined(CONFIG_CMD_LOADB)
  22 extern command_ret_t do_load_serial_bin(cmd_tbl_t *, int, int, char * const []);
  23 #endif
  24 extern command_ret_t do_go(cmd_tbl_t *, int, int, char * const []);
  25 extern command_ret_t do_restart(cmd_tbl_t *, int, int, char * const []);
  26 extern command_ret_t do_console(cmd_tbl_t *, int, int, char * const []);
  27 extern command_ret_t do_dump_mem(cmd_tbl_t *, int, int, char * const []);
  28 extern command_ret_t do_mem_mm_avr(cmd_tbl_t *, int, int, char * const []);
  29 extern command_ret_t do_mem_nm_avr(cmd_tbl_t *, int, int, char * const []);
  30 extern command_ret_t do_eep_cp(cmd_tbl_t *, int, int, char * const []);
  31 extern command_ret_t do_busreq_pulse(cmd_tbl_t *, int, int, char * const []);
  32 extern command_ret_t do_date(cmd_tbl_t *, int, int, char * const []);
  33 extern command_ret_t do_gpio(cmd_tbl_t *, int, int, char * const []);
  34 extern command_ret_t do_sd(cmd_tbl_t *, int, int, char * const []);
  35 extern command_ret_t do_fat_stat(cmd_tbl_t *, int, int, char * const []);
  36 extern command_ret_t do_fat_ls(cmd_tbl_t *, int, int, char * const []);
  37 extern command_ret_t do_fat_rw(cmd_tbl_t *, int, int, char * const []);
  38 extern command_ret_t do_run(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
  39 extern command_ret_t do_source(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
  40 extern command_ret_t do_attach(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
  41
  42 #ifdef CONFIG_SYS_LONGHELP
  43 const FLASH char sd_help_text[] =
  44         "bla \t- do bla\n"
  45         ;
  46 #endif /* CONFIG_SYS_LONGHELP */
  47
  48
  49 cmd_tbl_t cmd_tbl[] = {
  50
  51 CMD_TBL_ITEM(
  52         date,   2,      1,      do_date,
  53         "get/set date & time",
  54         "[MMDDhhmm[[CC]YY][.ss]]\n"
  55         "  - without arguments: print date & time\n"
  56         "  - with numeric argument: set the system date & time\n"
  57 ),
  58
  59 #ifdef DEBUG
  60
  61 CMD_TBL_ITEM(
  62         !mdr,   3,      1,      do_dump_mem,
  63         "RAM dump",
  64         "address [count]"
  65 ),
  66 CMD_TBL_ITEM(
  67         !mde,   3,      1,      do_dump_mem,
  68         "EEPROM dump",
  69         "address [count]"
  70 ),
  71 CMD_TBL_ITEM(
  72         !mdf,   3,      1,      do_dump_mem,
  73         "FLASH dump",
  74         "address [count]"
  75 ),
  76 CMD_TBL_ITEM(
  77         !cpe,   4,      0,      do_eep_cp,
  78         "EEPROM copy",
  79         "source target count"
  80 ),
  81 CMD_TBL_ITEM(
  82         !mm,    2,      1,      do_mem_mm_avr,
  83         "avr memory modify (auto-incrementing address)",
  84         "address"
  85 ),
  86 CMD_TBL_ITEM(
  87         !nm,    2,      1,      do_mem_nm_avr,
  88         "avr memory modify (constant address)",
  89         "address"
  90 ),
  91 #endif
  92 CMD_TBL_ITEM(
  93         mstep,  2,      1,      do_busreq_pulse,
  94         "execute one M cycle",
  95         "[count]\n"
  96         "     - repeat count times"
  97 ),
  98 CMD_TBL_ITEM(
  99         echo,   CONFIG_SYS_MAXARGS,     1,      do_echo,
 100         "display a line of text",
 101         "[-n] [argument ...]\n"
 102         "- echo the argument(s) to console.\n"
 103         "  -n  do not output the trailing newline"
 104 ),
 105 CMD_TBL_ITEM(
 106         sleep ,    2,    1,     do_sleep,
 107         "delay execution for some time",
 108         "N[m][s]\n"
 109         "    - delay execution for decimal N (milli) seconds"
 110 ),
 111 CMD_TBL_ITEM_COMPLETE(
 112         run,    CONFIG_SYS_MAXARGS,     1,      do_run,
 113         "run commands in an environment variable",
 114         "var [...]\n"
 115         "    - run the commands in the environment variable(s) 'var'",
 116         var_complete
 117 ),
 118 CMD_TBL_ITEM_COMPLETE(
 119         source, CONFIG_SYS_MAXARGS,     1,      do_source,
 120         "run commands from a file",
 121         "filename\n"
 122         "    - run the commands in the script file 'filename'",
 123         var_complete
 124 ),
 125 CMD_TBL_ITEM_COMPLETE(
 126         printenv, CONFIG_SYS_MAXARGS,   1,      do_env_print,
 127         "print environment variables",
 128         "\n"
 129         "    - print values of all environment variables\n"
 130         "printenv name ...\n"
 131         "    - print value of environment variable 'name'",
 132         var_complete
 133 ),
 134 CMD_TBL_ITEM_COMPLETE(
 135         setenv, CONFIG_SYS_MAXARGS,     0,      do_env_set,
 136         "set environment variables",
 137         "name value ...\n"
 138         "    - set environment variable 'name' to 'value ...'\n"
 139         "setenv name\n"
 140         "    - delete environment variable 'name'",
 141         var_complete
 142 ),
 143 CMD_TBL_ITEM(
 144         saveenv,        1,      0,      do_env_save,
 145         "save environment variables to persistent storage",
 146         ""
 147 ),
 148 CMD_TBL_ITEM(
 149         defaultenv,     1,      0,      do_env_default,
 150         "set all environment variables to their default values",
 151         ""
 152 ),
 153
 154 CMD_TBL_ITEM(
 155         loadf,  1,      0,      do_loadf,
 156         "load srec_cat prepared image from controller flash",
 157         ""
 158 ),
 159 CMD_TBL_ITEM(
 160         loadcpm3, 3,    0,      do_loadcpm3,
 161         "load CPM3.SYS file",
 162         "[filename [common-base [banked-base]]] \n"
 163         "    - Load CP/M 3 system file from FAT filesystem. This command makes\n"
 164         "      CPMLDR superfluous. Uses the following environment variables if set:\n"
 165         "         '"ENV_CPM3_SYSFILE"' File to load. Default is '"CONFIG_CPM3_SYSFILE"'.\n"
 166         "         '"ENV_CPM3_BANKED_BASE"' Default is '"CONFIG_CPM3_BANKED_BASE_STR"'.\n"
 167         "      Sets the following environment variables after loading:\n"
 168         "         '"ENV_CPM3_COMMON_BASE"'\n"
 169         "         '"ENV_STARTADDRESS"'"
 170 ),
 171 CMD_TBL_ITEM(
 172         loadi,  2,      0,      do_loadihex,
 173         "load intel hex file over serial line",
 174         "[[-]offset]\n"
 175         "    - load Intel-Hex-Record file over serial line with offset 'offset'"
 176 ),
 177
 178 #if defined(CONFIG_CMD_LOADB)
 179 CMD_TBL_ITEM(
 180         loadb, 1, 0,    do_load_serial_bin,
 181         "load binary file over serial line (kermit mode)",
 182         "    - load binary file over serial line"
 183 ),
 184
 185 CMD_TBL_ITEM(
 186         loadx, 1, 0,    do_load_serial_bin,
 187         "load binary file over serial line (xmodem mode)",
 188         "    - load binary file over serial line"
 189 ),
 190
 191 CMD_TBL_ITEM(
 192         loady, 1, 0,    do_load_serial_bin,
 193         "load binary file over serial line (ymodem mode)",
 194         "    - load binary file over serial line"
 195 ),
 196 #endif  /* CONFIG_CMD_LOADB */
 197
 198 CMD_TBL_ITEM(
 199         go,     2,      0,      do_go,
 200         "start application at address 'addr'",
 201         "addr\n"
 202         "    - start application at address 'addr'"
 203 //      "\n"
 204 //      "      passing 'arg' as arguments"
 205 ),
 206 CMD_TBL_ITEM(
 207         reset,  1,      0,      do_reset,
 208         "Keep CPU in RESET state",
 209         ""
 210 ),
 211 CMD_TBL_ITEM(
 212         restart, 1, 1,  do_restart,
 213         "Perform RESET of the CPU",
 214         ""
 215 ),
 216 CMD_TBL_ITEM(
 217         connect, 1, 0,  do_console,
 218         "Connect to CPU console i/o",
 219         "\n"
 220         "    - type the escape character followed by Q to close the connection, \n"
 221         "      or followed by ? to see other options. The default escape character \n"
 222         "      is Ctrl-^ (0x1E). It can be changed by setting env var '"ENV_ESC_CHAR"'."
 223
 224 ),
 225
 226 CMD_TBL_ITEM(
 227         pin, CONFIG_SYS_MAXARGS, 1,     do_gpio,
 228         "Set or query pin state",
 229         "[-s] [<pins>]\n"
 230         "    - print cofiguration and state or frequency of pins\n"
 231         "      print all pins, if argument is omitted\n"
 232         "pin <pins> h[igh]|l[ow]\n"
 233         "    - config pins as output and set to level high or low\n"
 234         "pin <pins> ts|i[n]|p[ullup]\n"
 235         "    - config pins as input/tristate or input with pullup\n"
 236         "pin <pins> value[K|M][Hz]\n"
 237         "    - output a clock on pins\n"
 238         "      value is system clock divider or frequency, if 'Hz' is appended\n"
 239         "      divider is rounded down to next possible value (depends on pin)\n"
 240         "\n"
 241         "<pins> is a comma separated list of numbers or ranges, i.e. \"0,9,3-6\"\n"
 242 ),
 243
 244 CMD_TBL_ITEM(
 245         md,     3,      1,      do_mem_md,
 246         "memory display",
 247         "address [# of objects]"
 248 ),
 249 CMD_TBL_ITEM(
 250         mm,     2,      1,      do_mem_mm,
 251         "memory modify (auto-incrementing address)",
 252         "address"
 253 ),
 254 CMD_TBL_ITEM(
 255         nm,     2,      1,      do_mem_nm,
 256         "memory modify (constant address)",
 257         "address"
 258 ),
 259 CMD_TBL_ITEM(
 260         mw,     CONFIG_SYS_MAXARGS,     1,      do_mem_mw,
 261         "memory write (fill)",
 262         "[-bwl] address value [count]\n"
 263         "   -b  write value as byte (8 bit, default)\n"
 264         "   -w  write value as word (16 bit)\n"
 265         "   -l  write value as long (32 bit)\n"
 266 ),
 267 CMD_TBL_ITEM(
 268         cp,     4,      1,      do_mem_cp,
 269         "memory copy",
 270         "source target count"
 271 ),
 272 CMD_TBL_ITEM(
 273         cmp,    4,      1,      do_mem_cmp,
 274         "memory compare",
 275         "addr1 addr2 count"
 276 ),
 277 CMD_TBL_ITEM(
 278         base,   2,      0,      do_mem_base,
 279         "print or set address offset",
 280         "\n"
 281         "    - print address offset for memory commands\n"
 282         "base offset\n"
 283         "    - set address offset for memory commands to 'offset'"
 284 ),
 285 CMD_TBL_ITEM(
 286         mloop,  3,      1,      do_mem_loop,
 287         "infinite loop on address range",
 288         "address number_of_bytes"
 289 ),
 290 CMD_TBL_ITEM(
 291         mloopw, 4,      1,      do_mem_loopw,
 292         "infinite write loop on address range",
 293         "address number_of_bytes data_to_write"
 294 ),
 295
 296 #ifdef CONFIG_CMD_MEMTEST
 297 CMD_TBL_ITEM(
 298         mtest,  4,      1,      do_mem_mtest,
 299         "simple RAM read/write test",
 300         "[start [end [iterations]]]"
 301 ),
 302 #endif  /* CONFIG_CMD_MEMTEST */
 303
 304 #ifdef CONFIG_MX_CYCLIC
 305 CMD_TBL_ITEM(
 306         mdc,    4,      1,      do_mem_mdc,
 307         "memory display cyclic",
 308         "address count delay(ms)"
 309 ),
 310 CMD_TBL_ITEM(
 311         mwc,    4,      1,      do_mem_mdc,
 312         "memory write cyclic",
 313         "address value delay(ms)"
 314 ),
 315 #endif /* CONFIG_MX_CYCLIC */
 316
 317 CMD_TBL_ITEM(
 318         sd,   CONFIG_SYS_MAXARGS, 1, do_sd,
 319         "SD/MMC card handling commands",
 320         "<subcommand> args ...\n"
 321         "sd help\n"
 322         "    - print help on subcommands"
 323 ),
 324
 325 CMD_TBL_ITEM(
 326         fatstat,        2,      1,      do_fat_stat,
 327         "Show logical drive status",
 328         "dev"
 329 ),
 330 CMD_TBL_ITEM(
 331         fatls,  2,      1,      do_fat_ls,
 332         "Directory listing",
 333         "path"
 334 ),
 335 CMD_TBL_ITEM(
 336         fatload,        5,      0,      do_fat_rw,
 337         "load binary file from a dos filesystem",
 338         "<d:/path/filename> <addr> [bytes [pos]]\n"
 339         "    - Load binary file 'path/filename' on logical drive 'd'\n"
 340         "      to address 'addr' from dos filesystem.\n"
 341         "      'pos' gives the file position to start loading from.\n"
 342         "      If 'pos' is omitted, 0 is used. 'pos' requires 'bytes'.\n"
 343         "      'bytes' gives the size to load. If 'bytes' is 0 or omitted,\n"
 344         "      the load stops on end of file."
 345 ),
 346 CMD_TBL_ITEM(
 347         fatwrite,       4,      0,      do_fat_rw,
 348         "write file into a dos filesystem",
 349         "<d:/path/filename> <addr> <bytes>\n"
 350         "    - Write file to 'path/filename' on logical drive 'd' from RAM\n"
 351         "      starting at address 'addr'.\n"
 352 ),
 353 CMD_TBL_ITEM(
 354         attach, CONFIG_SYS_MAXARGS,     1,      do_attach,
 355         "attach filesystem image file to CP/M drive",
 356         "[options] [dsk<n> <d:/path/filename>]\n"
 357         "    - attach drive number <n> to diskfile <d:/path/filename>\n"
 358         "attach -d dsk<n>\n"
 359         "    - detach drive\n"
 360         "attach\n"
 361         "    - without arguments, list current assignments"
 362 ),
 363 CMD_TBL_ITEM(
 364         detach, 2,      1,      do_attach,
 365         "detach file from CP/M drive",
 366         "dsk<n>]\n"
 367         "    - same as attach -d dsk<n>"
 368 ),
 369
 370 CMD_TBL_ITEM(
 371         help,   CONFIG_SYS_MAXARGS,     1,      do_help,
 372         "print command description/usage",
 373         "\n"
 374         "       - print brief description of all commands\n"
 375         "help command ...\n"
 376         "       - print detailed usage of 'command'"
 377 ),
 378
 379 /* This does not use the CMD_TBL_ITEM macro as ? can't be used in symbol names */
 380         {FSTR("?"),   CONFIG_SYS_MAXARGS, 1, do_help,
 381          FSTR("alias for 'help'"),
 382 #ifdef  CONFIG_SYS_LONGHELP
 383         FSTR(""),
 384 #endif /* CONFIG_SYS_LONGHELP */
 385 #ifdef CONFIG_AUTO_COMPLETE
 386         0,
 387 #endif
 388 },
 389 /* Mark end of table */
 390 { 0 },
 391 };