EMS-ESP32/src/mqtt.h

/*
 * 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/>.
 */

#ifndef EMSESP_MQTT_H_
#define EMSESP_MQTT_H_

#include <Arduino.h>
#include <ArduinoJson.h>

#include <string>
#include <vector>
#include <deque>
#include <functional>

#include <AsyncMqttClient.h>

#include "helpers.h"
#include "system.h"
#include "console.h"

#include <uuid/log.h>

using uuid::console::Shell;

#define EMSESP_MAX_JSON_SIZE_SMALL 200  // for smaller json docs
#define EMSESP_MAX_JSON_SIZE_MEDIUM 800 // for smaller json docs from ems devices
#define EMSESP_MAX_JSON_SIZE_LARGE 1500 // for large json docs from ems devices, like boiler or thermostat data

namespace emsesp {

using mqtt_function_p = std::function<void(const char * message)>;
using namespace std::placeholders; // for `_1`

struct MqttMessage {
    MqttMessage(uint8_t operation, const std::string & topic, const std::string & payload, bool retain);
    ~MqttMessage() = default;

    const uint8_t     operation;
    const std::string topic;
    const std::string payload;
    const bool        retain;
};

class Mqtt {
  public:
    void loop();

    void start(AsyncMqttClient * mqttClient);

    void set_publish_time(uint16_t publish_time);
    void set_qos(uint8_t mqtt_qos);

    enum Operation { PUBLISH, SUBSCRIBE };

    static constexpr uint8_t MQTT_TOPIC_MAX_SIZE = 100;

    static void subscribe(const uint8_t device_id, const std::string & topic, mqtt_function_p cb);
    static void subscribe(const std::string & topic, mqtt_function_p cb);
    static void resubscribe();

    static void publish(const std::string & topic, const std::string & payload, bool retain = false);
    static void publish(const std::string & topic, const JsonDocument & payload, bool retain = false);
    static void publish(const std::string & topic, const bool value);
    static void publish(const std::string & topic);

    static void show_topic_handlers(uuid::console::Shell & shell, const uint8_t device_id);
    static void show_mqtt(uuid::console::Shell & shell);

    static void on_connect();

    void disconnect() {
        mqttClient_->disconnect();
    }

    void incoming(char * topic, char * payload); // for testing

    static bool connected() {
        return mqttClient_->connected();
    }

    static uint32_t publish_fails() {
        return mqtt_publish_fails_;
    }

    static void reset_publish_fails() {
        mqtt_publish_fails_ = 0;
    }

  private:
    static uuid::log::Logger logger_;

    class QueuedMqttMessage {
      public:
        QueuedMqttMessage(uint16_t id, std::shared_ptr<MqttMessage> && content);
        ~QueuedMqttMessage() = default;

        const uint16_t                           id_;
        const std::shared_ptr<const MqttMessage> content_;
        uint8_t                                  retry_count_;
        uint16_t                                 packet_id_;
    };
    static std::deque<QueuedMqttMessage> mqtt_messages_;

    static AsyncMqttClient * mqttClient_;

    static constexpr size_t MAX_MQTT_MESSAGES = 50;
    static size_t           maximum_mqtt_messages_;
    static uint16_t         mqtt_message_id_;
    static bool             mqtt_retain_;

    static constexpr uint8_t  MQTT_QUEUE_MAX_SIZE    = 50;
    static constexpr uint32_t MQTT_PUBLISH_WAIT      = 250; // delay between sending publishes, to account for large payloads
    static constexpr uint8_t  MQTT_PUBLISH_MAX_RETRY = 3;   // max retries for giving up on publishing

    static void queue_publish_message(const std::string & topic, const std::string & payload, const bool retain);
    static void queue_subscribe_message(const std::string & topic);

    void          on_publish(uint16_t packetId);
    void          on_message(char * topic, char * payload, size_t len);
    static char * make_topic(char * result, const std::string & topic);
    void          process_queue();
    void          process_all_queue();

    static uint16_t mqtt_publish_fails_;

    class MQTTFunction {
      public:
        MQTTFunction(uint8_t device_id, const std::string && topic, mqtt_function_p mqtt_function);
        ~MQTTFunction() = default;

        uint8_t         device_id_; // which device ID owns this
        std::string     topic_;
        mqtt_function_p mqtt_function_;
    };

    static std::vector<MQTTFunction> mqtt_functions_; // list of mqtt subscribe callbacks for all devices

    uint32_t last_mqtt_poll_ = 0;
    uint32_t last_publish_   = 0;

    // settings, copied over
    static std::string hostname_;
    static uint8_t     mqtt_qos_;
    static uint16_t    publish_time_;
};

} // namespace emsesp

#endif