263 lines
10 KiB
C++
263 lines
10 KiB
C++
#pragma once
|
|
|
|
#include <unordered_map>
|
|
#include "atm90e36_reg.h"
|
|
#include "esphome/components/sensor/sensor.h"
|
|
#include "esphome/components/spi/spi.h"
|
|
#include "esphome/core/application.h"
|
|
#include "esphome/core/component.h"
|
|
#include "esphome/core/helpers.h"
|
|
#include "esphome/core/preferences.h"
|
|
|
|
namespace esphome {
|
|
namespace atm90e36 {
|
|
|
|
class ATM90E36Component : public PollingComponent,
|
|
public spi::SPIDevice<spi::BIT_ORDER_MSB_FIRST, spi::CLOCK_POLARITY_HIGH,
|
|
spi::CLOCK_PHASE_TRAILING, spi::DATA_RATE_2MHZ> {
|
|
public:
|
|
static const uint8_t PHASEA = 0;
|
|
static const uint8_t PHASEB = 1;
|
|
static const uint8_t PHASEC = 2;
|
|
const char *phase_labels[3] = {"A", "B", "C"};
|
|
void loop() override;
|
|
void setup() override;
|
|
void dump_config() override;
|
|
float get_setup_priority() const override;
|
|
void update() override;
|
|
void set_voltage_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].voltage_sensor_ = obj; }
|
|
void set_current_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].current_sensor_ = obj; }
|
|
void set_power_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].power_sensor_ = obj; }
|
|
void set_reactive_power_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].reactive_power_sensor_ = obj; }
|
|
void set_apparent_power_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].apparent_power_sensor_ = obj; }
|
|
void set_thd_voltage_a_sensor(sensor::Sensor *thd_voltage_a_sensor) {
|
|
thd_voltage_a_sensor_ = thd_voltage_a_sensor;
|
|
}
|
|
void set_thd_current_a_sensor(sensor::Sensor *thd_current_a_sensor) {
|
|
thd_current_a_sensor_ = thd_current_a_sensor;
|
|
}
|
|
void set_thd_voltage_b_sensor(sensor::Sensor *thd_voltage_b_sensor) {
|
|
thd_voltage_b_sensor_ = thd_voltage_b_sensor;
|
|
}
|
|
void set_thd_current_b_sensor(sensor::Sensor *thd_current_b_sensor) {
|
|
thd_current_b_sensor_ = thd_current_b_sensor;
|
|
}
|
|
void set_thd_voltage_c_sensor(sensor::Sensor *thd_voltage_c_sensor) {
|
|
thd_voltage_c_sensor_ = thd_voltage_c_sensor;
|
|
}
|
|
void set_thd_current_c_sensor(sensor::Sensor *thd_current_c_sensor) {
|
|
thd_current_c_sensor_ = thd_current_c_sensor;
|
|
}
|
|
void set_forward_active_energy_sensor(int phase, sensor::Sensor *obj) {
|
|
this->phase_[phase].forward_active_energy_sensor_ = obj;
|
|
}
|
|
void set_reverse_active_energy_sensor(int phase, sensor::Sensor *obj) {
|
|
this->phase_[phase].reverse_active_energy_sensor_ = obj;
|
|
}
|
|
void set_power_factor_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].power_factor_sensor_ = obj; }
|
|
void set_phase_angle_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].phase_angle_sensor_ = obj; }
|
|
void set_harmonic_active_power_sensor(int phase, sensor::Sensor *obj) {
|
|
this->phase_[phase].harmonic_active_power_sensor_ = obj;
|
|
}
|
|
void set_volt_gain(int phase, uint16_t gain) {
|
|
this->phase_[phase].voltage_gain_ = gain;
|
|
}
|
|
void set_ct_gain(int phase, uint16_t gain) {
|
|
this->phase_[phase].ct_gain_ = gain;
|
|
}
|
|
void set_freq_sensor(sensor::Sensor *freq_sensor) { freq_sensor_ = freq_sensor; }
|
|
void set_chip_temperature_sensor(sensor::Sensor *chip_temperature_sensor) {
|
|
chip_temperature_sensor_ = chip_temperature_sensor;
|
|
}
|
|
void set_line_freq(int freq) { line_freq_ = freq; }
|
|
void set_current_phases(int phases) { current_phases_ = phases; }
|
|
void set_pga_current(uint16_t gain) { pga_current_ = gain; }
|
|
void set_pga_voltage(uint16_t gain) { pga_voltage_ = gain; }
|
|
void set_dpga_gain(uint16_t gain) { dpga_gain_ = gain; }
|
|
#ifdef USE_NUMBER
|
|
void set_reference_voltage(uint8_t phase, number::Number *ref_voltage) { ref_voltages_[phase] = ref_voltage; }
|
|
void set_reference_current(uint8_t phase, number::Number *ref_current) { ref_currents_[phase] = ref_current; }
|
|
#endif
|
|
float get_reference_voltage(uint8_t phase) {
|
|
#ifdef USE_NUMBER
|
|
return (phase >= 0 && phase < 3 && ref_voltages_[phase]) ? ref_voltages_[phase]->state : 120.0; // Default voltage
|
|
#else
|
|
return 120.0; // Default voltage
|
|
#endif
|
|
}
|
|
float get_reference_current(uint8_t phase) {
|
|
#ifdef USE_NUMBER
|
|
return (phase >= 0 && phase < 3 && ref_currents_[phase]) ? ref_currents_[phase]->state : 5.0f; // Default current
|
|
#else
|
|
return 5.0f; // Default current
|
|
#endif
|
|
}
|
|
bool using_saved_calibrations_ = false; // Track if stored calibrations are being used
|
|
#ifdef USE_TEXT_SENSOR
|
|
void check_phase_status();
|
|
void check_freq_status();
|
|
void check_over_current();
|
|
void set_phase_status_text_sensor(text_sensor::TextSensor *sensor) {
|
|
this->phase_status_text_sensor_ = sensor;
|
|
}
|
|
void set_freq_status_text_sensor(text_sensor::TextSensor *sensor) { this->freq_status_text_sensor_ = sensor; }
|
|
#endif
|
|
uint16_t calculate_voltage_threshold(int line_freq, uint16_t ugain, float multiplier);
|
|
int32_t last_periodic_millis = millis();
|
|
|
|
protected:
|
|
#ifdef USE_NUMBER
|
|
number::Number *ref_voltages_[3]{nullptr, nullptr, nullptr};
|
|
number::Number *ref_currents_[3]{nullptr, nullptr, nullptr};
|
|
#endif
|
|
uint16_t read16_(uint16_t a_register);
|
|
void write16_(uint16_t a_register, uint16_t val, bool validate = true);
|
|
float get_local_phase_voltage_(uint8_t phase);
|
|
float get_local_phase_current_(uint8_t phase);
|
|
float get_local_phase_active_power_(uint8_t phase);
|
|
float get_local_phase_reactive_power_(uint8_t phase);
|
|
float get_local_phase_apparent_power_(uint8_t phase);
|
|
float get_local_phase_power_factor_(uint8_t phase);
|
|
float get_local_phase_forward_active_energy_(uint8_t phase);
|
|
float get_local_phase_reverse_active_energy_(uint8_t phase);
|
|
float get_local_phase_angle_(uint8_t phase);
|
|
float get_local_phase_harmonic_active_power_(uint8_t phase);
|
|
float get_phase_voltage_(uint8_t phase);
|
|
float get_phase_voltage_avg_(uint8_t phase);
|
|
float get_phase_current_(uint8_t phase);
|
|
float get_phase_current_avg_(uint8_t phase);
|
|
float get_phase_active_power_(uint8_t phase);
|
|
float get_phase_reactive_power_(uint8_t phase);
|
|
float get_phase_apparent_power_(uint8_t phase);
|
|
float get_phase_power_factor_(uint8_t phase);
|
|
float get_phase_forward_active_energy_(uint8_t phase);
|
|
float get_phase_reverse_active_energy_(uint8_t phase);
|
|
float get_phase_angle_(uint8_t phase);
|
|
float get_phase_harmonic_active_power_(uint8_t phase);
|
|
float get_thd_voltage_a();
|
|
float get_thd_current_a();
|
|
float get_thd_voltage_b();
|
|
float get_thd_current_b();
|
|
float get_thd_voltage_c();
|
|
float get_thd_current_c();
|
|
float get_frequency_();
|
|
float get_chip_temperature_();
|
|
bool get_publish_interval_flag_() { return publish_interval_flag_; };
|
|
void set_publish_interval_flag_(bool flag) { publish_interval_flag_ = flag; };
|
|
void restore_offset_calibrations_();
|
|
void restore_power_offset_calibrations_();
|
|
void restore_gain_calibrations_();
|
|
void save_offset_calibration_to_memory_();
|
|
void save_gain_calibration_to_memory_();
|
|
void save_power_offset_calibration_to_memory_();
|
|
void write_offsets_to_registers_(uint8_t phase, int16_t voltage_offset, int16_t current_offset);
|
|
void write_power_offsets_to_registers_(uint8_t phase, int16_t p_offset, int16_t q_offset);
|
|
void write_gains_to_registers_();
|
|
bool verify_gain_writes_();
|
|
bool validate_spi_read_(uint16_t expected, const char *context = nullptr);
|
|
void log_calibration_status_();
|
|
|
|
struct ATM90E32Phase {
|
|
uint16_t voltage_gain_{0};
|
|
uint16_t ct_gain_{0};
|
|
int16_t voltage_offset_{0};
|
|
int16_t current_offset_{0};
|
|
int16_t active_power_offset_{0};
|
|
int16_t reactive_power_offset_{0};
|
|
float voltage_{0};
|
|
float current_{0};
|
|
float active_power_{0};
|
|
float reactive_power_{0};
|
|
float apparent_power_{0};
|
|
float power_factor_{0};
|
|
float forward_active_energy_{0};
|
|
float reverse_active_energy_{0};
|
|
float phase_angle_{0};
|
|
float harmonic_active_power_{0};
|
|
sensor::Sensor *voltage_sensor_{nullptr};
|
|
sensor::Sensor *current_sensor_{nullptr};
|
|
sensor::Sensor *power_sensor_{nullptr};
|
|
sensor::Sensor *reactive_power_sensor_{nullptr};
|
|
sensor::Sensor *apparent_power_sensor_{nullptr};
|
|
sensor::Sensor *power_factor_sensor_{nullptr};
|
|
sensor::Sensor *forward_active_energy_sensor_{nullptr};
|
|
sensor::Sensor *reverse_active_energy_sensor_{nullptr};
|
|
sensor::Sensor *phase_angle_sensor_{nullptr};
|
|
sensor::Sensor *harmonic_active_power_sensor_{nullptr};
|
|
uint32_t cumulative_forward_active_energy_{0};
|
|
uint32_t cumulative_reverse_active_energy_{0};
|
|
} phase_[3];
|
|
|
|
union SysStatus0 {
|
|
uint16_t data;
|
|
struct {
|
|
bool b0 : 1;
|
|
bool b1 : 1;
|
|
bool PhaseLoseWn : 1;
|
|
bool SagWarn : 1;
|
|
bool b4 : 1;
|
|
bool b5 : 1;
|
|
bool IRevWn : 1;
|
|
bool URevWn : 1;
|
|
bool CS3Err : 1;
|
|
bool b9 : 1;
|
|
bool CS2Err : 1;
|
|
bool b11 : 1;
|
|
bool CS1Err : 1;
|
|
bool b13 : 1;
|
|
bool CS0Err : 1;
|
|
bool b15 : 1;
|
|
} bits;
|
|
};
|
|
|
|
union SysStatus1 {
|
|
uint16_t data;
|
|
struct {
|
|
bool RevPchgC : 1;
|
|
bool RevPchgB : 1;
|
|
bool RevPchgA : 1;
|
|
bool RevPchgT : 1;
|
|
bool RevQchgC : 1;
|
|
bool RevQchgB : 1;
|
|
bool RevQchgA : 1;
|
|
bool RevQchgT : 1;
|
|
bool b8 : 1;
|
|
bool DFTDone : 1;
|
|
bool THDIOv : 1;
|
|
bool THDUOv : 1;
|
|
bool b12 : 1;
|
|
bool b13 : 1;
|
|
bool INOv0 : 1;
|
|
bool INOv1 : 1;
|
|
} bits;
|
|
};
|
|
|
|
ESPPreferenceObject offset_pref_;
|
|
ESPPreferenceObject power_offset_pref_;
|
|
ESPPreferenceObject gain_calibration_pref_;
|
|
std::string cs_summary_;
|
|
|
|
sensor::Sensor *freq_sensor_{nullptr};
|
|
sensor::Sensor *thd_voltage_a_sensor_{nullptr};
|
|
sensor::Sensor *thd_current_a_sensor_{nullptr};
|
|
sensor::Sensor *thd_voltage_b_sensor_{nullptr};
|
|
sensor::Sensor *thd_current_b_sensor_{nullptr};
|
|
sensor::Sensor *thd_voltage_c_sensor_{nullptr};
|
|
sensor::Sensor *thd_current_c_sensor_{nullptr};
|
|
#ifdef USE_TEXT_SENSOR
|
|
text_sensor::TextSensor *phase_status_text_sensor_{nullptr};
|
|
text_sensor::TextSensor *freq_status_text_sensor_{nullptr};
|
|
#endif
|
|
sensor::Sensor *chip_temperature_sensor_{nullptr};
|
|
uint16_t pga_current_{0x15};
|
|
uint16_t pga_voltage_{0x15};
|
|
uint16_t dpga_gain_{0x2};
|
|
int line_freq_{60};
|
|
int current_phases_{3};
|
|
bool publish_interval_flag_{false};
|
|
uint16_t pga_cal{0x0};
|
|
};
|
|
|
|
} // namespace atm90e32
|
|
} // namespace esphome
|