v1.2.9

Minor improvement and bug fix

Fixed hass type None error #54
Moved battery sensor to diagnostics section #52
Fix CGP22C CO2 decoding (x-soft-ua) 8b16180

v1.2.9_beta_1

Minor improvement and bug fix

Attempt to fix hass type None error #54
Moved battery sensor to diagnostics section #52

v1.2.8

🎉 New Features:

• ✅ Added support for TLV binary protocol devices
• ✅ Automatic report mode switching based on USB power state
• ✅ Device-specific configuration entities (offsets, intervals, modes)
• ✅ Dynamic offline timeouts (5min real-time, 15min historic)
• ✅ Improved device discovery for both JSON and TLV devices
• ✅ Temperature unit switching via MQTT
• ✅ CO₂ ASC and calibration controls

Supported Device Expansion:

• Added CGP22W, CGP23W, CGP22C, CGR1PW, CGR1W

Bug Fixes:

• #46 Type 13 reports to be ignored on JSON devices. Changed DEFAULT_DURATION to 6 hours from 24.
• #45 Device classes will now be set dynamically based unit measurement.
• Fixed battery sensor for TLV devices
• Fixed pressure unit conversion (displays in kPa)
• Improved historical data handling (always uses most recent reading)

v1.2.8_beta2

CGDN1 Fixes
Restored removed config entities

v1.2.8_beta1

🎉 New Features:

• ✅ Added support for TLV binary protocol devices
• ✅ Automatic report mode switching based on USB power state
• ✅ Device-specific configuration entities (offsets, intervals, modes)
• ✅ Dynamic offline timeouts (5min real-time, 15min historic)
• ✅ Improved device discovery for both JSON and TLV devices
• ✅ Temperature unit switching via MQTT
• ✅ CO₂ ASC and calibration controls

Supported Device Expansion:

• Added CGP22W, CGP23W, CGP22C, CGR1AD

Bug Fixes:

• #46 Type 13 reports to be ignored on JSON devices. Changed DEFAULT_DURATION to 6 hours from 24.
• #45 Device classes will now be set dynamically based unit measurement.
• Fixed battery sensor for TLV devices
• Fixed pressure unit conversion (displays in kPa)
• Improved historical data handling (always uses most recent reading)

v1.2.7

Version 1.2.7 (New Release)

Breaking Change:

• Temperature/Humidity offsets now applied by device, not Home Assistant
  • Device Limitation: Temperature offsets can only be changed in whole degree Celsius units (±1°C). When using imperial units, adjustments appear as ±1.8°F due to unit conversion

🎉 New Features

Enhanced Sensor Offset Controls

Added offset configuration for additional sensors (all models):

• CO2 Offset (-500 to 500 ppm)
• PM2.5 Offset (-500 to 500 µg/m³)
• PM10 Offset (-500 to 500 µg/m³)
• Noise Offset (CGS2 only, -500 to 500 dB)
• TVOC Offset (CGS1 only, -500 to 500%)
• TVOC Index Offset (CGS2 only, -500 to 500%)

CGDN1 Advanced Settings

New configuration entities for CGDN1 model:

• Power Off Time (0-60 minutes)
• Auto Sliding Time (0-180 seconds)
• Screensaver Type (0-3 options)
• Timezone (-12 to +14, supports half-hour increments)

🔧 Improvements

Device Communication

• Bidirectional Settings Sync: Device settings now sync back to Home Assistant when changed on the physical device (Type 28 messages)
• Debounced Updates: Setting changes delayed 5 seconds to prevent excessive MQTT publishes
• Improved Offline Detection: Uses system time instead of device timestamps for better reliability
• Auto Recovery: Configuration republishes automatically when device comes back online

MQTT Handling

• Better message type handling (Type 28 settings, Type 12 realtime, Type 17 historic)
• More lenient MAC address checking for messages without MAC field
• Delayed initial config (2 seconds) ensures entities are ready before publishing
• Enhanced logging for subscriptions and message processing

Battery Status

• Added "Unknown" state for undefined battery status
• Improved charging state handling (Charging, Fully Charged, Discharging)

🐛 Bug Fixes

TVOC Calculation

• Updated TVOC mg/m³ formula : mg/m³ = ppb/218.77
• Improved eTVOC calculation with logarithmic formula for better accuracy

Offset Application

• Temperature/Humidity Offset Fix: Offsets are now applied by device only (not double-applied by Home Assistant)
• Improved Fahrenheit offset conversion when publishing to device

Status Handling

• Type 17 single-sensor messages now properly ignored to prevent errors
• Device status immediately updates on any message receipt
• Enhanced logging for online/offline transitions

⚠️ Upgrade Notes

• All existing devices continue working without reconfiguration
• New offset controls appear automatically for supported sensors
• Breaking Change: Temperature/Humidity offsets now applied by device, not Home Assistant
  • If you manually compensated for offsets in automations, remove that compensation
  • Configured offset values are sent to device via MQTT

📊 Supported Models

CGS1: CO2, Temperature, Humidity, PM2.5, PM10, TVOC, Battery
CGS2: CO2, Temperature, Humidity, PM2.5, PM10, eTVOC, Noise, Battery
CGDN1: CO2, Temperature, Humidity, PM2.5, PM10, Battery + Advanced Settings

v1.2.7_beta4

• Re added display and power off time
• Added timezone settings for CGDN1
• Hopefully fixed issue for CGDN1

v1.2.7_beta3

• Refactor timestamp updates for CGDN1 device handling

v1.2.7_beta2

• Bi-directional settings change complete.
• Hopefully CGDN1 issue is resolved
• Removed settings display and power off time for CGDN1

v1.2.7_beta1

• WIP
• Added commands for devices to set device specific settings
• Moved Temp and Hum offsets from Home assistant to device based
• Below is listed watch changes can be made for each device

All Models:

Temperature Offset
Humidity Offset
CO2/PM2.5/PM10 Offsets

CGS1:

TVOC Offset

CGS2:

Noise Offset
TVOC Index Offset

CGDN1:

Power Off Time
Display Off Time
Night Mode Start/End
Auto Sliding Time
Screensaver Type
CO2 ASC Switch
Manual Calibration Button