uponor_smatrix.h

Go to the documentation of this file.

#pragma once
 
#include "esphome/components/uart/uart.h"
#include "esphome/core/component.h"
#include "esphome/core/helpers.h"
 
#include "esphome/core/defines.h"
 
#ifdef USE_TIME
#include "esphome/components/time/real_time_clock.h"
#include "esphome/core/time.h"
#endif
 
#include <queue>
#include <set>
#include <vector>
 
namespace esphome::uponor_smatrix {
 
static const uint8_t UPONOR_ID_DATETIME1 = 0x08;
static const uint8_t UPONOR_ID_DATETIME2 = 0x09;
static const uint8_t UPONOR_ID_DATETIME3 = 0x0A;
static const uint8_t UPONOR_ID_UNKNOWN1 = 0x0C;
static const uint8_t UPONOR_ID_OUTDOOR_TEMP = 0x2D;
static const uint8_t UPONOR_ID_UNKNOWN2 = 0x35;
static const uint8_t UPONOR_ID_TARGET_TEMP_MIN = 0x37;
static const uint8_t UPONOR_ID_TARGET_TEMP_MAX = 0x38;
static const uint8_t UPONOR_ID_TARGET_TEMP = 0x3B;
static const uint8_t UPONOR_ID_ECO_SETBACK = 0x3C;
static const uint8_t UPONOR_ID_DEMAND = 0x3D;
static const uint8_t UPONOR_ID_MODE1 = 0x3E;
static const uint8_t UPONOR_ID_MODE2 = 0x3F;
static const uint8_t UPONOR_ID_ROOM_TEMP = 0x40;
static const uint8_t UPONOR_ID_EXTERNAL_TEMP = 0x41;
static const uint8_t UPONOR_ID_HUMIDITY = 0x42;
static const uint8_t UPONOR_ID_REQUEST = 0xFF;
 
static const uint16_t UPONOR_INVALID_VALUE = 0x7FFF;
 
struct UponorSmatrixData {
  uint8_t id;
  uint16_t value;
};
 
class UponorSmatrixDevice;
 
class UponorSmatrixComponent : public uart::UARTDevice, public Component {
 public:
  UponorSmatrixComponent() = default;
 
  void setup() override;
  void dump_config() override;
  void loop() override;
 
  void register_device(UponorSmatrixDevice *device) { this->devices_.push_back(device); }
 
  bool send(uint32_t device_address, const UponorSmatrixData *data, size_t data_len);
 
#ifdef USE_TIME
  void set_time_id(time::RealTimeClock *time_id) { this->time_id_ = time_id; }
  void set_time_device_address(uint32_t address) { this->time_device_address_ = address; }
  void send_time() { this->send_time_requested_ = true; }
#endif
 
 protected:
  bool parse_byte_(uint8_t byte);
 
  std::vector<UponorSmatrixDevice *> devices_;
  std::set<uint32_t> unknown_devices_;
 
  std::vector<uint8_t> rx_buffer_;
  std::queue<std::vector<uint8_t>> tx_queue_;
  uint32_t last_rx_{0};
  uint32_t last_tx_{0};
 
#ifdef USE_TIME
  time::RealTimeClock *time_id_{nullptr};
  uint32_t time_device_address_;
  bool send_time_requested_;
  bool do_send_time_();
#endif
};
 
class UponorSmatrixDevice : public Parented<UponorSmatrixComponent> {
 public:
  void set_address(uint32_t address) { this->address_ = address; }
 
  virtual void on_device_data(const UponorSmatrixData *data, size_t data_len) = 0;
  bool send(const UponorSmatrixData *data, size_t data_len) {
    return this->parent_->send(this->address_, data, data_len);
  }
 
 protected:
  friend UponorSmatrixComponent;
  uint32_t address_;
};
 
inline float raw_to_celsius(uint16_t raw) {
  return (raw == UPONOR_INVALID_VALUE) ? NAN : fahrenheit_to_celsius(raw / 10.0f);
}
 
inline uint16_t celsius_to_raw(float celsius) {
  return std::isnan(celsius) ? UPONOR_INVALID_VALUE
                             : static_cast<uint16_t>(lroundf(celsius_to_fahrenheit(celsius) * 10.0f));
}
 
}  // namespace esphome::uponor_smatrix