ESPHome  2023.3.2
text_sensor.h
Go to the documentation of this file.
1 #pragma once
2 
5 #include "esphome/core/helpers.h"
7 
8 #include <vector>
9 
10 namespace esphome {
11 namespace text_sensor {
12 
13 #define LOG_TEXT_SENSOR(prefix, type, obj) \
14  if ((obj) != nullptr) { \
15  ESP_LOGCONFIG(TAG, "%s%s '%s'", prefix, LOG_STR_LITERAL(type), (obj)->get_name().c_str()); \
16  if (!(obj)->get_icon().empty()) { \
17  ESP_LOGCONFIG(TAG, "%s Icon: '%s'", prefix, (obj)->get_icon().c_str()); \
18  } \
19  if (!(obj)->unique_id().empty()) { \
20  ESP_LOGV(TAG, "%s Unique ID: '%s'", prefix, (obj)->unique_id().c_str()); \
21  } \
22  }
23 
24 #define SUB_TEXT_SENSOR(name) \
25  protected: \
26  text_sensor::TextSensor *name##_text_sensor_{nullptr}; \
27 \
28  public: \
29  void set_##name##_text_sensor(text_sensor::TextSensor *text_sensor) { this->name##_text_sensor_ = text_sensor; }
30 
31 class TextSensor : public EntityBase {
32  public:
33  explicit TextSensor();
34  explicit TextSensor(const std::string &name);
35 
37  std::string get_state() const;
39  std::string get_raw_state() const;
40 
41  void publish_state(const std::string &state);
42 
44  void add_filter(Filter *filter);
45 
47  void add_filters(const std::vector<Filter *> &filters);
48 
50  void set_filters(const std::vector<Filter *> &filters);
51 
53  void clear_filters();
54 
55  void add_on_state_callback(std::function<void(std::string)> callback);
57  void add_on_raw_state_callback(std::function<void(std::string)> callback);
58 
59  std::string state;
60  std::string raw_state;
61 
62  // ========== INTERNAL METHODS ==========
63  // (In most use cases you won't need these)
64  virtual std::string unique_id();
65 
66  bool has_state();
67 
68  void internal_send_state_to_frontend(const std::string &state);
69 
70  protected:
73 
74  Filter *filter_list_{nullptr};
75 
76  bool has_state_{false};
77 };
78 
79 } // namespace text_sensor
80 } // namespace esphome
const char * name
Definition: stm32flash.h:78
void add_on_state_callback(std::function< void(std::string)> callback)
Definition: text_sensor.cpp:55
virtual std::string unique_id()
Definition: text_sensor.cpp:71
void add_filters(const std::vector< Filter *> &filters)
Add a list of vectors to the back of the filter chain.
Definition: text_sensor.cpp:39
void publish_state(const std::string &state)
Definition: text_sensor.cpp:12
void add_on_raw_state_callback(std::function< void(std::string)> callback)
Add a callback that will be called every time the sensor sends a raw value.
Definition: text_sensor.cpp:58
void add_filter(Filter *filter)
Add a filter to the filter chain. Will be appended to the back.
Definition: text_sensor.cpp:25
CallbackManager< void(std::string)> callback_
Storage for filtered state callbacks.
Definition: text_sensor.h:72
void internal_send_state_to_frontend(const std::string &state)
Definition: text_sensor.cpp:64
std::string get_state() const
Getter-syntax for .state.
Definition: text_sensor.cpp:62
void set_filters(const std::vector< Filter *> &filters)
Clear the filters and replace them by filters.
Definition: text_sensor.cpp:44
Filter * filter_list_
Store all active filters.
Definition: text_sensor.h:74
Definition: a4988.cpp:4
void clear_filters()
Clear the entire filter chain.
Definition: text_sensor.cpp:48
Apply a filter to text sensor values such as to_upper.
Definition: filter.h:20
std::string get_raw_state() const
Getter-syntax for .raw_state.
Definition: text_sensor.cpp:63
CallbackManager< void(std::string)> raw_callback_
Storage for raw state callbacks.
Definition: text_sensor.h:71