APIs#

sl_mdns_event_t#

sl_mdns_event_t

mDNS events

sl_mdns_protocol_t#

sl_mdns_protocol_t

mDNS protocol

sl_mdns_query_type#

sl_mdns_query_type

mDNS service query types.

sl_mdns_query_type_t#

typedef enum sl_mdns_query_type sl_mdns_query_type_t

mDNS service query types.

sl_mdns_t#

typedef struct sl_mdns_s sl_mdns_t

mDNS instance handle

sl_mdns_event_handler_t#

sl_mdns_event_handler_t )(sl_mdns_t *mdns, sl_mdns_event_t event, void *data)

mDNS event handler

sl_mdns_response_t#

typedef struct sl_mdns_response_s sl_mdns_response_t

Represents the result of an mDNS query.

This structure contains details about the discovered mDNS service, including instance name, service type, protocol, hostname, port, TXT records, IP addresses, and TTL.

sl_mdns_init#

sl_status_t sl_mdns_init (sl_mdns_t * mdns, const sl_mdns_configuration_t * config, sl_mdns_event_handler_t event_handler)

Initialize mDNS instance.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

Note

• This API needs to be called before calling any other mDNS API

• sl_mdns_event_handler_t currently not supported. User should pass NULL for event_handler.

sl_mdns_deinit#

sl_status_t sl_mdns_deinit (sl_mdns_t * mdns)

De-initialize mDNS instance.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_mdns_add_interface#

sl_status_t sl_mdns_add_interface (sl_mdns_t * mdns, sl_net_interface_t interface)

Add network interface to mDNS instance.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_mdns_remove_interface#

sl_status_t sl_mdns_remove_interface (const sl_mdns_t * mdns, sl_net_interface_t interface)

Remove network interface to mDNS instance.

(Currently not supported.) Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_mdns_register_service#

sl_status_t sl_mdns_register_service (sl_mdns_t * mdns, sl_net_interface_t interface, const sl_mdns_service_t * service)

Register a service in mDNS instance.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_mdns_unregister_service#

sl_status_t sl_mdns_unregister_service (const sl_mdns_t * mdns, const sl_mdns_service_query_t * service_query)

Unregister a service from mDNS instance.

(Currently not supported.) Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_mdns_update_service_message#

sl_status_t sl_mdns_update_service_message (const sl_mdns_t * mdns, const sl_mdns_service_query_t * service_query, const char * message, uint32_t message_length)

Update service message of a service in mDNS instance.

(Currently not supported.) Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_mdns_service_discovery_start#

sl_status_t sl_mdns_service_discovery_start (const sl_mdns_t * mdns, sl_net_interface_t interface, const sl_mdns_service_query_t * service_query)

Initiates mDNS service discovery on the specified network interface.

This is an asynchronous API. Discovery results are delivered via the registered mDNS event callback.

The discovery process queries for a specific DNS record type using the provided service query. The query type determines the nature of the response:

• SL_MDNS_QUERY_TYPE_PTR → Returns service instance name, service type, and protocol.

• SL_MDNS_QUERY_TYPE_SRV → Returns target hostname and port for a given instance name.

• SL_MDNS_QUERY_TYPE_A → Returns IPv4 address for a given hostname.

• SL_MDNS_QUERY_TYPE_AAAA → Returns IPv6 address for a given hostname.

• SL_MDNS_QUERY_TYPE_TXT → Returns metadata (key-value pairs) for a given service instance.

• SL_MDNS_QUERY_TYPE_ANY → Returns all available record types. For broad discovery, use service type _services._dns-sd._udp.local. to enumerate available services via PTR records.

Note

• • For SRV, A, AAAA, and TXT queries, the service_type field must be set to the instance name or hostname as appropriate.

  • For PTR queries, service_type must be set to the service type, e.g., _http._tcp.local..

  • Minimum timeout value must be greater than 250 ms.

  • Internal stop handler is triggered automatically after 5 seconds of inactivity.

  • sl_mdns_register_service() must be called before initiating discovery.

  • mDNS works best with the DTIM-based power save method. Performance issues may be observed with the listen interval-based power save method due to multicast packet loss.

Returns

• Returns SL_STATUS_IN_PROGRESS if the discovery request was successfully initiated, or an appropriate error code from sl_status_t.

Note

• Discovery results are received asynchronously via the registered mDNS event handler.

sl_mdns_service_discovery_stop#

sl_status_t sl_mdns_service_discovery_stop (const sl_mdns_t * mdns, const sl_net_interface_t interface)

Stops an ongoing mDNS service discovery operation on the specified network interface.

This is a synchronous API and is used to explicitly terminate the discovery process from the host side.

This function halts any active discovery initiated via sl_mdns_service_discovery_start. It is typically used when the application no longer requires discovery results or wants to cancel the operation early.

Returns

• Returns SL_STATUS_OK if the discovery was successfully stopped, or an appropriate error code from sl_status_t.