From f089b7c411604184e9daacbba2cc3528365987f7 Mon Sep 17 00:00:00 2001
From: MysticBoy <mysticboy@live.com>
Date: Tue, 26 May 2020 15:17:46 +0800
Subject: [PATCH] =?UTF-8?q?=E5=8A=A0=E5=85=A5=E9=85=8D=E7=BD=AE=E9=A1=B9?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E=E5=92=8C=E9=BB=98=E8=AE=A4=E9=85=8D=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../webdocs/markdowndocs/connector-ch.md      | 38 +++++++++++++++++++
 packaging/cfg/taos.cfg                        | 12 ++++++
 2 files changed, 50 insertions(+)

diff --git a/documentation/webdocs/markdowndocs/connector-ch.md b/documentation/webdocs/markdowndocs/connector-ch.md
index b5d8fb5afb..b46408c4db 100644
--- a/documentation/webdocs/markdowndocs/connector-ch.md
+++ b/documentation/webdocs/markdowndocs/connector-ch.md
@@ -1207,11 +1207,49 @@ TDengine在Window系统上提供的API与Linux系统是相同的， 应用程序
 其中，最常用的文件列出如下：
 
 + Client可执行文件: /usr/local/taos/bin/taos 软连接到 /usr/local/bin/taos
+
 + 配置文件: /usr/local/taos/cfg/taos.cfg 软连接到 /etc/taos/taos.cfg
+
 + 驱动程序目录: /usr/local/taos/driver/libtaos.1.6.5.1.dylib 软连接到 /usr/local/lib/libtaos.dylib
+
 + 驱动程序头文件: /usr/local/taos/include/taos.h 软连接到 /usr/local/include/taos.h
+
 + 日志目录（第一次运行程序时生成）：~/TDengineLog
 
+  
+
+
+## MQTT客户端
+
+MQTT客户端实现了订阅MQTT Broker的特定Topic将Json数据进行转换入库的功能，任何终端只要将数据发给特定的Topic 即可,不用再编写转换器或者数据解析程序。如果终端量大，需要 Mqtt Broker 群集，这里不再详述。
+
+#### 如何配置？
+
+首先需要在 taos.cfg 中打开配置项 mqtt 用来启用， 再通过修改 mqttBrokerAddress  的值来配置连接，格式为: 
+
+> mqtt://username:password@hostname:port/path/
+
+ 例如:
+
+> mqtt://127.0.0.1:1883/taos/  mqtt://root@kissme@127.0.0.1:1883/taos/
+
+
+#### Topic 格式说明
+
+ Mqtt 的topic格式为
+
+> /<path>/<token>/<db name>/<table name>/
+
+因此TDengine的Mqtt客户端会订阅:
+
+> /taos/+/+/+/+/  
+
+例如: 
+
+>  /taos/token/db/t/  
+
+注意: 测试时如果需要使用到Mqtt Broker 推荐使用 [mosquitto](http://mosquitto.org/) ，客户端可以使用  [MQTT.fx ](http://www.jensd.de/)
+
 
 
 [1]: https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver
diff --git a/packaging/cfg/taos.cfg b/packaging/cfg/taos.cfg
index 38e960eb06..a0fd441a87 100644
--- a/packaging/cfg/taos.cfg
+++ b/packaging/cfg/taos.cfg
@@ -166,6 +166,15 @@
 # start system monitor module
 # monitor               1
 
+# start http service
+# mqtt                  0
+
+# mqtt uri  
+# mqttBrokerAddress  mqtt://username:password@hostname:1883/taos/
+
+# mqtt client name 
+# mqttBrokerClientId  taos_mqtt
+
 # maximum number of rows returned by the restful interface
 # restfulRowLimit       10240
 
@@ -244,5 +253,8 @@
 # debug flag for system monitor 
 # monitorDebugFlag      131
 
+#debug flag for mqtt client 
+# mqttDebugFlag         131
+
 # debug flag for TAOS TIMER
 # tmrDebugFlag          131
-- 
GitLab