Skip to content

CDFER/Auckland-LED-Train-Map

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Auckland Live LED Train Map

Hardware, Software and Documentation License: GPL-3.0-or-later PlatformIO Made with KiCad

You can now support my work by buying this through my store: https://keastudios.co.nz/store/akl-ltm/

A physical, real-time LED map of the Auckland train network, powered by an ESP32-C3 microcontroller. Train movements are displayed using addressable RGB LEDs, with live data fetched over Wi-Fi.


Table of Contents


PCB Overview Render

Features

  • Real-time Train Tracking: Displays the approximate locations of trains on the Auckland network.
  • Addressable LEDs: ~150 WS2812B-compatible RGB LEDs (1.6x1.5mm) for a vibrant display.
  • Wi-Fi Connectivity: ESP32-C3's built-in Wi-Fi fetches live train data.
  • Custom PCB: Designed for JLCPCB manufacturing limits.
  • Open Source: Hardware and firmware are open source.

Hardware

  • Microcontroller: ESP32-C3 (RISC-V, 160 MHz, 4 MB Flash, QFN32)
  • LEDs: ~150 x XL-1615RGBC-WS2812B (1.6mm x 1.5mm)
  • PCB: 249mm x 66mm, JLCPCB-friendly
  • Antenna: On-board PCB antenna (TI CC2430DB design)

ESP32-C3 PCB Render

Pukekohe PCB Render


PCB Design

Schematic


Software / Firmware

The ESP32-C3 firmware is responsible for:

  1. Connecting to Wi-Fi
  2. Fetching live train data from the GTFS Realtime Cache API
  3. Processing data to determine train locations
  4. Controlling WS2812B LEDs to display train positions

Getting Started

  1. Flash the Firmware:
    • Use the Web Installer (recommended, no drivers needed)
    • Or flash manually using PlatformIO (Firmware/ directory)
  2. Connect to Wi-Fi:
    • On first boot, use the web interface to configure Wi-Fi credentials.
  3. Power the Board:
    • Use a 5V USB-C power supply capable of at least 1A.
  4. Enjoy the Live Map!

Web Installer

Easily flash the latest firmware to your ESP32-C3 using your browser:

Open the Auckland LED Train Map Web Installer

  • Works with Chrome, Edge, or any Web Serial-compatible browser
  • Follow on-screen instructions to connect and flash your device

Links


Contributing

Contributions are welcome! Open an issue or submit a pull request for improvements, bug fixes, or feature suggestions.


License

This project is released under the GPL-3.0-or-later license.

© 2025 Chris Dirks

About

Curcuit board with RGB leds to show the live position of trains in Auckland

Topics

Resources

License

Stars

Watchers

Forks