ESPHome 2026.6.0-dev
Loading...
Searching...
No Matches
grove_gas_mc_v2.cpp
Go to the documentation of this file.
1#include "grove_gas_mc_v2.h"
2#include "esphome/core/hal.h"
3#include "esphome/core/log.h"
4
6
7static const char *const TAG = "grove_gas_mc_v2";
8
9// I2C Commands for Grove Gas Multichannel V2 Sensor
10// Taken from:
11// https://github.com/Seeed-Studio/Seeed_Arduino_MultiGas/blob/master/src/Multichannel_Gas_GroveGasMultichannelV2.h
12static const uint8_t GROVE_GAS_MC_V2_HEAT_ON = 0xFE;
13static const uint8_t GROVE_GAS_MC_V2_HEAT_OFF = 0xFF;
14static const uint8_t GROVE_GAS_MC_V2_READ_GM102B = 0x01;
15static const uint8_t GROVE_GAS_MC_V2_READ_GM302B = 0x03;
16static const uint8_t GROVE_GAS_MC_V2_READ_GM502B = 0x05;
17static const uint8_t GROVE_GAS_MC_V2_READ_GM702B = 0x07;
18
20 if (sensor == nullptr) {
21 return true;
22 }
23 uint32_t value = 0;
24 if (!this->read_bytes(address, (uint8_t *) &value, 4)) {
25 ESP_LOGW(TAG, "Reading Grove Gas Sensor data failed!");
26 this->error_code_ = COMMUNICATION_FAILED;
27 this->status_set_warning();
28 return false;
29 }
30 sensor->publish_state(value);
31 return true;
32}
33
35 // Before reading sensor values, must preheat sensor
36 if (!(this->write_bytes(GROVE_GAS_MC_V2_HEAT_ON, {}))) {
37 this->mark_failed();
38 this->error_code_ = APP_START_FAILED;
39 }
40}
41
42void GroveGasMultichannelV2Component::update() {
43 // Read from each of the gas sensors
44 if (!this->read_sensor_(GROVE_GAS_MC_V2_READ_GM102B, this->nitrogen_dioxide_sensor_))
45 return;
46 if (!this->read_sensor_(GROVE_GAS_MC_V2_READ_GM302B, this->ethanol_sensor_))
47 return;
48 if (!this->read_sensor_(GROVE_GAS_MC_V2_READ_GM502B, this->tvoc_sensor_))
49 return;
50 if (!this->read_sensor_(GROVE_GAS_MC_V2_READ_GM702B, this->carbon_monoxide_sensor_))
51 return;
52
54}
55
56void GroveGasMultichannelV2Component::dump_config() {
57 ESP_LOGCONFIG(TAG, "Grove Multichannel Gas Sensor V2");
58 LOG_I2C_DEVICE(this)
59 LOG_UPDATE_INTERVAL(this);
60 LOG_SENSOR(" ", "Nitrogen Dioxide", this->nitrogen_dioxide_sensor_);
61 LOG_SENSOR(" ", "Ethanol", this->ethanol_sensor_);
62 LOG_SENSOR(" ", "Carbon Monoxide", this->carbon_monoxide_sensor_);
63 LOG_SENSOR(" ", "TVOC", this->tvoc_sensor_);
64
65 if (this->is_failed()) {
66 switch (this->error_code_) {
68 ESP_LOGW(TAG, ESP_LOG_MSG_COMM_FAIL);
69 break;
70 case APP_INVALID:
71 ESP_LOGW(TAG, "Sensor reported invalid APP installed");
72 break;
74 ESP_LOGW(TAG, "Sensor reported APP start failed");
75 break;
76 case UNKNOWN:
77 default:
78 ESP_LOGW(TAG, "Unknown setup error");
79 break;
80 }
81 }
82}
83
84} // namespace esphome::grove_gas_mc_v2
uint8_t address
Definition bl0906.h:4
void mark_failed()
Mark this component as failed.
virtual void setup()
Where the component's initialization should happen.
Definition component.cpp:84
bool is_failed() const
Definition component.h:272
void status_clear_warning()
Definition component.h:289
bool read_sensor_(uint8_t address, sensor::Sensor *sensor)
enum esphome::grove_gas_mc_v2::GroveGasMultichannelV2Component::ErrorCode UNKNOWN
bool write_bytes(uint8_t a_register, const uint8_t *data, uint8_t len) const
Definition i2c.h:251
bool read_bytes(uint8_t a_register, uint8_t *data, uint8_t len)
Compat APIs All methods below have been added for compatibility reasons.
Definition i2c.h:217
Base-class for all sensors.
Definition sensor.h:47
void publish_state(float state)
Publish a new state to the front-end.
Definition sensor.cpp:68
if(written< 0)
Definition helpers.h:1047
static void uint32_t