Editing or Hiding Discovered Entities

[PLACEHOLDER: Editing and Entity Reference]

One of the most powerful features of the Discovery system is the ability to choose exactly which components of the lamp are exposed to Home Assistant. You can add or remove groups of entities at any time to keep your dashboard clean and relevant.

Updating an Existing Discovery

The primary controller stores your previous settings in a discovery.json file. This allows you to modify your entity list without creating duplicates in Home Assistant.

Modifying Entity Groups

Navigate to the Discovery page in the Advanced menu.
Your previously selected groups will be pre-populated.
Check any additional groups you wish to add, or uncheck groups you wish to remove.
Click the UPDATE DISCOVERY button.

💡 Device Name Limitation
The Device Name is used to generate unique MQTT discovery topics. Because of this, you cannot change the Device Name once Discovery is enabled. To change the name, you must first Remove Discovery and then recreate it with the new name.

The Update Button

When you click UPDATE DISCOVERY, the system immediately sends “clearance” messages for any removed groups and “discovery” messages for any new ones.

⚠️ Dashboard Warning
If you remove an entity group that is currently in use on a Home Assistant dashboard or in an automation, those items will show as “Unavailable” or may break entirely.

Handling System Resets or Hardware Changes

Because Discovery relies on a unique string (Device Name + MAC Address), certain hardware events require attention:

System Reset (Same ESP32): If you perform a factory reset but use the same hardware and the same Device Name, running Discovery again will simply “take over” the existing entities in Home Assistant.
New ESP32 / Different Name: If you replace the controller or change the name, Home Assistant will treat it as a brand-new device. In this case, it is best to delete the old device from the Home Assistant Devices page to avoid clutter.

Entities Created Reference Table

The following table lists the entities created in Home Assistant based on your selections.

Note: device_name refers to your specified Discovery Device Name (converted to lowercase with underscores).

Entity Group	Entities Created	Friendly Name
RGBW Light Bulb	`light.device_name_bulbstate` (Includes brightness, color & temperature attibutes)	Light Bulb
LED Strip	`light.device_name_ledstate` (Includes brightness and color attributes)	LED Strip
TFT Display	`number.device_name_dispbrightness` `switch.device_name_autodim` `text.device_name_clockcolor`	Display Brightness Auto-Dimming Clock Color
Touch Sensors	`binary_sensor.device_name_touch1state` `binary_sensor.device_name_touch2state` `select.device_name_touch1func` `select.device_name_touch2func`	Touch 1 State Touch 2 State Touch 1 Main Function Touch 2 Main Function
Alarms	`number.device_name_alarmvolume` `number.device_name_alarmtrack` `number.device_name_snoozetime` `switch.device_name_gentlewake` `button.device_name_alarm_snooze` `button.device_name_alarm_stop`	Alarm Volume Alarm Track Snooze Duration Gentle Wake Snooze Alarm Stop Alarm
Diagnostics	`sensor.device_name_ip_display` `sensor.device_name_ip_bulb` `sensor.device_name_ip_primary` `button.device_name_rb_display` `button.device_name_rb_primary`	IP Addr Display IP Addr Light Bulb IP Addr Primary Restart Display Restart Primary

💡 Customization
You can safely rename these entities or change their icons directly within the Home Assistant UI without affecting the lamp’s firmware.

<- Previous: Enabling and Disabling Discovery Next: Manually Creating MQTT Entities ->