{"id":50904119,"url":"https://github.com/gomeng-dev/smartthings-vehicle-ha","last_synced_at":"2026-06-16T05:31:16.169Z","repository":{"id":362654207,"uuid":"1259041526","full_name":"gomeng-dev/smartthings-vehicle-ha","owner":"gomeng-dev","description":"한국 SmartThings 현대자동차·기아·제네시스 차량용 Home Assistant 커스텀 통합","archived":false,"fork":false,"pushed_at":"2026-06-05T07:42:19.000Z","size":70,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T09:14:13.825Z","etag":null,"topics":["genesis","hacs","home-assistant","hyundai","kia","korea","smartthings","vehicle"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gomeng-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-04T06:28:29.000Z","updated_at":"2026-06-05T07:42:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gomeng-dev/smartthings-vehicle-ha","commit_stats":null,"previous_names":["gomeng-dev/smartthings-vehicle-ha"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/gomeng-dev/smartthings-vehicle-ha","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gomeng-dev%2Fsmartthings-vehicle-ha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gomeng-dev%2Fsmartthings-vehicle-ha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gomeng-dev%2Fsmartthings-vehicle-ha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gomeng-dev%2Fsmartthings-vehicle-ha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gomeng-dev","download_url":"https://codeload.github.com/gomeng-dev/smartthings-vehicle-ha/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gomeng-dev%2Fsmartthings-vehicle-ha/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34393302,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["genesis","hacs","home-assistant","hyundai","kia","korea","smartthings","vehicle"],"created_at":"2026-06-16T05:31:15.472Z","updated_at":"2026-06-16T05:31:16.164Z","avatar_url":"https://github.com/gomeng-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 스마트싱스 차량\n\n[![GitHub release](https://img.shields.io/github/v/release/gomeng-dev/smartthings-vehicle-ha?display_name=tag)](https://github.com/gomeng-dev/smartthings-vehicle-ha/releases)\n[![HACS Custom](https://img.shields.io/badge/HACS-Custom-41BDF5.svg)](https://hacs.xyz/)\n[![CI](https://github.com/gomeng-dev/smartthings-vehicle-ha/actions/workflows/ci.yml/badge.svg)](https://github.com/gomeng-dev/smartthings-vehicle-ha/actions/workflows/ci.yml)\n\n한국 SmartThings에 등록된 현대자동차·기아·제네시스 차량을 Home Assistant에서 조회하고 제어하는 커스텀 통합입니다.\n\nHome Assistant 공식 SmartThings 통합의 OAuth 인증을 재사용하므로, 별도 토큰을 복사하거나 붙여 넣을 필요가 없습니다.\n\n## 주요 기능\n\n- SmartThings 차량 자동 탐색\n- 주행 가능 거리, 누적 주행 거리, 시동, 공조, 잠금, 도어, 창문, 연료 경고, 스마트키 배터리, 연결 상태 조회\n- 차량 상태 새로고침 및 연결 확인\n- 차량 잠금 / 잠금 해제는 잠금 엔티티로 제어\n- SmartThings 앱처럼 원격 시동은 별도 스위치로 노출하지 않고 공조 켜기 / 끄기 스위치로 함께 관리\n- Google Assistant에서 에어컨처럼 다루기 쉬운 냉방 모드 climate 엔티티 제공\n- 공조 온도, 작동 시간, 앞유리 김서림 제거 설정\n\n## 지원 환경\n\n- Home Assistant 2024.12.0 이상\n- HACS\n- Home Assistant 공식 SmartThings 통합\n- 한국 SmartThings 계정에 등록된 현대자동차·기아·제네시스 차량\n\n## 설치 전 준비\n\n먼저 Home Assistant에 공식 SmartThings 통합을 설정하세요.\n\n1. Home Assistant → 설정 → 기기 및 서비스\n2. 통합 추가 → SmartThings\n3. 삼성 계정 로그인 및 권한 승인\n4. SmartThings 앱 또는 Home Assistant에서 차량이 계정에 등록되어 있는지 확인\n\n## HACS 설치\n\n아직 HACS 기본 저장소에 포함되지 않은 경우 사용자 정의 저장소로 추가합니다.\n\n1. HACS → 통합\n2. 우측 상단 메뉴 → 사용자 정의 저장소\n3. 저장소 URL 입력\n\n   ```text\n   https://github.com/gomeng-dev/smartthings-vehicle-ha\n   ```\n\n4. 카테고리 `Integration` 선택\n5. `스마트싱스 차량` 다운로드\n6. Home Assistant 재시작\n\n## 최초 설정\n\nHome Assistant를 재시작한 뒤 통합을 추가합니다.\n\n1. 설정 → 기기 및 서비스\n2. 통합 추가\n3. `스마트싱스 차량` 검색\n4. 자동 탐색된 차량 목록에서 차량 선택\n5. 차량 이름 확인 또는 수정\n6. 설정 완료\n\n자동 탐색된 차량이 없으면 SmartThings 차량 장치 ID를 직접 입력할 수 있습니다.\n\n## 생성되는 엔티티\n\n### 센서\n\n- 주행 가능 거리\n- 누적 주행 거리\n- 시동 상태\n- 공조 상태\n- 실내 온도\n- 잠금 상태\n- 운전석 / 조수석 / 뒤 좌측 / 뒤 우측 도어\n- 운전석 / 조수석 / 뒤 좌측 / 뒤 우측 창문\n- 연료 경고\n- 스마트키 배터리\n- 연결 상태\n\n### 버튼\n\n- 차량 상태 새로고침\n- 차량 연결 확인\n\n### 잠금\n\n- 차량 잠금: 잠금 / 잠금 해제\n\n### 스위치\n\n- 공조: 켜기 / 끄기. 켜기 명령에는 설정된 작동 시간이 포함되어 SmartThings 차량 원격 공조처럼 시동과 공조가 함께 동작합니다.\n- 앞유리 김서림 제거: 켜기 / 끄기. 이 값은 다음 공조 켜기 명령에 함께 전송됩니다.\n\n### 에어컨\n\n- 에어컨: Google Assistant에서 온도 설정과 공조 켜기 / 끄기를 자연스럽게 제어하기 위한 냉방 모드 climate 엔티티입니다.\n\n### 공조 설정\n\n- 공조 설정 온도: 17–27℃, 기본 22℃\n- 공조 작동 시간: 1–30분, 기본 10분\n- 앞유리 김서림 제거: `off` / `on`, 기본 `off`\n\n`공조` 스위치를 켜면 현재 설정된 공조 값과 작동 시간이 SmartThings로 전송됩니다. 온도나 작동 시간을 바꾸는 것만으로는 차량 명령이 실행되지 않습니다.\n\nGoogle Assistant에는 `climate.smartthings_vehicle_hvac`를 `쏘나타 에어컨`으로 노출하는 것을 권장합니다. 추가 옵션으로 `switch.smartthings_vehicle_hvac_defog`, `select.smartthings_vehicle_hvac_ignition_duration`를 함께 노출하면 음성으로 온도 설정, 에어컨 켜기/끄기, 김서림 제거 설정, 작동 시간 설정을 다루기 쉽습니다.\n\n## 안전 안내\n\n차량 제어는 실제 차량 상태를 바꾸는 동작입니다.\n\n- 잠금 해제와 공조 제어는 신중하게 사용하세요. 공조 켜기는 차량 원격 공조 동작으로, 설정된 작동 시간 동안 차량 시동/공조가 함께 동작할 수 있습니다.\n- 자동화에 차량 제어를 넣을 때는 위치, 시간, 재실 여부 등 안전 조건을 함께 설정하는 것을 권장합니다.\n- 설치 및 설정 과정에서는 차량 제어 명령이 자동으로 실행되지 않습니다.\n- 창문은 현재 상태 조회만 지원합니다. SmartThings capability에 창문 열기/닫기 명령이 제공되지 않아 제어 버튼을 만들지 않습니다.\n\n## 문제 해결\n\n### SmartThings 차량 통합이 검색되지 않음\n\n- HACS 설치 후 Home Assistant를 재시작했는지 확인하세요.\n- `custom_components/smartthings_vehicle` 경로에 통합 파일이 설치되었는지 확인하세요.\n\n### SmartThings에 연결할 수 없다는 오류가 표시됨\n\n- 공식 SmartThings 통합이 먼저 설정되어 있어야 합니다.\n- 공식 SmartThings 통합의 삼성 계정 로그인이 만료되지 않았는지 확인하세요.\n- Home Assistant를 재시작한 뒤 다시 시도하세요.\n\n### 차량이 자동 탐색되지 않음\n\n- SmartThings 앱에서 차량이 같은 삼성 계정에 등록되어 있는지 확인하세요.\n- 공식 SmartThings 통합이 해당 계정으로 로그인되어 있는지 확인하세요.\n- 필요한 경우 SmartThings 차량 장치 ID를 직접 입력하세요.\n\n### 버튼/토글을 눌러도 차량 상태가 바로 바뀌지 않음\n\nSmartThings 차량 명령은 네트워크, 차량 통신 상태, 제조사 서버 상태에 따라 반영까지 시간이 걸릴 수 있습니다. 이 통합은 잠금/공조 명령이 `ACCEPTED` 되면 Home Assistant 상태를 목표 상태로 즉시 반영한 뒤 최대 약 24초 동안 실제 상태 수렴을 확인합니다. 차량 상태 반영이 더 늦으면 잠시 기다린 뒤 `차량 상태 새로고침`을 눌러 확인하세요.\n\n## 수동 설치\n\nHACS를 사용하지 않는 경우 아래 경로에 통합 폴더를 복사합니다.\n\n```bash\ncd ~/.homeassistant\nmkdir -p custom_components\ncp -R /path/to/smartthings-vehicle-ha/custom_components/smartthings_vehicle custom_components/\n```\n\n복사 후 Home Assistant를 재시작하세요.\n\n## 라이선스\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgomeng-dev%2Fsmartthings-vehicle-ha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgomeng-dev%2Fsmartthings-vehicle-ha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgomeng-dev%2Fsmartthings-vehicle-ha/lists"}