Ready to print PCB - sblantipodi/firefly_luciferin GitHub Wiki

(click the image to zoom)

If you don't want to design your own PCB and you have a soldering iron, you might find Luciferin's official PCB interesting.

---

1. Download the 👉 GERBER file for the Luciferin Official PCB

2. Upload the GERBER file to your favorite PCB manufacturer.
   If you want to use JLCPCB, follow 👉 this guide.

3. Order all the required components.

• D1 Mini–format board with a ESP32 or ESP8266 chip, for example.

  • Lolin ESP32-S3 Mini
  • Lolin ESP32-C3 Mini
  • Lolin ESP32-S2 Mini
  • Lolin ESP8266

  Note:
  For new purchases, preference should be given to newer chips such as the ESP32-S3 or ESP32-C6/C5 families.

• 74AHCT125N (logic level converter 3.3V → 5V) ⚠️ Align the notch correctly before soldering
• 1500 µF 16V capacitor
• 100 nF capacitor
• 3 × 330 Ω resistors (R1, R2, R3)
• WS2812B 5V LED strip
• Fuse holder (Keystone Electronics 3557-2)
• Full-size ATO fuses
  • WS2812B consumption: up to 0.060 A per LED
  • Example: 100 LEDs → ~6 A, Recommended fuse: 7.5 A
• Header pins (2.54 mm)
• Jumpers (2.54 mm)
• 5 × 2-pin terminal blocks (5.08 mm)

• LDR GL5516 (R5)
• 10 kΩ resistor (R4)
  👉 Auto brightness documentation

4. Solder all components following the PCB silkscreen.
5. Enjoy 🎉

---

---

• Connect the power supply to the first terminal block (+ IN −)
• Connect the LED strip power to the second and third terminal blocks (+ OUT −)
• Connect the data pin of the LED strip to the fourth or fifth terminal block
  • Using the ALL position allows GPIO switching via jumper
• Configure GPIOs: 👉 documentation here
• Optional relay support: 👉 documentation here

⚠️ Do NOT place a jumper on USB pins if using a USB cable. Add the jumper only when USB is not used.

---

• Tested up to:
  • 10 A with 1 oz copper
  • 15 A with 2 oz copper
• Copper thickness selectable during PCB manufacturing
• Thermal testing (free air):
  • Temperature rise: +15 °C over ambient at max load

---

Luciferin PCBs are designed to be future-proof and fully upgradable.

If your original build uses an ESP8266, you can later upgrade to:

• ESP32
• ESP32-C3
• ESP32-S2
• ESP32-S3
• Other compatible boards in D1 Mini format

✔️ No PCB redesign required
✔️ Just replace the microcontroller

---

The Luciferin Official PCB requires a "D1 Mini format" board. With the new Luciferin Module for the Official PCB, you can use a smaller board, opening up more upgrade possibilities without the need to replace the PCB or redo any soldering or cabling.

Download the 👉 GERBER file for the Luciferin Module for the Official PCB

If you prefer a board that is:

• smaller than D1 Mini
• based on a newer chipset (for example, a more powerful MCU capable of driving more LEDs, with improved connectivity, etc.)
• cheaper
• or simply different

You can use the Luciferin Module for the Official PCB.

The module supports boards with pin spacing of 6 × 2.54 mm (15.24 mm), including:

• WaveShare Zero family
• Seeed Studio XIAO family
• ESP32 Super Mini family
• Unexpected Maker Tiny family
• Adafruit QT Py family
• Other compatible layouts

Important:
Power pins (VCC and GND) must be located within the first three pins on either the left or right side.

---

Luciferin supports both software and hardware configuration.

Using Glow Worm Luciferin firmware, GPIOs can be remapped to match your board layout.

✔️ No PCB changes required

Power lines (5V, 3V3, GND) cannot be remapped in software.

Instead, the Luciferin Module allows hardware configuration using solder bridges.

Board layout:

• 5V → first pin (right)
• GND → second pin (right)
• 3V3 → first pin (left)

Solder bridges:

• L1 – 5V
• L2 – GND
• R1 – 3V3

This adapts the module power routing to your board.

The LDR hole (top-right of the PCB) is a flexible connection point for the LDR sensor's ADC pin.

If you solder the solder joint → the LDR sensor is automatically connected to the default ADC pin (the one printed on the silkscreen). No extra wiring needed. If you leave the solder joint open → the default connection is broken, and you can run a wire from any ADC pin you prefer to that LDR hole. This lets you choose a different ADC pin than the default one.

---

Download the 👉 GERBER file for the Luciferin Ethernet Module for the Official PCB

The Luciferin Ethernet Module adds Ethernet support to the official PCB.

• Luciferin Ethernet Module
• ESP32 (or newer, ESP32-S3 is one of the best option for the ethernet module)
• W5500 Lite Ethernet board

Enable Ethernet from the Luciferin web interface or from the Network tab and configure:

• MISO
• MOSI
• SCLK
• CS

Luciferin supports all SPI Ethernet devices, including custom ones. GPIOs can be configured for SPI Ethernet.

---

• Supports Wi-Fi and USB installations
• Compatible with ESP8266 and Tiny Pico ESP32 upgrades

• Desktop version (no mounting flaps)
• Regular version (with mounting flaps)

• Material: PLA
• Infill: 20%
• Layer height: 0.2 mm
• Supports: Yes

Luciferin Case is Designed by
@pbl0m (Patrick Blom)

Downloads:

• Thingiverse: https://www.thingiverse.com/thing:5220580
• Thangs: https://thangs.com/pbl0m/Luciferin%2520Case-51051

---

Join the community on Discord:

This PCB and kit are provided for educational and hobby use only.
They are not certified for commercial or safety-critical applications.

By manufacturing this PCB, you acknowledge that:

• Assembly and usage are your responsibility
• The author is not liable for damages
• The product is not CE/FCC/EMC/RoHS certified
• Proper tools and precautions must be used