Skip to content

Commit

Permalink
Update workflow and documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
GaryOderNichts committed Dec 5, 2024
1 parent 68e4085 commit c56ff9e
Show file tree
Hide file tree
Showing 5 changed files with 37 additions and 18 deletions.
35 changes: 29 additions & 6 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,18 +6,41 @@ jobs:
build-binary:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Checkout udpih
uses: actions/checkout@v4
with:
path: udpih
submodules: recursive
- name: Build pico

- name: Checkout pico-sdk
uses: actions/checkout@v4
with:
repository: raspberrypi/pico-sdk
ref: master
path: pico-sdk
submodules: recursive

- name: Setup pico-sdk
run: |
sudo apt install -y cmake gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib
- name: Build arm_kernel code
run: |
cd ${{github.workspace}}/udpih
docker build -t udpihbuilder .
docker run --rm -v ${PWD}:/project udpihbuilder make pico
docker run --rm -v ${PWD}:/project udpihbuilder make arm_kernel
- name: Build pico code
run: |
export PICO_SDK_PATH=${{github.workspace}}/pico-sdk
cd ${{github.workspace}}/udpih/pico
make
- uses: actions/upload-artifact@v4
with:
name: udpih
path: |
arm_kernel/arm_kernel.bin.h
pico/build_rp2040/udpih.uf2
pico/build_rp2350/udpih.uf2
${{github.workspace}}/udpih/arm_kernel/arm_kernel.bin.h
${{github.workspace}}/udpih/pico/build_rp2040/udpih.uf2
${{github.workspace}}/udpih/pico/build_rp2350/udpih.uf2
if-no-files-found: error
8 changes: 1 addition & 7 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -1,11 +1,5 @@
FROM devkitpro/devkitarm:20240511
FROM devkitpro/devkitarm:20241111

ENV PATH=$DEVKITARM/bin:$PATH

RUN apt-get update && apt-get -y install --no-install-recommends build-essential cmake gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib && rm -rf /var/lib/apt/lists/*

# clone pico-sdk
RUN git clone https://github.com/raspberrypi/pico-sdk
ENV PICO_SDK_PATH=/pico-sdk

WORKDIR /project
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,21 +12,22 @@ Exploits the Wii U's USB Host Stack descriptor parsing. Pronounced like "mud pie
I will add more devices below which are confirmed to work.*

### Supported devices:
- Raspberry Pi Pico
- Raspberry Pi Pico (W) / Pico 2 (W)
- Raspberry Pi Zero (W) / A / A+ / Zero 2 W / 4 / 5
- Steam Deck
- Nintendo Switch capable of running [udpih_nxpayload](https://github.com/GaryOderNichts/udpih_nxpayload)

## Instructions
### Device Setup
Follow the setup guide for the device you want to use below:
- [Raspberry Pi Pico](./docs/setup-pico.md)
- [Raspberry Pi Pico / Pico 2](./docs/setup-pico.md)
- [Raspberry Pi Zero (W) / A / A+ / Zero 2 W / 4 / 5](./docs/setup-linux.md)
- [Steam Deck](./docs/setup-linux.md)
- [Nintendo Switch](https://github.com/GaryOderNichts/udpih_nxpayload#Instructions)

### Booting the recovery_menu
> :warning: Important notes for this to work:
> [!IMPORTANT]
> Important notes for this to work:
> - Make sure **no** other USB devices are attached to the console.
> - Only use USB ports on the **front** of the console, the back ports **will not** work.
> - If your console has standby mode enabled, pull the power plug and turn it on from a full coldboot state.
Expand Down
3 changes: 2 additions & 1 deletion docs/setup-linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,8 @@ sudo insmod udpih.ko

The device is now ready to be used for udpih.

> :information_source: If you reboot your udpih device, you will need to load the kernel module again with the above command.
> [!NOTE]
> If you reboot your udpih device, you will need to load the kernel module again with the above command.

Continue with ["Booting the recovery_menu"](../README.md#booting-the-recovery_menu).

Expand Down
2 changes: 1 addition & 1 deletion docs/setup-pico.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Pico
## Instructions
- Download the latest `udpih.uf2` from the [releases page](https://github.com/GaryOderNichts/udpih/releases).
- Download the latest `udpih_pico.uf2` for the Pico, or `udpih_pico2.uf2` for the Pico 2, from the [releases page](https://github.com/GaryOderNichts/udpih/releases).
- Hold down the `BOOTSEL` button on the board and connect the Pico to your PC.
Your PC will detect the Pi as a storage device.
- Copy the `.uf2` file to the Pico. It will disconnect after a few seconds.
Expand Down

0 comments on commit c56ff9e

Please sign in to comment.