homebridge-ip-presence

이 플러그인은 지정한 IP 주소를 주기적으로 ping 하여 응답 여부를 확인하고,
HomeKit에 재실 감지 센서(Occupancy Sensor) 로 표시해주는 Homebridge 플랫폼 플러그인입니다.

기능

• IP 주소 기반 재실 감지
• 여러 장치 동시 모니터링 지원
• threshold 설정: 연속 실패 횟수를 기준으로 부재중으로 판단
• HomeKit에서 재실 여부 확인 가능
• 폴링 주기(초 단위) 설정 가능

설치 방법

cd ~/.homebridge/plugins
git clone https://github.com/yourname/homebridge-ip-presence.git
cd homebridge-ip-presence
npm install

설정 방법 (config.json)

{
  "platforms": [
    {
      "platform": "IPPresence",
      "interval": 10,
      "devices": [
        {
          "name": "Mac Mini",
          "ip": "192.168.1.21",
          "threshold": 3
        },
        {
          "name": "iPhone",
          "ip": "192.168.1.45",
          "threshold": 5
        }
      ]
    }
  ]
}

옵션 설명

• platform: 항상 "IPPresence"
• interval: ping 체크 주기 (초 단위, 기본값 15)
• devices: 감지할 장치 목록
  • name: HomeKit에 표시될 이름
  • ip: 모니터링할 장치의 IP 주소
  • threshold: 연속 ping 실패 허용 횟수 (기본값 3)

동작 방식

• 지정한 IP 주소로 ICMP ping을 보냅니다.
• 응답이 오면 재실 있음(Occupancy Detected = 1) 으로 표시됩니다.
• 응답이 없으면 내부 카운터를 증가시키며, 지정한 threshold 횟수만큼 연속 실패 시 부재중으로 전환합니다.

참고

• IP는 고정 IP 또는 DHCP 예약을 권장합니다.
• 네트워크 방화벽/라우터 설정에 따라 ping이 차단되면 항상 부재중으로 인식될 수 있습니다.