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/reset 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         "  - with 'reset' argument: reset the RTC"
  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         go,     2,      0,      do_go,
 131         "start application at address 'addr'",
 132         "addr\n"
 133         "    - start application at address 'addr'"
 134 //      "\n"
 135 //      "      passing 'arg' as arguments"
 136 ),
 137 CMD_TBL_ITEM(
 138         reset,  1,      0,      do_reset,
 139         "Keep CPU in RESET state",
 140         ""
 141 ),
 142 CMD_TBL_ITEM(
 143         restart, 1, 1,  do_restart,
 144         "Perform RESET of the CPU",
 145         ""
 146 ),
 147 CMD_TBL_ITEM(
 148         connect, 1, 1,  do_console,
 149         "Connect to CPU console i/o",
 150         ""
 151 ),
 152
 153 CMD_TBL_ITEM(
 154         pin, CONFIG_SYS_MAXARGS, 1,     do_gpio,
 155         "Set or query pin state",
 156         "[-s] [<pins>]\n"
 157         "    - print cofiguration and state or frequency of pins\n"
 158         "      print all pins, if argument is omitted\n"
 159         "pin <pins> h[igh]|l[ow]\n"
 160         "    - config pins as output and set to level high or low\n"
 161         "pin <pins> ts|i[n]|p[ullup]\n"
 162         "    - config pins as input/tristate or input with pullup\n"
 163         "pin <pins> value[K|M][Hz]\n"
 164         "    - output a clock on pins\n"
 165         "      value is system clock divider or frequency, if 'Hz' is appended\n"
 166         "      divider is rounded down to next possible value (depends on pin)\n"
 167         "\n"
 168         "<pins> is a comma separated list of numbers or ranges, i.e. \"0,9,3-6\"\n"
 169 ),
 170
 171 CMD_TBL_ITEM(
 172         md,     3,      1,      do_mem_md,
 173         "memory display",
 174         "address [# of objects]"
 175 ),
 176 CMD_TBL_ITEM(
 177         mm,     2,      1,      do_mem_mm,
 178         "memory modify (auto-incrementing address)",
 179         "address"
 180 ),
 181 CMD_TBL_ITEM(
 182         nm,     2,      1,      do_mem_nm,
 183         "memory modify (constant address)",
 184         "address"
 185 ),
 186 CMD_TBL_ITEM(
 187         mw,     4,      1,      do_mem_mw,
 188         "memory write (fill)",
 189         "address value [count]"
 190 ),
 191 CMD_TBL_ITEM(
 192         cp,     4,      1,      do_mem_cp,
 193         "memory copy",
 194         "source target count"
 195 ),
 196 CMD_TBL_ITEM(
 197         cmp,    4,      1,      do_mem_cmp,
 198         "memory compare",
 199         "addr1 addr2 count"
 200 ),
 201 CMD_TBL_ITEM(
 202         base,   2,      0,      do_mem_base,
 203         "print or set address offset",
 204         "\n"
 205         "    - print address offset for memory commands\n"
 206         "base offset\n"
 207         "    - set address offset for memory commands to 'offset'"
 208 ),
 209 CMD_TBL_ITEM(
 210         loop,   3,      1,      do_mem_loop,
 211         "infinite loop on address range",
 212         "address number_of_bytes"
 213 ),
 214 #ifdef CONFIG_LOOPW
 215 CMD_TBL_ITEM(
 216         loopw,  4,      1,      do_mem_loopw,
 217         "infinite write loop on address range",
 218         "address number_of_bytes data_to_write"
 219 ),
 220 #endif /* CONFIG_LOOPW */
 221
 222 #ifdef CONFIG_CMD_MEMTEST
 223 CMD_TBL_ITEM(
 224         mtest,  5,      1,      do_mem_mtest,
 225         "simple RAM read/write test",
 226         "[start [end [pattern [iterations]]]]"
 227 ),
 228 #endif  /* CONFIG_CMD_MEMTEST */
 229
 230 #ifdef CONFIG_MX_CYCLIC
 231 CMD_TBL_ITEM(
 232         mdc,    4,      1,      do_mem_mdc,
 233         "memory display cyclic",
 234         "address count delay(ms)"
 235 ),
 236 CMD_TBL_ITEM(
 237         mwc,    4,      1,      do_mem_mwc,
 238         "memory write cyclic",
 239         "address value delay(ms)"
 240 ),
 241 #endif /* CONFIG_MX_CYCLIC */
 242
 243 CMD_TBL_ITEM(
 244         sd,   CONFIG_SYS_MAXARGS, 1, do_sd,
 245         "SD/MMC card handling commands",
 246         "<subcommand> args ...\n"
 247         "sd help\n"
 248         "    - print help on subcommands"
 249 ),
 250
 251 CMD_TBL_ITEM(
 252         fatstat,        2,      1,      do_fat_stat,
 253         "Show logical drive status",
 254         "dev"
 255 ),
 256 CMD_TBL_ITEM(
 257         fatls,  2,      1,      do_fat_ls,
 258         "Directory listing",
 259         "path"
 260 ),
 261 CMD_TBL_ITEM(
 262         fatload,        5,      0,      do_fat_rw,
 263         "load binary file from a dos filesystem",
 264         "<d:/path/filename> <addr> [bytes [pos]]\n"
 265         "    - Load binary file 'path/filename' on logical drive 'd'\n"
 266         "      to address 'addr' from dos filesystem.\n"
 267         "      'pos' gives the file position to start loading from.\n"
 268         "      If 'pos' is omitted, 0 is used. 'pos' requires 'bytes'.\n"
 269         "      'bytes' gives the size to load. If 'bytes' is 0 or omitted,\n"
 270         "      the load stops on end of file."
 271 ),
 272 CMD_TBL_ITEM(
 273         fatwrite,       4,      0,      do_fat_rw,
 274         "write file into a dos filesystem",
 275         "<d:/path/filename> <addr> <bytes>\n"
 276         "    - Write file to 'path/filename' on logical drive 'd' from RAM\n"
 277         "      starting at address 'addr'. 'bytes' gives the size to load.\n"
 278         "      If 'bytes' is 0 or omitted, the load stops on end of file."
 279 ),
 280
 281 CMD_TBL_ITEM(
 282         help,   CONFIG_SYS_MAXARGS,     1,      do_help,
 283         "print command description/usage",
 284         "\n"
 285         "       - print brief description of all commands\n"
 286         "help command ...\n"
 287         "       - print detailed usage of 'command'"
 288 ),
 289
 290 /* This does not use the CMD_TBL_ITEM macro as ? can't be used in symbol names */
 291         {FSTR("?"),   CONFIG_SYS_MAXARGS, 1, do_help,
 292          FSTR("alias for 'help'"),
 293 #ifdef  CONFIG_SYS_LONGHELP
 294         FSTR(""),
 295 #endif /* CONFIG_SYS_LONGHELP */
 296 #ifdef CONFIG_AUTO_COMPLETE
 297         0,
 298 #endif
 299 },
 300 /* Mark end of table */
 301 { 0 },
 302 };