picovga-RGsB/BUILD_INSTRUCTIONS.md

Build Instructions

This project uses CMake with the Raspberry Pi Pico SDK and an ARM cross-toolchain.

Prerequisites (Ubuntu/Debian)

Install required packages:

sudo apt-get update
sudo apt-get install -y \
  cmake \
  ninja-build \
  gcc-arm-none-eabi \
  binutils-arm-none-eabi

Configure

From the repository root:

cmake -S . -B build -G Ninja -DPICO_SDK_FETCH_FROM_GIT=ON

Notes:

• PICO_SDK_FETCH_FROM_GIT=ON automatically downloads the Pico SDK into build/_deps.
• If you already have a local Pico SDK, set PICO_SDK_PATH instead.

Build the Monoscope Example

cmake --build build --target vga_monoscope -j

Output Artifacts

After a successful build, files are generated here:

• build/examples/vga_monoscope/vga_monoscope.uf2
• build/examples/vga_monoscope/vga_monoscope.hex
• build/examples/vga_monoscope/vga_monoscope.bin
• build/examples/vga_monoscope/build/vga_monoscope.elf

Rebuild

To rebuild after source changes:

cmake --build build --target vga_monoscope

Clean Build

To start from a clean state:

rm -rf build
cmake -S . -B build -G Ninja -DPICO_SDK_FETCH_FROM_GIT=ON
cmake --build build --target vga_monoscope -j