├── README.md
└── esphome_pinecilv2_ble.yaml


/README.md:
--------------------------------------------------------------------------------
 1 | # ESPHome PinecilV2 BLE
 2 | This is a config for a Bluetooth capable ESP32 to receive data from a PinecilV2 soldering iron and present the data to Home Assistant.
 3 | 
 4 | ## Setup
 5 | To use this config you will need to update your PinecilV2 to the latest firmware build. you shoudl be able to download the latyest firmware from here https://github.com/Ralim/IronOS/actions/workflows/push.yml
 6 | 
 7 | Once you have your ESP32 setup with ESPHome copy the sensor and BLE config to the bottom of your config file and put in the BLE MAC address of your PinecilV2.
 8 | 
 9 | Here are some instructions on finding your PinecilV2's BLE MAC address using your ESP32, https://esphome.io/components/binary_sensor/ble_presence.html#esp32-ble-tracker-setting-up-devices
10 | 
11 | ## Examples
12 | ![2023-02-04_23 44 58](https://user-images.githubusercontent.com/17092573/222944144-72a453ed-cf7b-4135-89e3-cf1f9836194f.png)
13 | ![2023-02-04_19 51 31](https://user-images.githubusercontent.com/17092573/222944143-6414dd7e-a75b-4fee-862a-588b2880e8b5.png)
14 | <video src='https://user-images.githubusercontent.com/17092573/222945489-c2014c01-6e50-4301-adbd-195d81ad1fac.mp4'/>
15 | 
16 | 
17 | 
18 | ## Thanks
19 | A big thanks to [@ithinkido](https://www.github.com/ithinkido) for his help getting started and working out some of the decoding and to [@Ralim](https://github.com/Ralim) for his help with IronOS and being increadably open to pull requests
20 | 


--------------------------------------------------------------------------------
/esphome_pinecilv2_ble.yaml:
--------------------------------------------------------------------------------
  1 | esphome:
  2 |   name: pinecil-receiver
  3 | 
  4 | esp32:
  5 |   board: esp32dev
  6 |   framework:
  7 |     type: arduino
  8 | 
  9 | # Enable logging
 10 | logger:
 11 | 
 12 | # Enable Home Assistant API
 13 | api:
 14 |   encryption:
 15 |     key: "xxxxxx"
 16 | 
 17 | ota:
 18 |   password: "xxxxxx"
 19 | 
 20 | wifi:
 21 |   ssid: !secret wifi_ssid
 22 |   password: !secret wifi_password
 23 | 
 24 |   # Enable fallback hotspot (captive portal) in case wifi connection fails
 25 |   ap:
 26 |     ssid: "Pinecil-Receiver"
 27 |     password: "xxxxxx"
 28 | 
 29 | captive_portal:
 30 | 
 31 | # everything above this should be auto generated #
 32 | 
 33 | # use your own address #
 34 | # see https://esphome.io/components/binary_sensor/ble_presence.html#esp32-ble-tracker-setting-up-devices #
 35 | # for instructions on finding the address of your PinecilV2 #
 36 | ble_client:
 37 |   - mac_address: 11:11:11:11:11:11
 38 |     id: pinecil
 39 | 
 40 | sensor:
 41 |   - platform: ble_client
 42 |     type: characteristic
 43 |     ble_client_id: pinecil
 44 |     id: PINECIL_BULK_DATA
 45 |     service_uuid: '9eae1000-9d0d-48c5-aa55-33e27f9bc533'
 46 |     characteristic_uuid: '9eae1001-9d0d-48c5-aa55-33e27f9bc533'
 47 |     lambda: |-
 48 |       uint32_t *data = (uint32_t *)(x.data());
 49 |       
 50 |       id(TEMP_TIP).    publish_state(data[0]);
 51 |       id(TEMP_SET).    publish_state(data[1]);
 52 |       id(DC_VOLTAGE).  publish_state(data[2]*0.1);
 53 |       id(TEMP_HANDLE). publish_state(data[3]*0.1);
 54 |       id(POWER_PWM).   publish_state(data[4]);
 55 | 
 56 |       //convert the 0-255 PWM value into a % that HA can display
 57 |       id(POWER_PC).    publish_state(((float)data[4]/255.0*100.0));
 58 |       
 59 |       switch (data[5]) {
 60 |         case 0:
 61 |           id(POWER_SRC).publish_state("DC");
 62 |           break;
 63 |         case 1:
 64 |           id(POWER_SRC).publish_state("QC");
 65 |           break;
 66 |         case 2:
 67 |           id(POWER_SRC).publish_state("PD With VBus");
 68 |           break;
 69 |         case 3:
 70 |           id(POWER_SRC).publish_state("PD No VBus");
 71 |           break;
 72 |       }
 73 |       
 74 |       id(TIP_RES). publish_state(data[6]*0.1);
 75 |       id(UPTIME).  publish_state(data[7]*0.1);
 76 |       id(MOVEMENT).publish_state(data[8]*0.1);
 77 |       id(MAX_TEMP).publish_state(data[9]);
 78 |       id(RAW_TIP). publish_state(data[10]*0.001);
 79 |       id(HALL).    publish_state(data[11]);
 80 |       
 81 |       switch (data[12]) {
 82 |         case 0:
 83 |           id(OPERATING_MODE).publish_state("Idle");
 84 |           break;
 85 |         case 1:
 86 |           id(OPERATING_MODE).publish_state("Soldering");
 87 |           break;
 88 |         case 2:
 89 |           id(OPERATING_MODE).publish_state("Boost");
 90 |           break;
 91 |         case 3:
 92 |           id(OPERATING_MODE).publish_state("Sleeping");
 93 |           break;
 94 |         case 4:
 95 |           id(OPERATING_MODE).publish_state("Settings");
 96 |           break;
 97 |         case 5:
 98 |           id(OPERATING_MODE).publish_state("Debug");
 99 |           break;
100 |       }
101 |       
102 |       id(EST_WATTS).publish_state(data[13]*0.1);
103 | 
104 |       return {};
105 |     update_interval: 500ms
106 |     notify: False
107 | 
108 |   - platform: template
109 |     name: "Pinecil Tip Temp"
110 |     id: TEMP_TIP
111 |     device_class: "temperature"
112 |     unit_of_measurement: "°C"
113 |     accuracy_decimals: 0
114 | 
115 |   - platform: template
116 |     name: "Pinecil Set Temp"
117 |     id: TEMP_SET
118 |     device_class: "temperature"
119 |     unit_of_measurement: "°C"
120 |     accuracy_decimals: 0
121 | 
122 |   - platform: template
123 |     name: "Pinecil DC Voltage"
124 |     id: DC_VOLTAGE
125 |     device_class: "voltage"
126 |     unit_of_measurement: "V"
127 |     accuracy_decimals: 1
128 | 
129 |   - platform: template
130 |     name: "Pinecil Handle Temp"
131 |     id: TEMP_HANDLE
132 |     device_class: "temperature"
133 |     unit_of_measurement: "°C"
134 |     accuracy_decimals: 1
135 | 
136 |   - platform: template
137 |     name: "Pinecil Power PWM"
138 |     id: POWER_PWM
139 |     state_class: "measurement"
140 |     accuracy_decimals: 0
141 | 
142 |   - platform: template
143 |     name: "Pinecil Power %"
144 |     id: POWER_PC
145 |     device_class: "power_factor"
146 |     unit_of_measurement: "%"
147 |     accuracy_decimals: 1
148 | 
149 |   - platform: template
150 |     name: "Pinecil Tip Resistance"
151 |     id: TIP_RES
152 |     state_class: "measurement"
153 |     unit_of_measurement: "Ω"
154 |     accuracy_decimals: 1
155 | 
156 |   - platform: template
157 |     name: "Pinecil Uptime"
158 |     id: UPTIME
159 |     device_class: "duration"
160 |     unit_of_measurement: "s"
161 |     accuracy_decimals: 1
162 | 
163 |   - platform: template
164 |     name: "Pinecil Last Movement Time"
165 |     id: MOVEMENT
166 |     device_class: "duration"
167 |     unit_of_measurement: "s"
168 |     accuracy_decimals: 1
169 | 
170 |   - platform: template
171 |     name: "Pinecil Max Temp"
172 |     id: MAX_TEMP
173 |     device_class: "temperature"
174 |     unit_of_measurement: "°C"
175 |     accuracy_decimals: 0
176 | 
177 |   - platform: template
178 |     name: "Pinecil Raw Tip Voltage"
179 |     id: RAW_TIP
180 |     device_class: "voltage"
181 |     unit_of_measurement: "mV"
182 |     accuracy_decimals: 0
183 | 
184 |   - platform: template
185 |     name: "Pincil Hall Effect Strength"
186 |     id: HALL
187 |     state_class: "measurement"
188 |     accuracy_decimals: 0
189 | 
190 |   - platform: template
191 |     name: "Pinecil Est. Watts"
192 |     id: EST_WATTS
193 |     device_class: "power"
194 |     unit_of_measurement: "W"
195 |     accuracy_decimals: 1
196 | 
197 | text_sensor:
198 |   - platform: template
199 |     name: "Pinecil Power Source"
200 |     id: POWER_SRC
201 | 
202 |   - platform: template
203 |     name: "Pinecil Operating Mode"
204 |     id: OPERATING_MODE
205 | 


--------------------------------------------------------------------------------