Skip to content

Commit 9d689a5

Browse files
Copilotrdar-lab
andauthored
Register Octo Fire Guard plugin (#1)
* Initial plan * Add Octo Fire Guard plugin registration Co-authored-by: rdar-lab <36108848+rdar-lab@users.noreply.github.com> * Update author for Octo Fire Guard plugin * Enhance documentation for Octo Fire Guard plugin Added images and clarified test button functionalities in the Octo Fire Guard plugin documentation. --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: rdar-lab <36108848+rdar-lab@users.noreply.github.com>
1 parent ff9cb9b commit 9d689a5

3 files changed

Lines changed: 124 additions & 0 deletions

File tree

_plugins/octo_fire_guard.md

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
---
2+
layout: plugin
3+
4+
id: octo_fire_guard
5+
title: Octo Fire Guard
6+
description: Temperature monitoring plugin that prevents fire hazards by monitoring hotend and heatbed temperatures in real-time
7+
author: rdar-lab
8+
license: MIT
9+
10+
date: 2026-01-02
11+
12+
homepage: https://github.com/rdar-lab/octo-fire-guard
13+
source: https://github.com/rdar-lab/octo-fire-guard
14+
archive: https://github.com/rdar-lab/octo-fire-guard/archive/main.zip
15+
16+
tags:
17+
- safety
18+
- temperature
19+
- monitoring
20+
- fire
21+
- emergency
22+
- thermal
23+
- protection
24+
25+
screenshots:
26+
- url: /assets/img/plugins/octo_fire_guard/settings-panel.png
27+
alt: Octo Fire Guard Settings Panel
28+
caption: Settings panel with temperature thresholds and termination mode configuration
29+
- url: /assets/img/plugins/octo_fire_guard/alert-modal.png
30+
alt: Temperature Alert Modal
31+
caption: Alert modal displayed when temperature threshold is exceeded
32+
33+
featuredimage: /assets/img/plugins/octo_fire_guard/alert-modal.png
34+
35+
compatibility:
36+
python: ">=3.8,<4"
37+
38+
---
39+
40+
An OctoPrint plugin that monitors printer temperatures in real-time to prevent fire hazards. The plugin watches both hotend and heatbed temperatures and triggers emergency shutdown procedures when configurable thresholds are exceeded.
41+
42+
## Motivation
43+
44+
Designed to address scenarios where hardware failures (such as a MOSFET failing in closed-circuit mode) can cause uncontrolled temperature increases that firmware alone cannot stop. By integrating with OctoPrint's temperature monitoring system and optional PSU control, this plugin provides an additional safety layer to prevent potential fire hazards.
45+
46+
## Features
47+
48+
- **Real-time Temperature Monitoring**: Continuously monitors hotend and heatbed temperatures via OctoPrint's temperature data stream
49+
- **Self-Test Monitoring**: Automatically detects if temperature data stops arriving and issues warnings to ensure the plugin is actively monitoring
50+
- **Dual Threshold Configuration**: Separate configurable thresholds for hotend (default: 250°C) and heatbed (default: 100°C)
51+
- **Immediate Alert System**: Displays a prominent alert popup in the OctoPrint interface when thresholds are exceeded
52+
- **Flexible Emergency Response**: Choose between two termination modes:
53+
- **GCode Commands**: Execute custom GCode commands (default: M112 emergency stop + heater shutdown)
54+
- **PSU Control Integration**: Turn off power entirely via PSU Control plugin
55+
- **User-Friendly Interface**: Easy-to-use settings panel with test functionality to verify proper operation
56+
- **Audio Alerts**: Plays an alert sound when temperature threshold is exceeded
57+
58+
## Configuration
59+
60+
After installation, configure the plugin in OctoPrint Settings → Plugins → Octo Fire Guard:
61+
62+
![settings screenshot](/assets/img/plugins/octo_fire_guard/settings-panel.png)
63+
64+
### Temperature Thresholds
65+
66+
- **Hotend Threshold**: Maximum safe temperature for the hotend in °C (default: 250°C)
67+
- **Heatbed Threshold**: Maximum safe temperature for the heatbed in °C (default: 100°C)
68+
69+
### Self-Test Monitoring
70+
71+
- **Enable Self-Test Monitoring**: When enabled, the plugin monitors itself to ensure it's receiving temperature data from the printer
72+
- **Temperature Data Timeout**: Time in seconds before issuing a warning if no temperature data is received (default: 300 seconds / 5 minutes)
73+
74+
If the printer is connected but the plugin doesn't receive temperature data for the configured timeout period, it will issue a warning notification. This helps ensure the plugin is functioning correctly and actively monitoring your printer.
75+
76+
### Termination Mode
77+
78+
Choose how the plugin responds when a threshold is exceeded:
79+
80+
#### GCode Commands Mode
81+
82+
Execute custom GCode commands to handle the emergency. Default commands:
83+
84+
```gcode
85+
M112 # Emergency stop
86+
M104 S0 # Turn off hotend
87+
M140 S0 # Turn off heatbed
88+
```
89+
90+
You can customize these commands to suit your printer's requirements.
91+
92+
#### PSU Control Mode
93+
94+
Integrates with the [PSU Control plugin](https://plugins.octoprint.org/plugins/psucontrol/) to turn off power completely. This mode:
95+
1. Turns off heaters using GCode
96+
2. Signals the PSU Control plugin to cut power
97+
98+
**Note**: Requires the PSU Control plugin to be installed and configured.
99+
100+
## Testing
101+
102+
The plugin provides two test buttons in the settings panel to verify functionality:
103+
104+
- **Test Alert System**: Tests the alert popup display without triggering emergency actions. This verifies that the visual alert, audio notification, and user interface components work correctly.
105+
106+
![alert screenshot](/assets/img/plugins/octo_fire_guard/alert-modal.png)
107+
108+
- **Test Emergency Actions**: Tests the actual emergency response by executing your configured termination commands (GCode or PSU control). Use this to verify that your emergency shutdown procedure works correctly before an actual emergency occurs.
109+
110+
**Important**: The "Test Emergency Actions" button will execute the real emergency shutdown commands configured in your termination settings. Make sure your printer is in a safe state before testing.
111+
112+
## Safety Considerations
113+
114+
- **This plugin is a safety feature, not a replacement for proper printer supervision**
115+
- Set thresholds appropriate for your printer and materials
116+
- Regularly test the plugin to ensure it's functioning correctly
117+
- Ensure your printer's firmware has proper thermal runaway protection
118+
- For PSU Control mode, verify your PSU Control setup works correctly before relying on it
119+
120+
## Requirements
121+
122+
- OctoPrint 1.4.0 or higher
123+
- Python 3.8 or higher
124+
- For PSU Control mode: PSU Control plugin installed and configured
38.2 KB
Loading
83.4 KB
Loading

0 commit comments

Comments
 (0)