From 36a505b0e590929705e7aff0e7e7872522c3ab21 Mon Sep 17 00:00:00 2001 From: Piotr Trzcinski Date: Sun, 11 Oct 2026 11:17:49 +0200 Subject: [PATCH] feat: fix adapter UUIDs and add PSA engine ECU sensors The adapter (IOS-Vlink) advertises service 0x18F0, so use the 18F0/2AF1/2AF0 layout instead of the Vgate E7810A71 guess. Add 26 UDS mode 22 sensors from the Bosch MD1CS003 engine ECU (header 6A8, replies from 688) using OBDb's Citroen signal set: DPF soot level/load, regeneration status and distances, exhaust temperatures around the catalyst, AdBlue range/volume/temperature, oil temperature/pressure and service distance, ECU odometer, fuel rail pressure, gear, water in diesel and battery data. The exhaust temperatures and DPF pressure deviation match Car Scanner readings. Co-Authored-By: Claude Opus 5.5 --- config.yaml | 281 +++++++++++++++++++++++++++++++++++++++++-- templates.yaml | 318 ++++++++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 586 insertions(+), 13 deletions(-) diff --git a/config.yaml b/config.yaml index f5cb328..3cb6a15 100644 --- a/config.yaml +++ b/config.yaml @@ -19,16 +19,16 @@ devices: source: obd obd: # Bind the adapter MAC in the app (Sensors tab) instead of committing it here. - # Vgate iCar Pro BLE GATT layout. If the app logs "OBD RX/TX characteristic not found", - # check the adapter with nRF Connect and try one of the common ELM327 BLE layouts: - # service FFF0, tx FFF2, rx FFF1 - # service 18F0, tx 2AF1, rx 2AF0 - service_uuid: "E7810A71-73AE-499D-8C15-FAA9AEF0C3F2" - tx_char_uuid: "BEF8D6C9-9C21-4C9E-B632-BD58C1009F9F" - rx_char_uuid: "BEF8D6C9-9C21-4C9E-B632-BD58C1009F9F" + # The adapter advertises as "IOS-Vlink" with service 0x18F0 (checked with nRF Connect). + service_uuid: "18F0" + tx_char_uuid: "2AF1" + rx_char_uuid: "2AF0" tx_delay: 50ms init_commands: - - "ATSP6" # ISO 15765-4 CAN 11-bit 500 kbps; use ATSP0 (auto) if the ECU does not answer + - "ATSP6" # ISO 15765-4 CAN 11-bit 500 kbps, confirmed by Car Scanner + # PSA sensors below talk to the engine ECU at 6A8 (answers from 688); + # standard PIDs need the functional header and automatic receive filter back. + default_commands: ["ATSH7DF", "ATCRA"] sensors: # Standard SAE J1979 mode 01 PIDs. A PID the ECU does not support answers NO DATA — # disable such sensors in the app. @@ -97,7 +97,8 @@ devices: update_interval: 300s # ── DPF / exhaust aftertreatment (SAE J1979 diesel PIDs) ── # Byte a is the PID's "supported" bitmask, so values start at byte b. - # If these answer NO DATA, the ECU exposes DPF data only through PSA-specific mode 22 DIDs. + # Car Scanner lists DPF data only from the PSA profile, so these may answer NO DATA; + # the PSA section below reads the same values from the engine ECU directly. - key: dpf_inlet_temp mode: "01" pid: "7C" @@ -179,3 +180,265 @@ devices: state_class: measurement accuracy_decimals: 0 update_interval: 10s + + # ── PSA engine ECU (Bosch MD1CS003, 1.5 BlueHDi), UDS mode 22 ── + # DIDs and scaling from OBDb (github.com/OBDb/Citroen, header 6A8 → 688). + # Names match what Car Scanner's "Citroen 1.5 BlueHDI" profile shows. + # Byte a is the first byte after the "62 Dxxx" echo. + - key: psa_dpf_soot_level + mode: "22" + pid: "D52F" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(b*256+a)/10.24" + unit: "%" + state_class: measurement + accuracy_decimals: 0 + icon: mdi:air-filter + update_interval: 60s + - key: psa_dpf_soot_load + mode: "22" + pid: "D54B" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b)/1024" + unit: "g/L" + state_class: measurement + accuracy_decimals: 2 + icon: mdi:air-filter + update_interval: 60s + - key: psa_dpf_regen_status + mode: "22" + pid: "D521" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a" + accuracy_decimals: 0 + icon: mdi:fire + update_interval: 15s + - key: psa_dpf_distance_since_regen + mode: "22" + pid: "D519" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(b*256+a)/16" + unit: "km" + device_class: distance + state_class: measurement + accuracy_decimals: 0 + update_interval: 120s + - key: psa_dpf_avg_regen_interval + mode: "22" + pid: "D525" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(b*256+a)/16" + unit: "km" + device_class: distance + state_class: measurement + accuracy_decimals: 0 + update_interval: 600s + - key: psa_dpf_remaining_life + mode: "22" + pid: "D530" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(b*256+a-floor(b/128)*65536)*16" + unit: "km" + device_class: distance + state_class: measurement + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 3600s + # Car Scanner shows this deviation in mbar. + - key: psa_dpf_diff_pressure_deviation + mode: "22" + pid: "D518" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a*256+b-floor(a/128)*65536" + unit: "mbar" + device_class: pressure + state_class: measurement + accuracy_decimals: 0 + update_interval: 15s + - key: psa_egt_before_catalyst + mode: "22" + pid: "D52E" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b-floor(a/128)*65536)/10-273.14" + unit: "°C" + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + update_interval: 10s + - key: psa_egt_after_catalyst + mode: "22" + pid: "D555" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b-floor(a/128)*65536)/10-273.14" + unit: "°C" + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + update_interval: 10s + - key: psa_adblue_range + mode: "22" + pid: "D513" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a*50" + unit: "km" + device_class: distance + state_class: measurement + accuracy_decimals: 0 + icon: mdi:water + update_interval: 600s + - key: psa_adblue_volume + mode: "22" + pid: "D558" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a/10" + unit: "L" + device_class: volume_storage + state_class: measurement + accuracy_decimals: 1 + icon: mdi:water + update_interval: 600s + - key: psa_adblue_temp + mode: "22" + pid: "D56D" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a-floor(a/128)*256" + unit: "°C" + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 600s + - key: psa_oil_temp + mode: "22" + pid: "D47D" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b-floor(a/128)*65536)/10-273.14" + unit: "°C" + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + icon: mdi:oil-temperature + update_interval: 30s + - key: psa_oil_pressure + mode: "22" + pid: "D429" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b)/1000" + unit: "bar" + device_class: pressure + state_class: measurement + accuracy_decimals: 2 + update_interval: 15s + - key: psa_km_since_oil_change + mode: "22" + pid: "D43F" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a*256+b" + unit: "km" + device_class: distance + state_class: measurement + accuracy_decimals: 0 + icon: mdi:oil + update_interval: 3600s + - key: psa_odometer + mode: "22" + pid: "D49C" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a*16777216+b*65536+c*256+d" + unit: "km" + device_class: distance + state_class: total_increasing + accuracy_decimals: 0 + icon: mdi:counter + update_interval: 300s + - key: psa_fuel_rail_pressure + mode: "22" + pid: "D446" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b)/10" + unit: "bar" + device_class: pressure + state_class: measurement + accuracy_decimals: 0 + update_interval: 10s + - key: psa_fuel_temp + mode: "22" + pid: "D42A" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b)/10-273.14" + unit: "°C" + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + update_interval: 60s + - key: psa_boost_air_temp + mode: "22" + pid: "D411" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b-floor(a/128)*65536)/10-273.14" + unit: "°C" + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + update_interval: 30s + - key: psa_engaged_gear + mode: "22" + pid: "D43D" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a" + accuracy_decimals: 0 + icon: mdi:car-shift-pattern + update_interval: 5s + - key: psa_water_in_diesel + platform: binary_sensor + mode: "22" + pid: "D52C" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "signum(a)" + icon: mdi:water-alert + update_interval: 300s + - key: psa_battery_voltage + mode: "22" + pid: "D78A" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*256+b)/128" + unit: "V" + device_class: voltage + state_class: measurement + accuracy_decimals: 2 + update_interval: 30s + - key: psa_battery_current + mode: "22" + pid: "D497" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "(a*16777216+b*65536+c*256+d-floor(a/128)*4294967296)/1024" + unit: "A" + device_class: current + state_class: measurement + accuracy_decimals: 1 + update_interval: 30s + # Raw BSI codes; meaning not documented in OBDb. + - key: psa_battery_charge_state + mode: "22" + pid: "D742" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a" + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 600s + - key: psa_battery_wear + mode: "22" + pid: "D741" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a" + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 3600s + - key: psa_stop_start_restarts + mode: "22" + pid: "D71B" + pre_commands: ["ATSH6A8", "ATCRA688"] + formula: "a*16777216+b*65536+c*256+d" + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 3600s diff --git a/templates.yaml b/templates.yaml index 156294c..c8e6fbc 100644 --- a/templates.yaml +++ b/templates.yaml @@ -4,18 +4,21 @@ templates: - id: toyota_proace_city name: Toyota Proace City (Vgate iCar Pro BLE) - description: Standard OBD-II and DPF PIDs for the PSA-based Proace City — bind the adapter in the app + description: Standard OBD-II, DPF and PSA engine ECU data for the Proace City 1.5 BlueHDi — bind the adapter in the app device: id: proace_city_obd name: Toyota Proace City source: obd obd: - service_uuid: E7810A71-73AE-499D-8C15-FAA9AEF0C3F2 - tx_char_uuid: BEF8D6C9-9C21-4C9E-B632-BD58C1009F9F - rx_char_uuid: BEF8D6C9-9C21-4C9E-B632-BD58C1009F9F + service_uuid: 18F0 + tx_char_uuid: 2AF1 + rx_char_uuid: 2AF0 tx_delay: 50ms init_commands: - ATSP6 + default_commands: + - ATSH7DF + - ATCRA sensors: - key: rpm preset: rpm @@ -175,3 +178,310 @@ templates: state_class: measurement accuracy_decimals: 0 update_interval: 10s + - key: psa_dpf_soot_level + mode: '22' + pid: D52F + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (b*256+a)/10.24 + unit: '%' + state_class: measurement + accuracy_decimals: 0 + icon: mdi:air-filter + update_interval: 60s + - key: psa_dpf_soot_load + mode: '22' + pid: D54B + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b)/1024 + unit: g/L + state_class: measurement + accuracy_decimals: 2 + icon: mdi:air-filter + update_interval: 60s + - key: psa_dpf_regen_status + mode: '22' + pid: D521 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a + accuracy_decimals: 0 + icon: mdi:fire + update_interval: 15s + - key: psa_dpf_distance_since_regen + mode: '22' + pid: D519 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (b*256+a)/16 + unit: km + device_class: distance + state_class: measurement + accuracy_decimals: 0 + update_interval: 120s + - key: psa_dpf_avg_regen_interval + mode: '22' + pid: D525 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (b*256+a)/16 + unit: km + device_class: distance + state_class: measurement + accuracy_decimals: 0 + update_interval: 600s + - key: psa_dpf_remaining_life + mode: '22' + pid: D530 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (b*256+a-floor(b/128)*65536)*16 + unit: km + device_class: distance + state_class: measurement + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 3600s + - key: psa_dpf_diff_pressure_deviation + mode: '22' + pid: D518 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a*256+b-floor(a/128)*65536 + unit: mbar + device_class: pressure + state_class: measurement + accuracy_decimals: 0 + update_interval: 15s + - key: psa_egt_before_catalyst + mode: '22' + pid: D52E + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b-floor(a/128)*65536)/10-273.14 + unit: °C + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + update_interval: 10s + - key: psa_egt_after_catalyst + mode: '22' + pid: D555 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b-floor(a/128)*65536)/10-273.14 + unit: °C + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + update_interval: 10s + - key: psa_adblue_range + mode: '22' + pid: D513 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a*50 + unit: km + device_class: distance + state_class: measurement + accuracy_decimals: 0 + icon: mdi:water + update_interval: 600s + - key: psa_adblue_volume + mode: '22' + pid: D558 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a/10 + unit: L + device_class: volume_storage + state_class: measurement + accuracy_decimals: 1 + icon: mdi:water + update_interval: 600s + - key: psa_adblue_temp + mode: '22' + pid: D56D + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a-floor(a/128)*256 + unit: °C + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 600s + - key: psa_oil_temp + mode: '22' + pid: D47D + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b-floor(a/128)*65536)/10-273.14 + unit: °C + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + icon: mdi:oil-temperature + update_interval: 30s + - key: psa_oil_pressure + mode: '22' + pid: D429 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b)/1000 + unit: bar + device_class: pressure + state_class: measurement + accuracy_decimals: 2 + update_interval: 15s + - key: psa_km_since_oil_change + mode: '22' + pid: D43F + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a*256+b + unit: km + device_class: distance + state_class: measurement + accuracy_decimals: 0 + icon: mdi:oil + update_interval: 3600s + - key: psa_odometer + mode: '22' + pid: D49C + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a*16777216+b*65536+c*256+d + unit: km + device_class: distance + state_class: total_increasing + accuracy_decimals: 0 + icon: mdi:counter + update_interval: 300s + - key: psa_fuel_rail_pressure + mode: '22' + pid: D446 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b)/10 + unit: bar + device_class: pressure + state_class: measurement + accuracy_decimals: 0 + update_interval: 10s + - key: psa_fuel_temp + mode: '22' + pid: D42A + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b)/10-273.14 + unit: °C + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + update_interval: 60s + - key: psa_boost_air_temp + mode: '22' + pid: D411 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b-floor(a/128)*65536)/10-273.14 + unit: °C + device_class: temperature + state_class: measurement + accuracy_decimals: 0 + update_interval: 30s + - key: psa_engaged_gear + mode: '22' + pid: D43D + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a + accuracy_decimals: 0 + icon: mdi:car-shift-pattern + update_interval: 5s + - key: psa_water_in_diesel + platform: binary_sensor + mode: '22' + pid: D52C + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: signum(a) + icon: mdi:water-alert + update_interval: 300s + - key: psa_battery_voltage + mode: '22' + pid: D78A + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*256+b)/128 + unit: V + device_class: voltage + state_class: measurement + accuracy_decimals: 2 + update_interval: 30s + - key: psa_battery_current + mode: '22' + pid: D497 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: (a*16777216+b*65536+c*256+d-floor(a/128)*4294967296)/1024 + unit: A + device_class: current + state_class: measurement + accuracy_decimals: 1 + update_interval: 30s + - key: psa_battery_charge_state + mode: '22' + pid: D742 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 600s + - key: psa_battery_wear + mode: '22' + pid: D741 + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 3600s + - key: psa_stop_start_restarts + mode: '22' + pid: D71B + pre_commands: + - ATSH6A8 + - ATCRA688 + formula: a*16777216+b*65536+c*256+d + accuracy_decimals: 0 + entity_category: diagnostic + update_interval: 3600s