Archived
The comment claimed some Kia clusters shift the odometer to i:k:k:l. That misread a search snippet: bytes j:k:l are a separate field holding the same odometer in miles for North American clusters, not an alternate km layout. Verified against OBDb (obdb.community), where 11 Hyundai/Kia models — Elantra, Sonata, Tucson, Kona, Santa Fe, Veloster, Forte, K5, Seltos, Sportage, Telluride — all publish the identical layout for 7C6 / 22 B002: e fuel level (liters) f cluster volts div 12.8 g:h:i odometer 24-bit km j:h:l odometer 24-bit miles OBDb's 12.8 divisor for byte f equals the 0.078125 multiplier already in the template, which confirms OBDb indexes bytes the same way Torque letters do, i.e. excluding the 62 B0 02 echo. So g:h:i is right as written. Fuel level stays at e*0.5. OBDb is split — Santa Fe and Soul carry div 2 while ten others carry no scale and max 255, the uncalibrated 8-bit default. The awesomeit plugin (35 models) and the Elantra CN7 list both scale by 0.5, and e*1.0989 % maps to a 45.5 L full tank, so 0.5 is the calibrated value. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
196 lines
6.9 KiB
YAML
196 lines
6.9 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를 반환한다.
|
|
- 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" }
|