gitwtfhub

wtf is bonbon?

machdyne/bonbon — explained in plain English

Analysis updated 2026-08-12 · repo last pushed 2023-05-23

14CAudience · developerComplexity · 4/5DormantLicenseSetup · moderate

TL;DR

Bonbon is a tiny customizable computer built around an FPGA chip paired with an RP2040 microcontroller. The repo includes circuit board designs, layout files, and example code so you can program, build, or even manufacture your own version.

Mindmap

mindmap
  root((repo))
    What it does
      Reprogrammable FPGA computer
      RP2040 manages boot and loading
      Micro-USB connection to PC
      Blink LED example included
    Tech stack
      C language
      FPGA tools open-source
      RP2040 microcontroller
      ldprog transfer tool
    Use cases
      Build retro game console
      Custom video display output
      Learn FPGA development
      Manufacture and sell device
    Audience
      Hardware hackers
      Electronics students
      Inventors
      Startups

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build a retro-style game console by programming the FPGA to act like a classic video chip.

REASON 2

Create custom hardware such as a unique signal processor or video display output.

REASON 3

Learn FPGA development starting from the included LED blink example.

REASON 4

Manufacture and sell your own modified version of the computer with custom branding.

What's in the stack?

CFPGARP2040ldprog

How it stacks up

machdyne/bonbonanylaysys/qemu-geniezonefelipealme/dvs-wireless-diy-dj-system
Stars141414
LanguageCCC
Last pushed2023-05-23
MaintenanceDormant
Setup difficultymoderatehardhard
Complexity4/54/54/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires installing open-source FPGA toolchain and the ldprog utility, plus a Micro-USB cable to connect the board.

Use freely including for commercial products, but you must add your own branding and cannot sell it under the original name.

Wtf does this do

Bonbon is a small, customizable computer built around a special kind of chip called an FPGA. Unlike a standard processor that comes with its functions permanently baked in at the factory, an FPGA is a blank slate. You can reprogram it on the fly to behave like different types of hardware. This repo gives you everything needed to understand, program, and even manufacture your own version of the device, including circuit blueprints, physical layout files, and example software. The system is a collaboration between two main chips. An RP2040 microcontroller (the same chip used in the popular Raspberry Pi Pico) acts as the manager. When you plug the board into your computer via a Micro-USB cable, this microcontroller handles the communication. Its job is to start the system up, manage the clock speed, and load your custom designs into the FPGA. You can write code that turns the FPGA into a custom video display output, a unique signal processor, or whatever else you design. The repository includes a simple example that just blinks an LED, which serves as a starting point for understanding how to program the hardware. This is a tool for hardware hackers, electronics students, and inventors who want to build custom computing hardware without designing a circuit board from scratch. For example, if someone wants to create a retro-style game console, they could use this board, program the FPGA to act like a classic video chip, and output the visuals to a modern monitor. Because the project includes the actual circuit board designs and allows commercial use, a startup could even manufacture and sell their own modified version of the computer, as long as they add their own branding. One notable aspect of the project is how it handles programming. You use free, open-source tools to compile your designs into a file, then transfer it to the board using a separate program called ldprog. The microcontroller's firmware is very easy to update via a simple drag-and-drop file transfer, making the system quite approachable for people learning how FPGA development works.

Yoink these prompts

Prompt 1
Help me write a Verilog design for the Bonbon FPGA board that outputs a simple VGA color bar pattern. Explain how to compile it with the open-source tools and load it onto the board using ldprog.
Prompt 2
I want to use the Bonbon board to build a retro game console. Write a starter FPGA design that acts like a basic video chip outputting a fixed-color screen, and show me how the RP2040 loads it onto the FPGA.
Prompt 3
Guide me through updating the RP2040 firmware on the Bonbon board using drag-and-drop over Micro-USB, then walk me through compiling and flashing the LED blink example to verify the board works.
Prompt 4
I have the Bonbon circuit board designs and want to manufacture my own version. Help me understand what files I need to send to a PCB fab house and what branding requirements the license imposes.

Frequently asked questions

wtf is bonbon?

Bonbon is a tiny customizable computer built around an FPGA chip paired with an RP2040 microcontroller. The repo includes circuit board designs, layout files, and example code so you can program, build, or even manufacture your own version.

What language is bonbon written in?

Mainly C. The stack also includes C, FPGA, RP2040.

Is bonbon actively maintained?

Dormant — no commits in 2+ years (last push 2023-05-23).

What license does bonbon use?

Use freely including for commercial products, but you must add your own branding and cannot sell it under the original name.

How hard is bonbon to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is bonbon for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.