/* HOME ASSISTANT MODULE Copyright (C) 2017-2019 by Xose PĂ©rez */ #if HOMEASSISTANT_SUPPORT #include #include #include bool _ha_enabled = false; bool _ha_send_flag = false; // ----------------------------------------------------------------------------- // UTILS // ----------------------------------------------------------------------------- // per yaml 1.1 spec, following scalars are converted to bool. we want the string, so quoting the output // y|Y|yes|Yes|YES|n|N|no|No|NO |true|True|TRUE|false|False|FALSE |on|On|ON|off|Off|OFF String _haFixPayload(const String& value) { if (value.equalsIgnoreCase("y") || value.equalsIgnoreCase("n") || value.equalsIgnoreCase("yes") || value.equalsIgnoreCase("no") || value.equalsIgnoreCase("true") || value.equalsIgnoreCase("false") || value.equalsIgnoreCase("on") || value.equalsIgnoreCase("off") ) { String temp; temp.reserve(value.length() + 2); temp = "\""; temp += value; temp += "\""; return temp; } return value; } String& _haFixName(String& name) { for (unsigned char i=0; i _messages; unsigned char _retry; }; std::unique_ptr _ha_discovery = nullptr; void _haSendDiscovery() { if (!_ha_discovery) return; const bool connected = mqttConnected(); const bool retry = _ha_discovery->retry(); const bool empty = _ha_discovery->empty(); if (!connected || !retry || empty) { _ha_discovery = nullptr; return; } const unsigned long ts = millis(); do { if (_ha_discovery->empty()) break; auto& message = _ha_discovery->next(); if (!mqttSendRaw(message.first.c_str(), message.second.c_str())) { break; } _ha_discovery->pop(); // XXX: should not reach this timeout, most common case is the break above } while (millis() - ts < ha_discovery_t::SEND_TIMEOUT); mqttSendStatus(); if (_ha_discovery->empty()) { _ha_discovery = nullptr; } else { // 2.3.0: Ticker callback arguments are not preserved and once_ms_scheduled is missing // We need to use global discovery object to reschedule it // Otherwise, this would've been shared_ptr from _haSend _ha_discovery->timer.once_ms(ha_discovery_t::SEND_TIMEOUT, []() { schedule_function(_haSendDiscovery); }); } } // ----------------------------------------------------------------------------- // SENSORS // ----------------------------------------------------------------------------- #if SENSOR_SUPPORT void _haSendMagnitude(unsigned char i, JsonObject& config) { unsigned char type = magnitudeType(i); config["name"] = _haFixName(getSetting("hostname") + String(" ") + magnitudeTopic(type)); config["state_topic"] = mqttTopic(magnitudeTopicIndex(i).c_str(), false); config["unit_of_measurement"] = magnitudeUnits(type); } void ha_discovery_t::prepareMagnitudes(ha_config_t& config) { // Note: because none of the keys are erased, use a separate object to avoid accidentally sending switch data JsonObject& root = config.jsonBuffer.createObject(); for (unsigned char i=0; i 1) { name += String("_") + String(i); } config.set("name", _haFixName(name)); if (relayCount()) { config["state_topic"] = mqttTopic(MQTT_TOPIC_RELAY, i, false); config["command_topic"] = mqttTopic(MQTT_TOPIC_RELAY, i, true); config["payload_on"] = relayPayload(RelayStatus::ON); config["payload_off"] = relayPayload(RelayStatus::OFF); config["availability_topic"] = mqttTopic(MQTT_TOPIC_STATUS, false); config["payload_available"] = mqttPayloadStatus(true); config["payload_not_available"] = mqttPayloadStatus(false); } #if LIGHT_PROVIDER != LIGHT_PROVIDER_NONE if (i == 0) { config["brightness_state_topic"] = mqttTopic(MQTT_TOPIC_BRIGHTNESS, false); config["brightness_command_topic"] = mqttTopic(MQTT_TOPIC_BRIGHTNESS, true); if (lightHasColor()) { config["rgb_state_topic"] = mqttTopic(MQTT_TOPIC_COLOR_RGB, false); config["rgb_command_topic"] = mqttTopic(MQTT_TOPIC_COLOR_RGB, true); } if (lightUseCCT()) { config["color_temp_command_topic"] = mqttTopic(MQTT_TOPIC_MIRED, true); config["color_temp_state_topic"] = mqttTopic(MQTT_TOPIC_MIRED, false); } if (lightChannels() > 3) { config["white_value_state_topic"] = mqttTopic(MQTT_TOPIC_CHANNEL, 3, false); config["white_value_command_topic"] = mqttTopic(MQTT_TOPIC_CHANNEL, 3, true); } } #endif // LIGHT_PROVIDER != LIGHT_PROVIDER_NONE } void ha_discovery_t::prepareSwitches(ha_config_t& config) { // Note: because none of the keys are erased, use a separate object to avoid accidentally sending magnitude data JsonObject& root = config.jsonBuffer.createObject(); for (unsigned char i=0; i()); } else { output += kv.value.as(); } output += "\n"; } output += " "; root.remove("config"); root["haConfig"] = output; } #if SENSOR_SUPPORT void _haSensorYaml(unsigned char index, JsonObject& root) { String output; output.reserve(HA_YAML_BUFFER_SIZE); JsonObject& config = root.createNestedObject("config"); config["platform"] = "mqtt"; _haSendMagnitude(index, config); if (index == 0) output += "\n\nsensor:"; output += "\n"; bool first = true; for (auto kv : config) { if (first) { output += " - "; first = false; } else { output += " "; } String value = kv.value.as(); value.replace("%", "'%'"); output += kv.key; output += ": "; output += value; output += "\n"; } output += " "; root.remove("config"); root["haConfig"] = output; } #endif // SENSOR_SUPPORT void _haGetDeviceConfig(JsonObject& config) { config.createNestedArray("identifiers").add(getIdentifier()); config["name"] = getSetting("desc", getSetting("hostname")); config["manufacturer"] = MANUFACTURER; config["model"] = DEVICE; config["sw_version"] = String(APP_NAME) + " " + APP_VERSION + " (" + getCoreVersion() + ")"; } void _haSend() { // Pending message to send? if (!_ha_send_flag) return; // Are we connected? if (!mqttConnected()) return; // Are we still trying to send discovery messages? if (_ha_discovery) return; DEBUG_MSG_P(PSTR("[HA] Preparing MQTT discovery message(s)...\n")); // Get common device config / context object ha_config_t config; // We expect only one instance, create now _ha_discovery = std::make_unique(); // Prepare all of the messages and send them in the scheduled function later _ha_discovery->prepareSwitches(config); #if SENSOR_SUPPORT _ha_discovery->prepareMagnitudes(config); #endif _ha_send_flag = false; schedule_function(_haSendDiscovery); } void _haConfigure() { const bool enabled = getSetting("haEnabled", HOMEASSISTANT_ENABLED).toInt() == 1; _ha_send_flag = (enabled != _ha_enabled); _ha_enabled = enabled; // https://github.com/xoseperez/espurna/issues/1273 // https://gitter.im/tinkerman-cat/espurna?at=5df8ad4655d9392300268a8c // TODO: ensure that this is called before _lightConfigure() // in case useCSS value is ever cached by the lights module #if LIGHT_PROVIDER != LIGHT_PROVIDER_NONE if (enabled) { if (getSetting("useCSS", LIGHT_USE_CSS).toInt() == 1) { setSetting("useCSS", 0); } } #endif _haSend(); } #if WEB_SUPPORT bool _haWebSocketOnKeyCheck(const char * key, JsonVariant& value) { return (strncmp(key, "ha", 2) == 0); } void _haWebSocketOnVisible(JsonObject& root) { root["haVisible"] = 1; } void _haWebSocketOnConnected(JsonObject& root) { root["haPrefix"] = getSetting("haPrefix", HOMEASSISTANT_PREFIX); root["haEnabled"] = getSetting("haEnabled", HOMEASSISTANT_ENABLED).toInt() == 1; } void _haWebSocketOnAction(uint32_t client_id, const char * action, JsonObject& data) { if (strcmp(action, "haconfig") == 0) { ws_on_send_callback_list_t callbacks; #if SENSOR_SUPPORT callbacks.reserve(magnitudeCount() + relayCount()); #else callbacks.reserve(relayCount()); #endif // SENSOR_SUPPORT { for (unsigned char idx=0; idx().c_str()); } #if SENSOR_SUPPORT for (unsigned char idx=0; idx().c_str()); } #endif // SENSOR_SUPPORT DEBUG_MSG("\n"); terminalOK(); }); terminalRegisterCommand(F("HA.SEND"), [](Embedis* e) { setSetting("haEnabled", "1"); _haConfigure(); #if WEB_SUPPORT wsPost(_haWebSocketOnConnected); #endif terminalOK(); }); terminalRegisterCommand(F("HA.CLEAR"), [](Embedis* e) { setSetting("haEnabled", "0"); _haConfigure(); #if WEB_SUPPORT wsPost(_haWebSocketOnConnected); #endif terminalOK(); }); } #endif // ----------------------------------------------------------------------------- void haSetup() { _haConfigure(); #if WEB_SUPPORT wsRegister() .onVisible(_haWebSocketOnVisible) .onConnected(_haWebSocketOnConnected) .onAction(_haWebSocketOnAction) .onKeyCheck(_haWebSocketOnKeyCheck); #endif #if TERMINAL_SUPPORT _haInitCommands(); #endif // On MQTT connect check if we have something to send mqttRegister([](unsigned int type, const char * topic, const char * payload) { if (type == MQTT_CONNECT_EVENT) schedule_function(_haSend); if (type == MQTT_DISCONNECT_EVENT) _ha_send_flag = _ha_enabled; }); // Main callbacks espurnaRegisterReload(_haConfigure); } #endif // HOMEASSISTANT_SUPPORT