Files
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

192 lines
5.9 KiB
Python

#!/usr/bin/env python3
# SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
# SPDX-License-Identifier: Unlicense OR CC0-1.0
"""Controlled mDNS peer for host querier tests (A / SRV only).
Answers only the configured hostname A and instance SRV questions. Ignores all
other traffic so system mDNS probes cannot create an answer storm.
"""
from __future__ import annotations
import argparse
import logging
import socket
import struct
import sys
import dns.flags
import dns.message
import dns.name
import dns.rdataclass
import dns.rdatatype
import dns.rrset
logging.basicConfig(level=logging.INFO, format='%(asctime)s %(levelname)s %(message)s')
logger = logging.getLogger(__name__)
MDNS_ADDR = '224.0.0.251'
MDNS_PORT = 5353
DEFAULTS = {
'hostname': 'tinytester',
'ipv4': '127.0.0.1',
'instance': 'ESP32',
'service': '_http',
'proto': '_tcp',
'port': 100,
}
def _fqdn(*labels: str) -> str:
return '.'.join(labels) + '.local.'
def create_socket(interface: str | None) -> socket.socket:
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
try:
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1)
except (AttributeError, OSError):
pass
if interface:
sock.setsockopt(socket.SOL_SOCKET, socket.SO_BINDTODEVICE, interface.encode() + b'\0')
sock.bind(('', MDNS_PORT))
membership = struct.pack('=4s4s', socket.inet_aton(MDNS_ADDR), socket.inet_aton('0.0.0.0'))
sock.setsockopt(socket.IPPROTO_IP, socket.IP_ADD_MEMBERSHIP, membership)
return sock
def build_a_response(query: dns.message.Message, hostname: str, ipv4: str) -> dns.message.Message:
host_name = _fqdn(hostname)
# Exact QR|AA (0x8400). dnspython make_response also sets RD, which is fine for
# answer parsing but keep mDNS-shaped packets consistent with bonjour fixtures.
response = dns.message.Message(id=query.id)
response.flags = dns.flags.QR | dns.flags.AA
response.answer.append(
dns.rrset.from_text(host_name, 120, dns.rdataclass.IN, dns.rdatatype.A, ipv4)
)
return response
def build_srv_response(
query: dns.message.Message,
*,
instance: str,
service: str,
proto: str,
hostname: str,
port: int,
ipv4: str,
) -> dns.message.Message:
instance_name = _fqdn(instance, service, proto)
host_name = _fqdn(hostname)
response = dns.message.Message(id=query.id)
response.flags = dns.flags.QR | dns.flags.AA
response.answer.append(
dns.rrset.from_text(
instance_name,
120,
dns.rdataclass.IN,
dns.rdatatype.SRV,
f'0 0 {port} {host_name}',
)
)
response.additional.append(
dns.rrset.from_text(host_name, 120, dns.rdataclass.IN, dns.rdatatype.A, ipv4)
)
return response
def match_question(query: dns.message.Message, args: argparse.Namespace):
host_name = dns.name.from_text(_fqdn(args.hostname))
instance_name = dns.name.from_text(_fqdn(args.instance, args.service, args.proto))
for question in query.question:
if question.rdtype == dns.rdatatype.A and question.name == host_name:
return 'A'
if question.rdtype == dns.rdatatype.SRV and question.name == instance_name:
return 'SRV'
return None
def send_response(sock: socket.socket, payload: bytes, source: tuple[str, int]) -> None:
# mDNS queries usually come from port 5353 → multicast reply; one-shot dig uses ephemeral ports.
destination = (MDNS_ADDR, MDNS_PORT) if source[1] == MDNS_PORT else source
sock.sendto(payload, destination)
logger.info('Sent %d byte response to %s (from %s:%d)', len(payload), destination, *source)
def serve(args: argparse.Namespace) -> None:
sock = create_socket(args.interface)
logger.info(
'Querier responder on %s:%d (%s): A %s.local -> %s; SRV %s.%s.%s.local -> %s.local:%d',
MDNS_ADDR,
MDNS_PORT,
args.interface or 'all interfaces',
args.hostname,
args.ipv4,
args.instance,
args.service,
args.proto,
args.hostname,
args.port,
)
while True:
try:
data, source = sock.recvfrom(9000)
except KeyboardInterrupt:
logger.info('Stopping querier responder')
break
try:
query = dns.message.from_wire(data)
except Exception as exc: # noqa: BLE001
logger.debug('Ignoring non-DNS payload from %s:%d (%s)', source[0], source[1], exc)
continue
if query.flags & dns.flags.QR:
continue
kind = match_question(query, args)
if kind == 'A':
response = build_a_response(query, args.hostname, args.ipv4)
elif kind == 'SRV':
response = build_srv_response(
query,
instance=args.instance,
service=args.service,
proto=args.proto,
hostname=args.hostname,
port=args.port,
ipv4=args.ipv4,
)
else:
continue
send_response(sock, response.to_wire(), source)
def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--interface', default='eth0')
parser.add_argument('--hostname', default=DEFAULTS['hostname'])
parser.add_argument('--ipv4', default=DEFAULTS['ipv4'])
parser.add_argument('--instance', default=DEFAULTS['instance'])
parser.add_argument('--service', default=DEFAULTS['service'])
parser.add_argument('--proto', default=DEFAULTS['proto'])
parser.add_argument('--port', type=int, default=DEFAULTS['port'])
return parser.parse_args(argv)
def main(argv: list[str] | None = None) -> int:
args = parse_args(argv)
serve(args)
return 0
if __name__ == '__main__':
sys.exit(main())