SmartHomeShop Docs

Home Assistant Integration

UltimateSensor v2 connects to Home Assistant through ESPHome. The optional SmartHomeShop.io integration adds the panel, product cards and calculated room insights.

UltimateSensor v2 Features

  • climate and available air-quality measurements;
  • PIR and mmWave presence, targets and zones where configured;
  • calculated room-quality and ventilation guidance;
  • supported media-player and voice-assistant entities.

Extra Entities Added by the Integration

Entity What it does
Room Quality (CC) Calculates a weighted 0-10 score from the available CO2, PM2.5, VOC, temperature and humidity readings. Missing readings are excluded; attributes include statuses and recommendations.
Room Quality Label (CC) Converts the score into Excellent, Good, Fair, Moderate, Poor or Unknown.
Room Quality Percentage (CC) Converts the score to 0-100% for gauges, thresholds and automations.

PIR, mmWave, target, zone, media and voice entities remain native ESPHome entities. See the complete UltimateSensor v2 entity reference.

Install the integration, select UltimateSensor and choose the matching ESPHome device. The complete Home Assistant Integration guide covers HACS installation, cards, entities, automations, privacy and troubleshooting.

The raw entities in Sensor Definitions remain available without the custom integration.