mirror of
https://github.com/espressif/openthread.git
synced 2026-06-05 21:14:49 +00:00
Zhanglong Xia
8b59f4d31e
The actual output power of the Thread device may be determined by both the Thread radio chip and the FEM. Consider the output power error of the Thread radio chip and the gain error of the FEM, the actual output power is inconsistent with the expected output power. To guarantee that the actual output power is accurate and meet the regulatory requirements, the output power should be calibrated in the factory if the output power is not accurate. This commit contains the following changes: - Adds a power calibration implementation - Adds a config file to configure the target power for different countries - Adds a tool for the factory to persist the power calibration data
118 lines
4.0 KiB
C++
118 lines
4.0 KiB
C++
/*
|
|
* Copyright (c) 2022, 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 strain 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.
|
|
*/
|
|
|
|
#ifndef CLI_H
|
|
#define CLI_H
|
|
|
|
#include "openthread-posix-config.h"
|
|
|
|
#include <stdint.h>
|
|
#include <stdio.h>
|
|
|
|
#include "config_file.hpp"
|
|
#include "power.hpp"
|
|
#include "utils/parse_cmdline.hpp"
|
|
|
|
#include <openthread/error.h>
|
|
#include <openthread/platform/radio.h>
|
|
|
|
namespace ot {
|
|
namespace Fct {
|
|
|
|
class Cli;
|
|
|
|
/**
|
|
* This class implements the factory CLI.
|
|
*
|
|
*/
|
|
class Cli
|
|
{
|
|
public:
|
|
Cli(void)
|
|
: mFactoryConfigFile(OPENTHREAD_POSIX_CONFIG_FACTORY_CONFIG_FILE)
|
|
, mProductConfigFile(OPENTHREAD_POSIX_CONFIG_PRODUCT_CONFIG_FILE)
|
|
{
|
|
}
|
|
|
|
/**
|
|
* This method processes a factory command.
|
|
*
|
|
* @param[in] aArgs The arguments of command line.
|
|
* @param[in] aArgsLength The number of args in @p aArgs.
|
|
*
|
|
*/
|
|
void ProcessCommand(Utils::CmdLineParser::Arg aArgs[]);
|
|
|
|
/**
|
|
* This method processes the command line.
|
|
*
|
|
* @param[in] aLine A pointer to a command line string.
|
|
*
|
|
*/
|
|
void ProcessLine(char *aLine);
|
|
|
|
/**
|
|
* This method outputs the prompt.
|
|
*
|
|
*/
|
|
void OutputPrompt(void);
|
|
|
|
private:
|
|
static constexpr uint16_t kMaxValueSize = 512;
|
|
const char *kKeyCalibratedPower = "calibrated_power";
|
|
const char *kKeyTargetPower = "target_power";
|
|
const char *kKeyRegionDomainMapping = "region_domain_mapping";
|
|
const char *kCommaDelimiter = ",";
|
|
|
|
struct Command
|
|
{
|
|
const char *mName;
|
|
otError (Cli::*mCommand)(Utils::CmdLineParser::Arg aArgs[]);
|
|
};
|
|
|
|
otError ParseNextCalibratedPower(char *aCalibratedPowerString,
|
|
uint16_t aLength,
|
|
uint16_t &aIterator,
|
|
Power::CalibratedPower &aCalibratedPower);
|
|
otError ProcessCalibrationTable(Utils::CmdLineParser::Arg aArgs[]);
|
|
otError ProcessTargetPowerTable(Utils::CmdLineParser::Arg aArgs[]);
|
|
otError ProcessRegionDomainTable(Utils::CmdLineParser::Arg aArgs[]);
|
|
otError GetNextDomain(int &aIterator, Power::Domain &aDomain);
|
|
otError GetNextTargetPower(const Power::Domain &aDomain, int &aIterator, Power::TargetPower &aTargetPower);
|
|
|
|
void AppendErrorResult(otError aError);
|
|
|
|
static const struct Command sCommands[];
|
|
|
|
ot::Posix::ConfigFile mFactoryConfigFile;
|
|
ot::Posix::ConfigFile mProductConfigFile;
|
|
};
|
|
} // namespace Fct
|
|
} // namespace ot
|
|
#endif
|