#pragma once #include #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 { 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_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].thd_voltage_sensor_ = obj; } void set_thd_current_sensor(int phase, sensor::Sensor *obj) { this->phase_[phase].thd_current_sensor_ = obj; } 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_local_phase_thd_voltage_(uint8_t phase); float get_local_phase_thd_current_(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_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}; sensor::Sensor *thd_voltage_sensor_{nullptr}; sensor::Sensor *thd_current_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}; #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