forked from espressif/esp-protocols
		
	
		
			
				
	
	
		
			204 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			204 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
| # SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
 | |
| # SPDX-License-Identifier: Unlicense OR CC0-1.0
 | |
| import re
 | |
| import select
 | |
| import socket
 | |
| import struct
 | |
| import subprocess
 | |
| import time
 | |
| from threading import Event, Thread
 | |
| 
 | |
| try:
 | |
|     import dpkt
 | |
|     import dpkt.dns
 | |
| except ImportError:
 | |
|     pass
 | |
| 
 | |
| 
 | |
| def get_dns_query_for_esp(esp_host):
 | |
|     dns = dpkt.dns.DNS(
 | |
|         b'\x00\x00\x01\x00\x00\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x00\x01'
 | |
|     )
 | |
|     dns.qd[0].name = esp_host + u'.local'
 | |
|     print('Created query for esp host: {} '.format(dns.__repr__()))
 | |
|     return dns.pack()
 | |
| 
 | |
| 
 | |
| def get_dns_answer_to_mdns(tester_host):
 | |
|     dns = dpkt.dns.DNS(
 | |
|         b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00'
 | |
|     )
 | |
|     dns.op = dpkt.dns.DNS_QR | dpkt.dns.DNS_AA
 | |
|     dns.rcode = dpkt.dns.DNS_RCODE_NOERR
 | |
|     arr = dpkt.dns.DNS.RR()
 | |
|     arr.cls = dpkt.dns.DNS_IN
 | |
|     arr.type = dpkt.dns.DNS_A
 | |
|     arr.name = tester_host
 | |
|     arr.ip = socket.inet_aton('127.0.0.1')
 | |
|     dns.an.append(arr)
 | |
|     print('Created answer to mdns query: {} '.format(dns.__repr__()))
 | |
|     return dns.pack()
 | |
| 
 | |
| 
 | |
| def get_dns_answer_to_mdns_lwip(tester_host, id):
 | |
|     dns = dpkt.dns.DNS(
 | |
|         b'\x5e\x39\x84\x00\x00\x01\x00\x01\x00\x00\x00\x00\x0a\x64\x61\x76\x69\x64'
 | |
|         b'\x2d\x63\x6f\x6d\x70\x05\x6c\x6f\x63\x61\x6c\x00\x00\x01\x00\x01\xc0\x0c'
 | |
|         b'\x00\x01\x00\x01\x00\x00\x00\x0a\x00\x04\xc0\xa8\x0a\x6c')
 | |
|     dns.qd[0].name = tester_host
 | |
|     dns.an[0].name = tester_host
 | |
|     dns.an[0].ip = socket.inet_aton('127.0.0.1')
 | |
|     dns.an[0].rdata = socket.inet_aton('127.0.0.1')
 | |
|     dns.id = id
 | |
|     print('Created answer to mdns (lwip) query: {} '.format(dns.__repr__()))
 | |
|     return dns.pack()
 | |
| 
 | |
| 
 | |
| def mdns_server(esp_host, events):
 | |
|     UDP_IP = '0.0.0.0'
 | |
|     UDP_PORT = 5353
 | |
|     MCAST_GRP = '224.0.0.251'
 | |
|     TESTER_NAME = u'tinytester.local'
 | |
|     TESTER_NAME_LWIP = u'tinytester-lwip.local'
 | |
|     QUERY_TIMEOUT = 0.2
 | |
|     sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
 | |
|     sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
 | |
|     sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1)
 | |
|     sock.setblocking(False)
 | |
|     sock.bind((UDP_IP, UDP_PORT))
 | |
|     mreq = struct.pack('4sl', socket.inet_aton(MCAST_GRP), socket.INADDR_ANY)
 | |
|     sock.setsockopt(socket.IPPROTO_IP, socket.IP_ADD_MEMBERSHIP, mreq)
 | |
|     last_query_timepoint = time.time()
 | |
|     while not events['stop'].is_set():
 | |
|         try:
 | |
|             current_time = time.time()
 | |
|             if current_time - last_query_timepoint > QUERY_TIMEOUT:
 | |
|                 last_query_timepoint = current_time
 | |
|                 if not events['esp_answered'].is_set():
 | |
|                     sock.sendto(get_dns_query_for_esp(esp_host),
 | |
|                                 (MCAST_GRP, UDP_PORT))
 | |
|                 if not events['esp_delegated_answered'].is_set():
 | |
|                     sock.sendto(get_dns_query_for_esp(esp_host + '-delegated'),
 | |
|                                 (MCAST_GRP, UDP_PORT))
 | |
|             timeout = max(
 | |
|                 0, QUERY_TIMEOUT - (current_time - last_query_timepoint))
 | |
|             read_socks, _, _ = select.select([sock], [], [], timeout)
 | |
|             if not read_socks:
 | |
|                 continue
 | |
|             data, addr = sock.recvfrom(1024)
 | |
|             dns = dpkt.dns.DNS(data)
 | |
|             if len(dns.qd) > 0:
 | |
|                 for dns_query in dns.qd:
 | |
|                     if dns_query.type == dpkt.dns.DNS_A:
 | |
|                         if dns_query.name == TESTER_NAME:
 | |
|                             print('Received query: {} '.format(dns.__repr__()))
 | |
|                             sock.sendto(get_dns_answer_to_mdns(TESTER_NAME),
 | |
|                                         (MCAST_GRP, UDP_PORT))
 | |
|                         elif dns_query.name == TESTER_NAME_LWIP:
 | |
|                             print('Received query: {} '.format(dns.__repr__()))
 | |
|                             sock.sendto(
 | |
|                                 get_dns_answer_to_mdns_lwip(TESTER_NAME_LWIP, dns.id),
 | |
|                                 addr)
 | |
|             if len(dns.an) > 0:
 | |
|                 for dns_answer in dns.an:
 | |
|                     if dns_answer.type == dpkt.dns.DNS_A:
 | |
|                         print('Received answer from {}'.format(dns_answer.name))
 | |
|                         if dns_answer.name == esp_host + u'.local':
 | |
|                             print('Received answer to esp32-mdns query: {}'.format(
 | |
|                                 dns.__repr__()))
 | |
|                             events['esp_answered'].set()
 | |
|                         if dns_answer.name == esp_host + u'-delegated.local':
 | |
|                             print('Received answer to esp32-mdns-delegate query: {}'.format(
 | |
|                                 dns.__repr__()))
 | |
|                             events['esp_delegated_answered'].set()
 | |
|         except socket.timeout:
 | |
|             break
 | |
|         except dpkt.UnpackError:
 | |
|             continue
 | |
| 
 | |
| 
 | |
| def test_examples_protocol_mdns(dut):
 | |
|     """
 | |
|     steps: |
 | |
|       1. obtain IP address + init mdns example
 | |
|       2. get the dut host name (and IP address)
 | |
|       3. check the mdns name is accessible
 | |
|       4. check DUT output if mdns advertized host is resolved
 | |
|       5. check if DUT responds to dig
 | |
|       6. check the DUT is searchable via reverse IP lookup
 | |
|     """
 | |
| 
 | |
|     specific_host = dut.expect(r'mdns hostname set to: \[(.*?)\]')[1].decode()
 | |
| 
 | |
|     mdns_server_events = {
 | |
|         'stop': Event(),
 | |
|         'esp_answered': Event(),
 | |
|         'esp_delegated_answered': Event()
 | |
|     }
 | |
|     mdns_responder = Thread(target=mdns_server,
 | |
|                             args=(str(specific_host), mdns_server_events))
 | |
|     ip_addresses = []
 | |
|     if dut.app.sdkconfig.get('LWIP_IPV4') is True:
 | |
|         ipv4 = dut.expect(r'IPv4 address: (\d+\.\d+\.\d+\.\d+)[^\d]',
 | |
|                           timeout=30)[1].decode()
 | |
|         ip_addresses.append(ipv4)
 | |
|     if dut.app.sdkconfig.get('LWIP_IPV6') is True:
 | |
|         ipv6_r = r':'.join((r'[0-9a-fA-F]{4}', ) * 8)
 | |
|         ipv6 = dut.expect(ipv6_r, timeout=30)[0].decode()
 | |
|         ip_addresses.append(ipv6)
 | |
|     print('Connected with IP addresses: {}'.format(','.join(ip_addresses)))
 | |
|     try:
 | |
|         # TODO: Add test for example disabling IPV4
 | |
|         mdns_responder.start()
 | |
|         if dut.app.sdkconfig.get('LWIP_IPV4') is True:
 | |
|             # 3. check the mdns name is accessible.
 | |
|             if not mdns_server_events['esp_answered'].wait(timeout=30):
 | |
|                 raise ValueError(
 | |
|                     'Test has failed: did not receive mdns answer within timeout')
 | |
|             if not mdns_server_events['esp_delegated_answered'].wait(timeout=30):
 | |
|                 raise ValueError(
 | |
|                     'Test has failed: did not receive mdns answer for delegated host within timeout'
 | |
|                 )
 | |
|             # 4. check DUT output if mdns advertized host is resolved
 | |
|             dut.expect(
 | |
|                 re.compile(
 | |
|                     b'mdns-test: Query A: tinytester.local resolved to: 127.0.0.1')
 | |
|             )
 | |
|             dut.expect(
 | |
|                 re.compile(
 | |
|                     b'mdns-test: gethostbyname: tinytester-lwip.local resolved to: 127.0.0.1'
 | |
|                 ))
 | |
|             dut.expect(
 | |
|                 re.compile(
 | |
|                     b'mdns-test: getaddrinfo: tinytester-lwip.local resolved to: 127.0.0.1'
 | |
|                 ))
 | |
|             # 5. check the DUT answers to `dig` command
 | |
|             dig_output = subprocess.check_output([
 | |
|                 'dig', '+short', '-p', '5353', '@224.0.0.251',
 | |
|                 '{}.local'.format(specific_host)
 | |
|             ])
 | |
|             print('Resolving {} using "dig" succeeded with:\n{}'.format(
 | |
|                 specific_host, dig_output))
 | |
|             if not ipv4.encode('utf-8') in dig_output:
 | |
|                 raise ValueError(
 | |
|                     'Test has failed: Incorrectly resolved DUT hostname using dig'
 | |
|                     "Output should've contained DUT's IP address:{}".format(ipv4))
 | |
|             # 6. check the DUT reverse lookup
 | |
|             if dut.app.sdkconfig.get('MDNS_RESPOND_REVERSE_QUERIES') is True:
 | |
|                 for ip_address in ip_addresses:
 | |
|                     dig_output = subprocess.check_output([
 | |
|                         'dig', '+short', '-p', '5353', '@224.0.0.251', '-x',
 | |
|                         '{}'.format(ip_address)
 | |
|                     ])
 | |
|                     print('Reverse lookup for {} using "dig" succeeded with:\n{}'.
 | |
|                           format(ip_address, dig_output))
 | |
|                     if specific_host not in dig_output.decode():
 | |
|                         raise ValueError(
 | |
|                             'Test has failed: Incorrectly resolved DUT IP address using dig'
 | |
|                             "Output should've contained DUT's name:{}".format(
 | |
|                                 specific_host))
 | |
| 
 | |
|     finally:
 | |
|         mdns_server_events['stop'].set()
 | |
|         mdns_responder.join()
 |