Supported GPIO and Baud Rate - sblantipodi/firefly_luciferin GitHub Wiki

Luciferin GPIOs can be configured as you prefer; the default configuration is shown below.

ESP32-S3

  • LED GPIO16 (Default) – Hardware accelerated GPIO using DMA
  • Relay GPIO13 (Default)
  • Button GPIO0 (Default)
  • LDR GPIO2 (Default)

ESP32-S2

  • LED GPIO16 (Default) – Hardware accelerated GPIO using DMA
  • Relay GPIO9 (Default)
  • Button GPIO0 (Default)
  • LDR GPIO3 (Default)

ESP32-C6

  • LED GPIO5 (Default) – Hardware accelerated GPIO using DMA
  • Relay GPIO15 (Default)
  • Button GPIO1 (Default)
  • LDR GPIO2 (Default)

ESP32-C3

  • LED GPIO6 (Default) – Hardware accelerated GPIO using DMA
  • Relay GPIO0 (Default)
  • Button GPIO9 (Default)
  • LDR GPIO3 (Default)

ESP32

  • LED GPIO2 (Default) – Hardware accelerated GPIO using DMA
  • Relay GPIO12 (Default)
  • Button GPIO0 (Default)
  • LDR GPIO36 (Default)

ESP8266

  • LED GPIO2 (Default) – Hardware accelerated GPIO using UART (recommended for using both Wireless Stream and USB)
  • LED GPIO3 – Hardware accelerated GPIO using DMA (fastest for Wireless Stream, USB will not work)
  • LED GPIO5 – Standard GPIO, no hardware acceleration (prefer GPIO2 or GPIO3)
  • Relay GPIO12 (Default)
  • Button GPIO0 (Default)
  • LDR GPIO17 (Default)

Using the Luciferin Module for the Official PCB?
Check Supported GPIO on Modules.

Tip: GPIOs can be changed on the fly on both Full and Light firmware from the Firefly Luciferin settings.
Curious about achievable framerate? See Very Fast Capture.

How to change the GPIO in use

  1. Open the Devices tab in Firefly Luciferin.
  2. Double-click the GPIO you want to change.
  3. Press Enter.

⚠️ It may take a moment for the UI to register the change.
Once changed, restart the capture for it to take effect.

You can also invert the relay GPIO for devices that require it, e.g., Gledopto.

GPIOs can also be changed via the Web Interface if you are using the FULL firmware.

Baud rate

  • If experiencing flickering and your hardware is correctly connected, try lowering the baud rate.
  • To increase maximum framerate, increase the baud rate.

Recommended maximums:

  • ESP8266 with CH340: up to 1,000,000 baud
  • ESP8266 with CP2102: up to 921,600 baud

⚠️ If you increase the baud rate above what your microcontroller supports, you cannot change it again until you manually reflash the firmware.

Default baud rates:

  • Light Firmware: 500K
  • Full Firmware: 115200