Button 스키마 작성법

벨/문열림 등 단순 트리거를 보내는 장치는 button 엔티티를 사용합니다. type은 button이며, 공통 필드(id, name, packet_parameters, device_class, icon)를 함께 지정할 수 있습니다.

필수 필드

• command_press: 버튼 눌림 시 송신할 패킷. CommandSchema 또는 CEL 표현식으로 작성합니다.

옵션 필드

• 추가 필드는 없지만, command_press에 CEL 표현식을 사용해 다중 패킷 전송이나 동적 명령 생성을 구성할 수 있습니다. CEL 가이드를 참고하세요.
• discovery_always: 버튼은 상태 패킷이 없는 경우가 많으므로, 기본값이 true로 설정됩니다. (discovery_linked_id가 설정된 경우 제외)

MQTT 디스커버리 메시지 구성

• 토픽: homeassistant/button/<unique_id>/config
• 공통 필드
  • name, default_entity_id, unique_id
  • state_topic: ${MQTT_TOPIC_PREFIX}/${id}/state (버튼은 상태를 쓰지 않지만 브리지에서 기본으로 포함)
  • availability: ${MQTT_TOPIC_PREFIX}/bridge/status
  • device: devices 설정 또는 브리지 기본 정보
  • 선택: suggested_area, device_class, icon
• 버튼 전용
  • command_topic: ${MQTT_TOPIC_PREFIX}/${id}/set
  • payload_press: PRESS

예제: 공동 현관 문열림 명령

button:
  - id: door_open_common
    name: 'Door Open Common'
    icon: mdi:door-sliding-open
    command_press:
      data: [0x61, 0x00, 0x00]
  - id: door_open_single
    name: 'Door Open'
    icon: mdi:door-sliding-open
    command_press:
      data: [0xB4, 0x00, 0x00]

작성 체크리스트

1. 버튼은 상태를 가지지 않으므로 state 블록을 넣지 않습니다.
2. 장비가 응답 패킷을 요구한다면 packet_defaults.tx_checksum과 헤더/푸터를 상위에서 맞춰준 뒤, command_press에 필요한 바이트만 넣습니다.