8000 Update debugger tutorial for Arduino IDE >=2.0.3 by per1234 · Pull Request #709 · arduino/docs-content · GitHub
[go: up one dir, main page]
Skip to content

Update debugger tutorial for Arduino IDE >=2.0.3 #709

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Dec 7, 2022
Merged

Update debugger tutorial for Arduino IDE >=2.0.3 #709

Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
1065764
Update "J-Link GDB Server" path in IDE 2.x debugger tutorial
per1234 Dec 5, 2022
ded6025
Clean up formatting of example `debug_custom.json` file in IDE 2.x de…
per1234 Dec 5, 2022
154c713
Use command line version of "J-Link GDB Server" in example configurat…
per1234 Dec 5, 2022
90d1203
Provide filename of "J-Link GDB Server" for each OS in IDE 2.x debugg…
per1234 Dec 5, 2022
c99daed
Correct line numbers referenced in breakpoint section of IDE 2.x debu…
per1234 Dec 5, 2022
c9ede0e
Update breakpoints section of IDE 2.x debugger tutorial to reflect ne…
per1234 Dec 5, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to 8000 file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Use command line version of "J-Link GDB Server" in example configurat… 
…ion file of IDE 2.x debugger tutorial

Installation of the "SEGGER J-Link GDB Server" software is required in order to use a J-Link debug proble with the
Arduino IDE integrated sketch debugger.

This installation includes two variants of the "J-Link GDB Server" tool, each executable with a different filename:

- GUI: `JLinkGDBServer.exe` (Windows) / `JLinkGDBServerExe` (Linux/macOS)
- Command Line: `JLinkGDBServerCL.exe` (Windows) / `JLinkGDBServer` (Linux/macOS)

The user must specify the path to the tool executable in the debug_custom.json configuration file. The Arduino IDE 2.x
debugger tutorial includes a sample debug_custom.json file. Previously this example used the filename of the GUI
variant.

Although technically inappropriate for this application, this variant worked fine with the previous version of the
debugger extension (0.3.10) used by Arduino IDE 2.0.2 and older, and also offered the advantage of having the same
filename as Linux and macOS users will need (confusingly, `JLinkGDBServer` is the filename of the GUI variant on
Windows, and of the command line variant on the other operating systems).

I found that the newer version of the debugger extension (1.5.1) used by Arduino IDE 2.0.3 fails on startup when the GUI
variant is used, while the command line variant works fine. For this reason, the filename used in the example
debug_custom.json file must now be updated to use the command line variant. This should not impact anyone who is
following the tutorial while using an Arduino IDE version 2.0.2 or older because the command line variant works fine
with those versions as well.
  • Loading branch information
@per1234
per1234 committed Dec 5, 2022
commit 154c7132a3731c305875e9af62476cdc5e8b8d8e
2 changes: 1 addition & 1 deletion .../hardware/01.mkr/01.boards/mkr-wifi-1010/tutorials/mkr-jlink-setup/mkr-jlink.md
7CCD
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ Now go to the folder where the sketch is located. Add a `.json` file in the same
"servertype": "jlink",
"device": "ATSAMD21G18",
"interface": "SWD",
"serverpath": "C:/Program Files/SEGGER/JLink/JLinkGDBServer"
"serverpath": "C:/Program Files/SEGGER/JLink/JLinkGDBServerCL"
}
```

Expand Down
0