class Matter::MDNS::Responder

• Matter::MDNS::Responder
• Reference
• Object

Overview

mDNS Responder for advertising Matter services

Handles:

• Service advertisement (announcements)
• Query responses
• Using Authority Section for authoritative records

Included Modules

• Matter::MDNS::ResponderInterface

Defined in:

matter/mdns/responder.cr

Constant Summary

ANNOUNCEMENT_INTERVAL = 30.seconds

DEFAULT_TTL = 120.seconds

MDNS_IPV4 = Socket::IPAddress.new("224.0.0.251", MDNS_PORT)

MDNS_IPV6 = Socket::IPAddress.new("ff02::fb", MDNS_PORT)

MDNS_PORT = 5353

Constructors

• .new(port : Int32 = MDNS_PORT, hostname : String = "matter-device.local", ip_addresses : Array(Socket::IPAddress) = [] of Socket::IPAddress)

Instance Method Summary

• #advertise_commissioning(info : CommissioningInfo, port : Int32 = 5540, ttl : Time::Span = 120.seconds) : Nil

  Advertise commissioning service

• #advertise_operational(info : OperationalInfo, port : Int32 = 5540, ttl : Time::Span = 120.seconds) : Nil

  Advertise operational service

• #close : Nil

  Close responder

• #commissioning_instance_name : String | Nil

  Returns the current commissioning DNS-SD instance name (e.g.

• #hostname : String
• #ip_addresses : Array(Socket::IPAddress)
• #on_query : Proc(DNS::Packet, Socket::IPAddress, Nil) | Nil

  Callback for received queries Signature: (query : DNS::Packet, peer_address : Socket::IPAddress) -> Nil

• #on_query=(on_query : Proc(DNS::Packet, Socket::IPAddress, Nil) | Nil)

  Callback for received queries Signature: (query : DNS::Packet, peer_address : Socket::IPAddress) -> Nil

• #port : Int32
• #respond_to_query(query : DNS::Packet, service_type : ServiceType, instance : String, port : Int32, txt_records : Hash(String, String), hostname : String) : Nil

  Respond to a specific query with explicit hostname (SRV target).

• #respond_to_query(query : DNS::Packet, service_type : ServiceType, instance : String, port : Int32, txt_records : Hash(String, String)) : Nil

  Respond to a specific query

• #send_goodbye(service_type : ServiceType, instance : String) : Nil

  Send goodbye announcement (TTL=0) to remove service

• #socket_ipv4 : UDPSocket | Nil
• #socket_ipv6 : UDPSocket | Nil
• #start : Nil

  Start listening for mDNS queries

• #stop : Nil

  Stop listening

• #stop_commissioning : Nil

  Stop all commissioning advertisements

• #stop_operational_advertisement : Nil

  Stop all operational advertisements

• #update_commissioning_hostname(hostname : String) : Nil

  Updates the default commissioning target hostname (SRV target) and re-announces any active commissioning advertisements without changing the commissioning instance name.

Constructor Detail

Instance Method Detail