/** * NEURON IIoT System for Industry 4.0 * Copyright (C) 2020-2022 EMQ Technologies Co., Ltd All rights reserved. * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this program; if not, write to the Free Software Foundation, * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. **/ #include "utils/asprintf.h" #include "mqtt_config.h" #include "mqtt_handle.h" #include "mqtt_plugin.h" const neu_plugin_module_t neu_plugin_module; static void connect_cb(void *data) { neu_plugin_t *plugin = data; plugin->common.link_state = NEU_NODE_LINK_STATE_CONNECTED; plog_info(plugin, "plugin `%s` connected", neu_plugin_module.module_name); } static void disconnect_cb(void *data) { neu_plugin_t *plugin = data; plugin->common.link_state = NEU_NODE_LINK_STATE_DISCONNECTED; plog_info(plugin, "plugin `%s` disconnected", neu_plugin_module.module_name); } static neu_plugin_t *mqtt_plugin_open(void) { neu_plugin_t *plugin = (neu_plugin_t *) calloc(1, sizeof(neu_plugin_t)); neu_plugin_common_init(&plugin->common); return plugin; } static int mqtt_plugin_close(neu_plugin_t *plugin) { const char *name = neu_plugin_module.module_name; plog_info(plugin, "success to free plugin:%s", name); free(plugin); return NEU_ERR_SUCCESS; } static int mqtt_plugin_init(neu_plugin_t *plugin) { plog_info(plugin, "initialize plugin `%s` success", neu_plugin_module.module_name); neu_adapter_register_metric_cb_t register_metric = plugin->common.adapter_callbacks->register_metric; register_metric(plugin->common.adapter, NEU_METRIC_CACHED_MSGS_NUM, NEU_METRIC_CACHED_MSGS_NUM_HELP, NEU_METRIC_CACHED_MSGS_NUM_TYPE, 0); return NEU_ERR_SUCCESS; } static int mqtt_plugin_uninit(neu_plugin_t *plugin) { mqtt_config_fini(&plugin->config); if (plugin->client) { neu_mqtt_client_close(plugin->client); neu_mqtt_client_free(plugin->client); plugin->client = NULL; } free(plugin->read_req_topic); plugin->read_req_topic = NULL; free(plugin->read_resp_topic); plugin->read_resp_topic = NULL; free(plugin->write_req_topic); plugin->write_req_topic = NULL; free(plugin->write_resp_topic); plugin->write_resp_topic = NULL; plog_info(plugin, "uninitialize plugin `%s` success", neu_plugin_module.module_name); return NEU_ERR_SUCCESS; } static int config_mqtt_client(neu_plugin_t *plugin, neu_mqtt_client_t *client, const mqtt_config_t *config) { int rv = 0; if (NULL == client) { return 0; } // set log category as soon as possible to ease debugging rv = neu_mqtt_client_set_zlog_category(client, plugin->common.log); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_set_zlog_category fail"); return -1; } rv = neu_mqtt_client_set_addr(client, config->host, config->port); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_set_host fail"); return -1; } rv = neu_mqtt_client_set_id(client, config->client_id); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_set_id fail"); return -1; } rv = neu_mqtt_client_set_connect_cb(client, connect_cb, plugin); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_set_connect_cb fail"); return -1; } rv = neu_mqtt_client_set_disconnect_cb(client, disconnect_cb, plugin); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_set_disconnect_cb fail"); return -1; } rv = neu_mqtt_client_set_cache_size(client, config->cache_mem_size, config->cache_disk_size); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_set_msg_cache_limit fail"); return -1; } if (NULL != config->username) { rv = neu_mqtt_client_set_user(client, config->username, config->password); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_set_user fail"); } } // when config->ca is NULL tls will be disabled rv = neu_mqtt_client_set_tls(client, config->ca, config->cert, config->key, config->keypass); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_set_tsl fail"); return -1; } return rv; } static int mqtt_plugin_config(neu_plugin_t *plugin, const char *setting) { int rv = 0; const char * plugin_name = neu_plugin_module.module_name; mqtt_config_t config = { 0 }; bool started = false; rv = mqtt_config_parse(plugin, setting, &config); if (0 != rv) { plog_error(plugin, "neu_mqtt_config_parse fail"); return NEU_ERR_NODE_SETTING_INVALID; } if (NULL == plugin->client) { plugin->client = neu_mqtt_client_new(NEU_MQTT_VERSION_V311); if (NULL == plugin->client) { plog_error(plugin, "neu_mqtt_client_new fail"); rv = NEU_ERR_EINTERNAL; goto error; } } else if (neu_mqtt_client_is_open(plugin->client)) { started = true; rv = neu_mqtt_client_close(plugin->client); if (0 != rv) { plog_error(plugin, "neu_mqtt_client_close fail"); rv = NEU_ERR_EINTERNAL; goto error; } } rv = config_mqtt_client(plugin, plugin->client, &config); if (0 != rv) { rv = NEU_ERR_MQTT_INIT_FAILURE; goto error; } if (started && 0 != neu_mqtt_client_open(plugin->client)) { plog_error(plugin, "neu_mqtt_client_open fail"); rv = NEU_ERR_MQTT_CONNECT_FAILURE; goto error; } if (plugin->config.host) { // already configured mqtt_config_fini(&plugin->config); } memmove(&plugin->config, &config, sizeof(config)); plog_info(plugin, "config plugin `%s` success", plugin_name); return 0; error: plog_info(plugin, "config plugin `%s` fail", plugin_name); mqtt_config_fini(&config); return rv; } static int create_topic(neu_plugin_t *plugin) { if (plugin->read_req_topic) { // topics already created return 0; } neu_asprintf(&plugin->read_req_topic, "/neuron/%s/read/req", plugin->common.name); if (NULL == plugin->read_req_topic) { return -1; } neu_asprintf(&plugin->read_resp_topic, "/neuron/%s/read/resp", plugin->common.name); if (NULL == plugin->read_resp_topic) { free(plugin->read_req_topic); plugin->read_req_topic = NULL; return -1; } neu_asprintf(&plugin->write_req_topic, "/neuron/%s/write/req", plugin->common.name); if (NULL == plugin->read_req_topic) { free(plugin->read_req_topic); plugin->read_req_topic = NULL; free(plugin->read_resp_topic); plugin->read_resp_topic = NULL; return -1; } neu_asprintf(&plugin->write_resp_topic, "/neuron/%s/write/resp", plugin->common.name); if (NULL == plugin->read_req_topic) { free(plugin->read_req_topic); plugin->read_req_topic = NULL; free(plugin->read_resp_topic); plugin->read_resp_topic = NULL; free(plugin->write_req_topic); plugin->write_req_topic = NULL; return -1; } return 0; } static int mqtt_plugin_start(neu_plugin_t *plugin) { int rv = 0; const char *plugin_name = neu_plugin_module.module_name; if (NULL == plugin->client) { plog_error(plugin, "mqtt client is NULL due to init failure"); rv = NEU_ERR_MQTT_IS_NULL; goto end; } if (0 != neu_mqtt_client_open(plugin->client)) { plog_error(plugin, "neu_mqtt_client_open fail"); rv = NEU_ERR_MQTT_CONNECT_FAILURE; goto end; } if (0 != create_topic(plugin)) { plog_error(plugin, "create topics fail"); rv = NEU_ERR_EINTERNAL; goto end; } if (0 != neu_mqtt_client_subscribe(plugin->client, 0, plugin->read_req_topic, plugin, handle_read_req)) { plog_error(plugin, "subscribe [%s] fail", plugin->read_req_topic); rv = NEU_ERR_MQTT_SUBSCRIBE_FAILURE; goto end; } if (0 != neu_mqtt_client_subscribe(plugin->client, 0, plugin->write_req_topic, plugin, handle_write_req)) { plog_error(plugin, "subscribe [%s] fail", plugin->write_req_topic); rv = NEU_ERR_MQTT_SUBSCRIBE_FAILURE; goto end; } end: if (0 == rv) { plog_info(plugin, "start plugin `%s` success", plugin_name); } else { plog_error(plugin, "start plugin `%s` failed, error %d", plugin_name, rv); neu_mqtt_client_close(plugin->client); } return rv; } static int mqtt_plugin_stop(neu_plugin_t *plugin) { if (plugin->client) { neu_mqtt_client_close(plugin->client); plog_info(plugin, "mqtt client closed"); } plog_info(plugin, "stop plugin `%s` success", neu_plugin_module.module_name); return NEU_ERR_SUCCESS; } static int mqtt_plugin_request(neu_plugin_t *plugin, neu_reqresp_head_t *head, void *data) { neu_err_code_e error = NEU_ERR_SUCCESS; neu_adapter_update_metric_cb_t update_metric = plugin->common.adapter_callbacks->update_metric; // update cached messages number per seconds if (NULL != plugin->client && (global_timestamp - plugin->cache_metric_update_ts) >= 1000) { update_metric(plugin->common.adapter, NEU_METRIC_CACHED_MSGS_NUM, neu_mqtt_client_get_cached_msgs_num(plugin->client), NULL); plugin->cache_metric_update_ts = global_timestamp; } switch (head->type) { case NEU_RESP_ERROR: error = handle_write_response(plugin, head->ctx, data); break; case NEU_RESP_READ_GROUP: error = handle_read_response(plugin, head->ctx, data); break; case NEU_REQRESP_TRANS_DATA: error = handle_trans_data(plugin, data); break; case NEU_REQRESP_NODE_DELETED: break; default: error = NEU_ERR_MQTT_FAILURE; break; } return error; } static const neu_plugin_intf_funs_t plugin_intf_funs = { .open = mqtt_plugin_open, .close = mqtt_plugin_close, .init = mqtt_plugin_init, .uninit = mqtt_plugin_uninit, .start = mqtt_plugin_start, .stop = mqtt_plugin_stop, .setting = mqtt_plugin_config, .request = mqtt_plugin_request, }; #define DESCRIPTION "Neuron northbound MQTT plugin bases on NanoSDK." #define DESCRIPTION_ZH "基于 NanoSDK 的 Neuron 北向应用 MQTT 插件" const neu_plugin_module_t neu_plugin_module = { .version = NEURON_PLUGIN_VER_1_0, .module_name = "mqtt", .module_descr = DESCRIPTION, .module_descr_zh = DESCRIPTION_ZH, .intf_funs = &plugin_intf_funs, .kind = NEU_PLUGIN_KIND_SYSTEM, .type = NEU_NA_TYPE_APP, .sub_msg = { 0 }, .display = true, .single = false, };