MQTT配置說明

• MQTT_TOPIC_LEN_MAX

  配置客戶端支持最大的主題名長度，主題是支持通配符的，如果主題太長則會(huì)被截?cái)?，默認(rèn)值為64。

  #define     MQTT_TOPIC_LEN_MAX                  64
  

• MQTT_ACK_HANDLER_NUM_MAX

  配置mqtt等待應(yīng)答列表的最大記錄個(gè)數(shù)，對(duì)于qos1、qos2服務(wù)質(zhì)量有要求的可以將其設(shè)置大一點(diǎn)，當(dāng)然也必須資源跟得上，它主要是保證qos1、qos2的mqtt報(bào)文能準(zhǔn)確到達(dá)服務(wù)器，默認(rèn)值為64。

  #define     MQTT_ACK_HANDLER_NUM_MAX            64
  

• MQTT_DEFAULT_BUF_SIZE

  默認(rèn)的讀寫數(shù)據(jù)緩沖區(qū)的大小，根據(jù)要收發(fā)數(shù)據(jù)量修改即可，默認(rèn)值為1024。

  #define     MQTT_DEFAULT_BUF_SIZE               1024
  

• MQTT_DEFAULT_CMD_TIMEOUT

  默認(rèn)的命令超時(shí)，它主要是用于socket讀寫超時(shí)（還包括等待響應(yīng)的時(shí)間、重連等待時(shí)間等），默認(rèn)值為5000。

  #define     MQTT_DEFAULT_CMD_TIMEOUT            5000
  

• MQTT_MAX_CMD_TIMEOUT

  設(shè)置最大的命令超時(shí)時(shí)間，默認(rèn)值是20000。

  #define     MQTT_MAX_CMD_TIMEOUT                20000
  

• MQTT_MIN_CMD_TIMEOUT

  設(shè)置最小的命令超時(shí)時(shí)間，默認(rèn)值是1000。

  #define     MQTT_MIN_CMD_TIMEOUT                1000
  

• MQTT_KEEP_ALIVE_INTERVAL

  設(shè)置默認(rèn)的?；顣r(shí)間，它主要是保證MQTT客戶端與服務(wù)器的保持活性連接，單位為 秒 ，默認(rèn)值為50。比如MQTT客戶端與服務(wù)器在指定時(shí)間間隔內(nèi)沒有發(fā)送數(shù)據(jù)，有沒有接收到數(shù)據(jù)，此時(shí)MQTT客戶端會(huì)發(fā)送一個(gè)心跳包，確認(rèn)一下這個(gè)連接是否存在，如果收到服務(wù)器的應(yīng)答，那么說明這個(gè)連接還是存在的，可以隨時(shí)收發(fā)數(shù)據(jù)，而如果不存在了，就嘗試重連或者清除會(huì)話。

  #define     MQTT_KEEP_ALIVE_INTERVAL            50         // unit: second
  

• MQTT_VERSION

  選擇MQTT協(xié)議的版本，默認(rèn)為4，表示使用MQTT 3.1.1版本，而3則表示使用MQTT 3.1版本。

  #define     MQTT_VERSION                        4           // 4 is mqtt 3.1.1
  

• MQTT_RECONNECT_DEFAULT_DURATION

  設(shè)置默認(rèn)的重連時(shí)間間隔，當(dāng)發(fā)生掉線時(shí)，會(huì)以這個(gè)時(shí)間間隔嘗試重連，默認(rèn)值為1000。

  #define     MQTT_RECONNECT_DEFAULT_DURATION     1000
  

• MQTT_THREAD_STACK_SIZE

  MQTT內(nèi)部維護(hù)一個(gè)線程，需要設(shè)置默認(rèn)的線程屬性信息，MQTT_THREAD_STACK_SIZE表示線程棧的大小，默認(rèn)值是2048。在linux環(huán)境下可以是不需要理會(huì)這些參數(shù)的，而在RTOS平臺(tái)則需要配置，如果不使用mbedtls，線程棧2048字節(jié)已足夠，而使用mbedtls加密后，需要配置4096字節(jié)以上

  #define     MQTT_THREAD_STACK_SIZE              2048    // 線程棧
  

• MQTT_THREAD_PRIO

  設(shè)置線程優(yōu)先級(jí)，默認(rèn)為5。

  #define     MQTT_THREAD_PRIO                    5       // 線程優(yōu)先級(jí)
  

• MQTT_THREAD_TICK

  設(shè)置線程優(yōu)時(shí)間片，默認(rèn)為50。

  #define     MQTT_THREAD_TICK                    50      // 線程時(shí)間片
  

• MQTT_NETWORK_TYPE_NO_TLS

  設(shè)置是否需要支持TLS加密傳輸，如果定義了該宏，則表示不支持TLS加密傳輸，否則默認(rèn)將支持TLS加密傳輸。

  #define     MQTT_NETWORK_TYPE_NO_TLS
  

salof相關(guān)的配置

salof 全稱是：Synchronous Asynchronous Log Output Framework（同步異步日志輸出框架），它是一個(gè)同步異步日志輸出框架，可以在空閑時(shí)候輸出對(duì)應(yīng)的日志信息，并且該庫與mqttclient無縫銜接。

• LOG_LEVEL

  配置對(duì)應(yīng)的日志輸出級(jí)別，它支持以下4種級(jí)別：ERR_LEVEL、WARN_LEVEL、INFO_LEVEL、DEBUG_LEVEL。

  #define BASE_LEVEL      (0)
      #define ERR_LEVEL       (BASE_LEVEL + 1)          /* 日志輸出級(jí)別：錯(cuò)誤級(jí)別（高優(yōu)先級(jí)） */
      #define WARN_LEVEL      (ERR_LEVEL + 1)             /* 日志輸出級(jí)別：警告級(jí)別（中優(yōu)先級(jí)） */
      #define INFO_LEVEL      (WARN_LEVEL + 1)            /* 日志輸出級(jí)別：信息級(jí)別（低優(yōu)先級(jí)） */
      #define DEBUG_LEVEL     (INFO_LEVEL + 1)            /* 日志輸出級(jí)別：調(diào)試級(jí)別（更低優(yōu)先級(jí)） */#define         LOG_LEVEL                   WARN_LEVEL      /* 日志輸出級(jí)別 */
  

• USE_SALOF

  如果該宏大于0，則表示使用salof指定的后端作為日志輸出，反之則使用printf作為日志輸出接口。

  #define         USE_SALOF                   (1U)
  

• SALOF_OS

  設(shè)置salof日志庫的操作系統(tǒng)，有以下選項(xiàng)：USE_LINUX、USE_TENCENTOS、USE_FREERTOS、USE_RTT。

  #define         SALOF_OS                    USE_LINUX
  

• USE_IDLE_HOOK

  如果該宏大于0，則表示在操作系統(tǒng)中的空閑鉤子函數(shù)中輸出日志，反之則通過線程異步處理或者同步處理。

  #define         USE_IDLE_HOOK               (0U)
  

• LOG_COLOR

  如果該宏大于0，則表示輸出的日志是帶有顏色的（需要終端的支持），反之則沒有顏色。

  #define         LOG_COLOR                   (1U)
  

• LOG_TS

  如果該宏大于0，則表示輸出的日志是帶有時(shí)間戳的，反之則沒有時(shí)間戳。

  #define         LOG_TS                   (0U)
  

• LOG_TAR

  如果該宏大于0，則表示輸出的日志是帶有標(biāo)簽的（任務(wù)名字），反之則沒有標(biāo)簽。

  #define         LOG_TAR                   (0U)
  

• SALOF_BUFF_SIZE

  設(shè)置日志庫salof輸出庫的buf緩沖區(qū)大小，即最大一次性能輸出多少個(gè)字節(jié)。

  #define         SALOF_BUFF_SIZE                   (512U)
  

• SALOF_FIFO_SIZE

  設(shè)置日志庫salof的fifo緩沖區(qū)大小，即最能緩存多少個(gè)字節(jié)的日志數(shù)據(jù)。

  #define         SALOF_FIFO_SIZE             (1024*4U)
  

• SALOF_TASK_STACK_SIZE

  如果使用了空閑線程輸出日志，則配置salof線程棧的大小。

  #define         SALOF_TASK_STACK_SIZE       (2048U)
  

• SALOF_TASK_TICK

  如果使用了空閑線程輸出日志，則配置salof線程棧的時(shí)間片大小。

  #define         SALOF_TASK_TICK             (50U)
  

使用mqttclient裁剪配置工具

我們可以通過配置很方便地裁剪我們需要的功能，設(shè)置上述MQTT客戶端的默認(rèn)參數(shù)，完全不需要手動(dòng)修改代碼，直接使用工具裁剪配置即可。

打開在線mqttclient裁剪配置工具：https://jiejietop.gitee.io/mqtt/mqtt-config.html

它支持裁剪配置相關(guān)的頭文件，配置客戶端默認(rèn)的一些參數(shù)：

mqtt-config-tool01

還支持配置salof同步異步日志相關(guān)的信息，以保證日志能正常運(yùn)作，配置完成后生成對(duì)應(yīng)的代碼，然后覆蓋掉原本的MQTT客戶端配置即可，如果不知道如何配置，那就導(dǎo)入默認(rèn)的配置即可。

mqtt-config-tool02

如果是初次接觸，看不懂上面配置的信息，沒關(guān)系，我很貼心地準(zhǔn)備了配置的宏定義及其描述信息，保證你能看得懂的。

mqtt-config-tool03