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