ESPHome  2024.11.3
sun_gtil2.cpp
Go to the documentation of this file.
1 #include "sun_gtil2.h"
2 #include "esphome/core/log.h"
3 
4 namespace esphome {
5 namespace sun_gtil2 {
6 
7 static const char *const TAG = "sun_gtil2";
8 
9 static const double NTC_A = 0.0011591051055979914;
10 static const double NTC_B = 0.00022878183547845582;
11 static const double NTC_C = 1.0396291358342124e-07;
12 static const float PULLUP_RESISTANCE = 10000.0f;
13 static const uint16_t ADC_MAX = 1023; // ADC of the inverter controller, not the ESP
14 
15 struct SunGTIL2Message {
16  uint16_t sync;
17  uint8_t ac_waveform[277];
18  uint8_t frequency;
19  uint16_t ac_voltage;
20  uint16_t ac_power;
21  uint16_t dc_voltage;
22  uint8_t state;
23  uint8_t unknown1;
24  uint8_t unknown2;
25  uint8_t unknown3;
26  uint8_t limiter_mode;
27  uint8_t unknown4;
28  uint16_t temperature;
29  uint32_t limiter_power;
30  uint16_t dc_power;
31  char serial_number[10];
32  uint8_t unknown5;
33  uint8_t end[39];
34 } __attribute__((packed));
35 
36 static const uint16_t MESSAGE_SIZE = sizeof(SunGTIL2Message);
37 
38 static_assert(MESSAGE_SIZE == 350, "Expected the message size to be 350 bytes");
39 
40 void SunGTIL2::setup() { this->rx_message_.reserve(MESSAGE_SIZE); }
41 
43  while (this->available()) {
44  uint8_t c;
45  this->read_byte(&c);
46  this->handle_char_(c);
47  }
48 }
49 
50 std::string SunGTIL2::state_to_string_(uint8_t state) {
51  switch (state) {
52  case 0x02:
53  return "Starting voltage too low";
54  case 0x07:
55  return "Working";
56  default:
57  return str_sprintf("Unknown (0x%02x)", state);
58  }
59 }
60 
61 float SunGTIL2::calculate_temperature_(uint16_t adc_value) {
62  if (adc_value >= ADC_MAX || adc_value == 0) {
63  return NAN;
64  }
65 
66  float ntc_resistance = PULLUP_RESISTANCE / ((static_cast<float>(ADC_MAX) / adc_value) - 1.0f);
67  double lr = log(double(ntc_resistance));
68  double v = NTC_A + NTC_B * lr + NTC_C * lr * lr * lr;
69  return float(1.0 / v - 273.15);
70 }
71 
72 void SunGTIL2::handle_char_(uint8_t c) {
73  if (this->rx_message_.size() > 1 || c == 0x07) {
74  this->rx_message_.push_back(c);
75  } else if (!this->rx_message_.empty()) {
76  this->rx_message_.clear();
77  }
78  if (this->rx_message_.size() < MESSAGE_SIZE) {
79  return;
80  }
81 
82  SunGTIL2Message msg;
83  memcpy(&msg, this->rx_message_.data(), MESSAGE_SIZE);
84  this->rx_message_.clear();
85 
86  if (!((msg.end[0] == 0) && (msg.end[38] == 0x08)))
87  return;
88 
89  ESP_LOGVV(TAG, "Frequency raw value: %02x", msg.frequency);
90  ESP_LOGVV(TAG, "Unknown values: %02x %02x %02x %02x %02x", msg.unknown1, msg.unknown2, msg.unknown3, msg.unknown4,
91  msg.unknown5);
92 
93 #ifdef USE_SENSOR
94  if (this->ac_voltage_ != nullptr)
95  this->ac_voltage_->publish_state(__builtin_bswap16(msg.ac_voltage) / 10.0f);
96  if (this->dc_voltage_ != nullptr)
97  this->dc_voltage_->publish_state(__builtin_bswap16(msg.dc_voltage) / 8.0f);
98  if (this->ac_power_ != nullptr)
99  this->ac_power_->publish_state(__builtin_bswap16(msg.ac_power) / 10.0f);
100  if (this->dc_power_ != nullptr)
101  this->dc_power_->publish_state(__builtin_bswap16(msg.dc_power) / 10.0f);
102  if (this->limiter_power_ != nullptr)
103  this->limiter_power_->publish_state(static_cast<int32_t>(__builtin_bswap32(msg.limiter_power)) / 10.0f);
104  if (this->temperature_ != nullptr)
105  this->temperature_->publish_state(calculate_temperature_(__builtin_bswap16(msg.temperature)));
106 #endif
107 #ifdef USE_TEXT_SENSOR
108  if (this->state_ != nullptr) {
109  this->state_->publish_state(this->state_to_string_(msg.state));
110  }
111  if (this->serial_number_ != nullptr) {
112  std::string serial_number;
113  serial_number.assign(msg.serial_number, 10);
114  this->serial_number_->publish_state(serial_number);
115  }
116 #endif
117 }
118 
120 #ifdef USE_SENSOR
121  LOG_SENSOR("", "AC Voltage", this->ac_voltage_);
122  LOG_SENSOR("", "DC Voltage", this->dc_voltage_);
123  LOG_SENSOR("", "AC Power", this->ac_power_);
124  LOG_SENSOR("", "DC Power", this->dc_power_);
125  LOG_SENSOR("", "Limiter Power", this->limiter_power_);
126  LOG_SENSOR("", "Temperature", this->temperature_);
127 #endif
128 #ifdef USE_TEXT_SENSOR
129  LOG_TEXT_SENSOR("", "State", this->state_);
130  LOG_TEXT_SENSOR("", "Serial Number", this->serial_number_);
131 #endif
132 }
133 
134 } // namespace sun_gtil2
135 } // namespace esphome
esphome::sun_gtil2::SunGTIL2 __attribute__
uint16_t ac_voltage
Definition: sun_gtil2.cpp:17
uint16_t sync
Definition: sun_gtil2.cpp:14
uint8_t unknown1
Definition: sun_gtil2.cpp:21
uint8_t unknown5
Definition: sun_gtil2.cpp:30
uint8_t ac_waveform[277]
Definition: sun_gtil2.cpp:15
void dump_config() override
Definition: sun_gtil2.cpp:119
uint8_t unknown2
Definition: sun_gtil2.cpp:22
uint16_t dc_voltage
Definition: sun_gtil2.cpp:19
std::string state_to_string_(uint8_t state)
Definition: sun_gtil2.cpp:50
uint8_t limiter_mode
Definition: sun_gtil2.cpp:24
uint8_t frequency
Definition: sun_gtil2.cpp:16
char serial_number[10]
Definition: sun_gtil2.cpp:29
void handle_char_(uint8_t c)
Definition: sun_gtil2.cpp:72
std::string str_sprintf(const char *fmt,...)
Definition: helpers.cpp:315
uint32_t limiter_power
Definition: sun_gtil2.cpp:27
float calculate_temperature_(uint16_t adc_value)
Definition: sun_gtil2.cpp:61
uint16_t ac_power
Definition: sun_gtil2.cpp:18
uint8_t state
Definition: sun_gtil2.cpp:20
uint16_t temperature
Definition: sun_gtil2.cpp:26
uint8_t unknown3
Definition: sun_gtil2.cpp:23
Implementation of SPI Controller mode.
Definition: a01nyub.cpp:7
uint8_t unknown4
Definition: sun_gtil2.cpp:25
uint8_t end[39]
Definition: sun_gtil2.cpp:31
uint16_t dc_power
Definition: sun_gtil2.cpp:28