Document default_port programmer property

This commit is contained in:
stefanrueger
2026-07-28 04:01:54 +02:00
parent 19d77434ef
commit 658b4aa1e9
2 changed files with 21 additions and 19 deletions

View File

@@ -28,7 +28,8 @@ avrdude_conf_version = "@AVRDUDE_FULL_VERSION@";
# is_serialadapter = <yes|no> # programmer is also a serialadapter
# extra_features = HAS_<fea> {| HAS_<fea>} # extra features, eg, HAS_SUFFER (2)
# connection_type = parallel | serial | usb | spi
# baudrate = <num> ; # baudrate for avr910-programmer
# default_port = <port> # default port, quoted string
# baudrate = <num> ; # baudrate for the programmer
# vcc = <pin1> [, <pin2> ... ] ; # pin number(s) (3)
# buff = <pin1> [, <pin2> ... ] ; # pin number(s)
# reset = <pin> ; # pin number
@@ -46,9 +47,9 @@ avrdude_conf_version = "@AVRDUDE_FULL_VERSION@";
# usbvid = <hexnum> ; # USB vendor ID
# usbpid = <hexnum> [, <hexnum> ...] ; # USB product ID (4)
# usbdev = <interface> ; # USB interface or other device info
# usbvendor = <vendorname> ; # USB Vendor Name
# usbproduct = <productname> ; # USB Product Name
# usbsn = <serialno> ; # USB Serial Number
# usbvendor = <vendorname> ; # USB vendor name
# usbproduct = <productname> ; # USB product name
# usbsn = <serialno> ; # USB serial number
# hvupdi_support = <num> [, <num>, ... ] ; # HV support for enabling UPDI
# ;
#
@@ -97,7 +98,7 @@ avrdude_conf_version = "@AVRDUDE_FULL_VERSION@";
# baudrate = <num> ; # optional default baudrate, eg, in .avrduderc
# usbvid = <hexnum> ; # USB vendor ID
# usbpid = <hexnum> [, <hexnum> ...] ; # list of USB product IDs
# usbsn = <serialno> ; # USB Serial Number in per-user .avrduderc
# usbsn = <serialno> ; # USB serial number in per-user .avrduderc
# ;
#
# part

View File

@@ -3793,7 +3793,8 @@ programmer
is_serialadapter = <yes|no> # programmer is also a serialadapter
extra_features = HAS_<fea> @{| HAS_<fea>@} # extra features, e.g., HAS_SUFFER (2)
connection_type = parallel | serial | usb | spi
baudrate = <num>; # baudrate for avr910-programmer
default_port = <port> # default port, quoted string
baudrate = <num>; # baudrate for the programmer
vcc = <pin1> [, <pin2> ... ]; # pin number(s) (3)
buff = <pin1> [, <pin2> ... ]; # pin number(s)
reset = <pin>; # pin number
@@ -3811,35 +3812,35 @@ programmer
usbvid = <hexnum>; # USB vendor ID
usbpid = <hexnum> [, <hexnum> ...]; # USB product ID (4)
usbdev = <interface>; # USB interface or other device info
usbvendor = <vendorname>; # USB Vendor Name
usbproduct = <productname>; # USB Product Name
usbsn = <serialno>; # USB Serial Number
usbvendor = <vendorname>; # USB vendor name
usbproduct = <productname>; # USB product name
usbsn = <serialno>; # USB serial number
hvupdi_support = <num> [, <num>, ... ]; # HV support for enabling UPDI
;
@end smallexample
@noindent
If a parent is specified, all settings of it (except its ids) are used for the new
programmer. These values can be changed by new setting them for the new programmer.
programmer. These values can be changed by setting them for the new programmer.
@noindent
Programmer definitions can be modified using the following syntax
@smallexample
modify programmer <id>
# Any property as above, for example
baudrate = <num>; # baudrate for the programmer
usbsn = <serialno>; # USB Serial Number
default_port = <port> # default port, quoted string
usbsn = <serialno>; # USB serial number
;
@end smallexample
@noindent
The @code{modify} keyword makes most sense in the per-user configuration
file, where users may want to add specific properties of their programmer
such as its USB serial number. This technique should not be used for the
main @code{avrdude.conf} file, as the developer option @code{-c
<programmer>/S} that prints the programmer definition as AVRDUDE
understands it will only consider the final definition; it will not print
@code{modify} statements.
file, where users may want to add specific properties of their programmer.
This could be its USB serial number or default port, eg, a serialadapter
such as @code{"ch340"}. This technique should not be used for the main
@code{avrdude.conf} file, as the developer option @code{-c <programmer>/S}
that prints the programmer definition as AVRDUDE understands it will only
consider the final definition; it will not print @code{modify} statements.
@noindent
@strong{Notes}
@@ -3953,7 +3954,7 @@ serialadapter
baudrate = <num>; # optional default baudrate, eg, in .avrduderc
usbvid = <hexnum>; # USB vendor ID
usbpid = <hexnum> [, <hexnum> ...]; # list of USB product IDs
usbsn = <serialno>; # USB Serial Number in per-user .avrduderc
usbsn = <serialno>; # USB serial number in per-user .avrduderc
;
@end smallexample