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