Everything Smart

Setup Wizard

Follow the Zone Configurator setup wizard to connect your devices and prepare your first room configuration.

The Setup Wizard guides you through configuring a new device in Zone Configurator. It runs automatically the first time you open the add-on, or you can launch it manually to add additional devices.

Starting the Wizard

The wizard launches automatically when:

To add another device manually:

  1. Click the menu icon (☰) in the top left
  2. Select Add New Device

Step 1: Select Your Device

Choose the Everything Presence device you want to configure from the list of available devices.

Step 1: Select Your Device — illustration 1

The wizard automatically discovers devices connected to Home Assistant. If your device doesn't appear:

Step 2: Entity Discovery

The wizard scans Home Assistant for entities belonging to your selected device and maps them automatically.

Step 2: Entity Discovery — illustration 1

Understanding the Discovery Results

After scanning, you'll see a summary showing how many entities were matched:

Status Icon Meaning
All matched ✓ Green Every required entity was found automatically
Needs attention ! Yellow Some entities need review or manual selection

Match Confidence Indicators

Each entity shows an icon indicating how confident the match is:

Icon Color Meaning Action Needed
✓ Green Exact match None - verified correct
~ Yellow Partial match Verify it's the right entity
! Orange Multiple matches Select the correct entity
✗ Red No match found Manually select an entity
✎ Blue Manually overridden You changed this mapping

Entity Groups

Entities are organized into expandable groups:

Groups with unmatched entities expand automatically so you can address them.

Handling Conflicts (Multiple Matches)

When the discovery finds multiple entities that could match, it marks them for review:

  1. Look for the orange "Review" label
  2. Click the dropdown to see all candidates
  3. Select the correct entity
  4. The display shows [disabled] or [hidden] next to entities with those states

Tip: If you renamed your device in Home Assistant, entity IDs may not match the expected pattern. Check that the selected entity belongs to your device.

Disabled Entities Warning

If matched entities are disabled in Home Assistant, you'll see a yellow warning:

"X matched entries are disabled in Home Assistant. Enable them in HA and everything should work without re-syncing."

To fix disabled entities:

  1. Note which entities are marked "Disabled in HA"
  2. Go to Home Assistant → Settings → Devices & Services → ESPHome
  3. Find your device and click on it
  4. Click on the disabled entity
  5. Click Enable and confirm
  6. Return to Zone Configurator - no re-sync needed

Disabled Entities Warning — illustration 1

Manually Changing a Mapping

To override an automatic match:

  1. Click the ✎ (edit) icon next to any entity
  2. A dropdown appears with all available entities for that type
  3. Select the correct entity
  4. The icon changes to ✎ to show it was manually set

What Gets Mapped

Here are some things that get mapped, these may vary depending on which device you have.

Entity Type Purpose Required
Occupancy Main presence detection state Yes
Target positions X/Y coordinates for tracking Yes
Zone states Zone occupancy status No
Distance Detection distance Yes
Environmental sensors Temperature, humidity, light No
Settings controls Max distance, sensitivity, etc. No

If Entities Are Missing

If important entities don't appear:

  1. Click Re-discover entities at the bottom
  2. If still missing, check in Home Assistant:
    • Is the device online? (Check Settings → Devices & Services)
    • Is the ESPHome integration working?
    • Are entities disabled? (Enable them in HA)
  3. Try restarting the device
  4. Verify your firmware is up to date

Completing Entity Discovery

Once all required entities show a match (green or manually set):

  1. Review any yellow/orange items to confirm they're correct
  2. Address any disabled entity warnings if needed
  3. Click Continue to proceed to room setup

Step 3: Create a Room

Give your room a name (e.g., "Living Room", "Office", "Bedroom").

Step 3: Create a Room — illustration 1

This name is used throughout Zone Configurator to identify where the device is installed.

Step 4: Room Outline (Optional)

Draw the outline of your room to visualize the detection area. This step is optional but recommended for accurate zone placement.

Step 4: Room Outline (Optional) — illustration 1

Drawing Your Room

  1. Click to place the first corner point
  2. Continue clicking to add more points
  3. Press Enter or click the first point to close the shape
  4. Press Esc to cancel

Keyboard Shortcuts

Key Action
A Add point at cursor
Enter Complete the shape
Esc Cancel drawing
Del Delete last point

Tip: You can refine your room layout later using the Room Builder.

Step 5: Add Doors

Click on a wall to add a door. You can change the placement, hinge side and open side.

Step 5: Add Doors — illustration 1

Step 6: Add Furniture (Optional)

Add furniture to your room to visualize obstacles and help with zone placement. This step is optional but helps you understand how furniture affects sensor coverage.

Step 6: Add Furniture (Optional) — illustration 1

Adding Furniture

  1. Click Add Furniture or the furniture icon
  2. Select a furniture type from the catalog
  3. Click in the room to place it
  4. Drag to reposition as needed

Available Furniture Types

Adjusting Furniture

Tip: Place furniture where it actually is in your room - this helps identify areas that may block detection and assists with accurate zone placement later.

Adjusting Furniture — illustration 1

Why Add Furniture?

Step 7: Device Placement

Position the sensor icon to match where your device is physically installed in the room.

Step 7: Device Placement — illustration 1

Positioning

Installation Angle

If your sensor is mounted at an angle (tilted down from the ceiling or wall), you can set the installation angle. This helps calculate accurate target positions.

Installation Angle — illustration 1

Completing the Wizard

Click Finish to save your configuration. You'll be taken to the Live Dashboard where you can:

Next Steps