Velair 1.2.0

Velair 1.2.0

Velair 1.2.0 introduces Environmental Comfort monitoring and complete Celsius and Fahrenheit support, together with clearer Home Assistant entities, automation events, Zone overview improvements, and a safer portability and temperature-migration workflow.

✨ Added

• Automation events for cancelled Adaptive Preconditioning plans and persisted complete, partial, or invalid learning observations.
• Automation events when Room Assist is enabled or disabled.
• Environmental Comfort monitoring per managed climate, with human temperature/humidity conditions, independent CO2 air quality, and explicit reading quality.
• A dedicated Comfort tab and Lovelace view with a responsive temperature/humidity map, smooth metric-specific color scales, contrasting markers, and a separate CO2 scale.
• comfort_assessment_changed automation events with environmental condition, air quality, data quality, data issues, and current metric context.
• Persistent per-climate Home Assistant sensors for environmental condition, CO2 air quality, zone overrides, Adaptive Preconditioning start time, and Room Assist state.

🚀 Improved

• Spanish localization now uses more natural, consistent terminology across setup, Comfort, Room Assist, Adaptive Preconditioning, portability, and temperature migration.
• Celsius and Fahrenheit installations now receive physically equivalent schedule, template, Comfort, Room Assist, and Adaptive Preconditioning defaults, with units shown alongside temperature-related inputs.
• Thermal configuration and learning data now preserve values in the recorded Home Assistant unit instead of silently reinterpreting them when the unit changes.
• Settings now shows Home Assistant's detected temperature unit as a read-only value and provides an explicit stored-data migration when a later unit change requires one.
• Portable export model v3 declares its temperature unit, converts selected imports when needed, and accepts older unitless backups as Celsius with a visible warning.
• Export remains available while scheduling is stopped for a temperature-unit decision, allowing users to keep a reference copy before migrating or resetting.
• Stored schedules that cannot be validated while a climate is unavailable are checked when its exact range and temperature step return, with incompatible targets identified for review.
• Reset recreates schedules, templates, Comfort, Room Assist, and Adaptive Preconditioning defaults for Home Assistant's currently selected temperature unit.
• boost_ended automation events now describe whether Velair will restore the active schedule, the previous climate state, or nothing.
• Home Assistant sensors now have clearer responsibilities: scheduler status no longer duplicates upcoming-event history, while active target sensors include early-start preconditioning context and follow each climate's temperature unit.
• Home Assistant entities now expose user-facing scheduler and zone states without polling or duplicating raw temperature, humidity, or CO2 readings.
• Room Assist live status now separates the room-to-scheduled temperature gap from the climate setpoint offset, including signed heating/cooling corrections and zero-offset holding without implying physical HVAC activity.
• Zone overview now adapts to each card's available width, presents a clearer current-state summary, groups temperatures and Room Assist setpoints into compact separated details, and keeps Room Assist, Comfort, air-quality, and data signals clearly identified across desktop and mobile without duplicating no-readings warnings.
• Lovelace cards can filter the Comfort view to selected thermostats without changing stored schedules or scheduler behavior.
• Comfort Lovelace cards can hide configuration, temperature, humidity, or CO2 graphs independently for more focused dashboards.
• Documentation now includes dedicated user and developer guides for Environmental Comfort plus complete payload examples for automation events.
• Documentation now includes dedicated Celsius/Fahrenheit setup, migration, backup, and recovery guidance for users and developers.
• Comfort configuration now shows the effective automatic source or not-monitored state under each sensor selector and labels CO2 attention and poor thresholds clearly.
• Humidity monitoring can be disabled independently per climate without removing its saved sensor or thresholds.

🛠️ Fixed

• Fixed Zone overview signal chips overlapping when several indicators are shown by wrapping complete chips onto additional rows.
• Fixed Fahrenheit installations receiving Celsius-based schedule blocks, built-in templates, Comfort thresholds, Room Assist limits, and Adaptive Preconditioning parameters.
• Fixed mixed Celsius/Fahrenheit room and outdoor sensors being compared without conversion, including Room Assist, Comfort, and Adaptive Preconditioning paths.
• Fixed climate logbook entries always labelling target temperatures as Celsius.
• Fixed temperature-unit changes and portable imports reinterpreting stored schedules, overrides, thresholds, and Adaptive Preconditioning learning values by using explicit conversion, safe target-step alignment, scheduler locking, and recoverable atomic persistence.
• Fixed published legacy Celsius-only data being treated as Fahrenheit on existing Fahrenheit installations; Velair now stops safely and directs the user to create fresh unit-aware defaults.
• Fixed partially completed reset, migration, or import operations resuming the scheduler before runtime recovery succeeds.
• Removed obsolete per-climate Velair sensors from the Home Assistant entity registry when that climate is no longer managed.
• Fixed Comfort live assessments not refreshing when a tracked value changed inside the same environmental condition.
• Fixed Comfort enabling so previously selected sensors are kept instead of being replaced by defaults.
• Improved Comfort rows so unavailable-reading warnings are visible without expanding the climate.
• Fixed Comfort selector alignment when some sensors show selected entity IDs.
• Fixed Comfort climate rows so their typography, spacing, and collapsed-row layout match Preconditioning and Room Assist.
• Improved Comfort configuration by grouping each metric with its source and only showing thresholds when that metric has an available source.
• Fixed a Home Assistant thread-safety error when an active Adaptive Preconditioning learning session observed temperature changes.

🧭 Notes

• Existing Fahrenheit installations upgrading from a pre-1.2.0 release may contain legacy Celsius-only Velair data. Velair stops scheduling safely and asks the user to export a reference copy and reset Velair so schedules, templates, Comfort, Room Assist, and Adaptive Preconditioning defaults are recreated in Fahrenheit.
• For temperature-unit changes made after installing 1.2.0, use the migration action only when all stored Velair temperatures still use the previous Home Assistant unit. The Settings explanation shows the conversion direction before anything is changed.
• Climate firmware, supported HVAC modes, compressor or valve logic, temperature ranges, and temperature steps still apply because Velair works through Home Assistant's standard climate services.

📸 Screenshots

✨ New: Environmental Comfort

A responsive Comfort view for monitoring temperature, humidity, CO2, air quality, and data freshness.

🚀 Improved: Zone overview

A clearer overview of each zone’s current activity, temperatures, Room Assist state, comfort, air quality, and sensor data.

🚀 Improved: Room Assist

Room Assist now explains the room-to-target difference separately from the offset applied to the thermostat.