mirror of
https://github.com/emsesp/EMS-ESP32.git
synced 2025-12-06 15:59:52 +03:00
301 lines
10 KiB
C++
301 lines
10 KiB
C++
/*
|
|
* EMS-ESP - https://github.com/proddy/EMS-ESP
|
|
* Copyright 2019 Paul Derbyshire
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include "emsdevice.h"
|
|
#include "emsesp.h"
|
|
#include "mqtt.h" // for the mqtt_function_p
|
|
|
|
MAKE_PSTR(logger_name, "emsdevice")
|
|
|
|
namespace emsesp {
|
|
|
|
uuid::log::Logger EMSdevice::logger_{F_(logger_name), uuid::log::Facility::CONSOLE};
|
|
|
|
std::string EMSdevice::brand() const {
|
|
switch (brand_) {
|
|
case EMSdevice::Brand::BOSCH:
|
|
return read_flash_string(F("Bosch"));
|
|
break;
|
|
case EMSdevice::Brand::JUNKERS:
|
|
return read_flash_string(F("Junkers"));
|
|
break;
|
|
case EMSdevice::Brand::BUDERUS:
|
|
return read_flash_string(F("Buderus"));
|
|
break;
|
|
case EMSdevice::Brand::NEFIT:
|
|
return read_flash_string(F("Nefit"));
|
|
break;
|
|
case EMSdevice::Brand::SIEGER:
|
|
return read_flash_string(F("Sieger"));
|
|
break;
|
|
case EMSdevice::Brand::WORCESTER:
|
|
return read_flash_string(F("Worcester"));
|
|
break;
|
|
case EMSdevice::Brand::NO_BRAND:
|
|
default:
|
|
return read_flash_string(F("?"));
|
|
break;
|
|
}
|
|
|
|
return std::string{};
|
|
}
|
|
|
|
std::string EMSdevice::device_type_name() const {
|
|
switch (device_type_) {
|
|
case DeviceType::BOILER:
|
|
return read_flash_string(F("Boiler"));
|
|
break;
|
|
|
|
case DeviceType::THERMOSTAT:
|
|
return read_flash_string(F("Thermostat"));
|
|
break;
|
|
|
|
case DeviceType::HEATPUMP:
|
|
return read_flash_string(F("Heat Pump"));
|
|
break;
|
|
|
|
case DeviceType::SOLAR:
|
|
return read_flash_string(F("Solar Module"));
|
|
break;
|
|
|
|
case DeviceType::CONNECT:
|
|
return read_flash_string(F("Connect Module"));
|
|
break;
|
|
|
|
case DeviceType::CONTROLLER:
|
|
return read_flash_string(F("Controller"));
|
|
break;
|
|
|
|
case DeviceType::MIXING:
|
|
return read_flash_string(F("Mixing Module"));
|
|
break;
|
|
|
|
case DeviceType::SWITCH:
|
|
return read_flash_string(F("Switching Module"));
|
|
break;
|
|
|
|
case DeviceType::GATEWAY:
|
|
return read_flash_string(F("Gateway Module"));
|
|
break;
|
|
|
|
default:
|
|
return read_flash_string(F("Unknown"));
|
|
break;
|
|
}
|
|
}
|
|
|
|
// 0=unknown, 1=bosch, 2=junkers, 3=buderus, 4=nefit, 5=sieger, 11=worcester
|
|
uint8_t EMSdevice::decode_brand(uint8_t value) {
|
|
switch (value) {
|
|
case 1:
|
|
return EMSdevice::Brand::BOSCH;
|
|
break;
|
|
case 2:
|
|
return EMSdevice::Brand::JUNKERS;
|
|
break;
|
|
case 3:
|
|
return EMSdevice::Brand::BUDERUS;
|
|
break;
|
|
case 4:
|
|
return EMSdevice::Brand::NEFIT;
|
|
break;
|
|
case 5:
|
|
return EMSdevice::Brand::SIEGER;
|
|
break;
|
|
case 11:
|
|
return EMSdevice::Brand::WORCESTER;
|
|
break;
|
|
case 0:
|
|
default:
|
|
return EMSdevice::Brand::NO_BRAND;
|
|
break;
|
|
}
|
|
}
|
|
|
|
// print human friendly description of the EMS device
|
|
std::string EMSdevice::to_string() const {
|
|
std::string str(160, '\0');
|
|
|
|
// for devices that haven't been lookup yet, don't show all details
|
|
if (product_id_ == 0) {
|
|
snprintf_P(&str[0], str.capacity() + 1, PSTR("%s (DeviceID:0x%02X)"), name_.c_str(), device_id_);
|
|
return str;
|
|
}
|
|
|
|
if (brand_ == Brand::NO_BRAND) {
|
|
snprintf_P(&str[0], str.capacity() + 1, PSTR("%s (DeviceID:0x%02X, ProductID:%d, Version:%s)"), name_.c_str(), device_id_, product_id_, version_.c_str());
|
|
} else {
|
|
snprintf_P(&str[0],
|
|
str.capacity() + 1,
|
|
PSTR("%s %s (DeviceID:0x%02X ProductID:%d, Version:%s)"),
|
|
brand().c_str(),
|
|
name_.c_str(),
|
|
device_id_,
|
|
product_id_,
|
|
version_.c_str());
|
|
}
|
|
|
|
return str;
|
|
}
|
|
|
|
// prints the header for the section
|
|
void EMSdevice::show_values(uuid::console::Shell & shell) {
|
|
shell.printfln(F("%s: %s"), device_type_name().c_str(), to_string().c_str());
|
|
}
|
|
|
|
// for each telegram that has the fetch value set (true) do a read request
|
|
void EMSdevice::fetch_values() {
|
|
LOG_DEBUG(F("Fetching values for device ID 0x%02X"), device_id());
|
|
|
|
for (const auto & tf : telegram_functions_) {
|
|
if (tf.fetch_) {
|
|
read_command(tf.telegram_type_id_);
|
|
}
|
|
}
|
|
}
|
|
|
|
// toggle on/off automatic fetch for a telegram id
|
|
void EMSdevice::toggle_fetch(uint16_t telegram_id, bool toggle) {
|
|
LOG_DEBUG(F("Toggling fetch for device ID 0x%02X, telegram ID 0x%02X to %d"), device_id(), telegram_id, toggle);
|
|
|
|
for (auto & tf : telegram_functions_) {
|
|
if (tf.telegram_type_id_ == telegram_id) {
|
|
tf.fetch_ = toggle;
|
|
}
|
|
}
|
|
}
|
|
|
|
// list all the telegram type IDs for this device
|
|
void EMSdevice::show_telegram_handlers(uuid::console::Shell & shell) {
|
|
if (telegram_functions_.size() == 0) {
|
|
return;
|
|
}
|
|
|
|
shell.printf(F(" This %s will respond to telegram type IDs: "), device_type_name().c_str());
|
|
for (const auto & tf : telegram_functions_) {
|
|
shell.printf(F("0x%02X "), tf.telegram_type_id_);
|
|
}
|
|
shell.println();
|
|
}
|
|
|
|
// list all the mqtt handlers for this device
|
|
void EMSdevice::show_mqtt_handlers(uuid::console::Shell & shell) {
|
|
Mqtt::show_topic_handlers(shell, this->device_id_);
|
|
}
|
|
|
|
void EMSdevice::register_mqtt_topic(const std::string & topic, mqtt_function_p f) {
|
|
LOG_DEBUG(F("Registering MQTT topic %s for device ID %02X"), topic.c_str(), this->device_id_);
|
|
Mqtt::subscribe(this->device_id_, topic, f);
|
|
}
|
|
|
|
EMSdevice::TelegramFunction::TelegramFunction(uint16_t telegram_type_id,
|
|
const __FlashStringHelper * telegram_type_name,
|
|
bool fetch,
|
|
process_function_p process_function)
|
|
: telegram_type_id_(telegram_type_id)
|
|
, telegram_type_name_(telegram_type_name)
|
|
, fetch_(fetch)
|
|
, process_function_(process_function) {
|
|
}
|
|
|
|
// register a call back function for a specific telegram type
|
|
void EMSdevice::register_telegram_type(const uint16_t telegram_type_id, const __FlashStringHelper * telegram_type_name, bool fetch, process_function_p f) {
|
|
telegram_functions_.emplace_back(telegram_type_id, telegram_type_name, fetch, f);
|
|
}
|
|
|
|
// return the name of the telegram type
|
|
std::string EMSdevice::telegram_type_name(std::shared_ptr<const Telegram> telegram) {
|
|
// see if it's one of the common ones, like Version
|
|
if (telegram->type_id == EMS_TYPE_VERSION) {
|
|
return read_flash_string(F("Version"));
|
|
} else if (telegram->type_id == EMS_TYPE_UBADevices) {
|
|
return read_flash_string(F("UBADevices"));
|
|
}
|
|
|
|
for (const auto & tf : telegram_functions_) {
|
|
if ((tf.telegram_type_id_ == telegram->type_id) && ((telegram->type_id & 0x0F0) != 0xF0)) {
|
|
return uuid::read_flash_string(tf.telegram_type_name_);
|
|
}
|
|
}
|
|
|
|
return std::string{};
|
|
}
|
|
|
|
// take a telegram_type_id and call the matching handler
|
|
// return true if match found
|
|
bool EMSdevice::handle_telegram(std::shared_ptr<const Telegram> telegram) {
|
|
for (const auto & tf : telegram_functions_) {
|
|
if (tf.telegram_type_id_ == telegram->type_id) {
|
|
// if the data block is empty, assume that this telegram is not recognized by the bus master
|
|
// so remove it from the automatic fetch list
|
|
if (telegram->message_length == 0) {
|
|
LOG_DEBUG(F("This telegram (%s) is not recognized by the EMS bus"), uuid::read_flash_string(tf.telegram_type_name_).c_str());
|
|
toggle_fetch(tf.telegram_type_id_, false);
|
|
return false;
|
|
}
|
|
|
|
LOG_DEBUG(F("Processing %s..."), uuid::read_flash_string(tf.telegram_type_name_).c_str());
|
|
tf.process_function_(telegram);
|
|
return true;
|
|
}
|
|
}
|
|
return false; // type not found
|
|
}
|
|
|
|
// send Tx write with a data block
|
|
void EMSdevice::write_command(const uint16_t type_id, const uint8_t offset, uint8_t * message_data, const uint8_t message_length, const uint16_t validate_typeid) {
|
|
EMSESP::send_write_request(type_id, device_id(), offset, message_data, message_length, validate_typeid);
|
|
}
|
|
|
|
// send Tx write with a single value
|
|
void EMSdevice::write_command(const uint16_t type_id, const uint8_t offset, const uint8_t value, const uint16_t validate_typeid) {
|
|
uint8_t message_data[1];
|
|
message_data[0] = value;
|
|
EMSESP::send_write_request(type_id, device_id(), offset, message_data, 1, validate_typeid);
|
|
}
|
|
|
|
// send Tx write with a single value, with no post validation
|
|
void EMSdevice::write_command(const uint16_t type_id, const uint8_t offset, const uint8_t value) {
|
|
write_command(type_id, offset, value, 0);
|
|
}
|
|
|
|
// send Tx read command to the device
|
|
void EMSdevice::read_command(const uint16_t type_id) {
|
|
EMSESP::send_read_request(type_id, device_id());
|
|
}
|
|
|
|
// prints a value to the console
|
|
void EMSdevice::print_value(uuid::console::Shell & shell, uint8_t padding, const __FlashStringHelper * name, const __FlashStringHelper * suffix, const char * value) {
|
|
uint8_t i = padding;
|
|
while (i-- > 0) {
|
|
shell.print(F(" "));
|
|
}
|
|
shell.printf(PSTR("%s: %s"), uuid::read_flash_string(name).c_str(), value);
|
|
if (suffix != nullptr) {
|
|
shell.print(uuid::read_flash_string(suffix).c_str());
|
|
}
|
|
shell.println();
|
|
}
|
|
|
|
// prints a value to the console - with no prefix
|
|
void EMSdevice::print_value(uuid::console::Shell & shell, uint8_t padding, const __FlashStringHelper * name, const char * value) {
|
|
print_value(shell, padding, name, nullptr, value);
|
|
}
|
|
|
|
} // namespace emsesp
|