feat: fix adapter UUIDs and add PSA engine ECU sensors
Validate YAML Configs / Validate YAML Schema (push) Successful in 1m9s

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 <noreply@anthropic.com>
This commit is contained in:
Piotr TrzcinskiandClaude Opus 5.5 committed 2026-10-11 11:17:49 +02:00
1 parent 6f2cf62a2c
commit 36a505b0e5
2 files changed
+586 -13

No files matched your search

+272 -9
View File
@@ -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
+314 -4
View File
@@ -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