2024.11.3
Home ▸ Integrations ▸

IronOS

The IronOS integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] 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.

Minimum requirements

  • Pinecil V2 requires IronOS v2.21 or higher to connect to Home Assistant. Please refer to the Pinecil Wiki for update instructions.

Configuration

To add the IronOS integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

Number controls

  • Setpoint temperature: Allows to set the desired target temperature for the soldering iron tip.

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’s thermocouple, which is then offset compensated and converted to the tip temperature.
  • 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. 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.

Update

  • Firmware: The update entity indicates if the firmware is up-to-date or if there is a newer IronOS version available for your device. For more information on how to update your device, please refer to the IronOS documentation.