sascha/esphome
1
0
Fork 0
mirror of https://github.com/esphome/esphome.git synced 2025-09-01 19:02:18 +01:00
Code Issues Releases Wiki Activity

Adjust sen5x to match VOC/NOX datasheet (#9894)

Browse Source 
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
This commit is contained in:
Ben Curtis
2025-08-28 22:00:54 -04:00
committed by GitHub
parent ef98f67b41
commit dea68bebd8
1 changed files with 67 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files

111
esphome/components/sen5x/sensor.py
View File

@@ -65,26 +65,47 @@ ACCELERATION_MODES = {
"high": RhtAccelerationMode.HIGH_ACCELERATION, "high": RhtAccelerationMode.HIGH_ACCELERATION,
} }
GAS_SENSOR = cv.Schema(
{ def _gas_sensor(
cv.Optional(CONF_ALGORITHM_TUNING): cv.Schema( *,
{ index_offset: int,
cv.Optional(CONF_INDEX_OFFSET, default=100): cv.int_range(1, 250), learning_time_offset: int,
cv.Optional(CONF_LEARNING_TIME_OFFSET_HOURS, default=12): cv.int_range( learning_time_gain: int,
1, 1000 gating_max_duration: int,
), std_initial: int,
cv.Optional(CONF_LEARNING_TIME_GAIN_HOURS, default=12): cv.int_range( gain_factor: int,
1, 1000 ) -> cv.Schema:
), return sensor.sensor_schema(
cv.Optional( icon=ICON_RADIATOR,
CONF_GATING_MAX_DURATION_MINUTES, default=720 accuracy_decimals=0,
): cv.int_range(0, 3000), device_class=DEVICE_CLASS_AQI,
cv.Optional(CONF_STD_INITIAL, default=50): cv.int_, state_class=STATE_CLASS_MEASUREMENT,
cv.Optional(CONF_GAIN_FACTOR, default=230): cv.int_range(1, 1000), ).extend(
} {
) cv.Optional(CONF_ALGORITHM_TUNING): cv.Schema(
} {
) cv.Optional(CONF_INDEX_OFFSET, default=index_offset): cv.int_range(
1, 250
),
cv.Optional(
CONF_LEARNING_TIME_OFFSET_HOURS, default=learning_time_offset
): cv.int_range(1, 1000),
cv.Optional(
CONF_LEARNING_TIME_GAIN_HOURS, default=learning_time_gain
): cv.int_range(1, 1000),
cv.Optional(
CONF_GATING_MAX_DURATION_MINUTES, default=gating_max_duration
): cv.int_range(0, 3000),
cv.Optional(CONF_STD_INITIAL, default=std_initial): cv.int_range(
10, 5000
),
cv.Optional(CONF_GAIN_FACTOR, default=gain_factor): cv.int_range(
1, 1000
),
}
)
}
)
def float_previously_pct(value): def float_previously_pct(value):
@@ -127,18 +148,22 @@ CONFIG_SCHEMA = (
state_class=STATE_CLASS_MEASUREMENT, state_class=STATE_CLASS_MEASUREMENT,
), ),
cv.Optional(CONF_AUTO_CLEANING_INTERVAL): cv.update_interval, cv.Optional(CONF_AUTO_CLEANING_INTERVAL): cv.update_interval,
cv.Optional(CONF_VOC): sensor.sensor_schema( cv.Optional(CONF_VOC): _gas_sensor(
icon=ICON_RADIATOR, index_offset=100,
accuracy_decimals=0, learning_time_offset=12,
device_class=DEVICE_CLASS_AQI, learning_time_gain=12,
state_class=STATE_CLASS_MEASUREMENT, gating_max_duration=180,
).extend(GAS_SENSOR), std_initial=50,
cv.Optional(CONF_NOX): sensor.sensor_schema( gain_factor=230,
icon=ICON_RADIATOR, ),
accuracy_decimals=0, cv.Optional(CONF_NOX): _gas_sensor(
device_class=DEVICE_CLASS_AQI, index_offset=1,
state_class=STATE_CLASS_MEASUREMENT, learning_time_offset=12,
).extend(GAS_SENSOR), learning_time_gain=12,
gating_max_duration=720,
std_initial=50,
gain_factor=230,
),
cv.Optional(CONF_STORE_BASELINE, default=True): cv.boolean, cv.Optional(CONF_STORE_BASELINE, default=True): cv.boolean,
cv.Optional(CONF_VOC_BASELINE): cv.hex_uint16_t, cv.Optional(CONF_VOC_BASELINE): cv.hex_uint16_t,
cv.Optional(CONF_TEMPERATURE): sensor.sensor_schema( cv.Optional(CONF_TEMPERATURE): sensor.sensor_schema(
@@ -194,16 +219,15 @@ async def to_code(config):
await i2c.register_i2c_device(var, config) await i2c.register_i2c_device(var, config)
for key, funcName in SETTING_MAP.items(): for key, funcName in SETTING_MAP.items():
if key in config: if cfg := config.get(key):
cg.add(getattr(var, funcName)(config[key])) cg.add(getattr(var, funcName)(cfg))
for key, funcName in SENSOR_MAP.items(): for key, funcName in SENSOR_MAP.items():
if key in config: if cfg := config.get(key):
sens = await sensor.new_sensor(config[key]) sens = await sensor.new_sensor(cfg)
cg.add(getattr(var, funcName)(sens)) cg.add(getattr(var, funcName)(sens))
if CONF_VOC in config and CONF_ALGORITHM_TUNING in config[CONF_VOC]: if cfg := config.get(CONF_VOC, {}).get(CONF_ALGORITHM_TUNING):
cfg = config[CONF_VOC][CONF_ALGORITHM_TUNING]
cg.add( cg.add(
var.set_voc_algorithm_tuning( var.set_voc_algorithm_tuning(
cfg[CONF_INDEX_OFFSET], cfg[CONF_INDEX_OFFSET],
@@ -214,8 +238,7 @@ async def to_code(config):
cfg[CONF_GAIN_FACTOR], cfg[CONF_GAIN_FACTOR],
) )
) )
if CONF_NOX in config and CONF_ALGORITHM_TUNING in config[CONF_NOX]: if cfg := config.get(CONF_NOX, {}).get(CONF_ALGORITHM_TUNING):
cfg = config[CONF_NOX][CONF_ALGORITHM_TUNING]
cg.add( cg.add(
var.set_nox_algorithm_tuning( var.set_nox_algorithm_tuning(
cfg[CONF_INDEX_OFFSET], cfg[CONF_INDEX_OFFSET],
@@ -225,12 +248,12 @@ async def to_code(config):
cfg[CONF_GAIN_FACTOR], cfg[CONF_GAIN_FACTOR],
) )
) )
if CONF_TEMPERATURE_COMPENSATION in config: if cfg := config.get(CONF_TEMPERATURE_COMPENSATION):
cg.add( cg.add(
var.set_temperature_compensation( var.set_temperature_compensation(
config[CONF_TEMPERATURE_COMPENSATION][CONF_OFFSET], cfg[CONF_OFFSET],
config[CONF_TEMPERATURE_COMPENSATION][CONF_NORMALIZED_OFFSET_SLOPE], cfg[CONF_NORMALIZED_OFFSET_SLOPE],
config[CONF_TEMPERATURE_COMPENSATION][CONF_TIME_CONSTANT], cfg[CONF_TIME_CONSTANT],
) )
) )