This repository has been archived on 2026-11-06. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
hassble-config/templates.yaml
T
eiggerandClaude Sonnet 5 d6fc16a875 chore(obd): drop the odometer scan now the engine-block sensor works
The dash-matching cluster/transmission/standard-PID sweep (34 diagnostic
sensors probing 22 B002 at 7C6, 21 A0 at 7E1, and the 01 A6 preset) found
nothing at 195958 km. The confirmed working sensor stays the 21 03 @ 7E0
engine block reading, already calibrated with offset_value -1436.5 to match
the dash.

Remove the scan sensors, the two 22 B001/B003 existence probes, and the
01 A6 preset attempt. Keep the gear/gear position/transmission oil temp
sensors from the 21 A0 @ 7E1 block: they are unrelated to the odometer
search — the awesomeit profile for this exact car reads them from bytes 13,
20 and 21, which the 0-15 scan window covered without ever matching an
odometer-shaped value, so the sweep's failure says nothing about whether
this block answers at all. If 21 A0 turns out not to respond, those three
should go too.

Sensor count: 45 -> 10.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-30 14:57:10 +09:00

363 lines
14 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 }
# 연료량은 이 차에서 읽을 방법이 없다. 표준 01 2F는 실차에서 NO DATA를
# 돌려주고(OBDb 캡처는 북미 가솔린 기준이라 디젤에는 맞지 않았다),
# 계기판 22B002도 7F 22 22로 거부한다.
# 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을 돌려주고 아무것도
# 발행되지 않는다 — 미지원 차에서 엉뚱한 값이 올라오지 않는다.
#
# offset_value = -1436.5 는 계기판 대조 보정이다. 2026-07-30 실측에서
# ECU 카운터 197394.5 km, 계기판 195958 km 로 0.733% 높게 나왔다.
# 이 카운터는 DPF 서비스 주기용이라 법정 계기판 수치와 별개로 관리되고,
# 속도 신호원이 달라 장기간에 걸쳐 벌어진다.
# 측정이 한 번뿐이라 상수 오차인지 비례 오차인지 구분되지 않아 우선 상수로 뒀다.
# 100km 이상 주행 후 재확인할 것:
# 차이가 1436.5 그대로면 상수가 맞고, 1437.2 근처로 늘면 비례이므로
# offset_value 를 빼고 scale 을 0.000992723 으로 바꾼다.
- key: odometer
mode: "21"
pid: "03"
pre_commands: ["ATSH7E0"]
decode: { offset: 57, length: 4, type: uint32, endian: big, scale: 0.001, offset_value: -1436.5 }
unit: "km"
device_class: distance
state_class: total_increasing
accuracy_decimals: 1
icon: mdi:counter
update_interval: 60s
# 검산용: 재생시점 주행거리 + 재생후 거리 = 총주행거리.
# 재생시점 값도 같은 ECU 카운터라 위와 같은 보정을 걸어야 이 관계가 유지된다.
# 재생후 거리는 차분이라 편향이 없으므로 보정하지 않는다.
- 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, offset_value: -1436.5 }
unit: "km"
device_class: distance
state_class: total_increasing
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
state_class: measurement
accuracy_decimals: 1
entity_category: diagnostic
update_interval: 60s
# 계기판(22B002)·표준(01A6)·변속기(21A0) 오프셋 0~15 스캔은 195958km와
# 일치하는 값을 찾지 못해 제거했다. 계기판은 애초에 22B002 자체를
# 7F 22 22로 거부하므로 다른 DID를 더 뒤져볼 이유가 약하고, 표준 01A6은
# mode 01 지원 목록에 없어 예상대로였다. 위 offset_value 보정을 계속 쓴다.
# ── 변속기(TCU) 21A0 @ 7E1 ────────────────────────────────────────
# awesomeit 엑센트RB 2013 D 1.6 TCI-U2 프로필의 공식 그대로다.
# 오도미터 스캔과는 별개로, 이 블록 자체는 이 차에 존재하는 것으로 알려진
# 값이라 남겨둔다. 스캔은 offset 0~15만 봤고 이 값들은 13·20·21번째라
# 범위 안이었지만 195958과 다른 값(온도·기어)이라 스캔에서 걸러졌을 뿐,
# 응답 자체가 없었는지는 확인되지 않았다. 재임포트 후 값이 안 뜨면
# (NO DATA가 로그에 남으면) 이 3개도 지운다.
# N(byte 13) 미션오일온도, U(byte 20) 기어위치, V(byte 21) 기어단수
- key: trans_oil_temp
mode: "21"
pid: "A0"
pre_commands: ["ATSH7E1"]
formula: "n-40"
unit: "°C"
device_class: temperature
state_class: measurement
accuracy_decimals: 1
icon: mdi:oil-temperature
update_interval: 10s
- key: gear_position
mode: "21"
pid: "A0"
pre_commands: ["ATSH7E1"]
platform: text_sensor
icon: mdi:car-shift-pattern
decode:
offset: 20
length: 1
type: uint8
map:
"8": "D"
"9": "N"
"10": "R"
"11": "P"
"12": "Sport"
"16": "E Mode"
update_interval: 1s
- key: gear
mode: "21"
pid: "A0"
pre_commands: ["ATSH7E1"]
platform: text_sensor
icon: mdi:numeric
decode:
offset: 21
length: 1
type: uint8
map:
"0": "P/N"
"1": "1"
"2": "2"
"3": "3"
"4": "4"
"5": "5"
"6": "6"
"7": "7"
"8": "8"
update_interval: 1s
- 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" }