mirror of
https://github.com/espressif/openthread.git
synced 2026-06-06 05:24:51 +00:00
2798cc9c05
This commit adds History Tracker feature and its CLI support. This feature records history of different events as the Thread network operates (e.g., history of RX and TX IPv6 messages or network info changes). Recorded entries are timestamped. When the history list is read, the timestamps are given as the entry age relative to the time the list is being read. For example in CLI a timestamp can be shown as `02:31:50.628 ago` indicating the entry was recorded 2 hours, 31 min, 50 sec, and 628 msec ago. Number of days is added for events that are older than 24 hours, e.g., `31 days 03:00:23.931 ago`. Timestamps use millisecond accuracy and are tacked up to 49 days. If an event is older than 49 days, the entry is still tracked in the list but the timestamp is shown as old or `more than 49 days ago`. The `HistoryTracker` currently maintains 3 lists. The Network Info history tracks changes to Device Role, Mode, RLOC16 and Partition ID. The RX/TX history list records information about the received/sent IPv6 messages: - Message type (UDP, TCP, ICMP6 (and its subtype), etc.) - Source and destination IPv6 addresses and port numbers - IPv6 payload length - The message checksum (for UDP, TCP, or ICMP6). - Whether or not the link-layer security was used - Message priority: low, norm, high, net (for control messages) - Short address (RLOC16) of neighbor who send/received the msg - Received Signal Strength (in dBm) for RX only - Radio link info (15.4/TREL) on which msg was sent/received (useful when `OPENTHREAD_CONFIG_MULTI_RADIO` is enabled) Config `HISTORY_TRACKER_EXCLUDE_THREAD_CONTROL_MESSAGES` can be used to configure `HistoryTracker` to exclude Thread Control message (e.g., MLE, TMF) from TX and RX history. The number of entries recorded for each history list is configurable through a set of OpenThread config options, e.g., number of entries in Network Info history list is specified by OpenThread config option `OPENTHREAD_CONFIG_HISTORY_TRACKER_NET_INFO_LIST_SIZE`. The `HistoryTracker` will keep the most recent entries overwriting oldest ones when the list gets full. This commit also adds support for `HistoryTracker` in CLI. The CLI commands provide two style for printing the history information: A table format (more human-readable) and list style (better suited for parsing by machine/code). `README_HISTORY.md` is added to document the commands and the info provided by each history list entry. This commit also adds `test_history_tracker.py` test-case which covers the behavior of `HistoryTracker`.
174 lines
5.2 KiB
Bash
Executable File
174 lines
5.2 KiB
Bash
Executable File
#!/bin/bash
|
|
#
|
|
# 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.
|
|
#
|
|
|
|
#
|
|
# This script calls cmake and ninja to compile OpenThread for the given platform.
|
|
#
|
|
# Compile with default build options:
|
|
#
|
|
# script/cmake-build ${platform}
|
|
#
|
|
# Compile with the specified build option enabled:
|
|
#
|
|
# script/cmake-build ${platform} -D${option}=ON
|
|
#
|
|
# Compile with the specified build option disabled that already enabled by default:
|
|
#
|
|
# script/cmake-build ${platform} -D${option}=OFF
|
|
#
|
|
# Compile with the specified ninja build target:
|
|
#
|
|
# OT_CMAKE_NINJA_TARGET="ot-cli-ftd" script/cmake-build ${platform}
|
|
#
|
|
# Compile with the specified build directory:
|
|
#
|
|
# OT_CMAKE_BUILD_DIR="./build/temp" script/cmake-build ${platform}
|
|
#
|
|
# Examples:
|
|
#
|
|
# script/cmake-build simulation
|
|
#
|
|
# script/cmake-build simulation -DOT_FULL_LOGS=ON -DOT_CHANNEL_MANAGER=OFF
|
|
#
|
|
# OT_CMAKE_NINJA_TARGET="ot-cli-mtd" OT_CMAKE_BUILD_DIR="./build/temp" script/cmake-build simulation -DOT_FULL_LOGS=ON -DOT_CHANNEL_MANAGER=OFF
|
|
#
|
|
|
|
set -euxo pipefail
|
|
|
|
OT_CMAKE_NINJA_TARGET=${OT_CMAKE_NINJA_TARGET:-}
|
|
|
|
readonly OT_SRCDIR="$(pwd)"
|
|
readonly OT_PLATFORMS=(cc2538 simulation posix)
|
|
readonly OT_POSIX_SIM_COMMON_OPTIONS=(
|
|
"-DOT_BORDER_AGENT=ON"
|
|
"-DOT_BORDER_ROUTER=ON"
|
|
"-DOT_COAP=ON"
|
|
"-DOT_COAP_BLOCK=ON"
|
|
"-DOT_COAP_OBSERVE=ON"
|
|
"-DOT_COAPS=ON"
|
|
"-DOT_COMMISSIONER=ON"
|
|
"-DOT_CHANNEL_MANAGER=ON"
|
|
"-DOT_CHANNEL_MONITOR=ON"
|
|
"-DOT_CHILD_SUPERVISION=ON"
|
|
"-DOT_DATASET_UPDATER=ON"
|
|
"-DOT_DHCP6_CLIENT=ON"
|
|
"-DOT_DHCP6_SERVER=ON"
|
|
"-DOT_DIAGNOSTIC=ON"
|
|
"-DOT_DNS_CLIENT=ON"
|
|
"-DOT_ECDSA=ON"
|
|
"-DOT_HISTORY_TRACKER=ON"
|
|
"-DOT_IP6_FRAGM=ON"
|
|
"-DOT_JAM_DETECTION=ON"
|
|
"-DOT_JOINER=ON"
|
|
"-DOT_LEGACY=ON"
|
|
"-DOT_MAC_FILTER=ON"
|
|
"-DOT_MTD_NETDIAG=ON"
|
|
"-DOT_NEIGHBOR_DISCOVERY_AGENT=ON"
|
|
"-DOT_NETDATA_PUBLISHER=ON"
|
|
"-DOT_PING_SENDER=ON"
|
|
"-DOT_REFERENCE_DEVICE=ON"
|
|
"-DOT_SERVICE=ON"
|
|
"-DOT_SNTP_CLIENT=ON"
|
|
"-DOT_SRP_CLIENT=ON"
|
|
"-DOT_COVERAGE=ON"
|
|
"-DOT_LOG_LEVEL_DYNAMIC=ON"
|
|
"-DOT_COMPILE_WARNING_AS_ERROR=ON"
|
|
"-DOT_RCP_RESTORATION_MAX_COUNT=2"
|
|
)
|
|
|
|
die()
|
|
{
|
|
echo " ** ERROR: Openthread CMake doesn't support platform \"$1\""
|
|
exit 1
|
|
}
|
|
|
|
build()
|
|
{
|
|
local platform=$1
|
|
local builddir="${OT_CMAKE_BUILD_DIR:-build/${platform}}"
|
|
shift
|
|
|
|
mkdir -p "${builddir}"
|
|
cd "${builddir}"
|
|
|
|
cmake -GNinja -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DOT_COMPILE_WARNING_AS_ERROR=ON "$@" "${OT_SRCDIR}"
|
|
|
|
if [[ -n ${OT_CMAKE_NINJA_TARGET[*]} ]]; then
|
|
ninja "${OT_CMAKE_NINJA_TARGET[@]}"
|
|
else
|
|
ninja
|
|
fi
|
|
|
|
cd "${OT_SRCDIR}"
|
|
}
|
|
|
|
main()
|
|
{
|
|
if [[ $# == 0 ]]; then
|
|
echo "Please specify a platform: ${OT_PLATFORMS[*]}"
|
|
exit 1
|
|
fi
|
|
|
|
local platform="$1"
|
|
# Check if the platform supports cmake.
|
|
echo "${OT_PLATFORMS[@]}" | grep -wq "${platform}" || die "${platform}"
|
|
|
|
shift
|
|
local local_options=()
|
|
local options=(
|
|
"-DOT_PLATFORM=${platform}"
|
|
"-DOT_SLAAC=ON"
|
|
)
|
|
|
|
case "${platform}" in
|
|
posix)
|
|
local_options+=(
|
|
"-DOT_LOG_OUTPUT=PLATFORM_DEFINED"
|
|
"-DOT_POSIX_MAX_POWER_TABLE=ON"
|
|
)
|
|
options+=("${OT_POSIX_SIM_COMMON_OPTIONS[@]}" "${local_options[@]}")
|
|
;;
|
|
simulation)
|
|
local_options=("-DOT_LINK_RAW=ON")
|
|
options+=("${OT_POSIX_SIM_COMMON_OPTIONS[@]}" "${local_options[@]}")
|
|
;;
|
|
cc2538)
|
|
options+=("-DCMAKE_TOOLCHAIN_FILE=examples/platforms/${platform}/arm-none-eabi.cmake" "-DCMAKE_BUILD_TYPE=MinSizeRel")
|
|
;;
|
|
*)
|
|
options+=("-DCMAKE_TOOLCHAIN_FILE=examples/platforms/${platform}/arm-none-eabi.cmake")
|
|
;;
|
|
esac
|
|
|
|
options+=("$@")
|
|
build "${platform}" "${options[@]}"
|
|
}
|
|
|
|
main "$@"
|