Files
Jonathan Hui 11cea0697d [nexus] add test 9.2.13 Energy Scan Requests (#12551)
This commit adds Nexus test case 9.2.13 which verifies that the Thread
device properly accepts and processes Energy Scan Requests and sends
the corresponding Energy Scan Reports.

Implementation details:
- tests/nexus/test_9_2_13.cpp: C++ test execution logic. Implements
  the 9.2.13 spec using direct core calls. Manages two separate
  networks (Network 1 on channel 11 and Network 2 on channel 12).
  Configures a topology with Leader, Commissioner, Router, and FED
  nodes in Network 1, and Leader and SED nodes in Network 2.
- tests/nexus/verify_9_2_13.py: PCAP verification script. Verifies
  unicast and multicast MGMT_ED_SCAN.qry messages and the resulting
  MGMT_ED_REPORT.ans responses. Uses strict CoAP URI path and ICMPv6
  type filtering.
- tests/nexus/platform/nexus_core.hpp/cpp: Added an optional leader
  node parameter to SaveTestInfo() to allow specifying which network
  partition information (like Network Key and Mesh-Local Prefix)
  should be exported to the JSON file for verification. This ensures
  correct packet dissection in multi-partition test scenarios.
- tests/nexus/run_nexus_tests.sh: Added 9_2_13 to default test list.
- tests/nexus/CMakeLists.txt: Added nexus_9_2_13 target.
2026-02-25 20:00:30 -06:00

110 lines
3.7 KiB
Python

#!/usr/bin/env python3
#
# Copyright (c) 2019, The OpenThread Authors.
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
# 1. Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
# 3. Neither the name of the copyright holder nor the
# names of its contributors may be used to endorse or promote products
# derived from this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#
from typing import Tuple, List, Optional
from pktverify.consts import COAP_CODE_POST, COAP_CODE_ACK
from pktverify.layers import Layer
class CoapTlvParser(object):
@staticmethod
def parse(t, v: bytearray, layer: 'CoapLayer' = None) -> List[Tuple[str, str]]:
assert isinstance(v, bytearray)
return []
class CoapLayer(Layer):
"""
Represents a COAP layer.
"""
def __init__(self, packet, layer_name):
super().__init__(packet, layer_name)
@property
def is_post(self) -> bool:
"""
Returns if the COAP layer is using code POST.
"""
return self.code == COAP_CODE_POST
@property
def is_ack(self) -> bool:
"""
Returns if the COAP layer is using code ACK.
"""
return self.code == COAP_CODE_ACK
@property
def uri_path(self) -> Optional[str]:
"""
Returns the COAP URI path.
"""
try:
return self.opt.uri_path_recon
except AttributeError:
return None
def __getattr__(self, name):
super_attr = super().__getattr__(name)
if name == 'tlv':
self._parse_coap_payload()
return super_attr
def _parse_coap_payload(self):
payload = self.payload
r = 0
while True:
t, tvs, r = self._parse_next_tlv(payload, r, layer=self)
if t is None:
break
self._add_field('coap.tlv.type', hex(t))
for k, v in tvs:
assert isinstance(k, str), (t, k, v)
if isinstance(v, (bytes, bytearray)):
v = v.hex()
assert isinstance(v, (str, int)), (t, k, v)
self._add_field('coap.tlv.' + k, str(v))
@staticmethod
def _parse_next_tlv(payload, read_pos, layer=None) -> tuple:
assert read_pos <= len(payload)
if read_pos == len(payload):
return None, None, read_pos
t = payload[read_pos]
len_ = payload[read_pos + 1]
assert (len(payload) - read_pos - 2 >= len_)
kvs = CoapTlvParser.parse(t, payload[read_pos + 2:read_pos + 2 + len_], layer=layer)
return t, kvs, read_pos + len_ + 2