mirror of
https://github.com/espressif/openthread.git
synced 2026-06-05 21:14:49 +00:00
Abtin Keshavarzian
66c7272eef
This commit introduces the Border Agent Admitter feature , which enhances Thread MeshCoP. A Border Admitter is an enhanced Border Agent that functions as a traditional BA while enabling new behaviors. It acts as a proxy and dispatcher, allowing multiple external Enrollers to connect to it. It then petitions to become the single Active Commissioner on the Thread mesh, forwards new joiner requests to connected Enrollers, and manages the session between joiners and multiple Enrollers The implementation includes three main components: - `Admitter`: The main class that orchestrates the feature, managing enroller sessions and aggregating steering data. - `Arbitrator`: A distributed election mechanism that runs among Border Admitters on the mesh to select a single "Prime Admitter" by publishing a new Border Admitter service in the Thread Network Data. - `CommissionerPetitioner`: A sub-component responsible for petitioning the Leader to be granted the commissioner role. It handles conflicts if another commissioner is already active. New public APIs are added in `openthread/border_agent_admitter.h`. This commit also introduces a suite of comprehensive tests for the Border Admitter functionality under the `nexus` test framework. It covers various scenarios including: - Prime Admitter election and role management - Enroller registration, keep-alive, and timeout interactions - Handling of commissioner conflicts and petitioner retry mechanisms - Support for multiple enroller sessions and combined steering data - Forwarding of Joiner `RelayRx` and `UdpProxy` messages - Joiner acceptance, release, and expiration tracking
144 lines
3.9 KiB
Plaintext
144 lines
3.9 KiB
Plaintext
# Copyright (c) 2020, 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.
|
|
#
|
|
|
|
import("../../etc/gn/openthread.gni")
|
|
|
|
source_set("openthread_config") {
|
|
public = [ "config.h" ]
|
|
|
|
if (openthread_config_file != "") {
|
|
public_deps = openthread_config_deps
|
|
}
|
|
|
|
public_configs = [ "../..:openthread_config" ]
|
|
}
|
|
|
|
source_set("openthread") {
|
|
public = [
|
|
"backbone_router.h",
|
|
"backbone_router_ftd.h",
|
|
"ble_secure.h",
|
|
"border_agent.h",
|
|
"border_agent_admitter.h",
|
|
"border_agent_ephemeral_key.h",
|
|
"border_agent_tracker.h",
|
|
"border_agent_txt_data.h",
|
|
"border_router.h",
|
|
"border_routing.h",
|
|
"channel_manager.h",
|
|
"channel_monitor.h",
|
|
"child_supervision.h",
|
|
"cli.h",
|
|
"coap.h",
|
|
"coap_secure.h",
|
|
"commissioner.h",
|
|
"config.h",
|
|
"crypto.h",
|
|
"dataset.h",
|
|
"dataset_ftd.h",
|
|
"dataset_updater.h",
|
|
"diag.h",
|
|
"dns.h",
|
|
"dns_client.h",
|
|
"dnssd_server.h",
|
|
"error.h",
|
|
"heap.h",
|
|
"history_tracker.h",
|
|
"icmp6.h",
|
|
"instance.h",
|
|
"ip6.h",
|
|
"jam_detection.h",
|
|
"joiner.h",
|
|
"link.h",
|
|
"link_metrics.h",
|
|
"link_raw.h",
|
|
"logging.h",
|
|
"mdns.h",
|
|
"mesh_diag.h",
|
|
"message.h",
|
|
"multi_ail_detection.h",
|
|
"multi_radio.h",
|
|
"nat64.h",
|
|
"ncp.h",
|
|
"netdata.h",
|
|
"netdata_publisher.h",
|
|
"netdiag.h",
|
|
"network_time.h",
|
|
"ping_sender.h",
|
|
"platform/alarm-micro.h",
|
|
"platform/alarm-milli.h",
|
|
"platform/ble.h",
|
|
"platform/border_routing.h",
|
|
"platform/crypto.h",
|
|
"platform/debug_uart.h",
|
|
"platform/diag.h",
|
|
"platform/dns.h",
|
|
"platform/dnssd.h",
|
|
"platform/dso_transport.h",
|
|
"platform/entropy.h",
|
|
"platform/flash.h",
|
|
"platform/infra_if.h",
|
|
"platform/logging.h",
|
|
"platform/mdns_socket.h",
|
|
"platform/memory.h",
|
|
"platform/messagepool.h",
|
|
"platform/misc.h",
|
|
"platform/multipan.h",
|
|
"platform/otns.h",
|
|
"platform/radio.h",
|
|
"platform/settings.h",
|
|
"platform/spi-slave.h",
|
|
"platform/time.h",
|
|
"platform/toolchain.h",
|
|
"platform/trel.h",
|
|
"platform/udp.h",
|
|
"provisional/link.h",
|
|
"provisional/p2p.h",
|
|
"radio_stats.h",
|
|
"random_crypto.h",
|
|
"random_noncrypto.h",
|
|
"seeker.h",
|
|
"server.h",
|
|
"sntp.h",
|
|
"srp_client.h",
|
|
"srp_client_buffers.h",
|
|
"srp_server.h",
|
|
"steering_data.h",
|
|
"tasklet.h",
|
|
"tcat.h",
|
|
"tcp.h",
|
|
"tcp_ext.h",
|
|
"thread.h",
|
|
"thread_ftd.h",
|
|
"trel.h",
|
|
"udp.h",
|
|
"verhoeff_checksum.h",
|
|
]
|
|
|
|
public_deps = [ ":openthread_config" ]
|
|
}
|