BACnet-objecten als Home Assistant entiteiten
Ondersteunde objecttypen
Elk BACnet-object dat je importeert wordt een entiteit. Het standaardtype hangt af van het objecttype:
| BACnet-object | Standaardentiteit | Schrijfbaar? |
|---|---|---|
| Analog Input | Sensor | Nee |
| Analog Output | Number | Ja |
| Analog Value | Sensor | Automatisch gedetecteerd |
| Binary Input | Binary sensor | Nee |
| Binary Output | Switch | Ja |
| Binary Value | Switch | Automatisch gedetecteerd |
| Multi-State Input | Sensor | Nee |
| Multi-State Output | Number | Ja |
| Multi-State Value | Sensor | Automatisch gedetecteerd |
| Schedule | Sensor (huidige waarde) | Via bacnet.write_schedule |
| Trend Log | Sensor (aantal records) | Nee; records via bacnet.read_trend_log |
Inputs zijn nooit schrijfbaar. Outputs altijd, omdat ze een Priority Array hebben: het BACnet-mechanisme waarmee meerdere schrijvers één object met verschillende prioriteiten kunnen aansturen (zie Hoe schrijven werkt). Value-objecten accepteren al dan niet schrijfacties: tijdens de installatie controleert de integratie of het object een Priority Array heeft. Een Value-object zonder Priority Array wordt een alleen-lezen sensor of binary_sensor.
Analoge sensoren houden langetermijnstatistieken bij: energie- en volume-objecten als meter (total_increasing, bruikbaar in het Energy-dashboard), alle andere als meting. Energie-, vermogen-, debiet- en volume-eenheden krijgen de device class die het Energy-dashboard nodig heeft. De instelling state class in Customize objects wijzigt dit per object.
Elk object kan in Customize objects een ander entiteitstype krijgen. Multi-state objecten kunnen ook een select worden die hun stateText-labels toont, bijvoorbeeld Off / Heat / Cool. Een setpoint kan een climate-entiteit worden. Zie de handleidingen Multi-state als select en Setpoint als climate.
Let op: Vóór 1.0.53 waren energie- en volumesensoren een meting. Na de update kan Developer tools → Statistics ze met een gewijzigde state class tonen; klik daar eenmalig per sensor op Fix issue. Sinds 1.0.55 krijgen meer BACnet-eenheden een Home Assistant-eenheid (L/h, mL/s, m³/s, m³/min, ft³/min, gal/min, gal/h, mL, ft³, gal, J, kJ, MJ en mW). Sensoren in deze eenheden hadden eerder geen eenheid; klik na de update eenmalig per sensor op Fix issue in Developer tools → Statistics.
Numbers gebruiken minPresValue, maxPresValue en resolution van het object als grenzen en stapgrootte als het apparaat die levert. Analoge sensoren behouden de volledige precisie van de apparaatwaarde; Home Assistant toont standaard 2 decimalen, wat je per entiteit kunt wijzigen.
Entiteitsattributen
Elke entiteit toont BACnet-metadata als statusattributen:
| Attribuut | Beschrijving |
|---|---|
bacnet_object_type | Naam van het BACnet-objecttype, bijvoorbeeld "Analog Input" |
bacnet_instance | BACnet-instancenummer van het object |
bacnet_commandable | Of dit object schrijfacties ondersteunt |
bacnet_units | Technische eenheid, bijvoorbeeld "degrees-celsius" |
bacnet_description | De BACnet-property description |
bacnet_status_flags | De BACnet-array met statusvlaggen |
bacnet_in_alarm | true zolang de statusvlag IN_ALARM van het object staat |
bacnet_update_method | Hoe deze entiteit wordt bijgewerkt: COV of polling |
bacnet_cov_increment | Ingestelde COV-gevoeligheid (alleen analoge objecten met actieve COV) |
bacnet_state_text | Het stateText-label van de huidige status (alleen multi-state objecten) |
Alleen bacnet_status_flags, bacnet_in_alarm en bacnet_state_text worden in de recorder-geschiedenis opgeslagen; de andere attributen veranderen niet.
Een entiteit is unavailable (niet beschikbaar) als het apparaat niet reageert. Statusvlaggen (in-alarm, fault, overridden, out-of-service) veranderen de beschikbaarheid niet, omdat sommige gateways FAULT op elk object melden terwijl de waarden live zijn. Bekijk bacnet_status_flags om ze te zien.
Diagnostische sensoren
Elk apparaat krijgt ook diagnostische sensoren, onder Diagnostic op de apparaatpagina:
| Sensor | Standaard ingeschakeld |
|---|---|
| Last successful poll | Ja |
| COV subscriptions | Nee |
| Consecutive failed polls | Ja |
Ze blijven beschikbaar terwijl het apparaat offline is, en dan zijn ze juist nuttig.
Andere entiteiten op elk apparaat
- Write Priority: een select om de schrijfprioriteit te kiezen, standaard uitgeschakeld. Zie Write Priority select.
- Refresh object metadata: een knop onder Configuration die namen, beschrijvingen, eenheden en limieten in één keer opnieuw leest.
- Alarm en Active alarms: zie Alarmen.
Geteste apparaten
BACnet is een standaard, dus een apparaat dat niet in de lijst staat werkt er hoogstwaarschijnlijk ook mee. De lijst met geteste apparaten toont wat gebruikers echt met deze integratie hebben gedraaid: fabrikant, model, firmware, integratieversie en wat bevestigd werkt.