ESPHome  2024.12.2
ld2410.h
Go to the documentation of this file.
1 #pragma once
2 #include "esphome/core/defines.h"
3 #include "esphome/core/component.h"
4 #ifdef USE_BINARY_SENSOR
5 #include "esphome/components/binary_sensor/binary_sensor.h"
6 #endif
7 #ifdef USE_SENSOR
8 #include "esphome/components/sensor/sensor.h"
9 #endif
10 #ifdef USE_NUMBER
11 #include "esphome/components/number/number.h"
12 #endif
13 #ifdef USE_SWITCH
14 #include "esphome/components/switch/switch.h"
15 #endif
16 #ifdef USE_BUTTON
17 #include "esphome/components/button/button.h"
18 #endif
19 #ifdef USE_SELECT
20 #include "esphome/components/select/select.h"
21 #endif
22 #ifdef USE_TEXT_SENSOR
23 #include "esphome/components/text_sensor/text_sensor.h"
24 #endif
25 #include "esphome/components/uart/uart.h"
26 #include "esphome/core/automation.h"
27 #include "esphome/core/helpers.h"
28 
29 #include <map>
30 
31 namespace esphome {
32 namespace ld2410 {
33 
34 #define CHECK_BIT(var, pos) (((var) >> (pos)) & 1)
35 
36 // Commands
37 static const uint8_t CMD_ENABLE_CONF = 0x00FF;
38 static const uint8_t CMD_DISABLE_CONF = 0x00FE;
39 static const uint8_t CMD_ENABLE_ENG = 0x0062;
40 static const uint8_t CMD_DISABLE_ENG = 0x0063;
41 static const uint8_t CMD_MAXDIST_DURATION = 0x0060;
42 static const uint8_t CMD_QUERY = 0x0061;
43 static const uint8_t CMD_GATE_SENS = 0x0064;
44 static const uint8_t CMD_VERSION = 0x00A0;
45 static const uint8_t CMD_QUERY_DISTANCE_RESOLUTION = 0x00AB;
46 static const uint8_t CMD_SET_DISTANCE_RESOLUTION = 0x00AA;
47 static const uint8_t CMD_QUERY_LIGHT_CONTROL = 0x00AE;
48 static const uint8_t CMD_SET_LIGHT_CONTROL = 0x00AD;
49 static const uint8_t CMD_SET_BAUD_RATE = 0x00A1;
50 static const uint8_t CMD_BT_PASSWORD = 0x00A9;
51 static const uint8_t CMD_MAC = 0x00A5;
52 static const uint8_t CMD_RESET = 0x00A2;
53 static const uint8_t CMD_RESTART = 0x00A3;
54 static const uint8_t CMD_BLUETOOTH = 0x00A4;
55 
56 enum BaudRateStructure : uint8_t {
57  BAUD_RATE_9600 = 1,
58  BAUD_RATE_19200 = 2,
59  BAUD_RATE_38400 = 3,
60  BAUD_RATE_57600 = 4,
61  BAUD_RATE_115200 = 5,
62  BAUD_RATE_230400 = 6,
63  BAUD_RATE_256000 = 7,
64  BAUD_RATE_460800 = 8
65 };
66 
67 static const std::map<std::string, uint8_t> BAUD_RATE_ENUM_TO_INT{
68  {"9600", BAUD_RATE_9600}, {"19200", BAUD_RATE_19200}, {"38400", BAUD_RATE_38400},
69  {"57600", BAUD_RATE_57600}, {"115200", BAUD_RATE_115200}, {"230400", BAUD_RATE_230400},
70  {"256000", BAUD_RATE_256000}, {"460800", BAUD_RATE_460800}};
71 
72 enum DistanceResolutionStructure : uint8_t { DISTANCE_RESOLUTION_0_2 = 0x01, DISTANCE_RESOLUTION_0_75 = 0x00 };
73 
74 static const std::map<std::string, uint8_t> DISTANCE_RESOLUTION_ENUM_TO_INT{{"0.2m", DISTANCE_RESOLUTION_0_2},
75  {"0.75m", DISTANCE_RESOLUTION_0_75}};
76 static const std::map<uint8_t, std::string> DISTANCE_RESOLUTION_INT_TO_ENUM{{DISTANCE_RESOLUTION_0_2, "0.2m"},
77  {DISTANCE_RESOLUTION_0_75, "0.75m"}};
78 
79 enum LightFunctionStructure : uint8_t {
80  LIGHT_FUNCTION_OFF = 0x00,
81  LIGHT_FUNCTION_BELOW = 0x01,
82  LIGHT_FUNCTION_ABOVE = 0x02
83 };
84 
85 static const std::map<std::string, uint8_t> LIGHT_FUNCTION_ENUM_TO_INT{
86  {"off", LIGHT_FUNCTION_OFF}, {"below", LIGHT_FUNCTION_BELOW}, {"above", LIGHT_FUNCTION_ABOVE}};
87 static const std::map<uint8_t, std::string> LIGHT_FUNCTION_INT_TO_ENUM{
88  {LIGHT_FUNCTION_OFF, "off"}, {LIGHT_FUNCTION_BELOW, "below"}, {LIGHT_FUNCTION_ABOVE, "above"}};
89 
90 enum OutPinLevelStructure : uint8_t { OUT_PIN_LEVEL_LOW = 0x00, OUT_PIN_LEVEL_HIGH = 0x01 };
91 
92 static const std::map<std::string, uint8_t> OUT_PIN_LEVEL_ENUM_TO_INT{{"low", OUT_PIN_LEVEL_LOW},
93  {"high", OUT_PIN_LEVEL_HIGH}};
94 static const std::map<uint8_t, std::string> OUT_PIN_LEVEL_INT_TO_ENUM{{OUT_PIN_LEVEL_LOW, "low"},
95  {OUT_PIN_LEVEL_HIGH, "high"}};
96 
97 // Commands values
98 static const uint8_t CMD_MAX_MOVE_VALUE = 0x0000;
99 static const uint8_t CMD_MAX_STILL_VALUE = 0x0001;
100 static const uint8_t CMD_DURATION_VALUE = 0x0002;
101 // Command Header & Footer
102 static const uint8_t CMD_FRAME_HEADER[4] = {0xFD, 0xFC, 0xFB, 0xFA};
103 static const uint8_t CMD_FRAME_END[4] = {0x04, 0x03, 0x02, 0x01};
104 // Data Header & Footer
105 static const uint8_t DATA_FRAME_HEADER[4] = {0xF4, 0xF3, 0xF2, 0xF1};
106 static const uint8_t DATA_FRAME_END[4] = {0xF8, 0xF7, 0xF6, 0xF5};
107 /*
108 Data Type: 6th byte
109 Target states: 9th byte
110  Moving target distance: 10~11th bytes
111  Moving target energy: 12th byte
112  Still target distance: 13~14th bytes
113  Still target energy: 15th byte
114  Detect distance: 16~17th bytes
115 */
116 enum PeriodicDataStructure : uint8_t {
117  DATA_TYPES = 6,
118  TARGET_STATES = 8,
119  MOVING_TARGET_LOW = 9,
120  MOVING_TARGET_HIGH = 10,
121  MOVING_ENERGY = 11,
122  STILL_TARGET_LOW = 12,
123  STILL_TARGET_HIGH = 13,
124  STILL_ENERGY = 14,
125  DETECT_DISTANCE_LOW = 15,
126  DETECT_DISTANCE_HIGH = 16,
127  MOVING_SENSOR_START = 19,
128  STILL_SENSOR_START = 28,
129  LIGHT_SENSOR = 37,
130  OUT_PIN_SENSOR = 38,
131 };
132 enum PeriodicDataValue : uint8_t { HEAD = 0XAA, END = 0x55, CHECK = 0x00 };
133 
134 enum AckDataStructure : uint8_t { COMMAND = 6, COMMAND_STATUS = 7 };
135 
136 // char cmd[2] = {enable ? 0xFF : 0xFE, 0x00};
137 class LD2410Component : public Component, public uart::UARTDevice {
138 #ifdef USE_SENSOR
139  SUB_SENSOR(moving_target_distance)
140  SUB_SENSOR(still_target_distance)
141  SUB_SENSOR(moving_target_energy)
142  SUB_SENSOR(still_target_energy)
143  SUB_SENSOR(light)
144  SUB_SENSOR(detection_distance)
145 #endif
146 #ifdef USE_BINARY_SENSOR
147  SUB_BINARY_SENSOR(target)
148  SUB_BINARY_SENSOR(moving_target)
149  SUB_BINARY_SENSOR(still_target)
150  SUB_BINARY_SENSOR(out_pin_presence_status)
151 #endif
152 #ifdef USE_TEXT_SENSOR
153  SUB_TEXT_SENSOR(version)
154  SUB_TEXT_SENSOR(mac)
155 #endif
156 #ifdef USE_SELECT
157  SUB_SELECT(distance_resolution)
158  SUB_SELECT(baud_rate)
159  SUB_SELECT(light_function)
160  SUB_SELECT(out_pin_level)
161 #endif
162 #ifdef USE_SWITCH
163  SUB_SWITCH(engineering_mode)
164  SUB_SWITCH(bluetooth)
165 #endif
166 #ifdef USE_BUTTON
167  SUB_BUTTON(reset)
168  SUB_BUTTON(restart)
169  SUB_BUTTON(query)
170 #endif
171 #ifdef USE_NUMBER
172  SUB_NUMBER(max_still_distance_gate)
173  SUB_NUMBER(max_move_distance_gate)
174  SUB_NUMBER(timeout)
175  SUB_NUMBER(light_threshold)
176 #endif
177 
178  public:
179  LD2410Component();
180  void setup() override;
181  void dump_config() override;
182  void loop() override;
183  void set_light_out_control();
184 #ifdef USE_NUMBER
185  void set_gate_still_threshold_number(int gate, number::Number *n);
186  void set_gate_move_threshold_number(int gate, number::Number *n);
187  void set_max_distances_timeout();
188  void set_gate_threshold(uint8_t gate);
189 #endif
190 #ifdef USE_SENSOR
191  void set_gate_move_sensor(int gate, sensor::Sensor *s);
192  void set_gate_still_sensor(int gate, sensor::Sensor *s);
193 #endif
194  void set_throttle(uint16_t value) { this->throttle_ = value; };
195  void set_bluetooth_password(const std::string &password);
196  void set_engineering_mode(bool enable);
197  void read_all_info();
198  void restart_and_read_all_info();
199  void set_bluetooth(bool enable);
200  void set_distance_resolution(const std::string &state);
201  void set_baud_rate(const std::string &state);
202  void factory_reset();
203 
204  protected:
205  int two_byte_to_int_(char firstbyte, char secondbyte) { return (int16_t) (secondbyte << 8) + firstbyte; }
206  void send_command_(uint8_t command_str, const uint8_t *command_value, int command_value_len);
207  void set_config_mode_(bool enable);
208  void handle_periodic_data_(uint8_t *buffer, int len);
209  bool handle_ack_data_(uint8_t *buffer, int len);
210  void readline_(int readch, uint8_t *buffer, int len);
211  void query_parameters_();
212  void get_version_();
213  void get_mac_();
214  void get_distance_resolution_();
215  void get_light_control_();
216  void restart_();
217 
218  int32_t last_periodic_millis_ = millis();
219  int32_t last_engineering_mode_change_millis_ = millis();
220  uint16_t throttle_;
221  std::string version_;
222  std::string mac_;
223  std::string out_pin_level_;
224  std::string light_function_;
225  float light_threshold_ = -1;
226 #ifdef USE_NUMBER
227  std::vector<number::Number *> gate_still_threshold_numbers_ = std::vector<number::Number *>(9);
228  std::vector<number::Number *> gate_move_threshold_numbers_ = std::vector<number::Number *>(9);
229 #endif
230 #ifdef USE_SENSOR
231  std::vector<sensor::Sensor *> gate_still_sensors_ = std::vector<sensor::Sensor *>(9);
232  std::vector<sensor::Sensor *> gate_move_sensors_ = std::vector<sensor::Sensor *>(9);
233 #endif
234 };
235 
236 } // namespace ld2410
237 } // namespace esphome
esphome::shelly_dimmer::version
uint8_t version
Definition: stm32flash.h:93
esphome::ld2410::LD2410Component::set_config_mode_
void set_config_mode_(bool enable)
Definition: ld2410.cpp:506
esphome::ld2410::DistanceResolutionStructure
DistanceResolutionStructure
Definition: ld2410.h:72
esphome::ld2410::LD2410Component::readline_
void readline_(int readch, uint8_t *buffer, int len)
Definition: ld2410.cpp:478
esphome::ld2410::LightFunctionStructure
LightFunctionStructure
Definition: ld2410.h:79
esphome::ld2410::LD2410Component::gate_move_threshold_numbers_
std::vector< number::Number * > gate_move_threshold_numbers_
Definition: ld2410.h:228
esphome::millis
uint32_t IRAM_ATTR HOT millis()
Definition: core.cpp:25
binary_sensor.h
esphome::ld2410::LD2410Component::last_engineering_mode_change_millis_
int32_t last_engineering_mode_change_millis_
Definition: ld2410.h:219
esphome::number::Number
Base-class for all numbers.
Definition: number.h:39
esphome::ld2410::LD2410Component::gate_still_threshold_numbers_
std::vector< number::Number * > gate_still_threshold_numbers_
Definition: ld2410.h:227
reset
uint16_t reset
Definition: ina226.h:39
esphome::ld2410::LD2410Component::handle_ack_data_
bool handle_ack_data_(uint8_t *buffer, int len)
Definition: ld2410.cpp:329
esphome::ld2410::LD2410Component::gate_move_sensors_
std::vector< sensor::Sensor * > gate_move_sensors_
Definition: ld2410.h:232
esphome::ld2410::OutPinLevelStructure
OutPinLevelStructure
Definition: ld2410.h:90
esphome::len
std::string size_t len
Definition: helpers.h:293
esphome
Implementation of SPI Controller mode.
Definition: a01nyub.cpp:7
esphome::ld2410::LD2410Component::gate_still_sensors_
std::vector< sensor::Sensor * > gate_still_sensors_
Definition: ld2410.h:231
esphome::ld2410::LD2410Component::send_command_
void send_command_(uint8_t command_str, const uint8_t *command_value, int command_value_len)
Definition: ld2410.cpp:119
esphome::ld2410::LD2410Component::two_byte_to_int_
int two_byte_to_int_(char firstbyte, char secondbyte)
Definition: ld2410.h:205
esphome::ld2410::LD2410Component::handle_periodic_data_
void handle_periodic_data_(uint8_t *buffer, int len)
Definition: ld2410.cpp:146
esphome::sensor::Sensor
Base-class for all sensors.
Definition: sensor.h:57
text_sensor.h
state
bool state
Definition: fan.h:34
Generated by   doxygen 1.8.13