Files
2026-05-22 22:05:03 +03:00

238 lines
8.3 KiB
C++

// Copyright 2022 Espressif Systems (Shanghai) PTE LTD
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#pragma once
#include <json_to_tlv.h>
#include <app-common/zap-generated/cluster-objects.h>
#include <app/data-model/EncodableToTLV.h>
#include <cassert>
#include <esp_err.h>
#include <esp_matter_core.h>
#include <string.h>
namespace esp_matter {
namespace client {
namespace interaction {
using chip::Optional;
using chip::app::AttributePathParams;
using chip::app::CommandPathParams;
using chip::app::CommandSender;
using chip::app::ConcreteCommandPath;
using chip::app::EventPathParams;
using chip::app::ReadClient;
using chip::app::StatusIB;
using chip::app::WriteClient;
using chip::Messaging::ExchangeManager;
using chip::Platform::ScopedMemoryBufferWithSize;
using chip::System::Clock::Timeout;
using chip::TLV::TLVReader;
using client::peer_device_t;
using chip::app::DataModel::EncodableToTLV;
class custom_encodable_type : public EncodableToTLV
{
public:
const char *k_empty_command_data = "{}";
const char *k_null_attribute_data = "null";
enum interaction_type {
k_invoke_cmd = 0,
k_write_attr,
};
custom_encodable_type(const char *json_str, interaction_type usage)
{
if (json_str) {
m_json_str = strdup(json_str);
} else {
if (usage == k_invoke_cmd) {
m_json_str = strdup("{}");
} else if (usage == k_write_attr) {
m_json_str = strdup("null");
}
}
assert(m_json_str);
}
~custom_encodable_type() { free(m_json_str); }
CHIP_ERROR EncodeTo(chip::TLV::TLVWriter & writer, chip::TLV::Tag tag) const override
{
if (json_to_tlv(m_json_str, writer, tag) != ESP_OK) {
return CHIP_ERROR_INTERNAL;
}
return CHIP_NO_ERROR;
}
private:
char *m_json_str = NULL;
};
class multiple_write_encodable_type
{
public:
multiple_write_encodable_type(const char *json_str)
{
json = cJSON_Parse(json_str);
}
~multiple_write_encodable_type() { cJSON_Delete(json); }
CHIP_ERROR EncodeTo(chip::TLV::TLVWriter &writer, chip::TLV::Tag tag, size_t index)
{
cJSON *json_at_index = NULL;
if (!json) {
return CHIP_ERROR_INVALID_ARGUMENT;
}
if (json->type != cJSON_Array) {
json_at_index = json;
} else {
json_at_index = cJSON_GetArrayItem(json, index);
}
if (json_to_tlv(json_at_index, writer, tag) != ESP_OK) {
return CHIP_ERROR_INTERNAL;
}
return CHIP_NO_ERROR;
}
size_t GetJsonArraySize() { return static_cast<size_t>(cJSON_GetArraySize(json)); }
private:
cJSON *json = NULL;
};
/** Command invoke APIs
*
* They can be used for all the commands of all the clusters, including the custom clusters.
*/
namespace invoke {
class custom_command_callback final : public chip::app::CommandSender::Callback {
public:
using on_success_callback_t =
std::function<void(void *, const ConcreteCommandPath &, const StatusIB &, TLVReader *)>;
using on_error_callback_t = std::function<void(void *, CHIP_ERROR error)>;
using on_done_callback_t = std::function<void(void *, CommandSender *command_sender)>;
custom_command_callback(void *ctx, on_success_callback_t on_success, on_error_callback_t on_error,
on_done_callback_t on_done = {})
: on_success_cb(on_success)
, on_error_cb(on_error)
, on_done_cb(on_done)
, context(ctx)
{
}
void set_on_done_callback(on_done_callback_t on_done) { on_done_cb = on_done; }
private:
void OnResponse(CommandSender *command_sender, const ConcreteCommandPath &command_path, const StatusIB &status,
TLVReader *response_data) override
{
if (called_callback) {
return;
}
called_callback = true;
if (on_success_cb) {
on_success_cb(context, command_path, status, response_data);
}
}
void OnError(const CommandSender *command_sender, CHIP_ERROR error) override
{
if (called_callback) {
return;
}
called_callback = true;
if (on_error_cb) {
on_error_cb(context, error);
}
}
void OnDone(CommandSender *command_sender) override
{
if (!called_callback) {
OnError(command_sender, CHIP_END_OF_TLV);
}
if (on_done_cb) {
on_done_cb(context, command_sender);
}
}
on_success_callback_t on_success_cb;
on_error_callback_t on_error_cb;
on_done_callback_t on_done_cb;
bool called_callback = false;
void *context;
};
esp_err_t send_request(void *ctx, peer_device_t *remote_device, const CommandPathParams &command_path,
const char *command_data_json_str, custom_command_callback::on_success_callback_t on_success,
custom_command_callback::on_error_callback_t on_error,
const Optional<uint16_t> &timed_invoke_timeout_ms,
const Optional<Timeout> &response_timeout = chip::NullOptional);
esp_err_t send_group_request(const uint8_t fabric_index, const CommandPathParams &command_path,
const char *command_data_json_str);
esp_err_t send_request(void *ctx, peer_device_t *remote_device, const CommandPathParams &command_path,
const chip::app::DataModel::EncodableToTLV &encodable,
custom_command_callback::on_success_callback_t on_success,
custom_command_callback::on_error_callback_t on_error,
const Optional<uint16_t> &timed_invoke_timeout_ms,
const Optional<Timeout> &response_timeout = chip::NullOptional);
esp_err_t send_group_request(const uint8_t fabric_index, const CommandPathParams &command_path,
const chip::app::DataModel::EncodableToTLV &encodable);
} // namespace invoke
/** Attribute/event read API
*
* It can be used for reading all the attributes/events of all the clusters, including the custom clusters.
*/
namespace read {
esp_err_t send_request(client::peer_device_t *remote_device, AttributePathParams *attr_path, size_t attr_path_size,
EventPathParams *event_path, size_t event_path_size, ReadClient::Callback &callback);
} // namespace read
/** Attribute write API
*
* It can be used for writing all the attributes of all the clusters, including the custom clusters.
*/
namespace write {
esp_err_t send_request(client::peer_device_t *remote_device, AttributePathParams &attr_path,
const char *attr_val_json_str, WriteClient::Callback &callback,
const chip::Optional<uint16_t> &timeout_ms);
esp_err_t send_request(client::peer_device_t *remote_device, AttributePathParams &attr_path,
const chip::app::DataModel::EncodableToTLV &encodable, WriteClient::Callback &callback,
const chip::Optional<uint16_t> &timeout_ms);
esp_err_t send_request(client::peer_device_t *remote_device, ScopedMemoryBufferWithSize<AttributePathParams> &attr_paths,
multiple_write_encodable_type &json_encodable, WriteClient::Callback &callback,
const chip::Optional<uint16_t> &timeout_ms);
} // namespace write
namespace subscribe {
esp_err_t send_request(client::peer_device_t *remote_device, AttributePathParams *attr_path, size_t attr_path_size,
EventPathParams *event_path, size_t event_path_size, uint16_t min_interval,
uint16_t max_interval, bool keep_subscription, bool auto_resubscribe,
ReadClient::Callback &callback);
} // namespace subscribe
} // namespace interaction
} // namespace client
} // namespace esp_matter