mirror of
https://github.com/esphome/esphome.git
synced 2026-09-11 15:27:33 +00:00
91 lines
3.0 KiB
C++
91 lines
3.0 KiB
C++
#pragma once
|
|
|
|
#include "esphome/core/component.h"
|
|
#include "esphome/core/entity_base.h"
|
|
#include "esphome/core/helpers.h"
|
|
#ifdef USE_TEXT_SENSOR_FILTER
|
|
#include "esphome/components/text_sensor/filter.h"
|
|
#endif
|
|
|
|
#include <initializer_list>
|
|
#include <memory>
|
|
|
|
namespace esphome::text_sensor {
|
|
|
|
class TextSensor;
|
|
|
|
void log_text_sensor(const char *tag, const char *prefix, const char *type, TextSensor *obj);
|
|
|
|
#define LOG_TEXT_SENSOR(prefix, type, obj) log_text_sensor(TAG, prefix, LOG_STR_LITERAL(type), obj)
|
|
|
|
#define SUB_TEXT_SENSOR(name) \
|
|
protected: \
|
|
text_sensor::TextSensor *name##_text_sensor_{nullptr}; \
|
|
\
|
|
public: \
|
|
void set_##name##_text_sensor(text_sensor::TextSensor *text_sensor) { this->name##_text_sensor_ = text_sensor; }
|
|
|
|
class TextSensor : public EntityBase {
|
|
public:
|
|
std::string state;
|
|
|
|
TextSensor() = default;
|
|
~TextSensor() = default;
|
|
|
|
/// Getter-syntax for .state.
|
|
const std::string &get_state() const;
|
|
/// Returns the raw (pre-filter) state.
|
|
const std::string &get_raw_state() const;
|
|
|
|
void publish_state(const std::string &state);
|
|
void publish_state(const char *state);
|
|
void publish_state(const char *state, size_t len);
|
|
|
|
#ifdef USE_TEXT_SENSOR_FILTER
|
|
/// Add a filter to the filter chain. Will be appended to the back.
|
|
void add_filter(Filter *filter);
|
|
|
|
/// Add a list of vectors to the back of the filter chain.
|
|
void add_filters(std::initializer_list<Filter *> filters);
|
|
|
|
/// Clear the filters and replace them by filters.
|
|
void set_filters(std::initializer_list<Filter *> filters);
|
|
|
|
/// Clear the entire filter chain.
|
|
void clear_filters();
|
|
#endif
|
|
|
|
template<typename F> void add_on_state_callback(F &&callback) { this->callback_.add(std::forward<F>(callback)); }
|
|
/// Add a callback that will be called every time the sensor sends a raw value.
|
|
/// When USE_TEXT_SENSOR_FILTER is not enabled, delegates to the regular callback
|
|
/// since raw state equals filtered state without filter support compiled in.
|
|
template<typename F> void add_on_raw_state_callback(F &&callback) {
|
|
#ifdef USE_TEXT_SENSOR_FILTER
|
|
this->raw_callback_.add(std::forward<F>(callback));
|
|
#else
|
|
this->callback_.add(std::forward<F>(callback));
|
|
#endif
|
|
}
|
|
|
|
// ========== INTERNAL METHODS ==========
|
|
// (In most use cases you won't need these)
|
|
|
|
void internal_send_state_to_frontend(const std::string &state);
|
|
void internal_send_state_to_frontend(const char *state, size_t len);
|
|
|
|
protected:
|
|
/// Notify frontend that state has changed (assumes this->state is already set)
|
|
void notify_frontend_();
|
|
#ifdef USE_TEXT_SENSOR_FILTER
|
|
std::string raw_state_; ///< Backing storage for the raw (pre-filter) value. Only used when a filter is attached.
|
|
LazyCallbackManager<void(const std::string &)> raw_callback_; ///< Storage for raw state callbacks.
|
|
#endif
|
|
LazyCallbackManager<void(const std::string &)> callback_; ///< Storage for filtered state callbacks.
|
|
|
|
#ifdef USE_TEXT_SENSOR_FILTER
|
|
Filter *filter_list_{nullptr}; ///< Store all active filters.
|
|
#endif
|
|
};
|
|
|
|
} // namespace esphome::text_sensor
|