diff --git a/source/_integrations/iron_os.markdown b/source/_integrations/iron_os.markdown
new file mode 100644
index 00000000000..c38dc5e47af
--- /dev/null
+++ b/source/_integrations/iron_os.markdown
@@ -0,0 +1,35 @@
+---
+title: IronOS
+description: Instructions on how to integrate IronOS-based Pinecil V2 devices with Home Assistant.
+ha_category:
+  - Sensor
+ha_iot_class: Local Polling
+ha_release: 2024.8
+ha_config_flow: true
+ha_codeowners:
+  - '@tr4nt0r'
+ha_domain: iron_os
+ha_integration_type: integration
+ha_platforms:
+  - sensor
+---
+
+The **IronOS** {% term integration %} seamlessly connects Home Assistant with PINE64's Pinecil V2 soldering irons, allowing for remote monitoring and control. This integration provides real-time updates on temperature, power, and various other settings and diagnostic information.
+
+{% include integrations/config_flow.md %}
+
+## Sensors
+
+- **Tip temperature:** Monitors the current temperature of the soldering iron tip.
+- **Handle temperature:** Displays the temperature of the soldering iron handle.
+- **Estimated power:** Shows the estimated power consumption of the soldering iron.
+- **DC input voltage:** Reports the voltage level being supplied to the soldering iron.
+- **Last movement time:** Indicates when the soldering iron was last in motion (relative to the uptime of the device), useful for activity monitoring.
+- **Operating mode:** Indicates the current operational state of the soldering iron, such as idle, soldering, boost, sleeping, settings, or debug.
+- **Max tip temperature:** Indicates the maximum temperature that the currently inserted soldering iron tip supports.
+- **Power level:** Displays the duty cycle of the pulse-width modulation (PWM) in percent, indicating the current power output of the soldering iron (for example, "50%" for a 50% duty cycle).
+- **Power source:** Identifies the current power source used by the soldering iron, such as DC input, USB Quick Charge, USB Power Delivery, or USB Power Delivery VBUS.
+- **Raw tip voltage:** Measures the raw voltage at the soldering iron tip.
+- **Tip resistance:** Indicates the resistance of the currently inserted soldering iron tip (for example, "6.2 Ω" for short tips, "8 Ω" for normal tips)
+- **Uptime:** Tracks the total operating time of the soldering iron since its last power-on.
+- **Hall effect strength:** (Optional) This feature requires the device to be [modified with a hall effect sensor](https://wiki.pine64.org/wiki/Pinecil_Hall_Effect_Sensor). If a neodymium magnet is attached to the stand, it enables proximity detection and can be utilized to calibrate when the iron enters sleep mode based on its proximity to the stand.