Skip to the content
4 layers74.3 × 115.1 mmBare metal, the printed circuit board in 3D

bare_metal FPGA open source development board

Size
74.3 × 115.1 mm
Copper layers
4
Thickness
1.7 mm
Parts
261
Nets
336
Pads
1,211
Tracks, vias
2,635, 687
Pours
7
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
30 Sep 2026
Updated
14 Oct 2026

Overview

Bare metal is an open-source printed circuit board by wenzellabs, from the wenzellabs/bare_metal repository on GitHub. It is a 4-layer board of 74.3 × 115.1 mm with 261 parts on 336 nets, routed with 2,635 tracks and 687 vias.

It is built around the ICE40UP5K-SG48ITR50, BD83070GWL-E2 and W25Q128JVSIQ, with the BQ24074RGTR, IP4234CZ6 and MIC5268-1.2BM5 among its other parts. Its parts include 136 diodes, 58 capacitors, 34 resistors, 10 ICs and 7 switches. It belongs with the FPGA and CPLD boards of this library.

Main components

9

README

README.md

bare_metal

bare metal is an FPGA development board - the ideal platform to get started with FPGAs and HDL of one or another sort. all open source.

you can buy bare_metal over at my little lectronz shop.

a black PCB (front) in the shape of a hand showing the metal horn, features are documented a black PCB (back) in the shape of a hand showing the metal horn, features are documented a black PCB (back, without battery) in the shape of a hand showing the metal horn, features are documented

bare_metal, the opensource FPGA development board:

  • five user buttons: OK, left, right, up, down
  • large 16x8 SPI-addressable RGB LEDs display
  • extensible through a PMOD interface
  • comes with a battery for many hours of runtime
  • extensive power management, monitoring and battery protection in HW
  • allows for CPU-less designs or soft-core CPUs
  • get into FPGAs with the yosys and nextpnr all open source toolchains
  • program in python/amarant, verilog, spade or others
  • comes with a stand
  • three bright white LEDs as simple debug or flashlight
  • usable as name tag, comes with a lace
  • comes with a bootloader as 1st of four bitstreams
  • can host up to 3 user bitstreams
  • 16MBytes flash in total (1 bitstream takes < 128kBytes)
  • 8MBytes RAM in total
  • transputer research platform, as 3 user bitstreams can "boot" each other, see bootloader below
  • hacky but feasible: more that 3 user bitstreams (hundreds)

tech bits

schematic

see the hardware directory. find the schematics, the KiCad sources and some nice renderings.

memory

  • 16MBytes SPI flash (W25Q128JVSIQ) this is where the FPGA boots from and user storage such as text, fonts, images, sounds, video, etc.
  • 8MBytes SPI PSRAM (LY68L6400) far all of your extensive memory needs

here's a memory map of the SPI flash:

text
# 0x000_0000 - 0x000_009f =160b, multiboot header, slot table
# 0x000_00a0 - 0x001_efff ~124kB, slot 0, bare_metal_bootloader
# 0x001_f000 - 0x001_ffff =4kB, bootmetadata
# 0x002_0000 - 0x003_ffff =128kB, slot 1, user bitstream, hackerstacker_demo by default
# 0x004_0000 - 0x005_ffff =128kB, slot 2, another bitstream, transputers anyone?
# 0x006_0000 - 0x007_ffff ~128kB, slot 3, yab, hooray for transputers!
# 0x008_0000 - 0x100_0000 ~15.5MB, user data, images, fonts, text, sounds, videos etc
text
# in hackerstacker_demo, we reserve the first 512 KB for bootloader and bitstreams,
# and use the rest for user data:
# 0x008_0000 - 0x008_ffff = 64 kB, font data
# 0x009_0000 - 0x009_ffff = 64 kB, game data
# 0x00a_0000 - 0x00a_ffff = 64 kB, nick names
# 0x00b_0000 - 0x0ff_ffff = ~15.3MB images, video

bootloader

the bootloader is always started after power up or reset. it lives in slot0 of the four default bitstream slots.

the bootloader is forked from https://github.com/tinyfpga/TinyFPGA-Bootloader which looks unmaintained nowadays. we forked, and implement our bootloader and the tinyprog flashing tool at https://codeberg.org/wenzellabs/bare_metal_bootloader

text
                   [-----------][----------][----------]
                   [ user bit- ][ user bit-][ user bit-]
                   [ stream 1  ][ stream 2 ][ stream 3 ]
                   [           ][          ][          ]
                   [===========][==========][==========]
                   [-----------------------------------]
                   [    USB-bootloader bitstream 0     ]
                   [===================================]
               [-------------------------------------------]
               [ iCE40-up5k-sg48 FPGA, 5k LCs, DSP fn()s   ]
               [===========================================]
[-----]    [----------------------------------------------------]    [---------------]
[ USB ]----[ bare_metal, buttons, batt., LEDs, RGB-display, PMOD]----[PMOD extensions]
[=====]    [====================================================]    [===============]

the bootloader animates the three white LEDs index, middle and pinky. if the bootloader detects a host PC (if it gets USB enumerated) it stays in the bootloader and creates a cdc_acm /dev/ttyACM0 that can be used in conjunction with tinyprog to flash user bitstreams into slot1, slot2 or slot3, or any other flash content.

if no host PC is detected the bootloader "jumps" to the user bitstream in slot1.

stay in bootloader although there's no host PC:

  • press btn_down while powerup/reset.

jump to slot1 user bitstrem although we're connected to a host PC:

  • press btn_ok while powerup/reset.

jump to slot2 user bitstrem although we're connected to a host PC:

  • press btn_left while powerup/reset.

jump to slot3 user bitstrem although we're connected to a host PC:

  • press btn_right while powerup/reset.

examples

hackerstacker_demo

by default the first user bitstream in slot1 is hackerstacker_demo, that has various modes, which can be advanced by a long btn_ok press.

modes:

  • hackerstacker game, control: btn_ok
  • scroll user text. control: switch text: btn_ok, brightness: btn_up, btn_down, scroll-mode: btn_left, font: btn-right
  • skating images. control: btn_ok
  • various static patterns, rainbow, trans flag, checker board. control: btn_ok
  • various animated patterns, rainbow, trans flag. control: btn_ok

the texts, fonts and images live in the SPI flash aside from the bitstream, so they can be replaced or extended without re-synthesizing the bitstream. see the hackerstacker_demo directory and there the make targets

text
make flash-nick # see nick.txt first!
make flash-font
make flash-image # see image.txt first!
julia

reach it by pressing btn_left while powerup/reset.

by default the second user bitstream in slot2 is julia. it renders a julia set, and loops:

  • pan to a random position
  • zoom in until the entropy is too low
  • zoom out again

the up/down/left/right control the complex coordinate C of the julia set being rendered.

the OK button changes the palette.

psram_probe

reach it by pressing btn_right while powerup/reset.

for now the default third user bitstream in slot3 is psram_probe, just a production PSRAM test. lights up one LED in green per pass.

I hope to get some small spade demo, looking at you @TheZoq2.

power

battery

a PS5 controller compatible battery similar to SNYHR37. 2500 mAh, 1S. the little plasic box is a nice feature to protect the pouch cell from stabbing you and vice versa.

USB-C

there's a current limit of 500mA in place. no USB-PD, just 5V.

the data pins are usable and available for creating any USB2 devices. the board has no dedicated USB-HW (aside from ESD protection) but anything can be implemented in the FPGA, just as the bootloader does. related pins:

text
# USB
set_io -nowarn usbp         42    # IOT_51a  - USB D+
set_io -nowarn usbn         38    # IOT_50b  - USB D-
set_io -nowarn usb_det      37    # IOT_36b  - USB_DET, active-high enables 1k5 pull-up on D+
battery protection

we turn the screen off at around 3V battery voltage to notify the user that she needs a power up. there's also a red charge me LED that indicates this state. at 2.5V a hard battery protection kicks in, and everything is switched off, until charging via USB-C again.

there's also a overvoltage and overcurrent protection and thermal monitoring in place.

the ring of power

bare_metal wears a little ring at it's pinky, the ring of power. here all various important voltages are accessible:

  • 1 GND
  • 2 VBUS
  • 3 VBAT_MINUS
  • 4 BAT_TEMP_SENSE
  • 5 VBAT
  • 5 3V3
  • 6 VCHG
  • 7 VMAIN

the FPGA

it's a Lattice iCE40 UP5K in a SG48 package

  • fully supported by yosys and nextpnr
  • 5000+ LUTs
  • 8 DSP blocks (MULT16 with ACC32)
  • 1024kBits SPRAM in 4 blocks
  • 120kBits EBR memory in 30 blocks
  • 2 hard I2C blocks
  • 2 hard SPI blocks

pinout

it's all in the examples and printed on the stand, but for completenes here's a PCF:

text
# bare_metal
# iCE40UP5K SG48 (QFN 48)

# this is a complete bare_metal pin definition
# you may use for your designs

# 12 MHz crystal oscillator (dedicated clock pad)
set_io -nowarn clk_12M      35    # IOT_46b_G0

# USB
set_io -nowarn usbp         42    # IOT_51a  - USB D+
set_io -nowarn usbn         38    # IOT_50b  - USB D-
set_io -nowarn usb_det      37    # IOT_36b  - USB_DET, active-high enables 1k5 pull-up on D+

# buttons
set_io -nowarn btn_ok       23    # IOT_37a
set_io -nowarn btn_up       45    # IOB_5b
set_io -nowarn btn_down     11    # IOB_20a
set_io -nowarn btn_left     44    # IOB_3b_G6
set_io -nowarn btn_right    10    # IOB_18a

# LED indicators - three white LEDs, low active
set_io -nowarn led_index    39    # white_index
set_io -nowarn led_middle   40    # white_middle

stand

the stand can serve multiple purposes

it conveniently lists all PMOD and all other pins.

a black PCB (front) with pin tabled printed on a black PCB (back) with pin tabled printed on

use it to display the bare_metal board, by sliding the two slots into each other.

a black PCB standing on a table

or when hanging the bare_metal around your neck (or elsewhere) you can hang the stand into the bottom holes, the stand then mimicks a sleeve.

a black hand shaped PCB with a 2nd sleeve shaped PCB

what's included?

the contents in the bare_metal kit
  • bare_metal main board
  • rugged lace, detachable
  • two soft plastic rings to hang bare_metal and its stand together
  • the bare_metal stand PCB
  • the 1S LiPo battery
  • double sided adhesive tape to mount the battery on the bare_metal main board

where to get?

bare_metal is available through my little lectronz shop.

license

Copyright (c) 2026 m. wenzel, wenzellabs

Unless otherwise stated, the hardware designs, firmware source code, and documentation in this repository are licensed under:

Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

https://creativecommons.org/licenses/by-nc-sa/4.0/

Commercial use, including commercial manufacture, sale, or distribution of products based on these materials, is not permitted without separate permission from the copyright holder.

see LICENSE.txt

Parts

261
QtyValueFootprintReferences
128APA102-2020wenzellabs:SK9822-EC20D3001, D3002, D3003, D3004, D3005, D3006, D3007, D3008, D3009, D3010, D3011, D3012, D3013, D3014, D3015, D3016 +112
35100nCapacitor_SMD:C_0402_1005MetricC1002, C1004, C1006, C1008, C1009, C1011, C1013, C1101, C1102, C2004, C3001, C3002, C3003, C3004, C3005, C3006 +19
1810uCapacitor_SMD:C_0603_1608MetricC1001, C1003, C1005, C1007, C1010, C1012, C2001, C2002, C2003, C2005, C2008, C2010, C2011, C3025, C3026, C3027 +2
1210kResistor_SMD:R_0402_1005MetricR4, R6, R7, R1001, R1005, R1007, R1008, R1009, R1010, R1101, R1102, R1103
6BTNButton_Switch_SMD:SW_Push_1P1T_XKB_TS-1187ASW1001, SW1002, SW1003, SW1004, SW1005, SW1006
4100kResistor_SMD:R_0402_1005MetricR2, R2006, R2007, R2008
4470Resistor_SMD:R_0402_1005MetricR1, R8, R1012, R2002
4MountingHoleMountingHole:MountingHole_2mmH1, H2, H3, H4
333Resistor_SMD:R_0402_1005MetricR1002, R1003, R1004
35k1Resistor_SMD:R_0402_1005MetricR3, R4001, R4002
3greenLED_SMD:LED_0805_2012MetricD1, D1004, D2001
21uCapacitor_SMD:C_0402_1005MetricC2006, C2007
23k3Resistor_SMD:R_0402_1005MetricR5, R2009
1100Resistor_SMD:R_0402_1005MetricR1006
110nCapacitor_SMD:C_0402_1005MetricC4002
112MHzCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmX1001
11MResistor_SMD:R_2512_6332MetricR4004
11kResistor_SMD:R_0402_1005MetricR2001
11k2Resistor_SMD:R_0402_1005MetricR2003
11k5Resistor_SMD:R_0402_1005MetricR4003
11k8Resistor_SMD:R_0402_1005MetricR2004
11u5Inductor_SMD:L_1008_2520MetricL2001
13.0V, ODPackage_TO_SOT_SMD:SOT-23-3U1
1470nCapacitor_SMD:C_0402_1005MetricC2009
1470uCapacitor_SMD:CP_Elec_6.3x7.7C3029
1BD83070GWLwenzellabs:UCSP50L1CU2004
1BQ24074RGTPackage_DFN_QFN:VQFN-16-1EP_3x3mm_P0.5mm_EP1.6x1.6mmU2002
1Conn_01x04_Pinwenzellabs:SMD_pads_01x04J1
1Conn_01x08_SocketConnector_PinSocket_2.54mm:PinSocket_1x08_P2.54mm_VerticalJ1101
1Conn_02x06_Top_Bottomwenzellabs:PMOD_PinSocket_2x06_P2.54mm_HorizontalJ5001
1D_SmallDiode_SMD:D_SOD-123D2
1ICE40UP5K-SG48ITRPackage_DFN_QFN:QFN-48-1EP_7x7mm_P0.5mm_EP5.6x5.6mmU1001
1IP4234CZ6Package_TO_SOT_SMD:SC-74-6_1.55x2.9mm_P0.95mmU4001
1LOGOLOGOG***
1LY68L6400Package_SO:SOIC-8_3.9x4.9mm_P1.27mmU1101
1Logo wenzellabswenzellabs:wenzellabs_logo_v1_13x6L101
1MIC5268-1.2Package_TO_SOT_SMD:SOT-23-5U2003
1SY6280AAACPackage_TO_SOT_SMD:SOT-23-5U2005
1USB_C_Receptacle_USB2.0_16Pwenzellabs:USB_C_Receptacle_GCT_USB4800-03-A_16P_TopMnt_HorizontalJ4001
1W25Q128JVSIQPackage_SO:SOIC-8_5.3x5.3mm_P1.27mmU1102
1XB8089DPackage_SO:SOIC-8-1EP_3.9x4.9mm_P1.27mm_EP2.62x3.51mm_ThermalViasU2001
1batterywenzellabs:JST_ZH_S3B-ZR-SM4A-TF_1x03-1MP_P1.50mm_HorizontalJ2001
1powerwenzellabs:diptronics_switch_SS3-CMSW2001
1redLED_SMD:LED_0805_2012MetricD3
1white middleLED_SMD:LED_0805_2012MetricD1002
1white_indexLED_SMD:LED_0805_2012MetricD1003
1white_pinkyLED_SMD:LED_0805_2012MetricD1001

The 258 most common of 261 parts.

Similar boards

  • 2 layers175 × 86 mmPreAmpBoard, the printed circuit board in 3D

    PreAmpBoard

    terjeio/MultimediaCenter

    Multimedia center with DAB/FM radio

    177 parts2
  • 6 layers17.8 × 33.2 mmGuilty devboard idk, the printed circuit board in 3D

    Guilty devboard idk

    askiiart/guilty-devboard-xrd

    A Xiao clone with a ton of GPIO, a focus on extremely low power draw, and which is relatively easy to assemble

    61 parts3
  • 2 layersSelfWatteringFlowerpot, the printed circuit board in 3D

    SelfWatteringFlowerpot

    stefano-papadopolo/Selfwatering-Flower-Pots

    18650 battery powered self watering flower pots with low battery alarm, low water level alarm, solar charging, moisture sensors and water pumps. Controlled by ATTiny828

    30 parts
  • 2 layers59.7 × 73 mmPico LoRa, the printed circuit board in 3D

    Pico LoRa

    ElektorLabs/210047-LoRa-with-the-Raspberry-Pi-Pico

    Raspberry Pi Pico with a RFM95 and DS18B20

    42 parts8
  • 6 layers130 × 57 mmMiniamp, the printed circuit board in 3D

    Miniamp

    wafaffles/Miniamp

    A pocketable DAC/amp based on the PCM2706CPJTR IC. It will be a low power DAC/amp with multiple buttons to be able to easily control media without opening the device.

    96 parts
  • 2 layers69.9 × 78.7 mmShadow, the printed circuit board in 3D

    Shadow

    ym-ci/shadow-pcb

    PCB files for shadow

    100 parts
  • 2 layers20 × 37.4 mmLiPo Charger, the printed circuit board in 3D

    LiPo Charger

    yousef-yasser-T/Smart-cycling-farming-system

    A complete modular LiPo battery management solution, designed in KiCad by Eng. Mohamed Yousry. This project combines a charger, protection circuit, and active balancer for safe and efficient LiPo battery management…

    46 parts

Questions

How big is the Bare metal PCB?

It measures 74.3 × 115.1 mm and has 4 copper layers, 1.7 mm thick.

What parts does the Bare metal use?

261 parts, built around the ICE40UP5K-SG48ITR50, BD83070GWL-E2, W25Q128JVSIQ and BQ24074RGTR. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Bare metal KiCad files?

From the wenzellabs/bare_metal repository on GitHub, at the commit this page was made from: the board is hardware/bare_metal.kicad_pcb and its schematic hardware/bare_metal.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Bare metal design in my own project?

Its repository states no licence, so its author keeps all rights: ask wenzellabs before reusing the design.