- 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>
102 lines
3.4 KiB
C
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
|