You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
#### Support for upload "without a port" (`no-port` dummy protocol)
771
+
#### Support for `default` fallback (allows upload "without a port")
772
772
773
773
Some upload tools already have the port detection builtin so there is no need to specify an upload port (for example the `openocd` tool is often able to autodetect the devices to upload by itself).
774
774
775
-
To support this particular use case a dummy `no-port` protocol has been reserved:
775
+
To support this particular use case a dummy `default` protocol has been reserved:
776
776
777
777
```
778
-
myboard.upload.tool.no-port=openocd_without_port
778
+
myboard.upload.tool.default=openocd_without_port
779
779
```
780
780
781
-
The `no-port` upload recipe will be selected when:
781
+
The `default` upload protocol is a kind of wildcard-protocol, it will be selected when:
782
782
783
783
- The upload port is not specified
784
784
@@ -789,21 +789,21 @@ or
789
789
Let's see some examples to clarify:
790
790
791
791
```
792
-
board1.upload.tool.no-port=openocd_without_port
792
+
board1.upload.tool.default=openocd_without_port
793
793
794
794
board2.upload.tool.serial=bossac
795
-
board2.upload.tool.no-port=openocd_without_port
795
+
board2.upload.tool.default=openocd_without_port
796
796
797
797
board3.upload.tool.serial=bossac
798
798
```
799
799
800
-
In the `board1` case: the `openocd_without_port` recipe will be always used, even if a port has been selected by the user.
800
+
In the `board1` case: the `openocd_without_port` recipe will be always used, whatever the user's port selection.
801
801
802
-
In the `board2` case: the `bossac` recipe will be used if the port selected is a `serial` port, otherwise the `openocd_without_port` will be used in all other cases (even if a port has been selected by the user).
802
+
In the `board2` case: the `bossac` recipe will be used if the port selected is a `serial` port, otherwise the `openocd_without_port` will be used in all other cases (whatever the user's port selection).
803
803
804
804
In the `board3` case: the `bossac` recipe will be used if the port selected is a `serial` port, otherwise the upload will fail.
805
805
806
-
A lot of existing platforms already have recipes without an explicit port address, in this case the upload tool specified in the old (non-pluggable) way will be considered as a `no-port` upload, for example let's consider the Arduino Zero board:
806
+
A lot of existing platforms already have recipes without an explicit port address, in this case the upload tool specified in the old (non-pluggable) way will be considered as a `default` protocol upload, for example let's consider the Arduino Zero board:
807
807
808
808
```
809
809
# Arduino Zero (Prorgamming Port)
@@ -812,7 +812,7 @@ arduino_zero_edbg.name=Arduino Zero (Programming Port)
812
812
arduino_zero_edbg.vid.0=0x03eb
813
813
arduino_zero_edbg.pid.0=0x2157
814
814
815
-
arduino_zero_edbg.upload.tool=openocd <--- CONSIDERED AS no-port PROT.
815
+
arduino_zero_edbg.upload.tool=openocd <--- CONSIDERED AS default PROTOCOL
0 commit comments