mirror of
https://github.com/alexhopeoconnor/arduino-home-assistant.git
synced 2026-10-04 02:48:13 +10:00
alex
b9f4fd7f4b
- Add HAAvailabilityConfig for per-entity availability_topic and payloads - Defer discovery until MQTT connected; publish availability after discovery - HASensor/HANumber: optional suggested_display_precision in discovery - HASerializer/HADictionary: extend for new keys; update device types and mocks - Docs and examples reflect availability and precision usage - Tests updated for discovery and availability behavior - Ignore .cursor/ in repo root
76 lines
2.5 KiB
Arduino
76 lines
2.5 KiB
Arduino
#include <Ethernet.h>
|
|
#include <ArduinoHA.h>
|
|
|
|
#define INPUT_PIN 9
|
|
#define BROKER_ADDR IPAddress(192,168,0,17)
|
|
|
|
byte mac[] = {0x00, 0x10, 0xFA, 0x6E, 0x38, 0x4A};
|
|
unsigned long lastReadAt = millis();
|
|
unsigned long lastAvailabilityToggleAt = millis();
|
|
bool lastInputState = false;
|
|
|
|
EthernetClient client;
|
|
HADevice device(mac, sizeof(mac));
|
|
HAMqtt mqtt(client, device);
|
|
|
|
// "myInput" is unique ID of the sensor. You should define you own ID.
|
|
HABinarySensor sensor("myInput");
|
|
|
|
void setup() {
|
|
pinMode(INPUT_PIN, INPUT_PULLUP);
|
|
lastInputState = digitalRead(INPUT_PIN);
|
|
|
|
// you don't need to verify return status
|
|
Ethernet.begin(mac);
|
|
|
|
lastReadAt = millis();
|
|
lastAvailabilityToggleAt = millis();
|
|
|
|
// set device's details (optional)
|
|
device.setName("Arduino");
|
|
device.setSoftwareVersion("1.0.0");
|
|
mqtt.setOriginSupportUrl("https://example.com/device-help");
|
|
|
|
sensor.setCurrentState(lastInputState); // optional
|
|
sensor.setName("Door sensor"); // optional
|
|
sensor.setDeviceClass("door"); // optional
|
|
sensor.setPayloadAvailable("ready");
|
|
sensor.setPayloadNotAvailable("lost");
|
|
|
|
// Optional multi-topic discovery metadata for external health sources.
|
|
// Runtime availability publishing still uses sensor.setAvailability(...).
|
|
// sensor.setAvailabilityMode("all");
|
|
// sensor.addAvailabilityEntry("bridge/status");
|
|
// sensor.addAvailabilityEntry("sensor/health", "{{ value_json.state }}");
|
|
|
|
// This method enables availability for all device types registered on the device.
|
|
// For example, if you have 5 sensors on the same device, you can enable
|
|
// shared availability and change availability state of all sensors using
|
|
// single method call "device.setAvailability(false|true)"
|
|
device.enableSharedAvailability();
|
|
|
|
// Optionally, you can enable MQTT LWT feature. If device will lose connection
|
|
// to the broker, all device types related to it will be marked as offline in
|
|
// the Home Assistant Panel.
|
|
device.enableLastWill();
|
|
|
|
mqtt.begin(BROKER_ADDR);
|
|
}
|
|
|
|
void loop() {
|
|
Ethernet.maintain();
|
|
mqtt.loop();
|
|
|
|
if ((millis() - lastReadAt) > 30) { // read in 30ms interval
|
|
// library produces MQTT message if a new state is different than the previous one
|
|
sensor.setState(digitalRead(INPUT_PIN));
|
|
lastInputState = sensor.getCurrentState();
|
|
lastReadAt = millis();
|
|
}
|
|
|
|
if ((millis() - lastAvailabilityToggleAt) > 5000) {
|
|
device.setAvailability(!device.isAvailable());
|
|
lastAvailabilityToggleAt = millis();
|
|
}
|
|
}
|