Archived
Replace the log-only probe with actual sensors now that OBD sensors can extract values by byte offset. All three come from the same 21 03 response on the engine ECU: offset 49 odometer at the last DPF regeneration offset 53 distance driven since that regeneration offset 57 total odometer Each is a 32-bit big-endian value scaled by 0.001 to give kilometres. The two DPF fields are marked diagnostic and exist as a cross-check: the value at 49 plus the value at 53 should equal the value at 57, which tells us the offsets are right rather than merely plausible. Whether this car's 21 03 frame reaches byte 57 is still unverified. If it does not, decodeStructured returns null and nothing is published, so the sensors stay empty instead of reporting a wrong distance. The probe is kept for now so the raw response still lands in the log either way. Document `decode` on OBD sensors in both READMEs. Needs hassble-android feat/obd-offset-decode. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
294 lines
11 KiB
YAML
294 lines
11 KiB
YAML
# Device templates for HassBle app → Sensors tab → Import template
|
|
# Loaded from repo root as templates.yaml (same branch as config.yaml)
|
|
|
|
templates:
|
|
- id: jaalee_jht
|
|
name: "Jaalee JHT"
|
|
description: "Temperature / humidity / battery (iBeacon, Apple manufacturer 76)"
|
|
device:
|
|
id: jaalee_jht
|
|
name: "Jaalee JHT"
|
|
source: advertisement
|
|
instance_mode: mac
|
|
match:
|
|
manufacturer_id: 76
|
|
manufacturer_min_length: 24
|
|
manufacturer_hex_prefix: "0215"
|
|
sensors:
|
|
- key: temperature
|
|
device_class: temperature
|
|
unit: "°C"
|
|
state_class: measurement
|
|
accuracy_decimals: 2
|
|
source_field: manufacturer_data
|
|
decode: { offset: 18, length: 2, type: uint16, endian: big, scale: 0.002670288, offset_value: -45 }
|
|
- key: humidity
|
|
device_class: humidity
|
|
unit: "%"
|
|
state_class: measurement
|
|
accuracy_decimals: 2
|
|
source_field: manufacturer_data
|
|
decode: { offset: 20, length: 2, type: uint16, endian: big, scale: 0.001524504 }
|
|
- key: battery
|
|
device_class: battery
|
|
unit: "%"
|
|
state_class: measurement
|
|
source_field: manufacturer_data
|
|
decode: { offset: 23, length: 1, type: uint8 }
|
|
|
|
- id: parking_beacon
|
|
name: "Parking Beacon"
|
|
description: "Shared parking beacon (manufacturer 861 / 0x035D)"
|
|
device:
|
|
id: parking_beacon
|
|
name: "Parking Beacon"
|
|
source: advertisement
|
|
instance_mode: shared
|
|
match:
|
|
manufacturer_id: 861
|
|
sensors:
|
|
- key: parking_time
|
|
device_class: timestamp
|
|
icon: mdi:clock-time-four-outline
|
|
source_field: manufacturer_data
|
|
length: 14
|
|
decode: { offset: 7, length: 4, type: timestamp }
|
|
- key: parking_floor
|
|
icon: mdi:layers-outline
|
|
source_field: manufacturer_data
|
|
length: 14
|
|
accuracy_decimals: 0
|
|
decode: { offset: 11, length: 1, type: uint8, scale: -1, offset_value: 256 }
|
|
- key: parking_location
|
|
platform: text_sensor
|
|
icon: mdi:map-marker-outline
|
|
source_field: manufacturer_data
|
|
length: 14
|
|
decode: { offset: 12, length: 2, type: string }
|
|
|
|
- id: obd_standard
|
|
name: "OBD-II (standard PIDs)"
|
|
description: "RPM, speed, coolant, fuel — bind ELM327 adapter in app"
|
|
device:
|
|
id: obd_vehicle
|
|
name: "OBD Vehicle"
|
|
source: obd
|
|
obd:
|
|
service_uuid: "FFF0"
|
|
tx_char_uuid: "FFF2"
|
|
rx_char_uuid: "FFF1"
|
|
tx_delay: 50ms
|
|
init_commands: []
|
|
sensors:
|
|
- { key: rpm, preset: rpm, update_interval: 1s }
|
|
- { key: speed, preset: speed, update_interval: 1s }
|
|
- { key: coolant_temp, preset: coolant_temp, update_interval: 10s }
|
|
- { key: fuel_level, preset: fuel_level, update_interval: 30s }
|
|
|
|
- id: obd_gm_extended
|
|
name: "OBD-II + GM extensions"
|
|
description: "Standard PIDs plus GM mode-22 sensors (ATSP6 init)"
|
|
device:
|
|
id: car_obd
|
|
name: "Vehicle OBD"
|
|
source: obd
|
|
obd:
|
|
service_uuid: "18F0"
|
|
tx_char_uuid: "2AF1"
|
|
rx_char_uuid: "2AF0"
|
|
tx_delay: 50ms
|
|
init_commands: ["ATSP6"]
|
|
sensors:
|
|
- { key: rpm, preset: rpm, update_interval: 1s }
|
|
- { key: speed, preset: speed, update_interval: 1s }
|
|
- { key: coolant_temp, preset: coolant_temp, update_interval: 10s }
|
|
- key: fuel_level
|
|
preset: fuel_level
|
|
update_interval: 30s
|
|
publish: { deadband: 0.5, min_interval: 60s }
|
|
- { key: gear, preset: gm_current_gear, update_interval: 1s }
|
|
- { key: prnd, preset: gm_prnd_status_alt, update_interval: 1s }
|
|
- { key: oil_pressure, preset: gm_oil_pressure, update_interval: 2s }
|
|
- { key: trans_temp, preset: gm_trans_temp, update_interval: 10s }
|
|
|
|
- id: obd_hyundai_kia
|
|
name: "OBD-II + 현대/기아 계기판"
|
|
description: "RPM, 속도, 총 주행거리, 연료잔량(L), 계기판 전압 — 계기판 7C6 / 22B002"
|
|
device:
|
|
id: car_obd_hk
|
|
name: "Hyundai/Kia OBD"
|
|
source: obd
|
|
obd:
|
|
service_uuid: "18F0"
|
|
tx_char_uuid: "2AF1"
|
|
rx_char_uuid: "2AF0"
|
|
tx_delay: 50ms
|
|
init_commands: ["ATSP6"]
|
|
# default_commands 생략 — 아래 ATSH7C6 센서가 있으므로 앱이 ATSH7DF로 자동 복원
|
|
sensors:
|
|
- { key: rpm, preset: rpm, update_interval: 1s }
|
|
- { key: speed, preset: speed, update_interval: 1s }
|
|
# 계기판(CLU) UDS. 요청 7C6 → 응답 7CE. 한 응답에 주행거리·연료·전압이 함께 온다.
|
|
# 응답: 62 B0 02 [a][b][c][d][e][f][g][h][i][j][k][l]…
|
|
# (a = 62B002 에코 바로 다음 바이트)
|
|
# e → 연료잔량 e*0.5 L
|
|
# f → 계기판 전압 f/12.8 = f*0.078125 V
|
|
# g:h:i → 총 주행거리 24bit km
|
|
# j:k:l → 위와 같은 주행거리의 mile 값 (북미 사양 계기판)
|
|
# 출처: OBDb(obdb.community)에서 현대·기아 11개 차종이 동일한 바이트 배치로 확인.
|
|
# awesomeit Torque 플러그인(35개 차종)·Elantra CN7 PID 목록과도 일치.
|
|
# 2013년식 이후에서 널리 동작하며, 미지원 차는 NO DATA를 반환한다.
|
|
#
|
|
# 예외: 엑센트(RB)는 계기판이 이 DID를 열지 않는다. 2013/2015/2019 실차 캡처에서
|
|
# unsupported로 확인됐고 (2018년식만 예외), 요청하면 7F 22 22를 돌려준다.
|
|
# 엑센트는 아래 obd_hyundai_accent_rb_diesel 템플릿을 쓸 것.
|
|
- key: odometer
|
|
mode: "22"
|
|
pid: "B002"
|
|
pre_commands: ["ATSH7C6"]
|
|
formula: "g*65536+h*256+i"
|
|
unit: "km"
|
|
device_class: distance
|
|
state_class: total_increasing
|
|
accuracy_decimals: 0
|
|
icon: mdi:counter
|
|
update_interval: 60s
|
|
- key: fuel_level
|
|
mode: "22"
|
|
pid: "B002"
|
|
pre_commands: ["ATSH7C6"]
|
|
formula: "e*0.5"
|
|
unit: "L"
|
|
state_class: measurement
|
|
accuracy_decimals: 1
|
|
icon: mdi:gas-station
|
|
update_interval: 30s
|
|
publish: { deadband: 0.5, min_interval: 60s }
|
|
- key: cluster_voltage
|
|
mode: "22"
|
|
pid: "B002"
|
|
pre_commands: ["ATSH7C6"]
|
|
formula: "f*0.078125"
|
|
unit: "V"
|
|
device_class: voltage
|
|
state_class: measurement
|
|
accuracy_decimals: 2
|
|
entity_category: diagnostic
|
|
update_interval: 60s
|
|
|
|
- id: obd_hyundai_accent_rb_diesel
|
|
name: "OBD-II 엑센트(RB) 디젤"
|
|
description: "RPM, 속도, 연료 %, 흡기온도, 대기압 + 총주행거리 프로브 — 엑센트 RB 1.6 TCI-U2"
|
|
device:
|
|
id: car_obd_accent
|
|
name: "Accent RB Diesel"
|
|
source: obd
|
|
obd:
|
|
service_uuid: "18F0"
|
|
tx_char_uuid: "2AF1"
|
|
rx_char_uuid: "2AF0"
|
|
tx_delay: 50ms
|
|
init_commands: ["ATSP6"]
|
|
# 아래 ATSH7E0 센서가 있으므로 표준 센서 앞에 ATSH7DF가 자동 삽입된다
|
|
sensors:
|
|
- { key: rpm, preset: rpm, update_interval: 1s }
|
|
- { key: speed, preset: speed, update_interval: 1s }
|
|
# 표준 연료 게이지(%). OBDb 엑센트 실차 캡처에서 2013~2019 전 연식
|
|
# 7E0 supported(012F:FLI)로 확인됨. 계기판 리터 값과 별개 경로다.
|
|
- { key: fuel_percent, preset: fuel_level, update_interval: 30s }
|
|
# awesomeit 엑센트RB 2013 D 1.6 TCI-U2 프로필에서 확인된 값들
|
|
- key: intake_temp
|
|
mode: "21"
|
|
pid: "01"
|
|
pre_commands: ["ATSH7E0"]
|
|
formula: "k*0.980392-50"
|
|
unit: "°C"
|
|
device_class: temperature
|
|
state_class: measurement
|
|
accuracy_decimals: 1
|
|
update_interval: 10s
|
|
- key: barometric_pressure
|
|
mode: "21"
|
|
pid: "01"
|
|
pre_commands: ["ATSH7E0"]
|
|
formula: "j*1.372549"
|
|
unit: "kPa"
|
|
device_class: pressure
|
|
state_class: measurement
|
|
accuracy_decimals: 1
|
|
update_interval: 30s
|
|
# ── 총주행거리 (엔진 ECU의 DPF 블록에 같이 실려 온다) ──────────────
|
|
# 엑센트 RB는 계기판(7C6 / 22B002)이 주행거리를 열지 않는다 — 요청하면 7F 22 22.
|
|
# 대신 엔진 ECU의 21 03 블록에 있다 (OBDb 메이커 공용 HYUNDAI_ODO_V2):
|
|
# byte 49~52 마지막 DPF 재생 시점의 주행거리 /1000 km
|
|
# byte 53~56 재생 이후 달린 거리 /1000 km
|
|
# byte 57~60 총주행거리 /1000 km ← 목표
|
|
# 셋은 서로 다른 필드다. awesomeit이 "DPF 주행거리"로 부르는 건 byte 53(재생 후 거리).
|
|
# 그 프로필이 같은 21 03에서 byte 53~55를 읽으므로, 이 차의 응답은 최소
|
|
# byte 55까지 도착한다 — 목표는 두 바이트 뒤다.
|
|
#
|
|
# 응답이 byte 57까지 도착하지 않으면 decode가 null을 돌려주고 아무것도
|
|
# 발행되지 않는다 — 미지원 차에서 엉뚱한 값이 올라오지 않는다.
|
|
- key: odometer
|
|
mode: "21"
|
|
pid: "03"
|
|
pre_commands: ["ATSH7E0"]
|
|
decode: { offset: 57, length: 4, type: uint32, endian: big, scale: 0.001 }
|
|
unit: "km"
|
|
device_class: distance
|
|
state_class: total_increasing
|
|
accuracy_decimals: 1
|
|
icon: mdi:counter
|
|
update_interval: 60s
|
|
# 검산용. 재생시점 주행거리 + 재생후 거리 = 총주행거리가 성립해야 한다.
|
|
- key: odometer_at_last_dpf_regen
|
|
mode: "21"
|
|
pid: "03"
|
|
pre_commands: ["ATSH7E0"]
|
|
decode: { offset: 49, length: 4, type: uint32, endian: big, scale: 0.001 }
|
|
unit: "km"
|
|
device_class: distance
|
|
accuracy_decimals: 1
|
|
entity_category: diagnostic
|
|
update_interval: 60s
|
|
- key: distance_since_dpf_regen
|
|
mode: "21"
|
|
pid: "03"
|
|
pre_commands: ["ATSH7E0"]
|
|
decode: { offset: 53, length: 4, type: uint32, endian: big, scale: 0.001 }
|
|
unit: "km"
|
|
device_class: distance
|
|
accuracy_decimals: 1
|
|
entity_category: diagnostic
|
|
update_interval: 60s
|
|
# raw= hex를 로그에 남기기 위한 프로브. 위 센서들이 값을 내면 지워도 된다.
|
|
- key: probe_2103
|
|
mode: "21"
|
|
pid: "03"
|
|
pre_commands: ["ATSH7E0"]
|
|
formula: "a"
|
|
entity_category: diagnostic
|
|
update_interval: 60s
|
|
|
|
- id: gatt_meter_relay
|
|
name: "GATT power meter + relay"
|
|
description: "Notify characteristic + switch control example"
|
|
device:
|
|
id: custom_meter
|
|
name: "Custom BLE Meter"
|
|
source: gatt_notify
|
|
gatt:
|
|
service_uuid: "ffe0"
|
|
notify_char_uuid: "ffe1"
|
|
write_char_uuid: "ffe2"
|
|
sensors:
|
|
- key: power
|
|
unit: "W"
|
|
device_class: power
|
|
state_class: measurement
|
|
decode: { offset: 0, length: 2, type: uint16, endian: little }
|
|
controls:
|
|
- key: relay
|
|
type: switch
|
|
command: { on: "A10100", off: "A10000" }
|