Skip to the content
2 layers17.8 × 35.6 mmOctoPrint ShutdownButtonLEDBuzzer, the printed circuit board in 3D

OctoPrint ShutdownButtonLEDBuzzer

danieleborgo/OctoPrint-ShutdownButtonLEDBuzzer6

This OctoPrint plugin implements a shutdown physical button for the Rasperry Pi, with a buzzer and a status LED.

Size
17.8 × 35.6 mm
Copper layers
2
Thickness
1.6 mm
Parts
6
Nets
7
Pads
17
Tracks, vias
9, 0
Pours
1
Routed
Yes
KiCad
KiCad 6 (file 20211014)
Created
8 Dec 2021
Updated
10 Apr 2026

Overview

OctoPrint ShutdownButtonLEDBuzzer is an open-source printed circuit board by danieleborgo, from the danieleborgo/OctoPrint-ShutdownButtonLEDBuzzer repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 17.8 × 35.6 mm with 6 parts on 7 nets, routed with 9 tracks and 0 vias.

Its parts include 2 connectors, 1 resistor, 1 diode and 1 switch.

README

README.md

ShutdownButtonLEDBuzzer

This OctoPrint plugin implements a shutdown physical button for the Raspberry Pi. It offers also a status LED to know when OctoPrint is ready and a buzzer to signal the startup and the shutdown. Remember that these signals may vary of few seconds.

By default, this plugin shuts down the Raspberry without checking of there are ongoing jobs. In settings, there is a flag to disable the button when printing.

Compatibility

The plugin automatically selects the correct GPIO driver based on the OS version:

  • periphery — for Raspberry Pi OS Bookworm (2023) and newer, including Raspberry Pi 5. Uses the modern character device interface (/dev/gpiochip0, or /dev/gpiochip4 on Raspberry Pi 5).
  • gpiozero — for Raspberry Pi OS Bullseye (2021) and older. Requires the legacy sysfs interface.

Auto-detection is the default and works in most cases. If needed, the driver can be overridden in the Advanced Settings section.

python-periphery is a required dependency. gpiozero is optional and only needed on older systems:

text
pip install "OctoPrint-ShutdownButtonLEDBuzzer[gpiozero]"

Notes

To shut down the Raspberry, it uses the command configured in OctoPrint settings.

This plugin supports both active and passive buzzers. By default, it assumes to have an active one.

The internal pull-up resistor for the button is applied automatically on kernels ≥ 5.10. On older kernels an external pull-up resistor on the button pin is required.

Setup

Install via the bundled Plugin Manager or manually using this URL:

text
https://github.com/danieleborgo/OctoPrint-ShutdownButtonLEDBuzzer/archive/master.zip

Circuit

The circuit hereafter exposed is just the one set by default, since the plugin allows to edit each of these pin:

  • Button: by default directly on pin GPIO26
  • LED: by default on pin GPIO6
  • Buzzer: by default on pin GPIO13

In case one of these features is not needed, it can be deactivated by the apposite settings section.

Always remember to properly check each connection, using the official datasheet, before turning on the Raspberry.

circuit

Configuration

This plugin offers several configuration parameters, accessible in the apposite OctoPrint section in setting:

settings1 settings2 settings3

PCB

There are KiCad PCB files available in case you want to make your own PCB. A bill of materials (BOM) can be found in the according folder.

pcb1 pcb2

FAQ

What resistor does it need to use?

There is no a precise resistor needed, since it depends on how much light is needed. Despite this, it is suggested to use a value at least of few thousands of ohms. Always remember to check the connections and the datasheet.

Which buzzer does it need?

The plugin supports both active that passive buzzer, but it is necessary to configure them by the settings panel.

Which LED does it need?

A 5 mm LED is a good option, and it is usually in Arduino kits. In case a different one is attached, check that the current it needs is lower than the one a Raspberry pin can give.

License

This software is distributed on GPLv3.0, more information available in LICENSE.md.

Parts

6
QtyValueFootprintReferences
110Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1
1BuzzerBuzzer_Beeper:Buzzer_12x9.5RM7.6BZ1
1Conn_01x05_MaleConnector_PinHeader_2.54mm:PinHeader_1x05_P2.54mm_VerticalJ2
1JumperConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ1
1LEDLED_THT:LED_D5.0mmD1
1SWButton_Switch_THT:SW_Tactile_Straight_KSA0Axx1LFTRSW1

Similar boards

  • 2 layers18.5 × 11.1 mmSwitch, the printed circuit board in 3D

    Switch

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    6 parts4.3kMIT
  • 2 layers14.6 × 33 mmBrain board SD Card 1, the printed circuit board in 3D

    Brain board SD Card 1

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    6 parts1.2k
  • 2 layers9 × 9 mmDpoint, the printed circuit board in 3D

    Dpoint

    Jcparkyn/dpoint

    Open-source digital stylus using camera tracking and inertial measurements

    6 parts1.1kMIT
  • 2 layers51.5 × 16.6 mmMicroswitchXY Endstop, the printed circuit board in 3D

    MicroswitchXY Endstop

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    6 parts1.1kGPL-3.0
  • 2 layers21.9 × 76.7 mmAmiga External, the printed circuit board in 3D

    Amiga External

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    6 parts1kGPL-3.0
  • 2 layers88.9 × 50.8 mmBusinesscard, the printed circuit board in 3D

    Businesscard

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    6 parts915
  • 2 layers20.3 × 15.2 mmL0 RGB led, the printed circuit board in 3D

    L0 RGB led

    Luos-io/luos_engine

    Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.

    6 parts546MIT
  • 2 layers9 × 3.6 mmOpticalEncoder, the printed circuit board in 3D

    OpticalEncoder

    adamb314/ServoProject

    Getting the most out of your hobby servo

    6 parts545

Questions

How big is the OctoPrint ShutdownButtonLEDBuzzer PCB?

It measures 17.8 × 35.6 mm and has 2 copper layers, 1.6 mm thick.

What parts does the OctoPrint ShutdownButtonLEDBuzzer use?

6 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 OctoPrint ShutdownButtonLEDBuzzer KiCad files?

From the danieleborgo/OctoPrint-ShutdownButtonLEDBuzzer repository on GitHub, at the commit this page was made from: the board is pcb/Octoprint_ShutdownButtonLEDBuzzer.kicad_pcb and its schematic pcb/Octoprint_ShutdownButtonLEDBuzzer.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the OctoPrint ShutdownButtonLEDBuzzer design in my own project?

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