Upload: Property 'upload.tool.serial' is undefined

stiliajohny · October 23, 2022, 5:00pm

Hi

I am using arduino-cli and I have installed all the libraries needed by the projects etc

When I am issuing the command
arduino-cli upload --config-file ./arduino_config.yaml --port $(PORT) -b rp2040:rp2040:rpipico $(FILE)

I am getting the project compiled, but I can't upload it due to the following error

Sketch uses 52148 bytes (2%) of program storage space. Maximum is 2093056 bytes.
Global variables use 7328 bytes (2%) of dynamic memory, leaving 254816 bytes for local variables. Maximum is 262144 bytes.

Used library  Version Path
Rtc by Makuna 2.3.5   /Users/johnstilia/Documents/GitHub/hardware-gps-tracker/hardware/gps_unit/.arduino/user/libraries/Rtc_by_Makuna

Used platform Version Path
rp2040:rp2040 2.6.1   /Users/johnstilia/Documents/GitHub/hardware-gps-tracker/hardware/gps_unit/.arduino/data/packages/rp2040/hardware/rp2040/2.6.1

Error during Upload: Property 'upload.tool.serial' is undefined
make: *** [code-upload] Error 1

That didn't seem to be the case on the 2.5.0 version.

It could be something different too.

Thank you in advance for any help you can provide

PS: I have followed some googled suggestions but have had no luck.
also, I need to do it via CLI and not via IDE

Juraj · October 23, 2022, 5:06pm

github.com/JAndrassy/ArduinoOTA

Make programmers.txt snippet compatible with platforms that use pluggable discovery syntax

JAndrassy:master ← per1234:update-program-tool

opened 02:03PM - 26 Sep 22 UTC

per1234

+1 -0

A new flexible and powerful ["pluggable discovery" system](https://arduino.githu…b.io/arduino-cli/0.27/platform-specification/#pluggable-discovery) was added to the Arduino boards platform framework. This system makes it easy for Arduino boards platform authors to use any arbitrary communication channel between the board and development tools. Boards platform configurations that use the old property syntax are automatically translated to the new syntax by Arduino CLI. https://arduino.github.io/arduino-cli/latest/platform-specification/#sketch-upload-configuration This translation is only done in platforms that use the old syntax exclusively. If `pluggable_discovery` properties are defined for the platform then the new pluggable discovery-style [`program.tool.<protocol_name>` properties](https://arduino.github.io/arduino-cli/latest/platform-specification/#upload-using-an-external-programmer) must be defined as well. If not, the "**Upload Using Programmer**" operation will fail: ```text Property 'program.tool.serial' is undefined ``` Or if no serial port is selected: ```text Property 'program.tool.' is undefined ``` Since the `programmers.txt` snippet provided in the readme is intended to be used with any platform, it must be compatible with those that use the new pluggable discovery syntax (e.g., https://github.com/arduino/ArduinoCore-samd/pull/648). This is accomplished by adding an `arduinoOTA115.program.tool.default` property. It is also important to provide compatibility with older versions of Arduino development tools. For this reason, the old style property `arduinoOTA115.program.tool` is retained. Old versions of the development tools will treat the `arduinoOTA115.program.tool.default` property as an arbitrary user defined property with no special significance and the new versions of the development tools will do the same for the `arduinoOTA115.program.tool` property.

stiliajohny · October 23, 2022, 5:09pm

hi @Juraj

THank you,

I am not too sure if this is directly related to my issue.

The GitHub link you have is about Arduino OTA, the issue I have is on the CLI

It could be the e same thought

Juraj · October 23, 2022, 5:12pm

just read it

stiliajohny · October 23, 2022, 5:56pm

Yep, Read it, see you merged it. I suppose is not on the latest yet?

Also as far as Arduino IDE and CLI go I am a user, not a sudo-user

Juraj · October 23, 2022, 6:13pm

sorry, I see the pico core has empty programmers.txt so the cause is something else there

ptillisch · October 23, 2022, 11:03pm

I investigated, found the bug in the "Raspberry Pi Pico/RP2040" platform, and submitted a fix:

github.com/earlephilhower/arduino-pico

Add protocol-explicit `upload.tool` properties required for pluggable discovery compatibility

earlephilhower:master ← per1234:update-upload-tool

opened 10:54PM - 23 Oct 22 UTC

per1234

+162 -9

A new flexible and powerful ["pluggable discovery" system](https://arduino.githu…b.io/arduino-cli/0.27/platform-specification/#pluggable-discovery) was added to the Arduino boards platform framework. This system makes it easy for Arduino boards platform authors to use any arbitrary communication channel between the board and development tools. Boards platform configurations that use the old property syntax are automatically translated to the new syntax by Arduino CLI: https://arduino.github.io/arduino-cli/latest/platform-specification/#sketch-upload-configuration > For backward compatibility with IDE 1.8.15 and older the previous syntax is still supported This translation is only done in platforms that use the old syntax exclusively. If `pluggable_discovery` properties are defined for the platform then the new pluggable discovery-style `upload.tool.<protocol_name>` properties must be defined for each board as well. This platform includes a "UF2 Devices" discovery tool for `uf2conv` protocol ports. This tool now uses the modern Arduino pluggable discovery system. `pluggable_discovery` properties were added to `platform.txt` in order to configure the Arduino development tools to use this pluggable discovery tool. The `upload.tool.<protocol_name>` properties in `boards.txt` were not updated at that time. Global properties of that name were added to `platform.txt`, but this approach is not provided for by the Arduino Platform specification: https://arduino.github.io/arduino-cli/latest/platform-specification/#sketch-upload-configuration > A specific upload.tool.<protocol_name> property should be defined for every board in `boards.txt`: Those missing properties caused uploads to fail for users of the recent versions of Arduino IDE and Arduino CLI (https://github.com/earlephilhower/arduino-pico/issues/932) with an error of the form: ```text Error during Upload: Property 'upload.tool.<protocol_name>' is undefined ``` (where `<protocol_name>` is the protocol of the selected port, if any) It is also important to provide compatibility with versions of Arduino development tools from before the introduction of the modern pluggable discovery system. For this reason, the old style `<board ID>.upload.tool` properties are retained. Old versions of the development tools will treat the `<board ID>.upload.tool.<protocol_name>` properties as an unused arbitrary user defined property with no special significance and the new versions of the development tools will do the same for the `<board ID>.upload.tool` properties. --- Fixes https://github.com/earlephilhower/arduino-pico/issues/932

If accepted, this fix will be in the next release of the "Raspberry Pi Pico/RP2040" platform, but you can apply the fix manually right away if you like. I'll provide instructions:

Open the file at this path in any text editor:

/Users/johnstilia/Documents/GitHub/hardware-gps-tracker/hardware/gps_unit/.arduino/data/packages/rp2040/hardware/rp2040/2.6.1/boards.txt

Add the following line anywhere in the file:
```
rpipico.upload.tool.default=uf2conv
```
Save the file.

Now try uploading your sketch again. The error should no longer occur.

Please let me know if you have any questions or problems while following those instructions.

Even if not directly related, the information provided in the PR description is generally relevant. It was written with the intention of serving as a reference for those who might encounter it in their researches in addition to the primary purpose of explaining the pull request.

I provided an equivalent (but adjusted to be applicable to the specific problem in the RP2040 platform) explanation in the pull request at https://github.com/earlephilhower/arduino-pico/pull/933

If you happen to be interested in all those boring details and have any additional questions I'd be happy to answer them.

system · April 21, 2023, 11:03pm

This topic was automatically closed 180 days after the last reply. New replies are no longer allowed.

Topic		Replies	Views
Arduino 2 Beta 12 STLink Programmer Error IDE 2.x	16	4805	June 21, 2022
missing 'upload.tool' configuration parameter IDE 1.x	2	1817	May 5, 2021
Arduino 1.0 upload issue IDE 1.x	27	12897	May 5, 2021
When uploading a project to the arduino it does not work Programming	2	738	May 5, 2021
Custom board - using Upload feature 3rd Party Boards	3	1080	May 6, 2021

Upload: Property 'upload.tool.serial' is undefined

Related topics