59 lines
212 KiB
Markdown
59 lines
212 KiB
Markdown
|
---
|
|||
|
|
obj: device
|
|||
|
|
repo: https://github.com/dbisu/pico-ducky
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Raspberry Pi Pico Rubberducky
|
|||
|
|
You can turn your [Raspberry Pi Pico](Raspberry%20Pi%20Pico%20W.md) into a [Rubberducky USB](Rubberducky%20USB.md).
|
|||
|
|
|
|||
|
|
## Quick Start Guide
|
|||
|
|
Install and have your USB Rubber Ducky working in less than 5 minutes.
|
|||
|
|
1. Download the latest release from the [Releases](https://github.com/dbisu/pico-ducky/releases) page.
|
|||
|
|
2. Plug the device into a USB port while holding the boot button. It will show up as a removable media device named `RPI-RP2`.
|
|||
|
|
3. Install CircuitPython on the Pico or Pico W
|
|||
|
|
If using a Pico board:
|
|||
|
|
Copy the `adafruit-circuitpython-raspberry_pi_pico-en_US-8.0.0.uf2` file to the root of the Pico (RPI-RP2). The device will reboot and after a second or so, it will reconnect as `CIRCUITPY`.
|
|||
|
|
|
|||
|
|
If using a Pico W board:
|
|||
|
|
Copy the `adafruit-circuitpython-raspberry_pi_pico_w-en_US-8.0.0.uf2` file to the root of the Pico (RPI-RP2). The device will reboot and after a second or so, it will reconnect as `CIRCUITPY`.
|
|||
|
|
1. Copy the `lib` folder to the root of the `CIRCUITPY`
|
|||
|
|
5. Copy `*.py` to the root of the `CIRCUITPY`
|
|||
|
|
6. Follow the instructions in `README.md` to enter setup mode
|
|||
|
|
7. Copy your payload as `payload.dd` to the root of the `CIRCUITPY`
|
|||
|
|
8. Unplug the device from the USB port and remove the setup jumper.
|
|||
|
|
|
|||
|
|
Enjoy your Pico-Ducky.
|
|||
|
|
|
|||
|
|
## Setup Mode
|
|||
|
|
To edit the payload, enter setup mode by connecting the pin 1 (`GP0`) to pin 3 (`GND`), this will stop the pico-ducky from injecting the payload in your own machine. The easiest way to do so is by using a jumper wire between those pins as seen bellow.
|
|||
|
|
|
|||
|
|
 and pin 20 (`GPIO15`).
|
|||
|
|
This will prevent the pico-ducky from showing up as a USB drive when plugged into the target computer.
|
|||
|
|
- Remove the jumper and reconnect to your PC to reprogram.
|
|||
|
|
|
|||
|
|
**Pico**: The default mode is USB mass storage enabled.
|
|||
|
|
**Pico W**: The default mode is USB mass storage **disabled**
|
|||
|
|
|
|||
|
|
![Pico](data:image/avif;base64,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
|
|||
|
|
|
|||
|
|
## Pico W Web Service
|
|||
|
|
The Pico W AP defaults to ip address `192.168.4.1`. You should be able to find the webservice at `http://192.168.4.1:80`
|
|||
|
|
|
|||
|
|
The following endpoints are available on the webservice:
|
|||
|
|
- `/`
|
|||
|
|
- `/new`
|
|||
|
|
- `/ducky`
|
|||
|
|
- `/edit/<filename>`
|
|||
|
|
- `/write/<filename>`
|
|||
|
|
- `/run/<filename>`
|
|||
|
|
|
|||
|
|
### API endpoints
|
|||
|
|
- `/api/run/<filenumber>`
|