기본 콘텐츠로 건너뛰기

게이트맨 연동기와 도어센서로 HA에 현관문 리모컨 구현하기

이번에 저희 집이 게이트맨 도어락을 구입해서 설치했습니다.

설치한김에 게이트맨 연동기로 HA에서 현관문을 열 수 있는 기능을 구현한 것을 공유해보고자 합니다.

초보는 검색도 힘들고.. 말해도 말귀도 어두워서..

막상 해보면 별거 없는데.. 그래도 혹시나 자신 없어 하시는 분들을 위해.. 남겨봅니다.

우선 준비물이 필요합니다.

HA는 당연히 있어야 할거고요..

ESP32로 구현하시는 분들도 계시던데.. 저는 직비로 할 예정이기 때문에.. 직비 코디네이터는 있으셔야 하고.. HA에 Z2M은 설치되어 있으셔야 합니다.(여기서부터.. 절대 초보자가 따라 할 수 없는 수준인것 같은 느낌이지만.. 직비는 HA에 알아서 구현해보세용.. 여기서는 그 정도는 당연히 되어 있다고 가정하고 진행하겠습니다.)

그 다음에 게이트맨 연동기를 조작할 직비 릴레이가 필요합니다. 저는 이걸 구매했습니다.

https://ko.aliexpress.com/item/1005002306870803.html?spm=a2g0s.9042311.0.0.663e4c4dcH88wQ

저도 몰랐는데.. 전원에 연결되는 직비 장치는 라우터 기능이 대부분 들어있다고 합니다. 이 릴레이도 라우터 기능이 포함되어 있습니다.

그렇잖아도 라우터가 하나 필요했는데.. 득템했네요.

그 다음에 스마트폰 충전 케이블과 어뎁터가 있으셔야 하고요.

게이트맨 연동기가 있어야겠죠.

저는 여기서 구매했는데요..

https://shop.11st.co.kr/stores/228714/search?searchKwd=%25EA%25B2%258C%25EC%259D%25B4%25ED%258A%25B8%25EB%25A7%25A8

본인의 도어락이 어떤걸 지원하는지 꼭 확인해보시고.. 자신 없으시면 게이트맨 고객센터에 전화해서 꼭 확인해보시기 바랍니다.

저는 처음에 홈케어로 잘못 구매해서 교환 받았습니다. ㅠㅠ

덕분에 연동기가 하나 더 생겼네요..

그 다음에 저희 집은 그 흔한 월패드 하나 없는 구축 중에 구축 아파트입니다. 그래서 버튼이 하나 필요할 거 같아서..

이것도 구매했습니다.

https://www.ikea.com/kr/ko/p/tradfri-shortcut-button-white-80356384/

이제 준비물이 준비되었으면..

구현해볼까요?

우선.. 최종 구현한 사진입니다.

게이트맨 연동기와 직비 릴레이 크기는 생각보다 작습니다. 가로 10cm, 세로 10cm, 높이 5cm 정도 되는 명함 케이스면 쏙 들어갑니다.

게이트맨 연동기에는 전선이 4가닥 있습니다.

빨간색과 검은색이 전원선입니다.

게이트맨 연동기는 스마트폰 충전기로도 충분히 동작합니다.

직비 릴레이도 스마트폰 충전기로 동작하기 때문에..

저는 아래처럼 전원을 공급하도록 했습니다. 스마트폰 충전기 어뎁처 중에 포트가 2개 있는 어뎁터가 있는데 거기에 케이블 2개를 꼽고 하나는 연동기로 하나는 직비 릴레이로 연결했습니다. 케이블 하나로 2개 장치에 모두 전원을 공급하셔도 되는데.. 저는 그냥 깔끔하게 따로 따로 연결했습니다.


빨간색과 검은색을 전원에 연결하시고 연동기를 도어락에 등록을 하신 다음에 나머지 하얀색과 노란색을 쇼트시켜서 도어락이 정상으로 열리는지 확인해 보시기 바랍니다.

연동기가 제대로 동작하면 이제 하얀색 선과 노란색 선을 직비 릴레이의 3번과 4번에 연결하시면 됩니다.

그 다음에 2번 버튼이 페어링 버튼입니다. 꾹 눌러서 LED 가 번쩍이면 Z2M에 등록하시면 됩니다.

1번 버튼이 모드 버튼입니다. 한번 누르면 스위치 모드이고 다시 한번 누르면 인칭 모드라고 해서 딸깍 켜졌다가 바로 딸깍 꺼지는 모드입니다. 저희는 인칭 모드를 쓸거기 때문에 Z2M에 등록하신 다음에 스위치를 동작해서 확인해 보시고 인칭 모드로 설정하시기 바랍니다.

자.. 이제 연동기와 직비 릴레이가 HA에 등록이 되었으면.. 문 열림 상태에 따른 자동화를 추가해보겠습니다.

그래서 도어 센서가 하나 필요합니다. 도어 센서는 구매하셔서 현관문에 잘 설치해주시고 Z2M에 등록해두시기 바랍니다.

그래서 연동기를 동작시키고 현관문이 열리지 않으면 도어를 잠금 상태로 유지하고 현관문이 열리면 열림 상태로 표현하는 자동화를 구현하겠습니다. 그리고 위에서 얘기한 버튼 관련된 자동화도 하나로 구현했습니다.

먼저 구성하기 > 도우미 에 들어가셔서 토글을 하나 추가해주시기 바랍니다. 이름은 적당히..

다음에 자동화로 가셔서 자동화를 추가하시기 바랍니다.

저는 아래처럼 구현했습니다.

alias: 현관문

description: ''

trigger:

  - type: opened

    platform: device

    device_id: *****

    entity_id: binary_sensor.maindoor_sensor_contact // 도어 센서입니다.

    domain: binary_sensor

    id: open

  - type: not_opened

    platform: device

    device_id: *****

    entity_id: binary_sensor.maindoor_sensor_contact

    domain: binary_sensor

    id: close

  - platform: device

    type: turned_on

    device_id: *****

    entity_id: switch.main_door // 직비 릴레이 스위치입니다.

    domain: switch

    id: switch

  - platform: device

    domain: mqtt

    device_id: ***** // 이케아 직비 버튼입니다.

    type: action

    subtype: 'on'

    discovery_id: ***** action_on

    id: switch2

condition: []

action:

  - choose:

      - conditions:

          - condition: trigger

            id: close

        sequence:

          - service: input_boolean.turn_off // 도우미에서 등록한 토글입니다.

            target:

              entity_id: input_boolean.door

      - conditions:

          - condition: trigger

            id: switch

        sequence:

          - service: input_boolean.turn_on

            target:

              entity_id:

                - input_boolean.door

          - delay:

              hours: 0

              minutes: 0

              seconds: 5 // 시간은 도어락이 자동으로 잠금 상태로 변경되는 시간을 감안해서 조정하시면 됩니다.

              milliseconds: 0

          - type: is_not_open

            condition: device

            device_id: *****

            entity_id: binary_sensor.maindoor_sensor_contact

            domain: binary_sensor

          - service: input_boolean.turn_off

            target:

              entity_id: input_boolean.door

      - conditions:

          - condition: trigger

            id: switch2

        sequence:

          - type: turn_on

            device_id: *****

            entity_id: switch.main_door

            domain: switch

    default:

      - condition: trigger

        id: open

      - service: input_boolean.turn_on

        target:

          entity_id: input_boolean.door

mode: parallel

max: 10

그 다음에 이 도어락을 구글 홈에 등록하기 원하시면 configuration.yaml에

lock:

  - platform: template

    name: 현관

    value_template: "{{ is_state('input_boolean.door', 'off') }}"

    lock:

      - service: input_boolean.turn_off

        target:

          entity_id: input_boolean.door

    unlock:

      - service: switch.turn_on

        target:

          entity_id: switch.main_door

      - service: input_boolean.turn_on

        target:

          entity_id: input_boolean.door

을 추가해주시고 google_assistant: 의 exposed_domains: 에 - lock 을 추가해주시면 구글 홈에서 도어락이 등록되는걸 보실 수 있습니다.

그리고 네스트 허브나 네스트 허브 맥스에서 스위치가 아니라 잠금 장치로 도어락을 제어하시려면

google_assistant: 에 secure_devices_pin: 을 추가하신 다음에 원하는 비밀번호를 입력하시면 됩니다.

구글 홈에 잠금 장치를 추가하는건 옵션이고.. 그냥 직비 릴레이 스위치 등록하셔서 제어하시는게 더 간편하긴 합니다.

혹시 궁금하신거나 더 좋은 아이디어 있으시면 댓글 남겨주시면 고맙겠습니다.

댓글

이 블로그의 인기 게시물

피드백 루프: AI 시대 테스터가 지켜내야 할 핵심 엔진

소프트웨어 개발과 테스팅 현장에서 가장 자주 언급되지만, 막상 시스템이 복잡해질수록 쉽게 경시되곤 하는 핵심 개념이 바로 '피드백 루프(Feedback Loop)'입니다. 코드를 수정하고, 빌드하고, 테스트 결과를 확인하고, 다시 개선하는 그 순환 과정의 속도와 정확도가 결국 소프트웨어의 품질을 결정짓기 때문입니다. 품질 전문가 매슈 하이저(Matthew Heusser)가 자신의 블로그 Quality Remarks에 기고한 "One Loop After Another" 아티클은 바로 이 피드백 루프의 다층적 구조와, AI 시대에 우리가 놓치지 말아야 할 품질 검증의 본질을 날카롭게 되짚어 줍니다. (출처: Quality Remarks - One Loop After Another / Matthew Heusser) https://qualityremarks.com/one-loop-after-another/ 매슈 하이저는 소프트웨어 개발 생태계가 단순히 하나의 커다란 테스트 루프로 돌아가는 것이 아니라, 시간 축과 관점에 따라 겹겹이 쌓인 '연쇄적인 피드백 루프들(One Loop After Another)'로 이루어져 있다고 설명합니다. 초단기 루프 (Inner Loop): 개발자가 코드를 작성하는 몇 초~몇 분 단위의 루프입니다. 단위 테스트(Unit Test)나 IDE의 Linter, AI 자동 완성이 즉각적인 피드백을 주는 영역입니다. 단기 루프 (Daily / CI Loop): 커밋과 푸시가 이루어지고, CI/CD 파이프라인에서 통합 테스트와 정적 분석이 실행되는 몇 시간 단위의 루프입니다. 중기 루프 (Iteration / Exploration Loop): 스프린트 단위로 탐색적 테스팅(Exploratory Testing)을 수행하고, 실제 사용자 시나리오나 엣지 케이스를 사람이 직접 검증하며 시스템의 유기적 작동을 확인하는 며칠~몇 주 단위의 루프입니다. 장기 루프 (Outer / Market Loop): 실제 ...

에이전틱 AI 프로젝트에서 테스터의 5가지 핵심 원칙

AI 코딩 에이전트와 자율형 에이전트가 빠르게 개발 워크플로우에 통합되면서, 단순히 코드를 잘 짜는 것을 넘어 '에이전트와 어떻게 협업하고 통제할 것인가'가 개발자와 아키텍트들의 가장 큰 화두로 떠올랐습니다. 윤석찬 님의 아티클 "AI 에이전트 시대, 개발자는 어떻게 일해야 하는가? – 프론티어 엔지니어링의 10가지 원칙"은 에이전틱 AI 시대에 엔지니어가 마주하는 패러다임 변화와, 실무 현장에서 일하는 방식을 어떻게 재정의해야 하는지 아주 명확한 가이드라인을 제시해 줍니다. (출처: channy.creation.net - 윤석찬 님의 블로그) https://channy.creation.net/blog/1989 비록 대규모 에이전트 오케스트레이션이나 초거대 인프라 시스템을 개인이 직접 구축하고 운용하는 것은 비용적·기술적으로 현실적인 한계가 있습니다. 하지만 개인 프로젝트에서 AI와 바이브 코딩(Vibe Coding)을 활용하며 겪었던 맥락 손실, 환각, 통제 불능의 경험들을 떠올려보면, 이 아티클이 제시하는 10가지 프론티어 엔지니어링 원칙은 소규모 개인 개발 환경에서도 대단히 깊은 공감을 불러일으킵니다. 이 글은 단순히 "AI 도구를 잘 쓰자"는 수준에 머무르지 않습니다. AI 에이전트가 생성해내는 불확실성 속에서 인간 엔지니어가 시스템의 맥락을 주도하고, 오작동을 제어하며, 품질의 키(Steering Wheel)를 쥐기 위한 구조적 사고법을 다룹니다. 그렇다면 프론티어 엔지니어링의 원칙을 바탕으로, 시스템의 신뢰성과 안전성을 검증해야 하는 테스터는 과연 어떤 실무 원칙을 세워나갈 수 있을까요? 윤석찬 님이 제시한 엔지니어링 원칙을 테스팅 관점으로 재해석해 보면, 다음과 같은 5가지 원칙으로 정리할 수 있을 것 같습니다. 1. 결정론적 검증에서 '경계선 및 허용 오차(Boundary)' 테스팅으로 전환하라 에이전트 기반 시스템은 같은 입력을 주어도 매번 다른 추론 경로를 거치는 확률적(Stoc...

에이전틱 AI 시대에 테스팅은?

 "소프트웨어 엔지니어링은 과연 끝난 것일까?" 최근 AI 코딩 에이전트와 바이브 코딩(Vibe Coding)의 급부상 속에서, 엔지니어들과 아키텍트들이 스스로에게 던지는 가장 뼈아픈 질문입니다. 이 질문에 대해 기술 현장의 날카로운 시선을 담은 이원국 님의 아티클 "소프트웨어 엔지니어링의 종말"과 arXiv 논문 "Agentic Software: How AI Agents Are Restructuring the Software Paradigm"은 아주 근본적인 패러다임의 변화를 짚어내고 있습니다. (출처: blog.wonkooklee.com - 소프트웨어 엔지니어링의 종말) https://blog.wonkooklee.com/blog/20260913_02/ (출처: arXiv - Agentic Software: How AI Agents Are Restructuring the Software Paradigm) https://arxiv.org/html/2606.05608v2 이원국님의 아티클과 논문에서 공통적으로 말하는 핵심은, 우리가 알고 있던 '인간이 직접 코드를 다듬고 작성하던 전통적 소프트웨어 엔지니어링'의 정체성은 종말을 고하고 있으며, 그 자리를 '에이전트 패러다임(Agentic Paradigm)'이 빠르게 대체하고 있다는 사실입니다. arXiv 논문 "Agentic Software"에서는 소프트웨어 구축의 단위가 단순히 결정론적(Deterministic) 알고리즘이나 코드에서, 목표를 스스로 자율 추론하고 도구를 호출하며 과업을 완수하는 'AI 에이전트 오케스트레이션'으로 이동하고 있음을 말하고 있습니다. 이제 개발자는 시스템의 메서드나 API 하나하나를 직접 타이핑하는 존재가 아닙니다. AI 에이전트가 코드를 생성하고, 실행하고, 테스트를 돌리고, 스스로 디버깅하는 일련의 자율 루프(Autonomous Loop)를 설계하는 '시스템...