excieve/pinecil2mqtt repository overview

⁠Pinecil V2 BLE to MQTT Gateway

This project has been barely tested and might not work as expected. Use at your own risk.

Find the full readme and source code at https://github.com/excieve/pinecil2mqtt⁠

This project is a BLE to MQTT gateway for the Pinecil V2⁠ soldering irons. It is based on the Pinecil V2 BLE Services⁠ from IronOS.

While there are already some excellent projects⁠ that read data from the Pinecil V2 soldering iron via BLE, this project aims to provide a more flexible and extensible solution by publishing the data to an MQTT broker. From there, the data can be consumed by other applications or services (e.g. Home Assistant, Grafana).

⁠Features

• Automatically discover and connect to the Pinecil V2 soldering iron via BLE
• Publish data provided by the soldering iron to an MQTT broker
• Optionally authenticate with the MQTT broker
• Transform raw data into human-readable values
• Can be run as a standalone binary or in a container

⁠Pre-requisites

• A Pinecil V2 soldering iron
• IronOS firmware version 2.22 or later (might work on 2.21 but not tested)
• A computer with Bluetooth Low Energy support
• An MQTT broker (e.g. Mosquitto⁠)

⁠Installation

⁠With containers

1. Pull the image from Docker Hub:

   docker pull excieve/pinecil2mqtt:dev
   

   Copy
2. Run the container (on a Linux machine) with the following command, replacing mqtt.example.com with your MQTT broker:

   docker run -d -e P2M_MQTT_HOST=mqtt.example.com -v /run/dbus/:/run/dbus excieve/pinecil2mqtt:dev
   

   Copy
3. Enjoy!

⁠Caveats

The container needs access to the host's D-Bus socket to be able to communicate with BLE devices. This is achieved by mounting the host's D-Bus socket into the container. This might not work on all platforms.

Additionally, this image is built on an Alpine Linux base image, which is known to be particular about DNS resolution. If you encounter issues with resolving your MQTT broker's hostname, you might need to use IP address instead. This might change in the future.