elf2uf2

Raspberry Pi Pico elf2uf2 Utility

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.

Further modifications

• 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.

Installation and use

Build with MSVC

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.

Build in *nix

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

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