ESPHome 2026.3.0-dev
Loading...
Searching...
No Matches
mics_4514.cpp
Go to the documentation of this file.
1#include "mics_4514.h"
2
4#include "esphome/core/log.h"
5
6namespace esphome {
7namespace mics_4514 {
8
9static const char *const TAG = "mics_4514";
10
11static const uint8_t SENSOR_REGISTER = 0x04;
12static const uint8_t POWER_MODE_REGISTER = 0x0a;
13
15 uint8_t power_mode;
16 this->read_register(POWER_MODE_REGISTER, &power_mode, 1);
17 if (power_mode == 0x00) {
18 ESP_LOGCONFIG(TAG, "Waking up MICS 4514, sensors will have data after 3 minutes");
19 power_mode = 0x01;
20 this->write_register(POWER_MODE_REGISTER, &power_mode, 1);
21 delay(100); // NOLINT
22 this->set_timeout("warmup", 3 * 60 * 1000, [this]() { this->warmed_up_ = true; });
23 this->status_set_warning();
24 return;
25 }
26 ESP_LOGCONFIG(TAG, "Device already awake.");
27 this->warmed_up_ = true;
28}
29void MICS4514Component::dump_config() {
30 ESP_LOGCONFIG(TAG, "MICS 4514:");
31 LOG_I2C_DEVICE(this);
32 LOG_UPDATE_INTERVAL(this);
33 LOG_SENSOR(" ", "Nitrogen Dioxide", this->nitrogen_dioxide_sensor_);
34 LOG_SENSOR(" ", "Carbon Monoxide", this->carbon_monoxide_sensor_);
35 LOG_SENSOR(" ", "Methane", this->methane_sensor_);
36 LOG_SENSOR(" ", "Ethanol", this->ethanol_sensor_);
37 LOG_SENSOR(" ", "Hydrogen", this->hydrogen_sensor_);
38 LOG_SENSOR(" ", "Ammonia", this->ammonia_sensor_);
39}
40void MICS4514Component::update() {
41 if (!this->warmed_up_) {
42 return;
43 }
44 uint8_t data[6];
45 if (this->read_register(SENSOR_REGISTER, data, 6) != i2c::ERROR_OK) {
46 this->status_set_warning();
47 return;
48 }
50 ESP_LOGV(TAG, "Got data: %02X %02X %02X %02X %02X %02X", data[0], data[1], data[2], data[3], data[4], data[5]);
51 uint16_t ox = encode_uint16(data[0], data[1]);
52 uint16_t red = encode_uint16(data[2], data[3]);
53 uint16_t power = encode_uint16(data[4], data[5]);
54
55 if (this->initial_) {
56 this->initial_ = false;
57 this->ox_calibration_ = (float) (power - ox);
58 this->red_calibration_ = (float) (power - red);
59 return;
60 }
61
62 float red_f = (float) (power - red) / this->red_calibration_;
63 float ox_f = (float) (power - ox) / this->ox_calibration_;
64
65 if (this->carbon_monoxide_sensor_ != nullptr) {
66 float co = 0.0f;
67 if (red_f > 3.4f) {
68 co = 0.0;
69 } else if (red_f < 0.01) {
70 co = 1000.0;
71 } else {
72 co = 4.2 / pow(red_f, 1.2);
73 }
74 this->carbon_monoxide_sensor_->publish_state(co);
75 }
76
77 if (this->nitrogen_dioxide_sensor_ != nullptr) {
78 float nitrogendioxide = 0.0f;
79 if (ox_f < 0.3f) {
80 nitrogendioxide = 0.0;
81 } else {
82 nitrogendioxide = 0.164 * pow(ox_f, 0.975);
83 }
84 this->nitrogen_dioxide_sensor_->publish_state(nitrogendioxide);
85 }
86
87 if (this->methane_sensor_ != nullptr) {
88 float methane = 0.0f;
89 if (red_f > 0.9f || red_f < 0.5) { // outside the range->unlikely
90 methane = 0.0;
91 } else {
92 methane = 630 / pow(red_f, 4.4);
93 }
94 this->methane_sensor_->publish_state(methane);
95 }
96
97 if (this->ethanol_sensor_ != nullptr) {
98 float ethanol = 0.0f;
99 if (red_f > 1.0f || red_f < 0.02) { // outside the range->unlikely
100 ethanol = 0.0;
101 } else {
102 ethanol = 1.52 / pow(red_f, 1.55);
103 }
104 this->ethanol_sensor_->publish_state(ethanol);
105 }
106
107 if (this->hydrogen_sensor_ != nullptr) {
108 float hydrogen = 0.0f;
109 if (red_f > 0.9f || red_f < 0.02) { // outside the range->unlikely
110 hydrogen = 0.0;
111 } else {
112 hydrogen = 0.85 / pow(red_f, 1.75);
113 }
114 this->hydrogen_sensor_->publish_state(hydrogen);
115 }
116
117 if (this->ammonia_sensor_ != nullptr) {
118 float ammonia = 0.0f;
119 if (red_f > 0.98f || red_f < 0.2532) { // outside the ammonia range->unlikely
120 ammonia = 0.0;
121 } else {
122 ammonia = 0.9 / pow(red_f, 4.6);
123 }
124 this->ammonia_sensor_->publish_state(ammonia);
125 }
126}
127
128} // namespace mics_4514
129} // namespace esphome
virtual void setup()
Where the component's initialization should happen.
Definition component.cpp:94
void status_set_warning(const char *message=nullptr)
ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") void set_timeout(const std voi set_timeout)(const char *name, uint32_t timeout, std::function< void()> &&f)
Set a timeout function with a unique name.
Definition component.h:443
void status_clear_warning()
ErrorCode write_register(uint8_t a_register, const uint8_t *data, size_t len) const
writes an array of bytes to a specific register in the I²C device
Definition i2c.cpp:34
ErrorCode read_register(uint8_t a_register, uint8_t *data, size_t len)
reads an array of bytes from a specific register in the I²C device
Definition i2c.cpp:25
PowerMode power_mode
Definition msa3xx.h:3
@ ERROR_OK
No error found during execution of method.
Definition i2c_bus.h:14
Providing packet encoding functions for exchanging data with a remote host.
Definition a01nyub.cpp:7
constexpr uint16_t encode_uint16(uint8_t msb, uint8_t lsb)
Encode a 16-bit value given the most and least significant byte.
Definition helpers.h:653
void HOT delay(uint32_t ms)
Definition core.cpp:27