ESPHome  2024.12.2
modbus_output.cpp
Go to the documentation of this file.
1 #include "modbus_output.h"
2 #include "esphome/core/helpers.h"
3 #include "esphome/core/log.h"
4 
5 namespace esphome {
6 namespace modbus_controller {
7 
8 static const char *const TAG = "modbus_controller.output";
9 
13 void ModbusFloatOutput::write_state(float value) {
14  std::vector<uint16_t> data;
15  auto original_value = value;
16  // Is there are lambda configured?
17  if (this->write_transform_func_.has_value()) {
18  // data is passed by reference
19  // the lambda can fill the empty vector directly
20  // in that case the return value is ignored
21  auto val = (*this->write_transform_func_)(this, value, data);
22  if (val.has_value()) {
23  ESP_LOGV(TAG, "Value overwritten by lambda");
24  value = val.value();
25  } else {
26  ESP_LOGV(TAG, "Communication handled by lambda - exiting control");
27  return;
28  }
29  } else {
30  value = this->multiply_by_ * value;
31  }
32  // lambda didn't set payload
33  if (data.empty()) {
34  data = float_to_payload(value, this->sensor_value_type);
35  }
36 
37  ESP_LOGD(TAG, "Updating register: start address=0x%X register count=%d new value=%.02f (val=%.02f)",
38  this->start_address, this->register_count, value, original_value);
39 
40  // Create and send the write command
41  ModbusCommandItem write_cmd;
42  if (this->register_count == 1 && !this->use_write_multiple_) {
43  write_cmd =
45  } else {
47  this->register_count, data);
48  }
49  this->parent_->queue_command(write_cmd);
50 }
51 
53  ESP_LOGCONFIG(TAG, "Modbus Float Output:");
54  LOG_FLOAT_OUTPUT(this);
55  ESP_LOGCONFIG(TAG, " Device start address: 0x%X", this->start_address);
56  ESP_LOGCONFIG(TAG, " Register count: %d", this->register_count);
57  ESP_LOGCONFIG(TAG, " Value type: %d", static_cast<int>(this->sensor_value_type));
58 }
59 
60 // ModbusBinaryOutput
62  // This will be called every time the user requests a state change.
64  std::vector<uint8_t> data;
65 
66  // Is there are lambda configured?
67  if (this->write_transform_func_.has_value()) {
68  // data is passed by reference
69  // the lambda can fill the empty vector directly
70  // in that case the return value is ignored
71  auto val = (*this->write_transform_func_)(this, state, data);
72  if (val.has_value()) {
73  ESP_LOGV(TAG, "Value overwritten by lambda");
74  state = val.value();
75  } else {
76  ESP_LOGV(TAG, "Communication handled by lambda - exiting control");
77  return;
78  }
79  }
80  if (!data.empty()) {
81  ESP_LOGV(TAG, "Modbus binary output write raw: %s", format_hex_pretty(data).c_str());
83  this->parent_, data,
84  [this, cmd](ModbusRegisterType register_type, uint16_t start_address, const std::vector<uint8_t> &data) {
85  this->parent_->on_write_register_response(cmd.register_type, this->start_address, data);
86  });
87  } else {
88  ESP_LOGV(TAG, "Write new state: value is %s, type is %d address = %X, offset = %x", ONOFF(state),
89  (int) this->register_type, this->start_address, this->offset);
90 
91  // offset for coil and discrete inputs is the coil/register number not bytes
92  if (this->use_write_multiple_) {
93  std::vector<bool> states{state};
95  } else {
97  }
98  }
99  this->parent_->queue_command(cmd);
100 }
101 
103  ESP_LOGCONFIG(TAG, "Modbus Binary Output:");
104  LOG_BINARY_OUTPUT(this);
105  ESP_LOGCONFIG(TAG, " Device start address: 0x%X", this->start_address);
106  ESP_LOGCONFIG(TAG, " Register count: %d", this->register_count);
107  ESP_LOGCONFIG(TAG, " Value type: %d", static_cast<int>(this->sensor_value_type));
108 }
109 
110 } // namespace modbus_controller
111 } // namespace esphome
void queue_command(const ModbusCommandItem &command)
queues a modbus command in the send queue
std::string format_hex_pretty(const uint8_t *data, size_t length)
Format the byte array data of length len in pretty-printed, human-readable hex.
Definition: helpers.cpp:369
std::vector< uint16_t > float_to_payload(float value, SensorValueType value_type)
void on_write_register_response(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)
default delegate called by process_modbus_data when a response for a write response has retrieved fro...
static ModbusCommandItem create_write_single_command(ModbusController *modbusdevice, uint16_t start_address, uint16_t value)
Create modbus write multiple registers command Function 16 (10hex) Write Multiple Registers...
mopeka_std_values val[4]
bool has_value() const
Definition: optional.h:87
static ModbusCommandItem create_write_single_coil(ModbusController *modbusdevice, uint16_t address, bool value)
Create modbus write single registers command Function 05 (05hex) Write Single Coil.
void write_state(float value) override
Write a value to the device.
optional< write_transform_func_t > write_transform_func_
Definition: modbus_output.h:38
static ModbusCommandItem create_write_multiple_coils(ModbusController *modbusdevice, uint16_t start_address, const std::vector< bool > &values)
Create modbus write multiple registers command Function 15 (0Fhex) Write Multiple Coils...
static ModbusCommandItem create_write_multiple_command(ModbusController *modbusdevice, uint16_t start_address, uint16_t register_count, const std::vector< uint16_t > &values)
Create modbus read command Function code 02-04.
Implementation of SPI Controller mode.
Definition: a01nyub.cpp:7
static ModbusCommandItem create_custom_command(ModbusController *modbusdevice, const std::vector< uint8_t > &values, std::function< void(ModbusRegisterType register_type, uint16_t start_address, const std::vector< uint8_t > &data)> &&handler=nullptr)
Create custom modbus command.
stm32_cmd_t * cmd
Definition: stm32flash.h:96
bool state
Definition: fan.h:34