Skip to the content
2 layers203.2 × 254 mmProduction red line new silk, the printed circuit board in 3D

Production red line new silk

tomunderwood99/CharlieBoard43

An open-source PCB map showing Boston's subway system

Size
203.2 × 254 mm
Copper layers
2
Thickness
1.6 mm
Parts
48
Nets
50
Pads
191
Tracks, vias
246, 47
Pours
2
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
29 Jan 2026
Updated
6 Aug 2026

Overview

Production red line new silk is an open-source printed circuit board by tomunderwood99, from the tomunderwood99/CharlieBoard repository on GitHub, published under the MIT licence. It is a 2-layer board of 203.2 × 254 mm with 48 parts on 50 nets, routed with 246 tracks and 47 vias.

Its parts include 47 ICs and 1 connector. It belongs with the lEDs and displays boards of this library.

README

README.md

The CharlieBoard

Software: MIT Hardware: CERN-OHL-S Python Version Hardware: Raspberry Pi Contributions Welcome

An open-source LED display system for the MBTA that runs on Raspberry Pi Zero 2W with WS2812B LEDs. Features real-time transit data visualization, web control interface, and geographically accurate station mapping. PCBs for the Red, Orange, and Blue line are live! Green line in progress :)

CharlieBoard Display

Quick Start

Prerequisites:

  • Raspberry Pi Zero 2W with Debian Trixie 64-bit Lite
  • WS2812B LED strip or custom PCB
  • WiFi (configured during pi setup)
  • SSH enabled (RPI Connect recommended)
  • MBTA API key

For hardware assembly instructions, see the Hardware Assembly Guide.

Run the following commands to install and initialize the display.

bash
sudo apt update && sudo apt install -y git python3-pip

cd ~
git clone --filter=blob:none --sparse https://github.com/tomunderwood99/CharlieBoard.git

cd CharlieBoard
git sparse-checkout set --no-cone '/*' '!hardware'

chmod +x deployment/quick_start/setup_mbta_controller.sh

# Optional: use flags to set custom recovery wifi settings:
# --with-wifi-helper
# --ap-ssid "CustomWifiName"
# --ap-password "YourStrongPassword"

sudo ./deployment/quick_start/setup_mbta_controller.sh

The setup script will prompt for your MBTA API key and various setting inputs. After completion, access the web interface at http://your-hostname.local:8000 on your local network. Settings can be changed from the web interface or from the command line using the charlieboard command. See the CLI reference for details.

Optional enhancement: Set up a reverse proxy to access the web interface at http://hostname.local without the port number. See the nginx reverse proxy setup guide.

Note: The sparse-checkout excludes the hardware/ directory (PCB design files) to speed up cloning. This setting persists across future git pull operations. If you need the hardware files, run: git sparse-checkout disable

Features

  • Real-time Transit Data: Live vehicle positions, occupancy, and speed data
  • Geographically Accurate: Stations are marked on a real map
  • Web Control Interface: Remote control from any device on your network
  • Customizable Display: Adjustable brightness, colors, and display hours
  • Reliable Operation: Automatic recovery, health monitoring, and maintenance

Hardware

ComponentNotes
Raspberry Pi Zero 2WMain controller
WS2812B LEDsCustom PCB (~$120 for 5) or LED strips (~$20)
5V 4A Power SupplyPowers Pi and LEDs
MicroSD Card (16GB+)For OS and software
Display EnclosurePicture frame or custom case

Total Cost: $50–180 depending on LED choice

Complete PCB design files (Gerber + KiCad) are available in hardware/PCB Production/. See the Bill of Materials for detailed pricing and sourcing.

Documentation

GuideDescription
Quick Start GuideStep-by-step setup walkthrough
Terminal CLIChange settings from SSH without the web UI
Complete Setup GuideDetailed manual configuration
Bill of MaterialsHardware pricing and sourcing
Hardware AssemblyPCB assembly instructions
Operations & TroubleshootingMaintenance and problem solving
Transit System AdaptationAdapt for other transit systems
Map Making with QGISCreate custom transit maps (example project)

Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Test on Raspberry Pi Zero 2W hardware
  4. Commit your changes (git commit -m 'Add amazing feature')
  5. Push and open a Pull Request

Follow existing code style, update documentation for new features, and add comments for complex logic. Contributions to software are under the MIT License; contributions to hardware/ design files are under CERN-OHL-S, as described in License.

License

This repository uses two licenses:

ScopeLicenseFull text
Software (Python, scripts, configs, docs outside hardware/, and everything except the hardware/ tree)MIT LicenseLICENSE
hardware/ (PCB designs, KiCad projects, Gerbers, and related production files in this directory)CERN Open Hardware Licence v2 — Strongly Reciprocal (CERN-OHL-S)LICENSE-CERN-OHL-S

Third-party materials bundled under hardware/ may carry their own licenses (see notices in those subfolders).

Copyright © 2025 Thomas Underwood

Disclaimers & Attributions

AI Assistance

This project was developed with the assistance of AI coding tools. All code has been reviewed, tested, and validated on actual hardware.

Data Sources

This project uses data from:

  • MBTA and MassDOT – Transit data via MBTA V3 API
  • MassGIS – Geographic and mapping data

All data is provided "as is" without warranties. This project is not affiliated with, endorsed by, or sponsored by MBTA, MassDOT, MassGIS, or the Commonwealth of Massachusetts.

Support

Parts

48
QtyValueFootprintReferences
47WS2812-2020WS2812_2020:LED_WS2812-2020U2, U10, U11, U12, U13, U14, U15, U16, U17, U18, U19, U20, U21, U22, U23, U24 +31
1Conn_01x03_MountingPinConnector_JST:JST_EH_B3B-EH-A_1x03_P2.50mm_VerticalJ4

More from tomunderwood99/CharlieBoard

2
  • 2 layers203.2 × 254 mmOrange Line, the printed circuit board in 3D

    Orange Line

    tomunderwood99/CharlieBoard

    An open-source PCB map showing Boston's subway system

    41 parts43MIT
  • 2 layers203.2 × 254 mmBlue Line, the printed circuit board in 3D

    Blue Line

    tomunderwood99/CharlieBoard

    An open-source PCB map showing Boston's subway system

    25 parts43MIT

Similar boards

  • 2 layersDemo, the printed circuit board in 3D

    Demo

    adamws/kicad-kbplacer

    KiCad plugin for automatic keyboard's key placement and routing

    48 parts547GPL-3.0
  • 2 layers18.8 × 18.1 mmAmoeba royale, the printed circuit board in 3D

    Amoeba royale

    mtl/keyboard-pcbs

    Keyboard PCBs

    48 parts485
  • 2 layers48.1 × 115.6 mmAPU ENG CRANK PANEL, the printed circuit board in 3D

    APU ENG CRANK PANEL

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    48 parts431
  • 2 layers106 × 55 mmEndcap, the printed circuit board in 3D

    Endcap

    softerhardware/Hermes-Lite2

    A second generation low-cost amateur HF software defined radio transceiver.

    48 parts384
  • 2 layers42.8 × 88 mm18650 pcb, the printed circuit board in 3D

    18650 pcb

    CRImier/MyKiCad

    My KiCad boards. Can't be bothered uploading individually anymore, so here you go.

    48 parts253GPL-3.0
  • 2 layers34 × 44 mmClk lo buffer, the printed circuit board in 3D

    Clk lo buffer

    loxodes/vna

    Under development open hardware microwave vector network analyzer

    48 parts205
  • 2 layers70.6 × 189.2 mmNano, the printed circuit board in 3D

    Nano

    fellesverkstedet/fabricatable-machines

    Motion systems for flexible digital fabrication and research. Easy to fabricate and customize. Documentation: https://github.com/fellesverkstedet/fabricatable-machines/wiki

    48 parts175

Questions

How big is the Production red line new silk PCB?

It measures 203.2 × 254 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Production red line new silk use?

48 parts. 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 Production red line new silk KiCad files?

From the tomunderwood99/CharlieBoard repository on GitHub, at the commit this page was made from: the board is hardware/PCB Production/KICAD Files/Red Line/production_red_line_new_silk.kicad_pcb and its schematic hardware/PCB Production/KICAD Files/Blue Line/Blue Line.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Production red line new silk design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).