구성 옵션
Home Assistant에서 성공적으로 구성된 각 로봇 청소기는 별개의 통합 항목으로 저장됩니다. 해당 항목에 자동으로 연결된 장치가 생성되며, 청소기의 엔티티, 서비스 및 지도 데이터를 제공합니다. 구성 옵션을 통해 장치별 설정에 접근할 수 있어, 각 통합 항목의 동작을 독립적으로 커스터마이즈할 수 있습니다.
이러한 설정은 초기 설정 과정에서 선택한 연결 유형 구성을 완료한 후 최종 단계에서 즉시 접근할 수 있으며(장치가 Home Assistant에 추가되기 직전), Home Assistant Integrations 페이지에서 언제든지 장치 카드를 오른쪽 상단의 Configure 버튼을 클릭하여 수정할 수도 있습니다.
Dreame Vacuum Card 키
Dreame 진공청소기 카드 라이선스 키를 위한 선택적 필드입니다. 유효한 키를 입력하면 통합 기능이 내장 커스텀 카드를 자동으로 활성화하고 대시보드의 커스텀 카드 목록에서 사용할 수 있게 됩니다. 잘못된 키를 입력하면 카드가 대시보드에서 미리보기 모드로 남아 있게 됩니다.
단일 장치 활성화
각 라이선스 키는 단일 장치에만 엄격하게 제한됩니다. 키가 한 번 활성화되면 해당 특정 장치에 영구적으로 연결되며, 다른 장치에서 카드를 활성화하는 데 사용할 수 없습니다.
참고
이 필드는 전적으로 선택 사항입니다. 비워 두어도 내장 커스텀 카드를 대시보드에 추가할 수 있지만 미리보기 모드로 작동합니다. 유효한 키는 미리보기 모드에서 카드 인터페이스를 통해 나중에 언제든지 직접 획득할 수 있습니다.
알림
이 통합 기능이 이 장치에 대해 생성할 수 있는 지속 알림 카테고리를 선택하십시오. 카테고리의 선택을 해제하면 기본 장치 이벤트가 발생하더라도 해당 카테고리는 완전히 비활성화됩니다.
- 정리 완료 (
cleanup_completed): 청소 작업이 성공적으로 완료될 때마다 생성됩니다. - 소모품 (
consumable): 소모품 수명이 부족할 때 또는 부품이 유지보수를 필요로 할 때 생성됩니다. - 정보 (
information): 일반 정보 이벤트 및 상태 업데이트를 위해 생성됩니다. - 경고 (
warning): 장치가 제거 가능한 오류나 경미한 문제를 만났을 때 생성됩니다. - 오류 (
error): 장치가 치명적인 결함이나 하드웨어 오류를 경험할 때 생성됩니다.
동반 앱
기본적으로 지속 알림은 Home Assistant 대시보드 내에서만 표시됩니다. 특정 알림 장치 ID가 필요하기 때문에 모바일 기기의 Home Assistant Companion 앱으로 직접 푸시할 수 없습니다. 모바일 기기에서 푸시 알림을 받으려면 통합의 이벤트를 듣거나 생성된 지속 알림을 모니터링한 후 특정 모바일 기기로 전달하는 사용자 지정 자동화를 만들어야 합니다.
지도 표시 옵션 지도 지원
다음 설정은 모두 지도 데이터를 기반으로 하기 때문에 클라우드 계정(DreameHome, MovaHome, TROUVER 또는 Xiaomi Home)과 설정된 장치에서만 사용할 수 있습니다:
Dreame 진공청소기 카드
아래 설정은 생성된 지도 카메라 엔티티에만 적용됩니다. Dreame 진공청소기 카드는 자체 지도를 기본적으로 표시하며 Color Scheme과 Icon Set을 고급 구성을 통해 독립적으로 재정의할 수 있습니다. Square Map Image 및 Low Resolution Map Image 옵션은 커스텀 카드에는 영향을 주지 않으므로 메모리를 절약하기 위해 Low Resolution Map Image를 활성화하는 것이 강력히 권장됩니다.
색상 구성
지도 이미지를 생성할 때 사용할 색상 팔레트를 선택합니다.
- Dreame Light (
dreame_light): 공식 Dreame 앱 테마. - Dreame Dark (
dreame_dark):dreame_vacuum통합 전용 다크 테마. - Mijia Light (
mijia_light): 공식 Xiaomi Mi Home 앱의 라이트 테마. - Mijia Dark (
mijia_dark): 공식 Xiaomi Mi Home 앱의 다크 테마. - Grayscale (
grayscale): 색상이 없는 단색 지도 테마. - Transparent (
transparent): 바닥, 벽 및 방 채우기를 완전히 투명하게 생성하여 지도 위에 커스텀 배경을 오버레이할 때 유용합니다.
아이콘 세트
로봇, 충전기 및 가구와 같은 맵 마커에 사용되는 아이콘 스타일을 선택하며, 공식 앱의 아이콘 세트와 일치합니다.
- Dreame (
dreame): 공식 Dreame 앱의 아이콘 세트. - Dreame Old (
dreame_old): 기존 Dreame 앱의 아이콘 세트. - Mijia (
mijia): 공식 Xiaomi Mi Home 앱의 아이콘 세트. - Material (
material): Home Assistant의 내장 Material Design 아이콘.
숨겨진 지도 개체
생성된 맵 이미지에서 제외할 맵 요소를 선택합니다. 이는 맵을 단순화하거나 특정 대시보드에서 필요 없는 정보를 숨기는 데 유용합니다.
사용 가능한 객체
- Room Colors (
color): 각 방의 개별 색상 채우기. - Room Icons (
icon): 방 유형에 따른 방 아이콘. - Room Names (
name): 방 이름의 텍스트 레이블. - Room Name Background (
name_background): 해당 색상의 방 이름 뒤에 있는 캡슐형 배경. - 룸 순서 (
order): 청소 순서를 나타내는 번호 배지. - 룸 흡입 수준 (
suction_level): 방의 설정된 흡입 수준을 나타내는 아이콘. - 룸 물 양 (
water_volume): 방의 설정된 물 양을 나타내는 아이콘. - 룸 청소 횟수 (
cleaning_times): 방이 청소될 횟수를 나타내는 배지. - 룸 청소 모드 (
cleaning_mode): 방의 설정된 청소 모드(청소, 걸레질 또는 둘 다)를 나타내는 아이콘. (지원되는 기기에서만) - 룸 걸레 모드 (
mopping_mode): 방에 설정된 걸레 패드 유형을 나타내는 아이콘. (지원되는 기기에서만) - 경로 (
path): 로봇이 청소한 경로를 나타냄. - 출입 금지 구역 (
no_go): 제한 구역. - 걸레 금지 구역 (
no_mop): 제한된 걸레 구역. - 가상 벽 (
virtual_wall): 로봇이 통과하지 못하도록 추가된 가상 벽. - 가상 경계 (
pathway): 로봇이 조심스럽게 넘어야 하는 정의된 경계입니다. (지원되는 장치에서만) - 활성 영역 (
active_area): 구역 청소 중 그려진 경계 상자입니다. - 활성 지점 (
active_point): 1.5m² 영역을 보여주는 스팟 청소 지점입니다. - 충전기 아이콘 (
charger): 베이스 스테이션 아이콘입니다. - 로봇 아이콘 (
robot): 로봇 자체를 나타내는 아이콘입니다. - 청소 방향 (
cleaning_direction): 로봇이 현재 청소하고 있는 방향을 나타내는 화살표입니다. - AI 장애물 (
obstacle): 신발이나 전선과 같은 AI가 감지한 장애물 아이콘입니다. (지원되는 장치에서만) - 반려동물 (
pet): 반려동물로 감지된 장애물입니다. (지원되는 장치에서만) - 카펫 영역 (
carpet): 카펫 질감입니다. (지원되는 장치에서만) - 바닥 재질 (
material): 목재나 타일과 같은 방의 바닥 재질 질감입니다. (지원되는 장치에서만) - 저지대 (
low_lying_area): 로봇이 LiDAR 스캐너를 내려 진입하는 낮은 지역. (지원되는 장치에서만) - 가구 (
furniture): 3D 또는 2D 가구. (지원되는 장치에서만) - 경사로 (
ramp): 환경에 배치된 경사로. (지원되는 장치에서만) - 커튼 (
curtain): 커튼. (지원되는 장치에서만) - 크루즈 포인트 (
cruise_point): 작업 포인트로 이동. (지원되는 장치에서만)
정사각형 지도 이미지
생성된 지도 카메라 이미지를 지도 본래 경계 상자가 아닌 1:1 정사각형 비율로 강제하여, 정사각형 이미지를 기대하는 대시보드 레이아웃에 유용할 수 있음.
저해상도 지도 이미지
메모리 사용량을 줄이고 업데이트를 빠르게 하기 위해 낮은 해상도로 지도 카메라 이미지를 생성.
메모리 제약
대형 지도를 생성하려면 상당한 양의 메모리가 필요할 수 있습니다. 장치 페이지로 이동하거나 지도 카메라 엔터티에 액세스할 때 Home Assistant가 충돌하고 재시작된다면, 메모리가 부족하기 때문일 가능성이 높습니다. 이 옵션을 활성화하면 보통 문제가 해결됩니다.
참고
이 옵션을 활성화하면 저해상도에서 사용할 수 없기 때문에 저장된 WiFi 지도 카메라 엔터티가 비활성화됩니다.
클라우드 사용 선호
Xiaomi Home 계정으로 설정된 장치에서만 사용 가능합니다. 이 설정은 초기 구성 단계에서 선택한 선호도를 업데이트할 수 있게 합니다.
- 활성화 시: 모든 통신을 클라우드를 통해 강제 수행합니다. 이는 Xiaomi가 로컬 액세스 기능을 비활성화한 최신 장치나 장치와 Home Assistant가 다른 서브넷에 있는 경우 필요합니다.
- 비활성화 시(지원되는 설정의 경우 권장): 이 통합은 장치와 직접 로컬 연결을 설정합니다(클라우드에서 토큰 및 IP 갱신을 자동으로 처리하는 것은 그대로 유지). 이로 인해 지도 데이터를 제외한 모든 통신이 완전히 로컬에서 이루어집니다.
로컬 API 사용 가능 여부 테스트
이 옵션은 로컬 연결을 테스트하는 매우 유용한 방법을 제공합니다. 초기 장치 설정이 오류 없이 성공하도록 보장하기 위해 구성 과정 중에는 클라우드 우선를 활성화 상태로 둘 수 있습니다. 장치가 Home Assistant에 성공적으로 추가되면, 장치가 실제로 로컬 API를 지원하는지 확인하기 위해 여기서 이 옵션을 비활성화할 수 있습니다. 비활성화 후 장치가 사용 불가능해지면, 단순히 다시 활성화하여 클라우드 연결로 되돌릴 수 있습니다.
YAML 참고용
yaml
dreame_vacuum:
# Local connection
host: 192.168.1.100
token: b2a1c3d4e5f6a7b8c9d0e1f2a3b4c5d6
# Cloud connection
username: your@email.com
password: your_password
country: de
prefer_cloud: true # Only available on Xiaomi Home
# Options available regardless of connection type
dvc_key: 123e4567-e89b-42d3-a456-426614174000
notify:
- information
- warning
- error
# Options available only with map support (Cloud)
color_scheme: dreame_dark
icon_set: dreame_old
hidden_map_objects:
- name_background
- name
- order
square: true
low_resolution: true