# 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 # ── 계기판 일치 오도미터 탐색용 프로브 (확인 끝나면 이 블록만 지울 것) ── # # 위 odometer 는 엔진 ECU 카운터라 계기판보다 1436.5 km 높고 offset_value 로 # 맞춰둔 상태다. 7E0 의 다른 블록을 더 뒤져도 같은 카운터라 편향이 같으므로, # 계기판 값을 얻으려면 독립된 ECU(계기판 7C6 / 변속기 7E1)를 봐야 한다. # # 배제된 것 — 다시 넣지 말 것: # 22 B002 @ 7C6 이 차가 7F 22 22 (conditionsNotCorrect)로 직접 거부. # OBDb 실차 캡처도 2013/2015/2019 엑센트 unsupported. # 01 2F 연료량. NO DATA. 오도미터와 무관하지만 재시도 방지용 기록. # # 주의: OBDb 의 엑센트 캡처는 북미 가솔린 차량이라 이 디젤을 대변하지 못한다. # 실제로 7E0.2103 이 거기서는 unsupported 인데 이 차에서는 동작한다. # 그래서 아래 후보들은 캡처로 배제하지 않고 실차에서 직접 확인한다. # # 전부 읽기 전용 요청(service 01/21/22)이다. 값은 쓰지 않고 응답 유무와 # raw hex 확보가 목적이므로 formula 는 첫 바이트만 본다. # 로그에서 확인할 것: # raw=61xx… / 62xx… → 응답함. hex 전체를 뜨면 오도미터 위치를 찾을 수 있다. # NO DATA → 미지원 # negative response → 존재하지만 거부 (NRC 확인) # 계기판 mode 21 블록. 7C6 은 22B002 를 거부하면서도 응답 자체는 하므로 # ECU 는 살아 있다. 계기판 값을 얻을 가능성이 가장 높은 후보다. - key: probe_7c6_2101 mode: "21" pid: "01" pre_commands: ["ATSH7C6"] formula: "a" entity_category: diagnostic update_interval: 60s # B002 인접 DID. awesomeit·OBDb 어디에도 기록이 없어 순수 탐색이다. - key: probe_7c6_22b001 mode: "22" pid: "B001" pre_commands: ["ATSH7C6"] formula: "a" entity_category: diagnostic update_interval: 60s - key: probe_7c6_22b003 mode: "22" pid: "B003" pre_commands: ["ATSH7C6"] formula: "a" entity_category: diagnostic update_interval: 60s # 변속기(TCU). awesomeit 엑센트RB 프로필이 21A0 @ 7E1 에서 기어단수·미션오일온도를 # 읽으므로 이 블록은 이 차에 존재한다. 엔진과 독립된 카운터를 가질 수 있다. - key: probe_7e1_21a0 mode: "21" pid: "A0" pre_commands: ["ATSH7E1"] formula: "a" entity_category: diagnostic update_interval: 60s # 표준 오도미터 PID. 2013 엑센트의 mode 01 지원 목록이 0145 에서 끊겨 # 가능성은 낮지만, 되면 그대로 계기판 값이라 한 번은 확인할 가치가 있다. - key: probe_01a6 mode: "01" pid: "A6" 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" }