

Bare metal
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
9ICE40UP5K-SG48ITR50
QFN-48QFN-48 Programmable Logic Device (CPLDs/FPGAs) ROHSLatticeProgrammable Logic Device (CPLDs/FPGAs)BD83070GWL-E2
UFBGA-12-40℃~+85℃ 1 1.5MHz 1A 2.5V、3.3V 2.8uA 2V~5.5V Buck-Boost Buck-Boost Built-in Fixed Yes UFBGA-12 DC-DC Converters ROHSROHM SemiconductorDC-DC ConvertersW25Q128JVSIQ
SOIC-8-208mil-40℃~+85℃ 100,000 cycles 120ms@(32KB) 128Mbit 133MHz 1uA 2.7V~3.6V 20 Years 3ms Power-on reset、Hardware write protection、Software write protection、Write enable latch、Absolute write protection SPI SOIC-8-208mil NOR FLASH ROHSWinbondNOR FLASHBQ24074RGTR
QFN-16-EP(3x3)-40℃~+125℃ 1 1.5A 4.2V 4.35V~10.2V 6.5uA Charging IC Lithium Battery Not supported Support QFN-16-EP(3x3) Battery Management ROHSTexas InstrumentsBattery ManagementIP4234CZ6
TSOP-6-40℃~+85℃@(Ta) 100W 100nA 3.1pF 5.5V 6V ESD Four channels IEC 61000-4-2、IEC 61000-4-5 TSOP-6 ESD and Surge Protection (TVS/ESD) ROHSNexperiaESD And Surge Protection (TVS/ESD)MIC5268-1.2BM5
SOT-23-5-40℃~+125℃@(Tj) 1 1.2V 150mA 1uA 6V Fixed Over Current Protection、Thermal Shutdown、Operating status indication Positive SOT-23-5 Voltage Regulators - Linear, Low Drop Out (LDO) RegulatorsMicrochip TechnologyVoltage Regulators - Linear, Low Drop Out (LDO) RegulatorsSY6280AAAC
SOT-23-5-40℃~+125℃ 1 2.4V~5.5V 2A 63mΩ Active High High Side Switch Overcurrent Protection(OCP)、Over Temperature Protection SOT-23-5 Power Distribution Switches ROHSSilergy CorpPower Distribution SwitchesXB8089D
SOIC-8-EP-40℃~+85℃ 1 2.5V 3uA 4.25V Lithium Battery Protection IC Support SOIC-8-EP Battery Management ROHSXySemiBattery ManagementAPA102-2020
SMD-8P,2x2mmSMD-8P,2x2mm New Arrivals ROHSAdafruit IndustriesLight Emitting Diodes (LED)
README
README.mdbare_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.
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
bootloaderbelow - 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:
# 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# 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, videobootloader
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
[-----------][----------][----------]
[ 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
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:
# 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:
# 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_middlestand
the stand can serve multiple purposes
it conveniently lists all PMOD and all other pins.
use it to display the bare_metal board, by sliding the two slots into each other.
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.
what's included?
- 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| Qty | Value | Footprint | References |
|---|---|---|---|
| 128 | APA102-2020 | wenzellabs:SK9822-EC20 | D3001, D3002, D3003, D3004, D3005, D3006, D3007, D3008, D3009, D3010, D3011, D3012, D3013, D3014, D3015, D3016 +112 |
| 35 | 100n | Capacitor_SMD:C_0402_1005Metric | C1002, C1004, C1006, C1008, C1009, C1011, C1013, C1101, C1102, C2004, C3001, C3002, C3003, C3004, C3005, C3006 +19 |
| 18 | 10u | Capacitor_SMD:C_0603_1608Metric | C1001, C1003, C1005, C1007, C1010, C1012, C2001, C2002, C2003, C2005, C2008, C2010, C2011, C3025, C3026, C3027 +2 |
| 12 | 10k | Resistor_SMD:R_0402_1005Metric | R4, R6, R7, R1001, R1005, R1007, R1008, R1009, R1010, R1101, R1102, R1103 |
| 6 | BTN | Button_Switch_SMD:SW_Push_1P1T_XKB_TS-1187A | SW1001, SW1002, SW1003, SW1004, SW1005, SW1006 |
| 4 | 100k | Resistor_SMD:R_0402_1005Metric | R2, R2006, R2007, R2008 |
| 4 | 470 | Resistor_SMD:R_0402_1005Metric | R1, R8, R1012, R2002 |
| 4 | MountingHole | MountingHole:MountingHole_2mm | H1, H2, H3, H4 |
| 3 | 33 | Resistor_SMD:R_0402_1005Metric | R1002, R1003, R1004 |
| 3 | 5k1 | Resistor_SMD:R_0402_1005Metric | R3, R4001, R4002 |
| 3 | green | LED_SMD:LED_0805_2012Metric | D1, D1004, D2001 |
| 2 | 1u | Capacitor_SMD:C_0402_1005Metric | C2006, C2007 |
| 2 | 3k3 | Resistor_SMD:R_0402_1005Metric | R5, R2009 |
| 1 | 100 | Resistor_SMD:R_0402_1005Metric | R1006 |
| 1 | 10n | Capacitor_SMD:C_0402_1005Metric | C4002 |
| 1 | 12MHz | Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm | X1001 |
| 1 | 1M | Resistor_SMD:R_2512_6332Metric | R4004 |
| 1 | 1k | Resistor_SMD:R_0402_1005Metric | R2001 |
| 1 | 1k2 | Resistor_SMD:R_0402_1005Metric | R2003 |
| 1 | 1k5 | Resistor_SMD:R_0402_1005Metric | R4003 |
| 1 | 1k8 | Resistor_SMD:R_0402_1005Metric | R2004 |
| 1 | 1u5 | Inductor_SMD:L_1008_2520Metric | L2001 |
| 1 | 3.0V, OD | Package_TO_SOT_SMD:SOT-23-3 | U1 |
| 1 | 470n | Capacitor_SMD:C_0402_1005Metric | C2009 |
| 1 | 470u | Capacitor_SMD:CP_Elec_6.3x7.7 | C3029 |
| 1 | BD83070GWL | wenzellabs:UCSP50L1C | U2004 |
| 1 | BQ24074RGT | Package_DFN_QFN:VQFN-16-1EP_3x3mm_P0.5mm_EP1.6x1.6mm | U2002 |
| 1 | Conn_01x04_Pin | wenzellabs:SMD_pads_01x04 | J1 |
| 1 | Conn_01x08_Socket | Connector_PinSocket_2.54mm:PinSocket_1x08_P2.54mm_Vertical | J1101 |
| 1 | Conn_02x06_Top_Bottom | wenzellabs:PMOD_PinSocket_2x06_P2.54mm_Horizontal | J5001 |
| 1 | D_Small | Diode_SMD:D_SOD-123 | D2 |
| 1 | ICE40UP5K-SG48ITR | Package_DFN_QFN:QFN-48-1EP_7x7mm_P0.5mm_EP5.6x5.6mm | U1001 |
| 1 | IP4234CZ6 | Package_TO_SOT_SMD:SC-74-6_1.55x2.9mm_P0.95mm | U4001 |
| 1 | LOGO | LOGO | G*** |
| 1 | LY68L6400 | Package_SO:SOIC-8_3.9x4.9mm_P1.27mm | U1101 |
| 1 | Logo wenzellabs | wenzellabs:wenzellabs_logo_v1_13x6 | L101 |
| 1 | MIC5268-1.2 | Package_TO_SOT_SMD:SOT-23-5 | U2003 |
| 1 | SY6280AAAC | Package_TO_SOT_SMD:SOT-23-5 | U2005 |
| 1 | USB_C_Receptacle_USB2.0_16P | wenzellabs:USB_C_Receptacle_GCT_USB4800-03-A_16P_TopMnt_Horizontal | J4001 |
| 1 | W25Q128JVSIQ | Package_SO:SOIC-8_5.3x5.3mm_P1.27mm | U1102 |
| 1 | XB8089D | Package_SO:SOIC-8-1EP_3.9x4.9mm_P1.27mm_EP2.62x3.51mm_ThermalVias | U2001 |
| 1 | battery | wenzellabs:JST_ZH_S3B-ZR-SM4A-TF_1x03-1MP_P1.50mm_Horizontal | J2001 |
| 1 | power | wenzellabs:diptronics_switch_SS3-CM | SW2001 |
| 1 | red | LED_SMD:LED_0805_2012Metric | D3 |
| 1 | white middle | LED_SMD:LED_0805_2012Metric | D1002 |
| 1 | white_index | LED_SMD:LED_0805_2012Metric | D1003 |
| 1 | white_pinky | LED_SMD:LED_0805_2012Metric | D1001 |
The 258 most common of 261 parts.
Similar boards
- 2 layers175 × 86 mm

- 6 layers17.8 × 33.2 mm

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 - 4 layers60 × 80 mm

Portable assetTracker v0.2
ericyuanyong/asset-tracker
a asset tracker demo project based on msom
160 partsMIT - 2 layers

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 mm

Pico LoRa
ElektorLabs/210047-LoRa-with-the-Raspberry-Pi-Pico
Raspberry Pi Pico with a RFM95 and DS18B20
42 parts8 - 6 layers130 × 57 mm

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 mm

- 2 layers20 × 37.4 mm

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.