Files
led-driver/managed_components/espressif__mdns/private_include/mdns_browser.h
T
jimmyandClaude Haiku 5.5 4cd3bc7973 feat: DDP frame sync over UDP broadcast, DDP acks, DDP enable setting
- 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>
2026-11-11 14:10:55 +13:00

102 lines
3.4 KiB
C

/*
* SPDX-FileCopyrightText: 2025-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
#pragma once
#include <stddef.h>
#include "mdns_private.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Free browse item queue
*
* @note Called from mdns_free()
*/
void mdns_priv_browse_free(void);
/**
* @brief Check if a running browse `_service._proto` exists.
*
* @param service Service name.
* @param proto Protocol name.
* @return true if a running browse `_service._proto` exists, false otherwise.
*/
bool mdns_priv_browse_has_service(const char *service, const char *proto);
/**
* @brief Check if a running browse `_service._proto` with the given subtype exists.
*
* @param service Service name.
* @param proto Protocol name.
* @param subtype Subtype name, or NULL to match browses without subtype.
* @return true if a running browse with identical service, proto and subtype exists, false otherwise.
*/
bool mdns_priv_browse_has_subtype(const char *service, const char *proto, const char *subtype);
/**
* @brief Looks for a running browse item as consumer of the provided record data
*
* @note Called from the packet parser (mdns_receive.c)
*
* @return matching browse item, or NULL if not found
*/
mdns_browse_t *mdns_priv_browse_find_consumer(mdns_name_t *name, uint16_t type, mdns_if_t tcpip_if, mdns_ip_protocol_t ip_protocol);
/**
* @brief Send out browse queries by IP protocol
*
* @note Called from the network events (mdns_netif.c)
* @note Calls (indirectly) search-send from mdns_querier.c, which sends out the query
*/
void mdns_priv_browse_send_by_ip_protocol(mdns_if_t mdns_if, mdns_ip_protocol_t ip_protocol);
/**
* @brief Perform action from mdns service queue
*
* @note Called by `free_action()` and `execute_action()` in mdns_service.c
*/
void mdns_priv_browse_action(mdns_action_t *action, mdns_action_subtype_t type);
/**
* @brief Build temporary result and queue for sync from service cache
*
* @param entry Owner cache entry.
* @param service Updated service cache.
* @param records Bitmask of cache record types to sync.
*
* @note Called from mdns_priv_cache_process_sync() in mdns_cache.c
*
* @return true if all matching browses have been notified about the updated service, false otherwise
*/
bool mdns_priv_browse_update_from_service_cache(const mdns_cache_entry_t *entry, const mdns_service_cache_t *service,
mdns_cache_record_mask_t records);
/**
* @brief Notify one browse about one visible cache service.
*
* @return true if browse is successfully notified, false otherwise
*/
bool mdns_priv_browse_notify_from_service_cache(const mdns_cache_entry_t *entry, const mdns_service_cache_t *service,
mdns_browse_t *browse);
/**
* @brief Notify the affected normal/subtype browse about a PTR goodbye.
*
* @param subtype The PTR subtype, or NULL for the base PTR.
*
* @note Used for both goodbye and natural expiration.
*
* @note Must be called before the PTR/subtype is removed from the cache to avoid UAF.
*/
bool mdns_priv_browse_notify_ptr_goodbye_from_service_cache(const mdns_cache_entry_t *entry,
const mdns_service_cache_t *service,
const char *subtype);
#ifdef __cplusplus
}
#endif