- Driver acks each completed DDP frame; the test waits for the acks before broadcasting the sync. - Sync listener on UDP 4049: a frame is held until the next sync, then shown. - DDP pixels are shown at full brightness, ignoring the device brightness settings. - "DDP and sync receive on" setting (NVS, network API, web UI); off ignores DDP and sync packets. - ddp_test.py: finds devices on the subnet, drives them in lockstep at a fixed rate, runs animations. - /api/ddp reports sync counters for diagnosis. - Includes in-progress WebSocket, multi-driver web UI and Wi-Fi work from the same tree. Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
1201 lines
47 KiB
C
1201 lines
47 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2015-2026 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
#ifndef ESP_MDNS_H_
|
|
#define ESP_MDNS_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "sdkconfig.h"
|
|
#include <esp_netif.h>
|
|
|
|
#define MDNS_TYPE_A 0x0001
|
|
#define MDNS_TYPE_PTR 0x000C
|
|
#define MDNS_TYPE_TXT 0x0010
|
|
#define MDNS_TYPE_AAAA 0x001C
|
|
#define MDNS_TYPE_SRV 0x0021
|
|
#define MDNS_TYPE_OPT 0x0029
|
|
#define MDNS_TYPE_NSEC 0x002F
|
|
#define MDNS_TYPE_ANY 0x00FF
|
|
|
|
#if defined(CONFIG_LWIP_IPV6) && defined(CONFIG_MDNS_RESPOND_REVERSE_QUERIES)
|
|
#define MDNS_NAME_MAX_LEN (64+4) // Need to account for IPv6 reverse queries (64 char address + ".ip6" )
|
|
#else
|
|
#define MDNS_NAME_MAX_LEN 64 // Maximum string length of hostname, instance, service and proto
|
|
#endif
|
|
#define MDNS_NAME_BUF_LEN (MDNS_NAME_MAX_LEN+1) // Maximum char buffer size to hold hostname, instance, service or proto
|
|
|
|
/**
|
|
* @brief Asynchronous query handle
|
|
*/
|
|
typedef struct mdns_search_once_s mdns_search_once_t;
|
|
|
|
/**
|
|
* @brief Daemon query handle
|
|
*/
|
|
typedef struct mdns_browse_s mdns_browse_t;
|
|
|
|
typedef enum {
|
|
MDNS_EVENT_ENABLE_IP4 = 1 << 1,
|
|
MDNS_EVENT_ENABLE_IP6 = 1 << 2,
|
|
MDNS_EVENT_ANNOUNCE_IP4 = 1 << 3,
|
|
MDNS_EVENT_ANNOUNCE_IP6 = 1 << 4,
|
|
MDNS_EVENT_DISABLE_IP4 = 1 << 5,
|
|
MDNS_EVENT_DISABLE_IP6 = 1 << 6,
|
|
MDNS_EVENT_IP4_REVERSE_LOOKUP = 1 << 7,
|
|
MDNS_EVENT_IP6_REVERSE_LOOKUP = 1 << 8,
|
|
} mdns_event_actions_t;
|
|
|
|
/**
|
|
* @brief mDNS enum to specify the ip_protocol type
|
|
*/
|
|
typedef enum {
|
|
MDNS_IP_PROTOCOL_V4,
|
|
MDNS_IP_PROTOCOL_V6,
|
|
MDNS_IP_PROTOCOL_MAX
|
|
} mdns_ip_protocol_t;
|
|
|
|
/**
|
|
* @brief mDNS basic text item structure
|
|
* Used in mdns_service_add()
|
|
*/
|
|
typedef struct {
|
|
const char *key; /*!< item key name */
|
|
const char *value; /*!< item value string */
|
|
} mdns_txt_item_t;
|
|
|
|
/**
|
|
* @brief mDNS basic text item structure, with length of values
|
|
* Suitable for both string and non-string items
|
|
* Used in mdns_service_add_with_explicit_txt_item_value_len()
|
|
*/
|
|
typedef struct {
|
|
const char *key; /*!< item key name */
|
|
const uint8_t *value; /*!< item value */
|
|
uint8_t value_len; /*!< item value length */
|
|
} mdns_txt_item_with_value_len_t;
|
|
|
|
/**
|
|
* @brief mDNS TXT item type, either regular one or with value length
|
|
*/
|
|
typedef enum {
|
|
MDNS_TXT_ITEM,
|
|
MDNS_TXT_ITEM_WITH_VALUE_LEN
|
|
} mdns_txt_item_type_t;
|
|
|
|
/**
|
|
* @brief mDNS basic subtype item structure
|
|
* Used in mdns_service_subtype_xxx() APIs
|
|
*/
|
|
typedef struct {
|
|
const char *subtype; /*!< subtype name */
|
|
} mdns_subtype_item_t;
|
|
|
|
/**
|
|
* @brief mDNS query linked list IP item
|
|
*/
|
|
typedef struct mdns_ip_addr_s {
|
|
esp_ip_addr_t addr; /*!< IP address */
|
|
struct mdns_ip_addr_s *next; /*!< next IP, or NULL for the last IP in the list */
|
|
} mdns_ip_addr_t;
|
|
|
|
/**
|
|
* @brief mDNS query type to be explicitly set to either Unicast or Multicast
|
|
*/
|
|
typedef enum {
|
|
MDNS_QUERY_UNICAST,
|
|
MDNS_QUERY_MULTICAST,
|
|
} mdns_query_transmission_type_t;
|
|
|
|
/**
|
|
* @brief mDNS query result structure
|
|
*/
|
|
typedef struct mdns_result_s {
|
|
struct mdns_result_s *next; /*!< next result, or NULL for the last result in the list */
|
|
|
|
esp_netif_t *esp_netif; /*!< ptr to corresponding esp-netif */
|
|
uint32_t ttl; /*!< time to live */
|
|
|
|
mdns_ip_protocol_t ip_protocol; /*!< ip_protocol type of the interface (v4/v6) */
|
|
// PTR
|
|
char *instance_name; /*!< instance name */
|
|
char *service_type; /*!< service type */
|
|
char *proto; /*!< srevice protocol */
|
|
// SRV
|
|
char *hostname; /*!< hostname */
|
|
uint16_t port; /*!< service port */
|
|
// TXT
|
|
mdns_txt_item_t *txt; /*!< txt record */
|
|
uint8_t *txt_value_len; /*!< array of txt value len of each record */
|
|
size_t txt_count; /*!< number of txt items */
|
|
// A and AAAA
|
|
mdns_ip_addr_t *addr; /*!< linked list of IP addresses found */
|
|
// Browse only
|
|
char *subtype; /*!< browse subtype, or NULL for normal browse */
|
|
} mdns_result_t;
|
|
|
|
typedef void (*mdns_query_notify_t)(mdns_search_once_t *search);
|
|
|
|
/**
|
|
* @brief Browse result change notifier
|
|
*
|
|
* Called once for every matching browse result changed by a received response,
|
|
* or once for every currently cached result when a new browse is registered.
|
|
*
|
|
* The @p result is a temporary projection of the internal mDNS cache, which is only valid
|
|
* during the lifetime of this callback and is freed immediately after the callback returns.
|
|
*
|
|
* @warning @p result->next is always NULL. Other instances cannot be obtained from @p result.
|
|
*
|
|
* @warning If handling is deferred outside this callback, applications must make a deep copy
|
|
* of @p result with all components, including strings, TXT entries, address list, and subtype.
|
|
*
|
|
* @warning This callback runs in the mDNS service task and holds the mDNS service lock.
|
|
* Users must not call APIs that acquire mDNS service lock in this callback.
|
|
* For example, mdns_browse_new() and mdns_browse_delete().
|
|
*
|
|
* @param result Temporary result of the browse that changed.
|
|
*/
|
|
typedef void (*mdns_browse_notify_t)(mdns_result_t *result);
|
|
|
|
/**
|
|
* @brief Hostname change notifier
|
|
*
|
|
* Called from the mDNS service task after the hostname changes.
|
|
* The @p hostname argument is the new hostname. It remains valid until the
|
|
* callback returns.
|
|
*
|
|
* @warning Do not call mDNS APIs from this callback. The callback runs while
|
|
* the mDNS service is processing an action.
|
|
*
|
|
* @param hostname The new responder hostname.
|
|
* @param arg User context supplied when registering the callback.
|
|
*/
|
|
typedef void (*mdns_hostname_changed_cb_t)(const char *hostname, void *arg);
|
|
|
|
/**
|
|
* @brief Initialize mDNS on given interface
|
|
*
|
|
* @return
|
|
* - ESP_OK on success
|
|
* - ESP_ERR_INVALID_STATE when failed to register event handler
|
|
* - ESP_ERR_NO_MEM on memory error
|
|
* - ESP_FAIL when failed to start mdns task
|
|
*/
|
|
esp_err_t mdns_init(void);
|
|
|
|
/**
|
|
* @brief Stop and free mDNS server
|
|
*
|
|
*/
|
|
void mdns_free(void);
|
|
|
|
/**
|
|
* @brief Set the hostname for mDNS server
|
|
* required if you want to advertise services
|
|
*
|
|
* @param hostname Hostname to set
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_hostname_set(const char *hostname);
|
|
|
|
/**
|
|
* @brief Register a callback notified when the hostname changes
|
|
*
|
|
* Multiple callbacks can be registered. Registering the same callback and
|
|
* context more than once has no effect. Callbacks cannot be unregistered and
|
|
* remain registered until mdns_free() is called.
|
|
*
|
|
* @param cb Callback to invoke when the hostname changes.
|
|
* @param arg User context passed to @p cb.
|
|
*
|
|
* @return
|
|
* - ESP_OK on success
|
|
* - ESP_ERR_INVALID_STATE when mDNS is not initialized
|
|
* - ESP_ERR_INVALID_ARG when @p cb is NULL
|
|
* - ESP_ERR_NO_MEM when the callback cannot be registered
|
|
*/
|
|
esp_err_t mdns_register_hostname_changed_callback(mdns_hostname_changed_cb_t cb, void *arg);
|
|
|
|
/**
|
|
* @brief Get the hostname for mDNS server
|
|
*
|
|
* @param hostname pointer to the hostname, it should be allocated
|
|
* and hold at least MDNS_NAME_BUF_LEN chars
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_INVALID_STATE when mdns is not initialized
|
|
*/
|
|
esp_err_t mdns_hostname_get(char *hostname);
|
|
|
|
/**
|
|
* @brief Adds a hostname and address to be delegated
|
|
* A/AAAA queries will be replied for the hostname and
|
|
* services can be added to this host.
|
|
*
|
|
* @param hostname Hostname to add
|
|
* @param address_list The IP address list of the host
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*
|
|
*/
|
|
esp_err_t mdns_delegate_hostname_add(const char *hostname, const mdns_ip_addr_t *address_list);
|
|
|
|
/**
|
|
* @brief Set the address to a delegated hostname
|
|
*
|
|
* @param hostname Hostname to set
|
|
* @param address_list The IP address list of the host
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*
|
|
*/
|
|
esp_err_t mdns_delegate_hostname_set_address(const char *hostname, const mdns_ip_addr_t *address_list);
|
|
|
|
/**
|
|
* @brief Remove a delegated hostname
|
|
* All the services added to this host will also be removed.
|
|
*
|
|
* @param hostname Hostname to remove
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*
|
|
*/
|
|
esp_err_t mdns_delegate_hostname_remove(const char *hostname);
|
|
|
|
/**
|
|
* @brief Query whether a hostname has been added
|
|
*
|
|
* @param hostname Hostname to query
|
|
*
|
|
* @return
|
|
* - true The hostname has been added.
|
|
* - false The hostname has not been added.
|
|
*
|
|
*/
|
|
bool mdns_hostname_exists(const char *hostname);
|
|
|
|
/**
|
|
* @brief Set the default instance name for mDNS server
|
|
*
|
|
* @param instance_name Instance name to set
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_instance_name_set(const char *instance_name);
|
|
|
|
/**
|
|
* @brief Add service to mDNS server
|
|
*
|
|
* @note The value length of txt items will be automatically decided by strlen
|
|
*
|
|
* @param instance_name instance name to set. If NULL,
|
|
* global instance name or hostname will be used.
|
|
* Note that MDNS_MULTIPLE_INSTANCE config option
|
|
* needs to be enabled for adding multiple instances
|
|
* with the same instance type.
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param port service port
|
|
* @param txt string array of TXT data (eg. {{"var","val"},{"other","2"}})
|
|
* @param num_items number of items in TXT data
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_FAIL failed to add service
|
|
*/
|
|
esp_err_t mdns_service_add(const char *instance_name, const char *service_type, const char *proto, uint16_t port, mdns_txt_item_t txt[], size_t num_items);
|
|
|
|
/**
|
|
* @brief Add service to mDNS server with a delegated hostname
|
|
*
|
|
* @note The value length of txt items will be automatically decided by strlen
|
|
*
|
|
* @param instance_name instance name to set. If NULL,
|
|
* global instance name or hostname will be used
|
|
* Note that MDNS_MULTIPLE_INSTANCE config option
|
|
* needs to be enabled for adding multiple instances
|
|
* with the same instance type.
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param port service port
|
|
* @param txt string array of TXT data (eg. {{"var","val"},{"other","2"}})
|
|
* @param num_items number of items in TXT data
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_FAIL failed to add service
|
|
*/
|
|
esp_err_t mdns_service_add_for_host(const char *instance_name, const char *service_type, const char *proto,
|
|
const char *hostname, uint16_t port, mdns_txt_item_t txt[], size_t num_items);
|
|
|
|
/**
|
|
* @brief Add service to mDNS server
|
|
*
|
|
* @note The value length of txt items should be configured in structures
|
|
*
|
|
* @param instance_name instance name to set. If NULL,
|
|
* global instance name or hostname will be used.
|
|
* Note that MDNS_MULTIPLE_INSTANCE config option
|
|
* needs to be enabled for adding multiple instances
|
|
* with the same instance type.
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param port service port
|
|
* @param txt array of TXT data with value length (eg. {{"var", "val", 3},{"other", "2", 1}})
|
|
* @param num_items number of items in TXT data
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_FAIL failed to add service
|
|
*/
|
|
esp_err_t mdns_service_add_with_explicit_txt_item_value_len(const char *instance_name, const char *service_type, const char *proto, uint16_t port, mdns_txt_item_with_value_len_t txt[], size_t num_items);
|
|
|
|
/**
|
|
* @brief Add service to mDNS server with a delegated hostname
|
|
*
|
|
* @note The value length of txt items should be configured in structures
|
|
*
|
|
* @param instance_name instance name to set. If NULL,
|
|
* global instance name or hostname will be used
|
|
* Note that MDNS_MULTIPLE_INSTANCE config option
|
|
* needs to be enabled for adding multiple instances
|
|
* with the same instance type.
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param port service port
|
|
* @param txt array of TXT data with value length (eg. {{"var", "val", 3},{"other", "2", 1}})
|
|
* @param num_items number of items in TXT data
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_FAIL failed to add service
|
|
*/
|
|
esp_err_t mdns_service_add_for_host_with_explicit_txt_item_value_len(const char *instance_name, const char *service_type, const char *proto,
|
|
const char *hostname, uint16_t port, mdns_txt_item_with_value_len_t txt[], size_t num_items);
|
|
|
|
/**
|
|
* @brief Check whether a service has been added.
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, checks for the local hostname.
|
|
*
|
|
* @return
|
|
* - true Correspondding service has been added.
|
|
* - false Service not found.
|
|
*/
|
|
bool mdns_service_exists(const char *service_type, const char *proto, const char *hostname);
|
|
|
|
/**
|
|
* @brief Check whether a service has been added.
|
|
*
|
|
* @param instance instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, checks for the local hostname.
|
|
*
|
|
* @return
|
|
* - true Correspondding service has been added.
|
|
* - false Service not found.
|
|
*/
|
|
bool mdns_service_exists_with_instance(const char *instance, const char *service_type, const char *proto,
|
|
const char *hostname);
|
|
|
|
/**
|
|
* @brief Remove service from mDNS server
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_remove(const char *service_type, const char *proto);
|
|
|
|
/**
|
|
* @brief Remove service from mDNS server with hostname
|
|
*
|
|
* @param instance instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_remove_for_host(const char *instance, const char *service_type, const char *proto, const char *hostname);
|
|
|
|
/**
|
|
* @brief Set instance name for service
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param instance_name instance name to set
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_instance_name_set(const char *service_type, const char *proto, const char *instance_name);
|
|
|
|
/**
|
|
* @brief Set instance name for service with hostname
|
|
*
|
|
* @param instance_old original instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param instance_name instance name to set
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_instance_name_set_for_host(const char *instance_old, const char *service_type, const char *proto, const char *hostname,
|
|
const char *instance_name);
|
|
|
|
/**
|
|
* @brief Set service port
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param port service port
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_port_set(const char *service_type, const char *proto, uint16_t port);
|
|
|
|
|
|
/**
|
|
* @brief Set service port with hostname
|
|
*
|
|
* @param instance instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param port service port
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_port_set_for_host(const char *instance, const char *service_type, const char *proto, const char *hostname,
|
|
uint16_t port);
|
|
|
|
/**
|
|
* @brief Replace all TXT items for service
|
|
*
|
|
* @note The value length of txt items will be automatically decided by strlen
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param txt array of TXT data (eg. {{"var","val"},{"other","2"}})
|
|
* @param num_items number of items in TXT data
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_set(const char *service_type, const char *proto, mdns_txt_item_t txt[], uint8_t num_items);
|
|
|
|
/**
|
|
* @brief Replace all TXT items for service with hostname
|
|
*
|
|
* @note The value length of txt items will be automatically decided by strlen
|
|
*
|
|
* @param instance instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param txt array of TXT data (eg. {{"var","val"},{"other","2"}})
|
|
* @param num_items number of items in TXT data
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_set_for_host(const char *instance, const char *service_type, const char *proto, const char *hostname,
|
|
mdns_txt_item_t txt[], uint8_t num_items);
|
|
|
|
/**
|
|
* @brief Replace all TXT items for service
|
|
*
|
|
* @note The value length of txt items should be configured in structures
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param txt array of TXT data with value length (eg. {{"var", "val", 3},{"other", "2", 1}})
|
|
* @param num_items number of items in TXT data
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_set_with_explicit_txt_item_value_len(const char *service_type, const char *proto, mdns_txt_item_with_value_len_t txt[], uint8_t num_items);
|
|
|
|
/**
|
|
* @brief Replace all TXT items for service with hostname
|
|
*
|
|
* @note The value length of txt items should be configured in structures
|
|
*
|
|
* @param instance instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param txt array of TXT data with value length (eg. {{"var", "val", 3},{"other", "2", 1}})
|
|
* @param num_items number of items in TXT data
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_set_for_host_with_explicit_txt_item_value_len(const char *instance, const char *service_type, const char *proto, const char *hostname,
|
|
mdns_txt_item_with_value_len_t txt[], uint8_t num_items);
|
|
|
|
/**
|
|
* @brief Set/Add TXT item for service TXT record
|
|
*
|
|
* @note The value length will be automatically decided by strlen
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param key the key that you want to add/update
|
|
* @param value the new value of the key
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_item_set(const char *service_type, const char *proto, const char *key, const char *value);
|
|
|
|
/**
|
|
* @brief Set/Add TXT item for service TXT record
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param key the key that you want to add/update
|
|
* @param value the new value of the key
|
|
* @param value_len the length of the value
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_item_set_with_explicit_value_len(const char *service_type, const char *proto,
|
|
const char *key, const char *value, uint8_t value_len);
|
|
|
|
/**
|
|
* @brief Set/Add TXT item for service TXT record with hostname
|
|
*
|
|
* @note The value length will be automatically decided by strlen
|
|
*
|
|
* @param instance instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param key the key that you want to add/update
|
|
* @param value the new value of the key
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_item_set_for_host(const char *instance, const char *service_type, const char *proto, const char *hostname,
|
|
const char *key, const char *value);
|
|
|
|
/**
|
|
* @brief Set/Add TXT item for service TXT record with hostname and txt value length
|
|
*
|
|
* @param instance instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param key the key that you want to add/update
|
|
* @param value the new value of the key
|
|
* @param value_len the length of the value
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_item_set_for_host_with_explicit_value_len(const char *instance, const char *service_type, const char *proto,
|
|
const char *hostname, const char *key,
|
|
const char *value, uint8_t value_len);
|
|
|
|
/**
|
|
* @brief Remove TXT item for service TXT record
|
|
*
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param key the key that you want to remove
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_item_remove(const char *service_type, const char *proto, const char *key);
|
|
|
|
/**
|
|
* @brief Remove TXT item for service TXT record with hostname
|
|
*
|
|
* @param instance instance name
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param key the key that you want to remove
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_txt_item_remove_for_host(const char *instance, const char *service_type, const char *proto, const char *hostname,
|
|
const char *key);
|
|
|
|
/**
|
|
* @brief Add a subtype for service.
|
|
*
|
|
* @param instance_name instance name. If NULL, will find the first service with the same service type and protocol.
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param subtype The subtype to add.
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_subtype_add_for_host(const char *instance_name, const char *service_type, const char *proto,
|
|
const char *hostname, const char *subtype);
|
|
|
|
/**
|
|
* @brief Remove a subtype for service.
|
|
*
|
|
* @param instance_name instance name. If NULL, will find the first service with the same service type and protocol.
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param subtype The subtype to remove.
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
*/
|
|
esp_err_t mdns_service_subtype_remove_for_host(const char *instance_name, const char *service_type, const char *proto,
|
|
const char *hostname, const char *subtype);
|
|
|
|
/**
|
|
* @brief Add multiple subtypes for service at once.
|
|
*
|
|
* @param instance_name instance name. If NULL, will find the first service with the same service type and protocol.
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param subtype the pointer of subtype array to add.
|
|
* @param num_items number of items in subtype array
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_subtype_add_multiple_items_for_host(const char *instance_name, const char *service_type, const char *proto,
|
|
const char *hostname, mdns_subtype_item_t subtype[], uint8_t num_items);
|
|
|
|
/**
|
|
* @brief Update subtype for service.
|
|
*
|
|
* @param instance_name instance name. If NULL, will find the first service with the same service type and protocol.
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param hostname service hostname. If NULL, local hostname will be used.
|
|
* @param subtype the pointer of subtype array to add.
|
|
* @param num_items number of items in subtype array
|
|
*
|
|
* @note If `num_items` is 0, then remove all subtypes.
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
* - ESP_ERR_NOT_FOUND Service not found
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_service_subtype_update_multiple_items_for_host(const char *instance_name, const char *service_type, const char *proto,
|
|
const char *hostname, mdns_subtype_item_t subtype[], uint8_t num_items);
|
|
/**
|
|
* @brief Remove and free all services from mDNS server
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
*/
|
|
esp_err_t mdns_service_remove_all(void);
|
|
|
|
/**
|
|
* @brief Deletes the finished query. Call this only after the search has ended!
|
|
*
|
|
* @param search pointer to search object
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE search has not finished
|
|
* - ESP_ERR_INVALID_ARG pointer to search object is NULL
|
|
*/
|
|
esp_err_t mdns_query_async_delete(mdns_search_once_t *search);
|
|
|
|
/**
|
|
* @brief Get results from search pointer. Results available as a pointer to the output parameter.
|
|
* Pointer to search object has to be deleted via `mdns_query_async_delete` once the query has finished.
|
|
* The results although have to be freed manually.
|
|
*
|
|
* @param search pointer to search object
|
|
* @param timeout time in milliseconds to wait for answers
|
|
* @param results pointer to the results of the query
|
|
* @param num_results pointer to the number of the actual result items (set to NULL to ignore this return value)
|
|
*
|
|
* @return
|
|
* True if search has finished before or at timeout
|
|
* False if search timeout is over
|
|
*/
|
|
bool mdns_query_async_get_results(mdns_search_once_t *search, uint32_t timeout, mdns_result_t **results, uint8_t *num_results);
|
|
|
|
/**
|
|
* @brief Query mDNS for host or service asynchronousely.
|
|
* Search has to be tested for progress and deleted manually!
|
|
*
|
|
* @param name service instance or host name (NULL for PTR queries)
|
|
* @param service_type service type (_http, _arduino, _ftp etc.) (NULL for host queries)
|
|
* @param proto service protocol (_tcp, _udp, etc.) (NULL for host queries)
|
|
* @param type type of query (MDNS_TYPE_*)
|
|
* @param timeout time in milliseconds during which mDNS query is active
|
|
* @param max_results maximum results to be collected
|
|
* @param notifier Notification function to be called when the result is ready, can be NULL
|
|
*
|
|
* @return mdns_search_once_s pointer to new search object if query initiated successfully.
|
|
* NULL otherwise.
|
|
*/
|
|
mdns_search_once_t *mdns_query_async_new(const char *name, const char *service_type, const char *proto, uint16_t type,
|
|
uint32_t timeout, size_t max_results, mdns_query_notify_t notifier);
|
|
|
|
/**
|
|
* @brief Generic mDNS query
|
|
* All following query methods are derived from this one
|
|
*
|
|
* @param name service instance or host name (NULL for PTR queries)
|
|
* @param service_type service type (_http, _arduino, _ftp etc.) (NULL for host queries)
|
|
* @param proto service protocol (_tcp, _udp, etc.) (NULL for host queries)
|
|
* @param type type of query (MDNS_TYPE_*)
|
|
* @param transmission_type either Unicast query, or Multicast query
|
|
* @param timeout time in milliseconds to wait for answers.
|
|
* @param max_results maximum results to be collected
|
|
* @param results pointer to the results of the query
|
|
* results must be freed using mdns_query_results_free below
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG timeout was not given
|
|
*/
|
|
esp_err_t mdns_query_generic(const char *name, const char *service_type, const char *proto, uint16_t type,
|
|
mdns_query_transmission_type_t transmission_type, uint32_t timeout, size_t max_results, mdns_result_t **results);
|
|
|
|
/**
|
|
* @brief Query mDNS for host or service
|
|
*
|
|
* Note that querying PTR types sends Multicast query, all other types send Unicast queries
|
|
*
|
|
* @param name service instance or host name (NULL for PTR queries)
|
|
* @param service_type service type (_http, _arduino, _ftp etc.) (NULL for host queries)
|
|
* @param proto service protocol (_tcp, _udp, etc.) (NULL for host queries)
|
|
* @param type type of query (MDNS_TYPE_*)
|
|
* @param timeout time in milliseconds to wait for answers.
|
|
* @param max_results maximum results to be collected
|
|
* @param results pointer to the results of the query
|
|
* results must be freed using mdns_query_results_free below
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG timeout was not given
|
|
*/
|
|
esp_err_t mdns_query(const char *name, const char *service_type, const char *proto, uint16_t type, uint32_t timeout, size_t max_results, mdns_result_t **results);
|
|
|
|
/**
|
|
* @brief Free query results
|
|
*
|
|
* @param results linked list of results to be freed
|
|
*/
|
|
void mdns_query_results_free(mdns_result_t *results);
|
|
|
|
/**
|
|
* @brief Query mDNS for service
|
|
*
|
|
* @param service_type service type (_http, _arduino, _ftp etc.)
|
|
* @param proto service protocol (_tcp, _udp, etc.)
|
|
* @param timeout time in milliseconds to wait for answer.
|
|
* @param max_results maximum results to be collected
|
|
* @param results pointer to the results of the query
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_query_ptr(const char *service_type, const char *proto, uint32_t timeout, size_t max_results, mdns_result_t **results);
|
|
|
|
/**
|
|
* @brief Query mDNS for SRV record
|
|
*
|
|
* @param instance_name service instance name
|
|
* @param service_type service type (_http, _arduino, _ftp etc.)
|
|
* @param proto service protocol (_tcp, _udp, etc.)
|
|
* @param timeout time in milliseconds to wait for answer.
|
|
* @param result pointer to the result of the query
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_query_srv(const char *instance_name, const char *service_type, const char *proto, uint32_t timeout, mdns_result_t **result);
|
|
|
|
/**
|
|
* @brief Query mDNS for TXT record
|
|
*
|
|
* @param instance_name service instance name
|
|
* @param service_type service type (_http, _arduino, _ftp etc.)
|
|
* @param proto service protocol (_tcp, _udp, etc.)
|
|
* @param timeout time in milliseconds to wait for answer.
|
|
* @param result pointer to the result of the query
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_query_txt(const char *instance_name, const char *service_type, const char *proto, uint32_t timeout, mdns_result_t **result);
|
|
|
|
/**
|
|
* @brief Look up delegated services.
|
|
*
|
|
* @param instance instance name (NULL for uncertain instance)
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param max_results maximum results to be collected
|
|
* @param result pointer to the result of the search
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_lookup_delegated_service(const char *instance, const char *service_type, const char *proto, size_t max_results,
|
|
mdns_result_t **result);
|
|
|
|
/**
|
|
* @brief Look up delegated services with a particular subtype.
|
|
*
|
|
* @param instance instance name (NULL for uncertain instance)
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param subtype service subtype (must not be NULL or empty)
|
|
* @param max_results maximum results to be collected
|
|
* @param result pointer to the result of the search
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_lookup_delegated_service_with_subtype(const char *instance, const char *service_type, const char *proto,
|
|
const char *subtype, size_t max_results, mdns_result_t **result);
|
|
|
|
/**
|
|
* @brief Look up self hosted services.
|
|
*
|
|
* @param instance instance name (NULL for uncertain instance)
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param max_results maximum results to be collected
|
|
* @param result pointer to the result of the search
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_lookup_selfhosted_service(const char *instance, const char *service_type, const char *proto, size_t max_results,
|
|
mdns_result_t **result);
|
|
|
|
/**
|
|
* @brief Look up self hosted services with a particular subtype.
|
|
*
|
|
* @param instance instance name (NULL for uncertain instance)
|
|
* @param service_type service type (_http, _ftp, etc)
|
|
* @param proto service protocol (_tcp, _udp)
|
|
* @param subtype service subtype (must not be NULL or empty)
|
|
* @param max_results maximum results to be collected
|
|
* @param result pointer to the result of the search
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_lookup_selfhosted_service_with_subtype(const char *instance, const char *service_type, const char *proto,
|
|
const char *subtype, size_t max_results, mdns_result_t **result);
|
|
|
|
/**
|
|
* @brief Query mDNS for A record
|
|
*
|
|
* @param host_name host name to look for
|
|
* @param timeout time in milliseconds to wait for answer.
|
|
* @param addr pointer to the resulting IP4 address
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_query_a(const char *host_name, uint32_t timeout, esp_ip4_addr_t *addr);
|
|
|
|
#if CONFIG_LWIP_IPV6
|
|
/**
|
|
* @brief Query mDNS for A record
|
|
*
|
|
* Please note that hostname must not contain domain name, as mDNS uses '.local' domain.
|
|
*
|
|
* @param host_name host name to look for
|
|
* @param timeout time in milliseconds to wait for answer. If 0, max_results needs to be defined
|
|
* @param addr pointer to the resulting IP6 address
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NO_MEM memory error
|
|
* - ESP_ERR_INVALID_ARG parameter error
|
|
*/
|
|
esp_err_t mdns_query_aaaa(const char *host_name, uint32_t timeout, esp_ip6_addr_t *addr);
|
|
#endif
|
|
|
|
|
|
/**
|
|
* @brief Register custom esp_netif with mDNS functionality
|
|
* mDNS service runs by default on preconfigured interfaces (STA, AP, ETH).
|
|
* This API enables running the service on any customized interface,
|
|
* either using standard WiFi or Ethernet driver or any kind of user defined driver.
|
|
*
|
|
* @param esp_netif Pointer to esp-netif interface
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running or this netif is already registered
|
|
* - ESP_ERR_NO_MEM not enough memory for this in interface in the netif list (see CONFIG_MDNS_MAX_INTERFACES)
|
|
*/
|
|
esp_err_t mdns_register_netif(esp_netif_t *esp_netif);
|
|
|
|
/**
|
|
* @brief Unregister esp-netif already registered in mDNS service
|
|
*
|
|
* @param esp_netif Pointer to esp-netif interface
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running
|
|
* - ESP_ERR_NOT_FOUND this esp-netif was not registered in mDNS service
|
|
*/
|
|
esp_err_t mdns_unregister_netif(esp_netif_t *esp_netif);
|
|
|
|
/**
|
|
* @brief Set esp_netif to a desired state, or perform a desired action, such as enable/disable this interface
|
|
* or send announcement packets to this netif
|
|
*
|
|
* * This function is used to enable (probe, resolve conflicts and announce), announce, or disable (send bye) mDNS
|
|
* services on the specified network interface.
|
|
* * This function must be called if users registers a specific interface using mdns_register_netif()
|
|
* to enable mDNS services on that interface.
|
|
* * This function could be used in IP/connection event handlers to automatically enable/announce mDNS services
|
|
* when network properties change and/or disable them on disconnection.
|
|
*
|
|
* @param esp_netif Pointer to esp-netif interface
|
|
* @param event_action Disable/Enable/Announce on this interface over IPv4/IPv6 protocol.
|
|
* Actions enumerated in mdns_event_actions_t type.
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_STATE mDNS is not running or this netif is not registered
|
|
* - ESP_ERR_NO_MEM memory error
|
|
*/
|
|
esp_err_t mdns_netif_action(esp_netif_t *esp_netif, mdns_event_actions_t event_action);
|
|
|
|
#ifdef CONFIG_MDNS_ENABLE_BROWSE
|
|
/**
|
|
* @brief Browse mDNS for a service `_service._proto`.
|
|
*
|
|
* @param service Pointer to the `_service` which will be browsed.
|
|
* @param proto Pointer to the `_proto` which will be browsed.
|
|
* @param notifier The callback which will be called when a browse result changes.
|
|
* See @ref mdns_browse_notify_t for callback semantics and limitations.
|
|
* @return mdns_browse_t pointer to new browse object if initiated successfully.
|
|
* NULL otherwise.
|
|
*
|
|
* @note If matching services already present in the internal mDNS cache,
|
|
* the notifier will be called once for each cached service after this browse
|
|
* is registered.
|
|
*
|
|
* @note The notifier receives a temporary result that is valid only during the callback.
|
|
* See @ref mdns_browse_notify_t for ownership and lifetime details.
|
|
*
|
|
* @note Available when CONFIG_MDNS_ENABLE_BROWSE is enabled (default); can be disabled to reduce binary size.
|
|
*
|
|
* @warning This function acquires the mDNS service lock and must not be called from the mDNS service task.
|
|
*/
|
|
mdns_browse_t *mdns_browse_new(const char *service, const char *proto, mdns_browse_notify_t notifier);
|
|
|
|
/**
|
|
* @brief Browse mDNS for a service subtype `_subtype._sub._service._proto`
|
|
* (Selective Instance Enumeration per RFC 6763 Section 7.1).
|
|
*
|
|
* @param service Pointer to the `_service` which will be browsed.
|
|
* @param proto Pointer to the `_proto` which will be browsed.
|
|
* @param subtype Pointer to the `_subtype` to restrict browsing to. Pass in NULL or empty string for standard browse.
|
|
* @param notifier The callback which will be called when the browsing service changed.
|
|
* @return mdns_browse_t pointer to new browse object if initiated successfully.
|
|
* NULL otherwise.
|
|
*
|
|
* @note If matching services already present in the internal mDNS cache,
|
|
* the notifier will be called once for each cached service after this browse
|
|
* is registered.
|
|
*
|
|
* @note The notifier receives a temporary result that is valid only during the callback.
|
|
* See @ref mdns_browse_notify_t for ownership and lifetime details.
|
|
*
|
|
* @note Passing in "_sub" to `subtype` is currently unsupported due to a limitation in mDNS name parser.
|
|
* Browsing this subtype will not obtain PTR record until this issue is fixed.
|
|
*
|
|
* @note Available when CONFIG_MDNS_ENABLE_BROWSE is enabled (default); can be disabled to reduce binary size.
|
|
*
|
|
* @warning This function acquires the mDNS service lock and must not be called from the mDNS service task.
|
|
*/
|
|
mdns_browse_t *mdns_browse_new_with_subtype(const char *service, const char *proto, const char *subtype, mdns_browse_notify_t notifier);
|
|
|
|
/**
|
|
* @brief Stop the `_service._proto` browse.
|
|
* @param service Pointer to the `_service` which will be browsed.
|
|
* @param proto Pointer to the `_proto` which will be browsed.
|
|
* @return
|
|
* - ESP_OK success.
|
|
* - ESP_FAIL mDNS is not running or the browsing of `_service._proto` is never started.
|
|
* - ESP_ERR_NO_MEM memory error.
|
|
*
|
|
* @note Available when CONFIG_MDNS_ENABLE_BROWSE is enabled (default); can be disabled to reduce binary size.
|
|
*
|
|
* @warning This function acquires the mDNS service lock and must not be called from the mDNS service task.
|
|
*/
|
|
esp_err_t mdns_browse_delete(const char *service, const char *proto);
|
|
|
|
/**
|
|
* @brief Stop the `_subtype._sub._service._proto` browse.
|
|
* @param service Pointer to the `_service` which will be browsed.
|
|
* @param proto Pointer to the `_proto` which will be browsed.
|
|
* @param subtype Pointer to the `_subtype`. Can be NULL to match a browse without subtype.
|
|
* @return
|
|
* - ESP_OK success.
|
|
* - ESP_FAIL mDNS is not running or the browsing was never started.
|
|
* - ESP_ERR_NO_MEM memory error.
|
|
*
|
|
* @note Available when CONFIG_MDNS_ENABLE_BROWSE is enabled (default); can be disabled to reduce binary size.
|
|
*
|
|
* @warning This function acquires the mDNS service lock and must not be called from the mDNS service task.
|
|
*/
|
|
esp_err_t mdns_browse_delete_with_subtype(const char *service, const char *proto, const char *subtype);
|
|
#endif /* CONFIG_MDNS_ENABLE_BROWSE */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* ESP_MDNS_H_ */
|