Skip to content

Commit 729163d

Browse files
Remove pico-debug because it's archived (#2392)
Pico-Debug is no longer supported and was removed from OpenOCD, so remove the references and upload menu items for it. Fixes earlephilhower/pico-quick-toolchain#61
1 parent 42a0c88 commit 729163d

File tree

7 files changed

+7
-693
lines changed

7 files changed

+7
-693
lines changed

README.md

Lines changed: 5 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,6 @@ Read the [Contributing Guide](https://github.com/earlephilhower/arduino-pico/blo
102102
* Generic RP2350 (configurable flash, I/O pins)
103103

104104
# Features
105-
* Transparent use of PSRAM globals and heap (RP2350 only)
106105
* Adafruit TinyUSB Arduino (USB mouse, keyboard, flash drive, generic HID, CDC Serial, MIDI, WebUSB, others)
107106
* Bluetooth on the PicoW (Classic and BLE) with Keyboard, Mouse, Joystick, and Virtual Serial
108107
* Bluetooth Classic and BLE HID master mode (connect to BT keyboard, mouse, or joystick)
@@ -123,6 +122,7 @@ Read the [Contributing Guide](https://github.com/earlephilhower/arduino-pico/blo
123122
* USB drive mode for data loggers (SingleFileDrive, FatFSUSB)
124123
* Peripherals: SPI master/slave, Wire(I2C) master/slave, dual UART, emulated EEPROM, I2S audio input/output, Servo
125124
* printf (i.e. debug) output over USB serial
125+
* Transparent use of PSRAM globals and heap (RP2350 only)
126126

127127
The RP2040 PIO state machines (SMs) are used to generate jitter-free:
128128
* Servos
@@ -195,11 +195,6 @@ cd ../tools
195195
python3 ./get.py
196196
`````
197197
198-
# Installing both Arduino and CMake
199-
Tom's Hardware presented a very nice writeup on installing `arduino-pico` on both Windows and Linux, available at https://www.tomshardware.com/how-to/program-raspberry-pi-pico-with-arduino-ide
200-
201-
If you follow Les' step-by-step you will also have a fully functional `CMake`-based environment to build Pico apps on if you outgrow the Arduino ecosystem.
202-
203198
# Uploading Sketches
204199
To upload your first sketch, you will need to hold the BOOTSEL button down while plugging in the Pico to your computer.
205200
Then hit the upload button and the sketch should be transferred and start to run.
@@ -220,9 +215,9 @@ To install, follow the directions in
220215
* https://github.com/earlephilhower/arduino-pico-littlefs-plugin/blob/master/README.md
221216
222217
For detailed usage information, please check the ESP8266 repo documentation (ignore SPIFFS related notes) available at
223-
* https://arduino-esp8266.readthedocs.io/en/latest/filesystem.html
218+
* https://arduino-pico.readthedocs.io/en/latest/fs.html
224219
225-
# Uploading Sketches with Picoprobe
220+
# Uploading Sketches with Picoprobe/Debugprobe
226221
If you have built a Raspberry Pi Picoprobe, you can use OpenOCD to handle your sketch uploads and for debugging with GDB.
227222
228223
Under Windows a local admin user should be able to access the Picoprobe port automatically, but under Linux `udev` must be told about the device and to allow normal users access.
@@ -242,28 +237,8 @@ If for some reason the device file does not appear, manually unplug and re-plug
242237
243238
Once Picoprobe permissions are set up properly, then select the board "Raspberry Pi Pico (Picoprobe)" in the Tools menu and upload as normal.
244239
245-
# Uploading Sketches with pico-debug
246-
[pico-debug](https://github.com/majbthrd/pico-debug/) differs from Picoprobe in that pico-debug is a virtual debug pod that runs side-by-side on the same RP2040 that you run your code on; so, you only need one RP2040 board instead of two. pico-debug also differs from Picoprobe in that pico-debug is standards-based; it uses the CMSIS-DAP protocol, which means even software not specially written for the Raspberry Pi Pico can support it. pico-debug uses OpenOCD to handle your sketch uploads, and debugging can be accomplished with CMSIS-DAP capable debuggers including GDB.
247-
248-
Under Windows and macOS, any user should be able to access pico-debug automatically, but under Linux `udev` must be told about the device and to allow normal users access.
249-
250-
To set up group-level access to all CMSIS-DAP adapters on Ubuntu (and other OSes which use `udev`):
251-
````
252-
echo 'ATTRS{product}=="*CMSIS-DAP*", MODE="664", GROUP="plugdev"' | sudo tee -a /etc/udev/rules.d/98-CMSIS-DAP.rules
253-
sudo udevadm control --reload
254-
sudo udevadm trigger -w -s usb
255-
````
256-
257-
The first line creates a device file in `/dev` that matches all CMSIS-DAP adapters, and it enables read+write permissions for members of the `plugdev` group. The second line causes `udev` to load this new rule. The third line requests the kernel generate "device change" events that will cause our new `udev` rule to run.
258-
259-
If for some reason the device file does not appear, manually unplug and re-plug the USB connection and check again. The output from `dmesg` can reveal useful diagnostics if the device file remains absent.
260-
261-
Once CMSIS-DAP permissions are set up properly, then select the board "Raspberry Pi Pico (pico-debug)" in the Tools menu.
262-
263-
When first connecting the USB port to your PC, you must copy [pico-debug-gimmecache.uf2](https://github.com/majbthrd/pico-debug/releases/) to the Pi Pico to load pico-debug into RAM; after this, upload as normal.
264-
265-
# Debugging with Picoprobe/pico-debug, OpenOCD, and GDB
266-
The installed tools include a version of OpenOCD (in the pqt-openocd directory) and GDB (in the pqt-gcc directory). These may be used to run GDB in an interactive window as documented in the Pico Getting Started manuals from the Raspberry Pi Foundation. For [pico-debug](https://github.com/majbthrd/pico-debug/), replace the raspberrypi-swd and picoprobe example OpenOCD arguments of "-f interface/raspberrypi-swd.cfg -f target/rp2040.cfg" or "-f interface/picoprobe.cfg -f target/rp2040.cfg" respectively in the Pico Getting Started manual with "-f board/pico-debug.cfg".
240+
# Debugging with Picoprobe, OpenOCD, and GDB
241+
The installed tools include a version of OpenOCD (in the pqt-openocd directory) and GDB (in the pqt-gcc directory). These may be used to run GDB in an interactive window as documented in the Pico Getting Started manuals from the Raspberry Pi Foundation. Use the command line `./system/openocd/bin/openocd -f ./lib/rp2040/picoprobe_cmsis_dap.tcl` or `./system/openocd/bin/openocd -f ./lib/rp2350/picoprobe_cmsis_dap.tcl` from the `git` installation directory.
267242
268243
# Licensing and Credits
269244
* The [Arduino IDE and ArduinoCore-API](https://arduino.cc) are developed and maintained by the Arduino team. The IDE is licensed under GPL.

0 commit comments

Comments
 (0)