diff --git a/src/avrdude.1 b/src/avrdude.1 index 8ed9e8f1..9594a07e 100644 --- a/src/avrdude.1 +++ b/src/avrdude.1 @@ -44,6 +44,7 @@ .Op Fl O .Op Fl P Ar port .Op Fl q +.Op Fl T Ar cmd .Op Fl t .Op Fl U Ar memtype:op:filename:filefmt .Op Fl v @@ -694,17 +695,28 @@ to the device. Specify it more often for even quieter operations. .It Fl s, u These options used to control the obsolete "safemode" feature which is no longer present. They are silently ignored for backwards compatibility. +.It Fl T Ar cmd +Slots a terminal command line +.Ar cmd +into the intermixed list of -T terminal commands and -U memory operations. +The terminal command line is executed when it is its turn in the mixed list. +Except for the simplest of terminal commands the argument +.Ar cmd +will most likely need to be set in quotes, see your OS shell manual for +details. .It Fl t Tells .Nm -to enter the interactive ``terminal'' mode instead of up- or downloading -files. See below for a detailed description of the terminal mode. +to enter the interactive terminal shell before up- or downloading files +via the -U option or processing other -T terminal commands, if any. See +below for a detailed description of the terminal mode. .It Xo Fl U Ar memtype Ns .Ar \&: Ns Ar op Ns .Ar \&: Ns Ar filename Ns .Op \&: Ns Ar format .Xc -Perform a memory operation as indicated. The +Perform a memory operation as indicated. Multiple -U operations are +allowed. The .Ar memtype field specifies the memory type to operate on. The available memory types are device-dependent, the actual diff --git a/src/doc/avrdude.texi b/src/doc/avrdude.texi index d3ac921d..c32387f6 100644 --- a/src/doc/avrdude.texi +++ b/src/doc/avrdude.texi @@ -757,9 +757,17 @@ to the device. Specify it a second time for even quieter operation. These options used to control the obsolete "safemode" feature which is no longer present. They are silently ignored for backwards compatibility. +@item -T @var{cmd} +Slots a terminal command line @var{cmd} into the intermixed list of +@code{-T} terminal commands and @code{-U} memory operations. The terminal +command line is executed when it is its turn in the mixed list. Except for +the simplest of terminal commands the argument @var{cmd} will most likely +need to be set in quotes, see your OS shell manual for details. + @item -t -Tells AVRDUDE to enter the interactive ``terminal'' mode instead of up- -or downloading files. See below for a detailed description of the +Tells AVRDUDE to enter the interactive terminal shell before uploading or +downloading files via the @code{-U} option or processing other @code{-T} +terminal commands, if any. See below for a detailed description of the terminal mode. @item -U @var{memtype}:@var{op}:@var{filename}[:@var{format}] diff --git a/src/main.c b/src/main.c index 6c0e7fb2..d59f6638 100644 --- a/src/main.c +++ b/src/main.c @@ -224,34 +224,35 @@ static void usage(void) msg_error( "Usage: %s [options]\n" "Options:\n" - " -p Specify AVR device\n" - " -p / Run developer options for matched AVR devices\n" - " -b Override RS-232 baud rate\n" - " -B Specify bit clock period (us)\n" - " -C Specify location of configuration file\n" - " -c Specify programmer type\n" - " -c / Run developer options for matched programmers\n" - " -A Disable trailing-0xff removal from file and AVR read\n" - " -D Disable auto erase for flash memory; implies -A\n" - " -i ISP Clock Delay [in microseconds]\n" - " -P Specify connection port\n" - " -F Override invalid signature or initialisation check\n" - " -e Perform a chip erase\n" - " -O Perform RC oscillator calibration (see AVR053)\n" + " -p Specify AVR device\n" + " -p / Run developer options for matched AVR devices\n" + " -b Override RS-232 baud rate\n" + " -B Specify bit clock period (us)\n" + " -C Specify location of configuration file\n" + " -c Specify programmer type\n" + " -c / Run developer options for matched programmers\n" + " -A Disable trailing-0xff removal for file/AVR read\n" + " -D Disable auto erase for flash memory; implies -A\n" + " -i ISP Clock Delay [in microseconds]\n" + " -P Specify connection port\n" + " -F Override invalid signature or initial checks\n" + " -e Perform a chip erase\n" + " -O Perform RC oscillator calibration (see AVR053)\n" + " -t Enter terminal shell before processing -U/T\n" + " -T Slot terminal line into a list and run in turn\n" " -U :r|w|v:[:format]\n" - " Memory operation specification\n" - " Multiple -U options are allowed, each request\n" - " is performed in the order specified\n" - " -n Do not write to the device whilst processing -U\n" - " -V Do not automatically verify during -U\n" - " -t Enter terminal mode\n" - " -E [,] List programmer exit specifications\n" - " -x Pass to programmer, see -xhelp\n" - " -v Verbose output; -v -v for more\n" - " -q Quell progress output; -q -q for less\n" - " -l logfile Use logfile rather than stderr for diagnostics\n" - " -? Display this usage\n" - "\navrdude version %s, URL: \n", + " Memory operation specification\n" + " Multiple -U/T options are allowed; each request\n" + " is performed in the specified intermixed order\n" + " -n Do not write to the device whilst processing -U\n" + " -V Do not automatically verify during -U\n" + " -E [,] List programmer exit specifications\n" + " -x Pass to programmer, see -xhelp\n" + " -v Verbose output; -v -v for more\n" + " -q Quell progress output; -q -q for less\n" + " -l logfile Use logfile rather than stderr for diagnostics\n" + " -? Display this usage\n" + "\navrdude version %s, https://github.com/avrdudes/avrdude\n", progname, version); }