# ralim/ironos

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/ralim-ironos).**

8,250 stars · 818 forks · C · GPL-3.0

## Links

- GitHub: https://github.com/Ralim/IronOS
- Homepage: https://ralim.github.io/IronOS/
- awesome-repositories: https://awesome-repositories.com/repository/ralim-ironos.md

## Topics

`alternate` `firmware` `flash` `hex` `iron` `miniware` `pine64` `pinecil` `soldering` `soldering-irons` `temperature` `temperature-control` `ts100` `ts80` `ts80p`

## Description

IronOS is a low-level soldering iron firmware and thermal control system. It serves as a comprehensive embedded UI framework and hardware controller designed to manage heating elements, temperature regulation, and power delivery for soldering tools.

The project distinguishes itself through a specialized USB-PD power controller that negotiates standards like USB-PD EPR and Quick Charge to maximize available wattage. It also features a wireless BLE hardware controller for monitoring real-time telemetry and modifying system parameters from a remote application.

The system covers broad capability areas including PID-based thermal regulation, sensor calibration for cold junction compensation, and state-based power management. It includes a localized display system with support for custom boot graphics, multi-language fonts, and automated sleep modes triggered by motion or magnetic sensors.

Firmware updates can be deployed via USB-C or the Device Firmware Upgrade protocol.

## Tags

### Operating Systems & Systems Programming

- [Heating Element Firmwares](https://awesome-repositories.com/f/operating-systems-systems-programming/heating-element-firmwares.md) — Develops low-level firmware to control heating elements and temperature regulation for soldering tools.
- [Power State Controllers](https://awesome-repositories.com/f/operating-systems-systems-programming/power-management/power-state-controllers.md) — Manages transitions between active, sleep, and shutdown modes using timers and hardware sensors.
- [Interrupt Handling](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/interrupt-handling.md) — Manages hardware signals from buttons and sensors to trigger system state changes and menu navigation.

### System Administration & Monitoring

- [PID Thermal Controllers](https://awesome-repositories.com/f/system-administration-monitoring/thermal-management-systems/pid-thermal-controllers.md) — Uses a PID-based feedback loop to maintain stable thermal setpoints for the heating element.
- [Thermal Compensation](https://awesome-repositories.com/f/system-administration-monitoring/logging-and-telemetry/metric-data-ingestion/temperature-metrics/ambient-temperature-monitoring/thermal-compensation.md) — Calculates temperature offsets at boot to correct sensor readings based on the handle environment.

### Part of an Awesome List

- [User Interface Frameworks](https://awesome-repositories.com/f/awesome-lists/devops/embedded-frameworks/user-interface-frameworks.md) — Implements a localized embedded UI framework with custom boot logos, multi-language fonts, and configuration menus.
- [Sensor Calibration](https://awesome-repositories.com/f/awesome-lists/devtools/sensor-calibration.md) — Corrects voltage measurement variance and compensation offsets to ensure accurate temperature and power readings. ([source](https://ralim.github.io/IronOS/Settings/))

### Hardware & IoT

- [BLE Device Management](https://awesome-repositories.com/f/hardware-iot/ble-device-management.md) — Uses Bluetooth Low Energy profiles to monitor real-time telemetry and modify system parameters wirelessly.
- [Bluetooth Connectivity](https://awesome-repositories.com/f/hardware-iot/bluetooth-connectivity.md) — Manages wireless pairing and data exchange for reading telemetry and modifying hardware settings. ([source](https://ralim.github.io/IronOS/Bluetooth/))
- [Hardware Power Management](https://awesome-repositories.com/f/hardware-iot/hardware-power-management.md) — Implements automatic sleep modes and battery protection thresholds to prevent hardware over-discharge.
- [Telemetry Interfaces](https://awesome-repositories.com/f/hardware-iot/integration-performance/hardware-interfacing-integration/hardware-integration/device-sensors/ble-sensor-monitors/telemetry-interfaces.md) — Exposes live sensor data and system parameters over Bluetooth Low Energy for wireless monitoring.
- [Manual Temperature Adjustment](https://awesome-repositories.com/f/hardware-iot/manual-temperature-adjustment.md) — Enables precise control of the heating element temperature via physical hardware buttons. ([source](https://ralim.github.io/IronOS/Menu/))
- [Temperature Point Regulation](https://awesome-repositories.com/f/hardware-iot/temperature-point-regulation.md) — Regulates the heating element to maintain specific temperature set points or provide wattage boosts. ([source](https://ralim.github.io/IronOS/GettingStarted/))
- [USB Power Delivery Managers](https://awesome-repositories.com/f/hardware-iot/usb-power-delivery-managers.md) — Negotiates USB-PD and Quick Charge protocols to maximize the available input wattage for the device.
- [Battery Discharge Protections](https://awesome-repositories.com/f/hardware-iot/battery-discharge-protections.md) — Sets low voltage thresholds and per-cell minimums to automatically shut down the heater and prevent over-discharge. ([source](https://ralim.github.io/IronOS/Settings/))
- [Firmware Flashing](https://awesome-repositories.com/f/hardware-iot/connectivity-iot/hardware-communication/serial-device-communication/firmware-flashing.md) — Implements binary firmware updates to the microcontroller via USB and DFU protocols.
- [DFU Update Implementations](https://awesome-repositories.com/f/hardware-iot/dfu-update-implementations.md) — Installs binary updates using the Device Firmware Upgrade protocol as an alternative to USB storage. ([source](https://ralim.github.io/IronOS/Flashing/TS100))
- [Analog Sensor Calibration](https://awesome-repositories.com/f/hardware-iot/embedded-robotics/sensor-processing/analog-sensor-calibration.md) — Performs mathematical adjustment of raw sensor inputs to ensure accurate voltage and temperature readings.
- [Firmware OTA Update Systems](https://awesome-repositories.com/f/hardware-iot/firmware-management/remote-firmware-updaters/firmware-ota-update-systems.md) — Provides a system for uploading new firmware images to the microcontroller via USB-C. ([source](https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/))
- [Magnetic Power Triggers](https://awesome-repositories.com/f/hardware-iot/magnetic-power-triggers.md) — Triggers sleep mode automatically when a hall effect sensor detects a magnet in the tool stand. ([source](https://ralim.github.io/IronOS/HallSensor/))
- [Physical Button Locking](https://awesome-repositories.com/f/hardware-iot/physical-button-interfacing/physical-button-locking.md) — Implements software-based locking of physical buttons using specific hold patterns to prevent accidental input. ([source](https://ralim.github.io/IronOS/Settings/))
- [Standby Temperature Control](https://awesome-repositories.com/f/hardware-iot/standby-temperature-control.md) — Implements a configurable standby temperature to protect soldering tips from oxidation during sleep. ([source](https://ralim.github.io/IronOS/HallSensor/))
- [Temperature Boost Overrides](https://awesome-repositories.com/f/hardware-iot/temperature-boost-overrides.md) — Implements a temporary temperature boost triggered by holding a physical button during operation. ([source](https://ralim.github.io/IronOS/Settings/))
- [Thermal Sensor Calibrations](https://awesome-repositories.com/f/hardware-iot/thermal-sensor-calibrations.md) — Provides cold-junction temperature compensation to ensure accurate thermal readings based on the handle environment. ([source](https://ralim.github.io/IronOS/Menu/))
- [Voltage Measurement Calibrations](https://awesome-repositories.com/f/hardware-iot/voltage-measurement-calibrations.md) — Adjusts voltage measurement offsets to ensure accurate cutoff triggers for connected power sources. ([source](https://ralim.github.io/IronOS/Menu/))
- [Wake State Control](https://awesome-repositories.com/f/hardware-iot/wake-state-control.md) — Provides automatic sleep and wake functionality using motion detection and manual user input. ([source](https://cdn.jsdelivr.net/gh/ralim/ironos@dev/README.md))

### Development Tools & Productivity

- [Hardware Power-Saving Triggers](https://awesome-repositories.com/f/development-tools-productivity/action-execution-frameworks/interactive-action-triggers/inactivity-timeouts/hardware-power-saving-triggers.md) — Lowers temperature during inactivity or shuts down the device after a period of stillness to save energy. ([source](https://ralim.github.io/IronOS/GettingStarted/))
- [On-Screen Device Settings Editors](https://awesome-repositories.com/f/development-tools-productivity/device-set-managers/device-profile-configurations/on-screen-device-settings-editors.md) — Provides an on-screen menu for adjusting internal system parameters and restoring defaults. ([source](https://ralim.github.io/IronOS/GettingStarted/))