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