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 Opus 5 d75bcd469a fix(obd): replace Hyundai/Kia template with the cluster 22B002 PIDs
The obd_hyundai_kia template shipped four PIDs that belong to other makes, so
a Hyundai or Kia never answered them:

  22 132A          → GM/Chevrolet (Malibu, Cruze, Trax, Spark)
  22 2203 + ATSH743 → Renault Samsung (SM5, SM6, QM3, QM6)
  22 FD40          → SsangYong (Korando, Rexton W, Tivoli)
  22 F22E          → SsangYong Tivoli

The odometer formulas were wrong independently of the PID: FD40 reads the
odometer from bytes U:V, not a:b.

Replace them with the HKMC instrument cluster DID, which carries odometer,
fuel level and cluster voltage in one response:

  ATSH7C6 + 22 B002 → 62 B0 02 [a][b][c][d][e][f][g][h][i] …
    e     → fuel level     e*0.5 L
    f     → cluster volts  f*0.078125 V
    g:h:i → odometer       24-bit km

Cross-checked against the Elantra CN7 PID list, JejuSoul/OBD-PIDs-for-HKMC-EVs
and the awesomeit Torque plugin database (35 HKMC models, 2013 onwards).

Requires hassble-android to group sensors by (mode, pid) and to expose
response bytes past h — all three sensors share one PID and the odometer
needs byte i.

Also document the formula byte range and the ATSH restore rule in both READMEs.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-30 00:29:02 +09:00

194 lines
6.7 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. 한 응답에 주행거리·연료·전압이 함께 담겨 온다.
# 응답: 62 B0 02 [a][b][c][d][e][f][g][h][i]… (a = 62B002 에코 다음 바이트)
# e → 연료잔량 e*0.5 L
# f → 계기판 전압 f*0.078125 V
# g:h:i → 총 주행거리 24bit km
# 2013년식 이후 현대·기아·제네시스에서 널리 동작. 미지원 차는 NO DATA.
# 일부 기아는 주행거리가 i:j:k:l(32bit)로 밀려 있다는 보고가 있음.
# 값이 이상하면 formula를 "i*16777216+j*65536+k*256+l" 로 바꿔볼 것.
- 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: 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" }