Files
Abtin Keshavarzian 064529cbfc [nexus] add helper to allow link between nodes in nexus (#12906)
Added `Core::AllowLinkBetween()` and `Core::UnallowLinkBetween()`
helper methods to the Nexus test platform. These methods simplify
establishing bidirectional links between nodes in simulation tests by
handling the reciprocal `AllowList()` calls in a single step.

Updated various Nexus test cases to utilize these new helpers,
replacing manual bidirectional `AllowList()` calls. This change
reduces verbosity and ensures consistency in how links are established
in the test topology.
2026-04-17 13:22:27 -05:00

476 lines
20 KiB
C++
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* Copyright (c) 2026, 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.
*/
#include <stdio.h>
#include "meshcop/dataset_manager.hpp"
#include "platform/nexus_core.hpp"
#include "platform/nexus_node.hpp"
namespace ot {
namespace Nexus {
/**
* Time to advance for a node to form a network and become leader, in milliseconds.
*/
static constexpr uint32_t kFormNetworkTime = 13 * 1000;
/**
* Time to advance for a node to join as a child and upgrade to a router, in milliseconds.
*/
static constexpr uint32_t kAttachToRouterTime = 200 * 1000;
/**
* Time to advance for a response, in milliseconds.
*/
static constexpr uint32_t kResponseTime = 2000;
/**
* Time to wait for ICMPv6 Echo response, in milliseconds.
*/
static constexpr uint32_t kEchoTimeout = 5000;
static constexpr uint64_t kActiveTimestampStep2 = 100;
static constexpr uint32_t kChannelMaskStep2 = 0x03fff800;
static constexpr uint8_t kExtendedPanIdStep2[] = {0x00, 0x0d, 0xb8, 0x00, 0x00, 0x00, 0x00, 0x01};
static constexpr char kNetworkNameStep2[] = "TEST_1";
static constexpr uint8_t kPskcStep2[] = {0xd2, 0xaa, 0x9c, 0xd8, 0xdf, 0xf7, 0x91, 0x91,
0x22, 0xd7, 0x7d, 0x37, 0xec, 0x3c, 0x1b, 0x5f};
static constexpr uint16_t kRotationTimeStep2 = 3600;
static constexpr uint8_t kSecurityFlagsStep2[] = {0xef};
static constexpr uint64_t kActiveTimestampStep7 = 99;
static constexpr uint32_t kChannelMaskStep7 = 0x01fff800;
static constexpr uint8_t kExtendedPanIdStep7[] = {0x00, 0x0d, 0xb8, 0x00, 0x00, 0x00, 0x00, 0x02};
static constexpr char kNetworkNameStep7[] = "TEST_2";
static constexpr uint8_t kPskcStep7[] = {0x17, 0xd6, 0x72, 0xbe, 0x32, 0xb0, 0xc2, 0x4a,
0x2f, 0x83, 0x85, 0xf2, 0xfb, 0xaf, 0x1d, 0x97};
static constexpr uint8_t kSecurityFlagsStep7[] = {0xff};
static constexpr uint64_t kActiveTimestampStep9 = 101;
static constexpr uint32_t kChannelMaskStep9 = 0x00fff800;
static constexpr uint8_t kExtendedPanIdStep9[] = {0x00, 0x0d, 0xb8, 0x00, 0x00, 0x00, 0x00, 0x03};
static constexpr char kNetworkNameStep9[] = "TEST_3";
static constexpr uint8_t kPskcStep9[] = {0x08, 0xf4, 0xe9, 0x53, 0x1e, 0x8e, 0xfa, 0x8e,
0x85, 0x2d, 0x5f, 0x4f, 0xb9, 0x51, 0xb1, 0x3e};
static constexpr uint16_t kRotationTimeStep9 = 7200;
static constexpr uint8_t kSecurityFlagsStep9[] = {0xff};
static constexpr uint8_t kFutureTlv[] = {130, 2, 0xaa, 0x55};
static constexpr uint64_t kActiveTimestampStep14 = 102;
static constexpr uint8_t kSecurityFlagsStep14[] = {0xf8};
static constexpr uint16_t kUnsupportedChannel = 63;
void Test9_2_5(void)
{
/**
* 9.2.5 Updating the Active Operational Dataset via Thread Node
*
* 9.2.5.1 Topology
* - DUT as Leader, Router_1
*
* 9.2.5.2 Purpose & Description
* The purpose of this test case is to verify the DUT’s behavior when receiving MGMT_ACTIVE_SET.req from an active
* Thread node.
*
* Spec Reference | V1.1 Section | V1.3.0 Section
* ----------------------------------------|--------------|---------------
* Updating the Active Operational Dataset | 8.7.4 | 8.7.4
*/
Core nexus;
Node &leader = nexus.CreateNode();
Node &router1 = nexus.CreateNode();
leader.SetName("LEADER");
router1.SetName("ROUTER_1");
nexus.AdvanceTime(0);
SuccessOrQuit(Instance::SetGlobalLogLevel(kLogLevelNote));
Log("---------------------------------------------------------------------------------------");
Log("Step 1: All");
/**
* Step 1: All
* - Description: Ensure topology is formed correctly.
* - Pass Criteria: N/A.
*/
AllowLinkBetween(leader, router1);
leader.Form();
nexus.AdvanceTime(kFormNetworkTime);
VerifyOrQuit(leader.Get<Mle::Mle>().IsLeader());
router1.Join(leader);
nexus.AdvanceTime(kAttachToRouterTime);
VerifyOrQuit(router1.Get<Mle::Mle>().IsRouter());
Log("---------------------------------------------------------------------------------------");
Log("Step 2: Router_1");
/**
* Step 2: Router_1
* - Description: Harness instructs Router_1 to send a MGMT_ACTIVE_SET.req to the Leader (DUT)’s Routing or Anycast
* Locator:
* - new, valid Timestamp TLV
* - all valid Active Operational Dataset parameters, with new values in the TLVs that don’t affect connectivity
* - Pass Criteria:
* - CoAP Request URI: coap://[<L>]:MM/c/as
* - CoAP Payload:
* - Active Timestamp TLV (new valid value)
* - Channel Mask TLV (new value)
* - Extended PAN ID TLV (new value)
* - Mesh-Local Prefix (old value)
* - Network Name TLV (new value)
* - PSKc TLV (new value)
* - Security Policy TLV (new value)
* - Network Master Key (old value)
* - PAN ID (old value)
* - Channel (old value)
* - The DUT’s Anycast Locator uses the Mesh local prefix with an IID of 0000:00FF:FE00:FC00.
*/
MeshCoP::Dataset::Info datasetInfo;
MeshCoP::Timestamp timestamp;
SuccessOrQuit(router1.Get<MeshCoP::ActiveDatasetManager>().Read(datasetInfo));
timestamp.Clear();
timestamp.SetSeconds(kActiveTimestampStep2);
datasetInfo.Set<MeshCoP::Dataset::kActiveTimestamp>(timestamp);
datasetInfo.Set<MeshCoP::Dataset::kChannelMask>(kChannelMaskStep2);
datasetInfo.Set<MeshCoP::Dataset::kExtendedPanId>(
AsCoreType(reinterpret_cast<const otExtendedPanId *>(kExtendedPanIdStep2)));
SuccessOrQuit(datasetInfo.Update<MeshCoP::Dataset::kNetworkName>().Set(kNetworkNameStep2));
datasetInfo.Set<MeshCoP::Dataset::kPskc>(AsCoreType(reinterpret_cast<const otPskc *>(kPskcStep2)));
datasetInfo.Update<MeshCoP::Dataset::kSecurityPolicy>().mRotationTime = kRotationTimeStep2;
datasetInfo.Update<MeshCoP::Dataset::kSecurityPolicy>().SetFlags(kSecurityFlagsStep2, sizeof(kSecurityFlagsStep2));
SuccessOrQuit(
router1.Get<MeshCoP::ActiveDatasetManager>().SendSetRequest(datasetInfo, nullptr, 0, nullptr, nullptr));
Log("---------------------------------------------------------------------------------------");
Log("Step 3: Leader (DUT)");
/**
* Step 3: Leader (DUT)
* - Description: Automatically sends MGMT_ACTIVE_SET.rsp to Router_1.
* - Pass Criteria: The DUT MUST send MGMT_ACTIVE_SET.rsp to Router_1 with the following format:
* - CoAP Response Code: 2.04 Changed
* - CoAP Payload: State TLV (value = Accept (01))
*/
nexus.AdvanceTime(kResponseTime);
Log("---------------------------------------------------------------------------------------");
Log("Step 4: Leader (DUT)");
/**
* Step 4: Leader (DUT)
* - Description: Automatically sends a Multicast MLE Data Response.
* - Pass Criteria: The DUT MUST send a multicast MLE Data Response, including the following TLVs:
* - Source Address TLV
* - Leader Data TLV
* - Data version field [incremented]
* - Stable Version field [incremented]
* - Network Data TLV
* - Active Timestamp TLV [new value set in Step 2]
*/
Log("---------------------------------------------------------------------------------------");
Log("Step 5: Router_1");
/**
* Step 5: Router_1
* - Description: Automatically sends a unicast MLE Data Request to Router_1 (Note: this appears to be a typo in the
* specification, as Router_1 would likely send it to the Leader), including the following TLVs:
* - TLV Request TLV:
* - Network Data TLV
* - Active Timestamp TLV
* - Pass Criteria: N/A.
*/
Log("---------------------------------------------------------------------------------------");
Log("Step 6: Leader (DUT)");
/**
* Step 6: Leader (DUT)
* - Description: Automatically sends a unicast MLE Data Response to Router_1.
* - Pass Criteria: The DUT MUST send a unicast MLE Data Response to Router_1, including the following TLVs:
* - Source Address TLV
* - Leader Data TLV
* - Network Data TLV
* - Active Operational Dataset TLV
* - Channel TLV
* - Channel Mask TLV [new value set in Step 2]
* - Extended PAN ID TLV [new value set in Step 2]
* - Network Mesh-Local Prefix TLV
* - Network Master Key TLV
* - Network Name TLV [new value set in Step 2]
* - PAN ID TLV
* - PSKc TLV [new value set in Step 2]
* - Security Policy TLV [new value set in Step 2]
* - Active Timestamp TLV [new value set in Step 2]
*/
nexus.AdvanceTime(kResponseTime);
Log("---------------------------------------------------------------------------------------");
Log("Step 7: Router_1");
/**
* Step 7: Router_1
* - Description: Harness instructs Router_1 to send a MGMT_ACTIVE_SET.req to the Leader (DUT)’s Routing or Anycast
* Locator:
* - old, invalid Active Timestamp TLV
* - all valid Active Operational Dataset parameters, with new values in the TLVs that don’t affect connectivity
* - Pass Criteria:
* - CoAP Request URI: coap://[<L>]:MM/c/as
* - CoAP Payload:
* - Active Timestamp TLV (old, invalid value)
* - Channel Mask TLV (new value)
* - Extended PAN ID TLV (new value)
* - Mesh-Local Prefix (old value)
* - Network Name TLV (new value)
* - PSKc TLV (new value)
* - Security Policy TLV (new value)
* - Network Master Key (old value)
* - PAN ID (old value)
* - Channel (old value)
* - The DUT’s Anycast Locator uses the Mesh local prefix with an IID of 0000:00FF:FE00:FC00.
*/
timestamp.SetSeconds(kActiveTimestampStep7);
datasetInfo.Set<MeshCoP::Dataset::kActiveTimestamp>(timestamp);
datasetInfo.Set<MeshCoP::Dataset::kChannelMask>(kChannelMaskStep7);
datasetInfo.Set<MeshCoP::Dataset::kExtendedPanId>(
AsCoreType(reinterpret_cast<const otExtendedPanId *>(kExtendedPanIdStep7)));
SuccessOrQuit(datasetInfo.Update<MeshCoP::Dataset::kNetworkName>().Set(kNetworkNameStep7));
datasetInfo.Set<MeshCoP::Dataset::kPskc>(AsCoreType(reinterpret_cast<const otPskc *>(kPskcStep7)));
datasetInfo.Update<MeshCoP::Dataset::kSecurityPolicy>().SetFlags(kSecurityFlagsStep7, sizeof(kSecurityFlagsStep7));
SuccessOrQuit(
router1.Get<MeshCoP::ActiveDatasetManager>().SendSetRequest(datasetInfo, nullptr, 0, nullptr, nullptr));
Log("---------------------------------------------------------------------------------------");
Log("Step 8: Leader (DUT)");
/**
* Step 8: Leader (DUT)
* - Description: Automatically sends a MGMT_ACTIVE_SET.rsp to Router_1.
* - Pass Criteria: The DUT MUST send MGMT_ACTIVE_SET.rsp to Router_1, with the following format:
* - CoAP Response Code: 2.04 Changed
* - CoAP Payload: State TLV (value = Reject (ff))
*/
nexus.AdvanceTime(kResponseTime);
Log("---------------------------------------------------------------------------------------");
Log("Step 9: Router_1");
/**
* Step 9: Router_1
* - Description: Harness instructs Router_1 to send a MGMT_ACTIVE_SET.req to the Leader (DUT)’s Routing or Anycast
* Locator:
* - new, valid Active Timestamp TLV
* - all of valid Commissioner Dataset parameters plus one bogus TLV, and new values in the TLVs that don’t affect
* connectivity
* - Pass Criteria:
* - CoAP Request URI: coap://[<L>]:MM/c/as
* - CoAP Payload:
* - Active Timestamp TLV (new, valid value)
* - Channel Mask TLV (new value, different from Step 2)
* - Extended PAN ID TLV (new value, different from Step 2)
* - Mesh-Local Prefix (old value)
* - Network Name TLV (new value, different from Step 2)
* - PSKc TLV (new value, different from Step 2)
* - Security Policy TLV (new value, different from Step 2)
* - Network Master Key (old value)
* - PAN ID (old value)
* - Channel (old value)
* - Future TLV:
* - Type 130
* - Length 2
* - Value (aa 55)
* - The DUT’s Anycast Locator uses the Mesh local prefix with an IID of 0000:00FF:FE00:FC00.
*/
timestamp.SetSeconds(kActiveTimestampStep9);
datasetInfo.Set<MeshCoP::Dataset::kActiveTimestamp>(timestamp);
datasetInfo.Set<MeshCoP::Dataset::kChannelMask>(kChannelMaskStep9);
datasetInfo.Set<MeshCoP::Dataset::kExtendedPanId>(
AsCoreType(reinterpret_cast<const otExtendedPanId *>(kExtendedPanIdStep9)));
SuccessOrQuit(datasetInfo.Update<MeshCoP::Dataset::kNetworkName>().Set(kNetworkNameStep9));
datasetInfo.Set<MeshCoP::Dataset::kPskc>(AsCoreType(reinterpret_cast<const otPskc *>(kPskcStep9)));
datasetInfo.Update<MeshCoP::Dataset::kSecurityPolicy>().mRotationTime = kRotationTimeStep9;
datasetInfo.Update<MeshCoP::Dataset::kSecurityPolicy>().SetFlags(kSecurityFlagsStep9, sizeof(kSecurityFlagsStep9));
SuccessOrQuit(router1.Get<MeshCoP::ActiveDatasetManager>().SendSetRequest(datasetInfo, kFutureTlv,
sizeof(kFutureTlv), nullptr, nullptr));
Log("---------------------------------------------------------------------------------------");
Log("Step 10: Leader (DUT)");
/**
* Step 10: Leader (DUT)
* - Description: Automatically sends a MGMT_ACTIVE_SET.rsp to Router_1.
* - Pass Criteria: The DUT MUST send MGMT_ACTIVE_SET.rsp to Router_1 with the following format:
* - CoAP Response Code: 2.04 Changed
* - CoAP Payload: State TLV (value = Accept (01))
*/
nexus.AdvanceTime(kResponseTime);
Log("---------------------------------------------------------------------------------------");
Log("Step 11: Leader (DUT)");
/**
* Step 11: Leader (DUT)
* - Description: Automatically sends a multicast MLE Data Response.
* - Pass Criteria: The DUT MUST send a multicast MLE Data Response, including the following TLVs:
* - Source Address TLV
* - Leader Data TLV
* - Data version field [incremented]
* - Stable Version field [incremented]
* - Network Data TLV
* - Active Timestamp TLV [new value set in Step 9]
*/
Log("---------------------------------------------------------------------------------------");
Log("Step 12: Router_1");
/**
* Step 12: Router_1
* - Description: Automatically sends a unicast MLE Data Request to the Leader (DUT), including the following TLVs:
* - TLV Request TLV:
* - Network Data TLV
* - Active Timestamp TLV
* - Pass Criteria: N/A.
*/
Log("---------------------------------------------------------------------------------------");
Log("Step 13: Leader (DUT)");
/**
* Step 13: Leader (DUT)
* - Description: Automatically sends a unicast MLE Data Response to Router_1.
* - Pass Criteria: The following TLVs MUST be included in the Unicast MLE Data Response:
* - Source Address TLV
* - Leader Data TLV
* - Network Data TLV
* - Stable flag set to 0
* - Active Operational Dataset TLV
* - Channel TLV
* - Channel Mask TLV [new value set in Step 9]
* - Extended PAN ID TLV [new value set in Step 9]
* - Network Mesh-Local Prefix TLV
* - Network Master Key TLV
* - Network Name TLV [new value set in Step 9]
* - PAN ID TLV
* - PSKc TLV [new value set in Step 9]
* - Security Policy TLV [new value set in Step 9]
* - Active Timestamp TLV [new value set in Step 9]
*/
nexus.AdvanceTime(kResponseTime);
Log("---------------------------------------------------------------------------------------");
Log("Step 14: Router_1");
/**
* Step 14: Router_1
* - Description: Harness instructs Router_1 to send a MGMT_ACTIVE_SET.req to the Leader (DUT)’s Routing or Anycast
* Locator:
* - new, valid Active Timestamp TLV
* - attempt to set Channel TLV to an unsupported channel + all of other TLVs
* - Pass Criteria:
* - CoAP Request URI: coap://[<L>]:MM/c/as
* - CoAP Payload:
* - Active Timestamp TLV (new, valid value)
* - Channel TLV (unsupported value = 63)
* - Channel Mask TLV (old value set in Step 9)
* - Extended PAN ID TLV (old value set in Step 9)
* - Mesh-Local Prefix (old value)
* - Network Name TLV (old value set in Step 9)
* - PSKc TLV (old value set in Step 9)
* - Security Policy TLV (old value set in Step 9)
* - Network Master Key (old value)
* - PAN ID (old value)
* - The DUT Anycast Locator uses the Mesh local prefix with an IID of 0000:00FF:FE00:FC00.
*/
timestamp.SetSeconds(kActiveTimestampStep14);
datasetInfo.Set<MeshCoP::Dataset::kActiveTimestamp>(timestamp);
datasetInfo.Set<MeshCoP::Dataset::kChannel>(kUnsupportedChannel);
datasetInfo.Update<MeshCoP::Dataset::kSecurityPolicy>().SetFlags(kSecurityFlagsStep14,
sizeof(kSecurityFlagsStep14));
SuccessOrQuit(
router1.Get<MeshCoP::ActiveDatasetManager>().SendSetRequest(datasetInfo, nullptr, 0, nullptr, nullptr));
Log("---------------------------------------------------------------------------------------");
Log("Step 15: Leader (DUT)");
/**
* Step 15: Leader (DUT)
* - Description: Automatically sends MGMT_ACTIVE_SET.rsp to Router_1.
* - Pass Criteria: The DUT MUST send MGMT_ACTIVE_SET.rsp to Router_1 with the following format:
* - CoAP Response Code: 2.04 Changed
* - CoAP Payload: State TLV (value = Reject (ff))
*/
nexus.AdvanceTime(kResponseTime);
Log("---------------------------------------------------------------------------------------");
Log("Step 16: All");
/**
* Step 16: All
* - Description: Verify connectivity by sending an ICMPv6 Echo Request to the DUT mesh local address.
* - Pass Criteria: The DUT must respond with an ICMPv6 Echo Reply.
*/
nexus.SendAndVerifyEchoRequest(router1, leader.Get<Mle::Mle>().GetMeshLocalEid(), 0, 64, kEchoTimeout);
nexus.SaveTestInfo("test_1_1_9_2_5.json");
}
} // namespace Nexus
} // namespace ot
int main(void)
{
ot::Nexus::Test9_2_5();
printf("All tests passed\n");
return 0;
}