]> cloudbase.mooo.com Git - z180-stamp.git/blame - avr/command_tbl.c
Bugfix: reset getopt vars on start of a new argument line
[z180-stamp.git] / avr / command_tbl.c
CommitLineData
35edb766 1/*
04b3ea0e 2 * (C) Copyright 2014-2016 Leo C. <erbl259-lmu@yahoo.de>
35edb766 3 *
b51d2360 4 * SPDX-License-Identifier: GPL-2.0
35edb766 5 */
d684c216
L
6
7#include "common.h"
d684c216 8#include "command.h"
72f58822 9#include "cmd_mem.h"
d684c216 10
d0581f88
L
11extern command_ret_t do_help(cmd_tbl_t *, int, int, char * const []);
12extern command_ret_t do_echo(cmd_tbl_t *, int, int, char * const []);
8a7decea 13extern command_ret_t do_sleep(cmd_tbl_t *, int, int, char * const []);
d0581f88 14extern command_ret_t do_env_print(cmd_tbl_t *, int, int, char * const []);
7e24905c 15extern command_ret_t do_env_default(cmd_tbl_t *, int, int, char * const []);
d0581f88
L
16extern command_ret_t do_env_set(cmd_tbl_t *, int, int, char * const []);
17extern command_ret_t do_env_save(cmd_tbl_t *, int, int, char * const []);
18extern command_ret_t do_loadf(cmd_tbl_t *, int, int, char * const []);
c0abd68b 19extern command_ret_t do_loadcpm3(cmd_tbl_t *, int, int, char * const []);
179bc609 20extern command_ret_t do_loadihex(cmd_tbl_t *, int, int, char * const []);
393b1897
L
21#if defined(CONFIG_CMD_LOADB)
22extern command_ret_t do_load_serial_bin(cmd_tbl_t *, int, int, char * const []);
23#endif
d0581f88
L
24extern command_ret_t do_go(cmd_tbl_t *, int, int, char * const []);
25extern command_ret_t do_restart(cmd_tbl_t *, int, int, char * const []);
89adce76 26extern command_ret_t do_console(cmd_tbl_t *, int, int, char * const []);
d0581f88 27extern command_ret_t do_dump_mem(cmd_tbl_t *, int, int, char * const []);
ad9bc17c
L
28extern command_ret_t do_mem_mm_avr(cmd_tbl_t *, int, int, char * const []);
29extern command_ret_t do_mem_nm_avr(cmd_tbl_t *, int, int, char * const []);
d0581f88
L
30extern command_ret_t do_eep_cp(cmd_tbl_t *, int, int, char * const []);
31extern command_ret_t do_busreq_pulse(cmd_tbl_t *, int, int, char * const []);
61b0cfe9 32extern command_ret_t do_date(cmd_tbl_t *, int, int, char * const []);
05994bd9
L
33extern command_ret_t do_gpio(cmd_tbl_t *, int, int, char * const []);
34extern command_ret_t do_sd(cmd_tbl_t *, int, int, char * const []);
2f53dd65
L
35extern command_ret_t do_fat_stat(cmd_tbl_t *, int, int, char * const []);
36extern command_ret_t do_fat_ls(cmd_tbl_t *, int, int, char * const []);
4565be9a 37extern command_ret_t do_fat_rw(cmd_tbl_t *, int, int, char * const []);
04b3ea0e
L
38extern command_ret_t do_run(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
39extern command_ret_t do_source(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
cb4fb1ed 40extern command_ret_t do_attach(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
05994bd9
L
41
42#ifdef CONFIG_SYS_LONGHELP
43const FLASH char sd_help_text[] =
44 "bla \t- do bla\n"
45 ;
46#endif /* CONFIG_SYS_LONGHELP */
d684c216
L
47
48
49cmd_tbl_t cmd_tbl[] = {
50
61b0cfe9
L
51CMD_TBL_ITEM(
52 date, 2, 1, do_date,
a036b05f 53 "get/set date & time",
85046f8c 54 "[MMDDhhmm[[CC]YY][.ss]]\n"
61b0cfe9
L
55 " - without arguments: print date & time\n"
56 " - with numeric argument: set the system date & time\n"
61b0cfe9
L
57),
58
323398b1 59#ifdef DEBUG
4565be9a 60
323398b1 61CMD_TBL_ITEM(
f338df2a
L
62 !mdr, 3, 1, do_dump_mem,
63 "RAM dump",
64 "address [count]"
65),
66CMD_TBL_ITEM(
67 !mde, 3, 1, do_dump_mem,
323398b1
L
68 "EEPROM dump",
69 "address [count]"
70),
c748023e
L
71CMD_TBL_ITEM(
72 !mdf, 3, 1, do_dump_mem,
73 "FLASH dump",
74 "address [count]"
75),
323398b1 76CMD_TBL_ITEM(
f338df2a 77 !cpe, 4, 0, do_eep_cp,
323398b1
L
78 "EEPROM copy",
79 "source target count"
80),
ad9bc17c
L
81CMD_TBL_ITEM(
82 !mm, 2, 1, do_mem_mm_avr,
83 "avr memory modify (auto-incrementing address)",
84 "address"
85),
86CMD_TBL_ITEM(
87 !nm, 2, 1, do_mem_nm_avr,
88 "avr memory modify (constant address)",
89 "address"
90),
323398b1 91#endif
f338df2a
L
92CMD_TBL_ITEM(
93 mstep, 2, 1, do_busreq_pulse,
94 "execute one M cycle",
95 "[count]\n"
96 " - repeat count times"
97),
d684c216
L
98CMD_TBL_ITEM(
99 echo, CONFIG_SYS_MAXARGS, 1, do_echo,
bbd45c46
L
100 "display a line of text",
101 "[-n] [argument ...]\n"
32154e5a
L
102 "- echo the argument(s) to console.\n"
103 " -n do not output the trailing newline"
d684c216 104),
8a7decea
L
105CMD_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),
d684c216
L
111CMD_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),
04b3ea0e
L
118CMD_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),
d684c216
L
125CMD_TBL_ITEM_COMPLETE(
126 printenv, CONFIG_SYS_MAXARGS, 1, do_env_print,
127 "print environment variables",
72f58822 128 "\n"
534e1dfc 129 " - print values of all environment variables\n"
d684c216
L
130 "printenv name ...\n"
131 " - print value of environment variable 'name'",
132 var_complete
133),
134CMD_TBL_ITEM_COMPLETE(
135 setenv, CONFIG_SYS_MAXARGS, 0, do_env_set,
136 "set environment variables",
72f58822
L
137 "name value ...\n"
138 " - set environment variable 'name' to 'value ...'\n"
139 "setenv name\n"
140 " - delete environment variable 'name'",
d684c216
L
141 var_complete
142),
323398b1
L
143CMD_TBL_ITEM(
144 saveenv, 1, 0, do_env_save,
145 "save environment variables to persistent storage",
146 ""
147),
7e24905c
L
148CMD_TBL_ITEM(
149 defaultenv, 1, 0, do_env_default,
150 "set all environment variables to their default values",
151 ""
152),
72f58822 153
534e1dfc 154CMD_TBL_ITEM(
323398b1 155 loadf, 1, 0, do_loadf,
534e1dfc
L
156 "load srec_cat prepared image from controller flash",
157 ""
158),
c0abd68b
L
159CMD_TBL_ITEM(
160 loadcpm3, 3, 0, do_loadcpm3,
161 "load CPM3.SYS file",
98aac4d0 162 "[filename [common-base [banked-base]]] \n"
fa84c3ba
L
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"
b51d2360
L
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"'"
c0abd68b 170),
179bc609
L
171CMD_TBL_ITEM(
172 loadi, 2, 0, do_loadihex,
bf587043
L
173 "load intel hex file over serial line",
174 "[[-]offset]\n"
175 " - load Intel-Hex-Record file over serial line with offset 'offset'"
179bc609 176),
393b1897
L
177
178#if defined(CONFIG_CMD_LOADB)
179CMD_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
185CMD_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
191CMD_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
534e1dfc 198CMD_TBL_ITEM(
323398b1 199 go, 2, 0, do_go,
534e1dfc
L
200 "start application at address 'addr'",
201 "addr\n"
202 " - start application at address 'addr'"
203// "\n"
204// " passing 'arg' as arguments"
205),
206CMD_TBL_ITEM(
323398b1 207 reset, 1, 0, do_reset,
534e1dfc
L
208 "Keep CPU in RESET state",
209 ""
210),
211CMD_TBL_ITEM(
89adce76 212 restart, 1, 1, do_restart,
534e1dfc
L
213 "Perform RESET of the CPU",
214 ""
215),
89adce76 216CMD_TBL_ITEM(
2fe44122 217 connect, 1, 0, do_console,
89adce76 218 "Connect to CPU console i/o",
98aac4d0
L
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
89adce76 224),
41d36f28 225
41d36f28 226CMD_TBL_ITEM(
05994bd9 227 pin, CONFIG_SYS_MAXARGS, 1, do_gpio,
cd5ee544
L
228 "Set or query pin state",
229 "[-s] [<pins>]\n"
41d36f28
L
230 " - print cofiguration and state or frequency of pins\n"
231 " print all pins, if argument is omitted\n"
cd5ee544 232 "pin <pins> h[igh]|l[ow]\n"
41d36f28 233 " - config pins as output and set to level high or low\n"
cd5ee544 234 "pin <pins> ts|i[n]|p[ullup]\n"
41d36f28 235 " - config pins as input/tristate or input with pullup\n"
cd5ee544 236 "pin <pins> value[K|M][Hz]\n"
41d36f28
L
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"
cd5ee544 241 "<pins> is a comma separated list of numbers or ranges, i.e. \"0,9,3-6\"\n"
6035a17b 242),
534e1dfc 243
72f58822
L
244CMD_TBL_ITEM(
245 md, 3, 1, do_mem_md,
246 "memory display",
247 "address [# of objects]"
248),
249CMD_TBL_ITEM(
250 mm, 2, 1, do_mem_mm,
251 "memory modify (auto-incrementing address)",
252 "address"
253),
254CMD_TBL_ITEM(
255 nm, 2, 1, do_mem_nm,
256 "memory modify (constant address)",
257 "address"
258),
259CMD_TBL_ITEM(
32154e5a 260 mw, CONFIG_SYS_MAXARGS, 1, do_mem_mw,
72f58822 261 "memory write (fill)",
32154e5a
L
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"
72f58822
L
266),
267CMD_TBL_ITEM(
268 cp, 4, 1, do_mem_cp,
269 "memory copy",
270 "source target count"
271),
272CMD_TBL_ITEM(
273 cmp, 4, 1, do_mem_cmp,
274 "memory compare",
275 "addr1 addr2 count"
276),
277CMD_TBL_ITEM(
c79c80b4 278 base, 2, 0, do_mem_base,
72f58822
L
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),
285CMD_TBL_ITEM(
5480dc65 286 mloop, 3, 1, do_mem_loop,
72f58822
L
287 "infinite loop on address range",
288 "address number_of_bytes"
289),
72f58822 290CMD_TBL_ITEM(
5480dc65 291 mloopw, 4, 1, do_mem_loopw,
72f58822
L
292 "infinite write loop on address range",
293 "address number_of_bytes data_to_write"
294),
72f58822
L
295
296#ifdef CONFIG_CMD_MEMTEST
297CMD_TBL_ITEM(
5480dc65 298 mtest, 4, 1, do_mem_mtest,
72f58822 299 "simple RAM read/write test",
5480dc65 300 "[start [end [iterations]]]"
72f58822
L
301),
302#endif /* CONFIG_CMD_MEMTEST */
303
304#ifdef CONFIG_MX_CYCLIC
305CMD_TBL_ITEM(
306 mdc, 4, 1, do_mem_mdc,
307 "memory display cyclic",
308 "address count delay(ms)"
309),
310CMD_TBL_ITEM(
5480dc65 311 mwc, 4, 1, do_mem_mdc,
72f58822
L
312 "memory write cyclic",
313 "address value delay(ms)"
314),
315#endif /* CONFIG_MX_CYCLIC */
316
7f552300
L
317CMD_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),
72f58822 324
2f53dd65
L
325CMD_TBL_ITEM(
326 fatstat, 2, 1, do_fat_stat,
327 "Show logical drive status",
328 "dev"
329),
330CMD_TBL_ITEM(
331 fatls, 2, 1, do_fat_ls,
332 "Directory listing",
333 "path"
334),
335CMD_TBL_ITEM(
4565be9a 336 fatload, 5, 0, do_fat_rw,
2f53dd65
L
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),
346CMD_TBL_ITEM(
4565be9a 347 fatwrite, 4, 0, do_fat_rw,
2f53dd65
L
348 "write file into a dos filesystem",
349 "<d:/path/filename> <addr> <bytes>\n"
4565be9a 350 " - Write file to 'path/filename' on logical drive 'd' from RAM\n"
79082813 351 " starting at address 'addr'.\n"
2f53dd65 352),
cb4fb1ed
L
353CMD_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),
363CMD_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),
2f53dd65 369
d684c216
L
370CMD_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
72f58822 379/* This does not use the CMD_TBL_ITEM macro as ? can't be used in symbol names */
d684c216
L
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};