3 * Copyright (c) 2020 Project CHIP Authors
4 * Copyright (c) 2016-2017 Nest Labs, Inc.
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
20 * This file defines CommandDataElement parser and builder in CHIP interaction model
26 #ifndef _CHIP_INTERACTION_MODEL_MESSAGE_DEF_COMMAND_DATA_ELEMENT_H
27 #define _CHIP_INTERACTION_MODEL_MESSAGE_DEF_COMMAND_DATA_ELEMENT_H
30 #include "CommandPath.h"
33 #include "StatusElement.h"
34 #include <core/CHIPCore.h>
35 #include <core/CHIPTLV.h>
36 #include <support/CodeUtils.h>
37 #include <support/logging/CHIPLogging.h>
38 #include <util/basic-types.h>
42 namespace CommandDataElement {
45 kCsTag_CommandPath = 0,
47 kCsTag_StatusElement = 2,
50 class Parser : public chip::app::Parser
54 * @brief Initialize the parser object with TLVReader
56 * @param [in] aReader A pointer to a TLVReader, which should point to the beginning of this CommandDataElement
58 * @return #CHIP_NO_ERROR on success
60 CHIP_ERROR Init(const chip::TLV::TLVReader & aReader);
63 * @brief Roughly verify the message is correctly formed
64 * 1) all mandatory tags are present
65 * 2) all elements have expected data type
66 * 3) any tag can only appear once
67 * 4) At the top level of the structure, unknown tags are ignored for forward compatibility
68 * @note The main use of this function is to print out what we're
69 * receiving during protocol development and debugging.
70 * The encoding rule has changed in IM encoding spec so this
71 * check is only "roughly" conformant now.
73 * @return #CHIP_NO_ERROR on success
75 CHIP_ERROR CheckSchemaValidity() const;
78 * @brief Get a TLVReader for the CommandPath. Next() must be called before accessing them.
80 * @param [in] apCommandPath A pointer to apCommandPath
82 * @return #CHIP_NO_ERROR on success
83 * #CHIP_ERROR_WRONG_TLV_TYPE if there is such element but it's not a Path
84 * #CHIP_END_OF_TLV if there is no such element
86 CHIP_ERROR GetCommandPath(CommandPath::Parser * const apCommandPath) const;
89 * @brief Get a TLVReader for the Data. Next() must be called before accessing them.
91 * @param [in] apReader A pointer to apReader
93 * @return #CHIP_NO_ERROR on success
94 * #CHIP_END_OF_TLV if there is no such element
96 CHIP_ERROR GetData(chip::TLV::TLVReader * const apReader) const;
99 * @brief Get a TLVReader for the StatusElement. Next() must be called before accessing them.
101 * @param [in] apStatusElement A pointer to apStatusElement
103 * @return #CHIP_NO_ERROR on success
104 * # CHIP_ERROR_WRONG_TLV_TYPE if there is such element but it's not a structure
105 * #CHIP_END_OF_TLV if there is no such element
107 CHIP_ERROR GetStatusElement(StatusElement::Parser * const apStatusElement) const;
110 // A recursively callable function to parse a data element and pretty-print it.
111 CHIP_ERROR ParseData(chip::TLV::TLVReader & aReader, int aDepth) const;
114 class Builder : public chip::app::Builder
118 * @brief Initialize a AttributeDataList::Builder for writing into a TLV stream
120 * @param [in] apWriter A pointer to TLVWriter
122 * @return #CHIP_NO_ERROR on success
124 CHIP_ERROR Init(chip::TLV::TLVWriter * const apWriter);
127 * @brief Initialize a CommandPath::Builder for writing into the TLV stream
129 * @return A reference to CommandPath::Builder
131 CommandPath::Builder & CreateCommandPathBuilder();
134 * @brief Initialize a StatusElement::Builder for writing into the TLV stream
136 * @return A reference to StatusElement::Builder
138 StatusElement::Builder & CreateStatusElementBuilder();
141 * @brief Mark the end of this CommandDataElement
143 * @return A reference to *this
145 CommandDataElement::Builder & EndOfCommandDataElement();
148 CommandPath::Builder mCommandPathBuilder;
149 StatusElement::Builder mStatusElementBuilder;
151 }; // namespace CommandDataElement
155 #endif // _CHIP_INTERACTION_MODEL_MESSAGE_DEF_COMMAND_DATA_ELEMENT_H