🧭 Device & Entity Mapping Guide

To map your Devices & Entities to the correct internal class, we use the device domain (e.g. switch, light, fan) and the name after the dot (e.g. light, exhaust, etc.) as matching criteria.

⚠️ Do not use any Space-Char " " on your Device Names, it will translate in Home Assistant to an under Slash "_" and break the Device Identification logic.

⚠️ That are only examples you can define your name how you like, but it needs to be in the Valid array Schema described below. See Mapping Function on the End.

⚠️ Temp And Humidity needs to be in the English language after the under slash _temperature _humidity. "Until we have a mapping function for all languages"

---

🌡️ Sensors

Device Name Format	Entity ID	Check
FlowerSensor1	sensor.flowersensor1__humidity	Correct ✅
FlowerSensor2	sensor.flowersensor2_temperature	Correct ✅
Flower Sensor1	sensor.flower_sensor1_temperature	Wrong ❌

Entity ID Format
sensor.sensorSome_humidity	Humidity
sensor.sensorSome_temperature	Temp

Entity ID Format	Device Sensors Mappings
sensor.exhaust_duty	Exhaust Duty Cycle
sensor.light_intensity	Light Voltage

Coming Soon Sensors	SOON Usable
sensor.sensorSome_dewpoint	Dewpoint
sensor.sensorSome_moisture	Moisture

---

💡 Lights

Device Name Format	Entity ID	Check
FlowerLight	switch.flowerlight	Correct ✅
Flower Light	switch.flower_light	Wrong ❌

Entity ID Format	Type
switch.light	Non-Dimmable
light.light	Dimmable

---

🌬️ Exhaust

Device Name Format	Entity ID	Check
FlowerExhaust	switch.flowerexhaust	Correct ✅

| Flower Exhaust | switch.flower_exhaust | Wrong ❌ |

Entity ID Format	Type
switch.exhaust	Non-Dimmable
light.exhaust	Dimmable
fan.exhaust	Dimmable

---

🌪️ Inhaust (Not fully implemented yet)

Device Name Format	Entity ID	Check
FlowerInhaust	switch.flowerinhaust	Correct ✅
Flower Inhaust	switch.flower_inhaust	Wrong ❌

Entity ID Format	Type
switch.inhaust	Non-Dimmable
light.inhaust	Dimmable
fan.inhaust	Dimmable

---

🌀 Ventilation

Device Name Format	Entity ID	Check
FlowerVentilation	switch.flowerventilation	Correct ✅
Flower Ventilation	switch.flower_ventilation	Wrong ❌

Entity ID Format	Type
switch.vents	Non-Dimmable
light.vents	Dimmable
fan.vents	Dimmable

---

💧 Humidifier

Device Name Format	Entity ID	Check
FlowerHumidifier	switch.flowerhumidifier	Correct ✅
Flower Humidifier	switch.flower_humidifier	Wrong ❌

Entity ID Format	Type / Mode Support
switch.humidifier	Non-Dimmable
humidifier.humidifier	Modes – Planned support

---

🧼 Dehumidifier

Device Name Format	Entity ID	Check
FlowerDehumidifier	switch.flowerdehumidifier	Correct ✅
Flower Dehumidifier	switch.flower_dehumidifier	Wrong ❌

Entity ID Format	Type / Mode Support
switch.dehumidifier	Non-Dimmable
humidifier.dehumidifier	Modes – Planned support

---

❄️ Cooler

Device Name Format	Entity ID	Check
FlowerCooler	switch.flowercooler	Correct ✅
Flower Cooler	switch.flower_cooler	Wrong ❌

Entity ID Format	Type
switch.cooler	Non-Dimmable

---

🔥 Heater

Device Name Format	Entity ID	Check
FlowerHeater	switch.flowerheater	Correct ✅
Flower Heater	switch.flower_heater	Wrong ❌

Entity ID Format	Type
switch.heater	Non-Dimmable

---

Co² Pump

Device Name Format	Entity ID	Check
FlowerCO2	switch.flowerco2	Correct ✅
Flower CO2	switch.flower_co2	Wrong ❌

Entity ID Format	Type / Mode Support
switch.co2	Non-Dimmable

---

🚰 Water Pumps

Device Name Format	Entity ID	Check
FlowerPump	switch.flowerpump	Correct ✅
Flower Pump	switch.flower_pump	Wrong ❌

Entity ID Format	Type / Mode Support
switch.waterpump	Non-Dimmable
switch.mistpump	Non-Dimmable
switch.rdwcpump	Non-Dimmable
switch.dwcpump	Non-Dimmable
switch.aeropump	Non-Dimmable
switch.clonerpump	Non-Dimmable

🚰 Water Retrieve Pumps (Not implemented yet)

Entity ID Format	Type / Mode Support
switch.retrievepump	Non-Dimmable

🚰 Feed Pumps (Not implemented yet)

Entity ID Format	Type / Mode Support
switch.feedpump_A	Non-Dimmable
switch.feedpump_B	Non-Dimmable
switch.feedpump_C	Non-Dimmable
switch.feedpump_W	Non-Dimmable
switch.feedpump_X	Non-Dimmable
switch.feedpump_Y	Non-Dimmable
switch.feedpump_Pp	Non-Dimmable
switch.feedpump_Pm	Non-Dimmable

---

🌡️ Climate Device (Not implemented yet)

Device Name Format	Entity ID	Check
FlowerClimate	switch.flowerclimate	Correct ✅
Flower Climate	switch.flower_climate	Wrong ❌

Entity ID Format	Features
climate.climate	Multi-mode – Planned

---

⚙️ Mapping Function

You can find the current mapping logic in the source code here:
📄 OGBDeviceManager.py – line 114