HomeAssistant의 블루프린트(Blueprints) 기능은 스마트 홈 설정을 간단하게 만들어 주는 마법 같은 도구입니다. 여기 2025.12.2 버전에 기반한 자세한 설명과 튜토리얼을 제공합니다.
1. 블루프린트란? (쉬운 설명)
HomeAssistant의 자동화를 요리로 생각해 보세요:
- 예전에는(자동화를 직접 작성): 레시피를 직접 써야 했습니다. 기름을 먼저 두르고, 어느 정도 온도에서 재료를 넣고, 얼마나 볶고, 소금을 얼마나 넣을지. 집에 5개의 방에서 모두 “사람이 오면 불 켜기”를 하려면 그 레시피를 5번 베껴 쓰고 매번 방 이름을 바꿔야 했습니다. 매우 번거롭고 실수하기 쉽습니다.
- 지금은(블루프린트 사용): 블루프린트는 “밀키트” 또는 “빈칸 채우기 문제”입니다. 고수들이 복잡한 로직(레시피)을 이미 다 작성해 두고 몇 개의 빈칸을 만들어 두었습니다.
- 여러분은 다음만 채우면 됩니다: 어떤 센서(사람), 어느 조명(불), 얼마나 켜 둘지(시간).
- “저장”을 한 번 누르면 한 접시(자동화)가 완성됩니다.
- 같은 블루프린트를 거실, 침실, 화장실에서 사용할 수 있고 자동화를 원하는 만큼 생성할 수 있습니다.
2. 초보자용 단계별 튜토리얼: 이 버전에 내장된 “동작 감지 조명”을 예로
사전 준비:
- HA에 이미 동작 센서(인체 센서 등)와 조명이 연동되어 있는지 확인하세요.
- 버전 확인: 본 튜토리얼은 Home Assistant 2025.12.2에서 검증되었습니다.
1단계: 블루프린트 패널 찾기
- 왼쪽 메뉴에서 설정(Settings)을 클릭합니다.
- 자동화 및 씬(Automations & Scenes)을 클릭합니다.
- 상단 탭에서 블루프린트(Blueprints)를 클릭합니다.
- 2025.12 버전 신기능: 각 블루프린트 이름 오른쪽에 숫자가 표시될 수 있습니다. 이는 현재 그 블루프린트를 사용하는 자동화 개수를 나타냅니다(새로 만들어 아직 사용하지 않았다면 0입니다).
2단계: 블루프린트 선택하기
Home Assistant에는 공식 블루프린트 두 개가 기본 제공됩니다. 여기서는 가장 대표적인 Motion-activated Light(동작 감지 조명)를 사용합니다.
- 목록에서 Motion-activated Light를 찾습니다.
- 오른쪽의 자동화 만들기(Create Automation) 버튼을 클릭합니다.
3단계: “빈칸” 채우기
시스템이 새 페이지로 이동합니다. 이것이 블루프린트 설정 페이지입니다. 코드를 작성할 필요 없이 화면에서 선택만 하면 됩니다:
- 이름(Name):
- 이 자동화에 이름을 지정합니다. 예를 들어 “거실 사람 오면 불 켜기”.
Motion Sensor(동작 센서):
- 드롭다운을 클릭해 집 안의 인체 센서를 선택합니다(엔티티 ID는 보통 binary_sensor.로 시작합니다).
- 참고: 여기가 블루프린트가 만들어 둔 첫 번째 “빈칸”입니다.
Light(조명):
- 드롭다운을 클릭해 영역(Area), 기기(Device) 또는 엔티티(Entity)를 선택합니다.
- 엔티티 선택(Pick entity)을 고른 뒤 제어할 조명을 체크하는 것을 권장합니다.
- 참고: 여기가 블루프린트가 만들어 둔 두 번째 “빈칸”입니다.
Wait time(대기 시간):
- 이것은 숫자 슬라이더 또는 입력 상자입니다. 120을 입력합니다.
- 의미는: 센서가 사람을 감지하지 못하면 120초 더 기다린 뒤 조명을 끈다는 것입니다.
4단계: 저장과 확인
- 오른쪽 아래의 저장(Save) 버튼을 클릭합니다.
- 이때 시스템이 자동으로 자동화 하나를 생성해 줍니다.
- 효과 확인:
- 센서 앞에서 움직여 보고 조명이 자동으로 켜지는지 확인합니다.
- 떠나서 설정한 시간(예: 120초) 동안 정지해 있고 조명이 자동으로 꺼지는지 확인합니다.
3. 고급: 다른 사람의 블루프린트 사용하기 (블루프린트 가져오기)
내장 블루프린트는 비교적 기초적입니다. 진짜 강력한 것은 커뮤니티가 제공하는 블루프린트입니다(조광, 일출·일몰 판단, 리모컨 제어 등을 지원하는 것).
가져오기 단계:
- 인터넷(Home Assistant 커뮤니티 포럼 등)에서 고수가 공유한 블루프린트 글을 찾습니다.
- 글에 제공된 GitHub 링크(보통 .yaml로 끝납니다)를 복사합니다.
- HA의 설정 > 자동화 및 씬 > 블루프린트 페이지로 돌아갑니다.
- 오른쪽 아래의 블루프린트 가져오기(Import Blueprint) 버튼을 클릭합니다.
- 나타난 상자에 방금 복사한 링크를 붙여 넣고 미리보기(Preview)를 클릭합니다.
- 문제가 없는지 확인한 뒤 가져오기(Import)를 클릭합니다.
- 이제 새 블루프린트가 목록에 나타나며, 위 튜토리얼처럼 “자동화 만들기”를 클릭해 사용할 수 있습니다.
정리
- 블루프린트 = 템플릿.
- 자동화 = 템플릿에 빈칸을 채워 생성된 실제 작업.
- 2025.12 버전에서 HA는 인터페이스를 개선해 블루프린트 사용 현황을 더 직관적으로 볼 수 있게 했지만, 핵심 조작 흐름은 여전히 “블루프린트 선택 -> 빈칸 채우기 -> 저장” 세 단계입니다.