DISCLAIMER: The code files in this repository are not my work, and have been produced by the Raspberry Pi Foundation.

This repository has been forked (and modified) from rej696/elf2uf2.

This repository copies code from the Raspberry Pi Pico SDK for building the elf2uf2 utility.

This utility allows elf files compiled for the pico, either using the pico-sdk or using the pico_bsp on alire, to be converted to uf2 files. uf2 firmware can then be loaded onto the pico via. holding the bootselect button when plugging in the usb cable, and copying the firmware into the mass storage device that appears.

• This fork has been modified to include an MSVC vs2022 workspace.
• It has also adapted the Makefile to be used on either Linux, MacOS or MinGW.
• Enhanced compiler warnings have been added (when using GCC). The resulting warnings have been handled in the code.
• Continuous integration on GHA has been added.

Clone the repo, locate and open the usual Visual Studio workspace. Rebuild the solution in Release mode. Use the resulting file elf2uf2.exe on your elf binary to prepare it for the RP2040.

To build this tool in a *nix-like environment, you will need a git and a c++ compiler.

Clone the repo, (assuming you are using g++) compile the tool, and use it on your elf binary.

When using the Makefile, the build results can be found in a temporary directory called bin.

git clone https://github.com/ckormanyos/elf2uf2.git
make all # or run your native compiler command
./elf2uf2 <input ELF file> <output UF2 file>

Then copy the output uf2 onto your pico.

For a more detailed guide to using Alire and compiling Ada for see my pico-with-ada repository.

Alternatively to using the elf2uf2 utility, you may wish to use pico-debug, which allows gdb debugging and uploading of an elf file over USB, rather than Serial Wire Debug (SWD).

Continuous integration runs on GHA using ubuntu-latest and macos-latest runners.