SmartHomeShop Docs

Home Assistant Integration

UltimateSensor v1 is available in Home Assistant through ESPHome. The optional SmartHomeShop.io integration adds a dedicated panel, room cards and calculated room-quality features.

UltimateSensor v1 Features

  • climate and air-quality overview from the fitted sensors;
  • presence and target information from supported motion sensors;
  • calculated room-quality guidance;
  • the Room Designer for polygon zones, exclusion zones and entry lines;
  • access to the display and other native 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.

Presence, tracking, illuminance and display entities remain native ESPHome entities. See the complete UltimateSensor v1 entity reference.

Install the integration, select UltimateSensor and choose the matching ESPHome device. Follow the complete Home Assistant Integration guide for installation, cards, entities and troubleshooting.

See Sensor Definitions for the exact v1 hardware entities.