xref: /aosp_15_r20/external/openthread/src/cli/cli_tcat.hpp (revision cfb92d1480a9e65faed56933e9c12405f45898b4)
1*cfb92d14SAndroid Build Coastguard Worker /*
2*cfb92d14SAndroid Build Coastguard Worker  *  Copyright (c) 2023, The OpenThread Authors.
3*cfb92d14SAndroid Build Coastguard Worker  *  All rights reserved.
4*cfb92d14SAndroid Build Coastguard Worker  *
5*cfb92d14SAndroid Build Coastguard Worker  *  Redistribution and use in source and binary forms, with or without
6*cfb92d14SAndroid Build Coastguard Worker  *  modification, are permitted provided that the following conditions are met:
7*cfb92d14SAndroid Build Coastguard Worker  *  1. Redistributions of source code must retain the above copyright
8*cfb92d14SAndroid Build Coastguard Worker  *     notice, this list of conditions and the following disclaimer.
9*cfb92d14SAndroid Build Coastguard Worker  *  2. Redistributions in binary form must reproduce the above copyright
10*cfb92d14SAndroid Build Coastguard Worker  *     notice, this list of conditions and the following disclaimer in the
11*cfb92d14SAndroid Build Coastguard Worker  *     documentation and/or other materials provided with the distribution.
12*cfb92d14SAndroid Build Coastguard Worker  *  3. Neither the name of the copyright holder nor the
13*cfb92d14SAndroid Build Coastguard Worker  *     names of its contributors may be used to endorse or promote products
14*cfb92d14SAndroid Build Coastguard Worker  *     derived from this software without specific prior written permission.
15*cfb92d14SAndroid Build Coastguard Worker  *
16*cfb92d14SAndroid Build Coastguard Worker  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
17*cfb92d14SAndroid Build Coastguard Worker  *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18*cfb92d14SAndroid Build Coastguard Worker  *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19*cfb92d14SAndroid Build Coastguard Worker  *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
20*cfb92d14SAndroid Build Coastguard Worker  *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21*cfb92d14SAndroid Build Coastguard Worker  *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22*cfb92d14SAndroid Build Coastguard Worker  *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23*cfb92d14SAndroid Build Coastguard Worker  *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24*cfb92d14SAndroid Build Coastguard Worker  *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25*cfb92d14SAndroid Build Coastguard Worker  *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26*cfb92d14SAndroid Build Coastguard Worker  *  POSSIBILITY OF SUCH DAMAGE.
27*cfb92d14SAndroid Build Coastguard Worker  */
28*cfb92d14SAndroid Build Coastguard Worker 
29*cfb92d14SAndroid Build Coastguard Worker #ifndef CLI_TCAT_HPP_
30*cfb92d14SAndroid Build Coastguard Worker #define CLI_TCAT_HPP_
31*cfb92d14SAndroid Build Coastguard Worker 
32*cfb92d14SAndroid Build Coastguard Worker #include "openthread-core-config.h"
33*cfb92d14SAndroid Build Coastguard Worker 
34*cfb92d14SAndroid Build Coastguard Worker #include <openthread/tcat.h>
35*cfb92d14SAndroid Build Coastguard Worker 
36*cfb92d14SAndroid Build Coastguard Worker #include "cli/cli_utils.hpp"
37*cfb92d14SAndroid Build Coastguard Worker 
38*cfb92d14SAndroid Build Coastguard Worker #if OPENTHREAD_CONFIG_BLE_TCAT_ENABLE && OPENTHREAD_CONFIG_CLI_BLE_SECURE_ENABLE
39*cfb92d14SAndroid Build Coastguard Worker 
40*cfb92d14SAndroid Build Coastguard Worker namespace ot {
41*cfb92d14SAndroid Build Coastguard Worker 
42*cfb92d14SAndroid Build Coastguard Worker namespace Cli {
43*cfb92d14SAndroid Build Coastguard Worker 
44*cfb92d14SAndroid Build Coastguard Worker /**
45*cfb92d14SAndroid Build Coastguard Worker  * Implements the Tcat CLI interpreter.
46*cfb92d14SAndroid Build Coastguard Worker  *
47*cfb92d14SAndroid Build Coastguard Worker  */
48*cfb92d14SAndroid Build Coastguard Worker class Tcat : private Utils
49*cfb92d14SAndroid Build Coastguard Worker {
50*cfb92d14SAndroid Build Coastguard Worker public:
51*cfb92d14SAndroid Build Coastguard Worker     /**
52*cfb92d14SAndroid Build Coastguard Worker      * Constructor
53*cfb92d14SAndroid Build Coastguard Worker      *
54*cfb92d14SAndroid Build Coastguard Worker      * @param[in]  aInstance            The OpenThread Instance.
55*cfb92d14SAndroid Build Coastguard Worker      * @param[in]  aOutputImplementer   An `OutputImplementer`.
56*cfb92d14SAndroid Build Coastguard Worker      *
57*cfb92d14SAndroid Build Coastguard Worker      */
Tcat(otInstance * aInstance,OutputImplementer & aOutputImplementer)58*cfb92d14SAndroid Build Coastguard Worker     Tcat(otInstance *aInstance, OutputImplementer &aOutputImplementer)
59*cfb92d14SAndroid Build Coastguard Worker         : Utils(aInstance, aOutputImplementer)
60*cfb92d14SAndroid Build Coastguard Worker     {
61*cfb92d14SAndroid Build Coastguard Worker     }
62*cfb92d14SAndroid Build Coastguard Worker 
63*cfb92d14SAndroid Build Coastguard Worker     /**
64*cfb92d14SAndroid Build Coastguard Worker      * Processes a CLI sub-command.
65*cfb92d14SAndroid Build Coastguard Worker      *
66*cfb92d14SAndroid Build Coastguard Worker      * @param[in]  aArgs     An array of command line arguments.
67*cfb92d14SAndroid Build Coastguard Worker      *
68*cfb92d14SAndroid Build Coastguard Worker      * @retval OT_ERROR_NONE              Successfully executed the CLI command.
69*cfb92d14SAndroid Build Coastguard Worker      * @retval OT_ERROR_PENDING           The CLI command was successfully started but final result is pending.
70*cfb92d14SAndroid Build Coastguard Worker      * @retval OT_ERROR_INVALID_COMMAND   Invalid or unknown CLI command.
71*cfb92d14SAndroid Build Coastguard Worker      * @retval OT_ERROR_INVALID_ARGS      Invalid arguments.
72*cfb92d14SAndroid Build Coastguard Worker      * @retval ...                        Error during execution of the CLI command.
73*cfb92d14SAndroid Build Coastguard Worker      *
74*cfb92d14SAndroid Build Coastguard Worker      */
75*cfb92d14SAndroid Build Coastguard Worker     otError Process(Arg aArgs[]);
76*cfb92d14SAndroid Build Coastguard Worker 
77*cfb92d14SAndroid Build Coastguard Worker private:
78*cfb92d14SAndroid Build Coastguard Worker     using Command = CommandEntry<Tcat>;
79*cfb92d14SAndroid Build Coastguard Worker 
80*cfb92d14SAndroid Build Coastguard Worker     template <CommandId kCommandId> otError Process(Arg aArgs[]);
81*cfb92d14SAndroid Build Coastguard Worker 
82*cfb92d14SAndroid Build Coastguard Worker     otTcatVendorInfo mVendorInfo;
83*cfb92d14SAndroid Build Coastguard Worker };
84*cfb92d14SAndroid Build Coastguard Worker 
85*cfb92d14SAndroid Build Coastguard Worker } // namespace Cli
86*cfb92d14SAndroid Build Coastguard Worker 
87*cfb92d14SAndroid Build Coastguard Worker } // namespace ot
88*cfb92d14SAndroid Build Coastguard Worker 
89*cfb92d14SAndroid Build Coastguard Worker #endif // OPENTHREAD_CONFIG_BLE_TCAT_ENABLE && OPENTHREAD_CONFIG_CLI_BLE_SECURE_ENABLE
90*cfb92d14SAndroid Build Coastguard Worker 
91*cfb92d14SAndroid Build Coastguard Worker #endif // CLI_TCAT_HPP_
92