如上图所示，wiot架构主要包含三部分：Node节点，wiot Cloud Module云模块，wiot cli命令行程序。其中，Node节点为烧录好wiot固件的NodeMCU单片机，他们通过IEEE 802.11 WiFi进行分布式通信，并于某个节点接入路由器以连接wiot云模块。用户在自己的PC上使用NodeJS调用wiot依赖编写物联网程序。完成后，用户使用wiot cli对开发好的程序进行检查、测试和部署。被部署的物联网程序将运行在wiot云模块上，并可使用nodeJS的接口与其它云服务或数据库进行交互。
Node节点
Node节点使用的是NodeMCU开发板（基于ESP8266的扩展板）。在使用wiot-cli烧录wiot固件后，NodeMCU将成为wiot节点。
-模式
wiot节点有四种模式：master模式、slave模式、bridge模式和debug模式。此模式只能在烧录固件时配置。master模式和bridge模式下，nodeMCU将同时开启STA和AP模式。slave模式下则只开启STA模式。master需要有稳定且无限制的电源供电，其功率较大，不适合低功耗场景。bridge与slave则可以灵活调整功率，可用于低功耗场景。
-debug模式下节点工作在STA和AP模式，用户可以使用手机等设备连接到此节点，并打开根目录网页。网页上将实时显示此节点当前所处位置的各种信息，比如收到各其它节点的信号强度等，适用于部署场景。
-低功耗
wiot节点支持低功耗（Low Power）状态。但此状态仅能在slave模式和bridge下开启。此状态可通过wiot api或者wiot-cli进行开启或关闭。低功耗状态由esp8266睡眠功能实现。此状态下可由干电池供电工作数年[1]。
-组网
wiot节点使用分布式组网。在路由器信号较强的地方，master节点将接入路由器WiFi网络，并桥接。在路由器信号不强的地方，每一个节点都会找到信号最强的另一个上游的master或bridge节点，并桥接（slave除外）。
+模式
wiot节点有四种模式：master模式、slave模式、bridge模式和debug模式。此模式只能在烧录固件时配置。master模式和bridge模式下，nodeMCU将同时开启STA和AP模式。slave模式下则只开启STA模式。master需要有稳定且无限制的电源供电，其功率较大(包含RSA, 协议转换等)，不适合低功耗场景。bridge与slave则可以灵活调整功率，可用于低功耗场景。
+debug模式下节点工作在STA和AP模式，用户可以使用手机等设备连接到此节点，并打开根目录网页。网页上将实时显示此节点当前所处位置的各种信息，比如收到各其它节点的信号强度等，适用于挑选部署场景。
+低功耗
wiot节点支持低功耗（Low Power）状态。但此状态仅能在slave模式和bridge下开启。此状态可通过wiot api或者wiot-cli进行开启或关闭。低功耗状态由esp8266睡眠功能实现。此状态下可由干电池供电工作数年[1]。
+组网
wiot节点使用分布式组网。在路由器信号较强的地方，master节点将接入路由器WiFi网络，并桥接。在路由器信号不强的地方，每一个节点都会找到信号最强的另一个上游的master或bridge节点，并桥接（slave除外）。
如上图，两个距离路由器近的master节点自动接入到路由器wifi。下游的其它节点分别连接至信号最强的上游节点。
-认证
![射频指纹识别[2]](https://api.yimian.xyz/img/?path=imgbed/img_d184ff2_1442x502_8_null_normal.jpeg)
wiot节点支持使用射频指纹识别2来实现下游通信认证。此方法使用esp8266的RSSI函数以及scan返回参数。在下游设备试图接入网络时，上游设备将搜集指纹信息并向服务器汇报。服务器将指纹与数据库存储的先前版本进行比对，并作出是否允许入网的决策。
认证
wiot节点支持使用射频指纹识别[2]来实现下游通信认证。此方法使用esp8266的RSSI函数以及scan返回参数。在下游设备试图接入网络时，上游设备将搜集指纹信息并向服务器汇报。服务器将指纹与数据库存储的先前版本进行比对，并作出是否允许入网的决策。
云模块
云模块充当wiot的云部分，提供云的功能。云模块能够守护运行run-time状态下的wiot程序。此外，云模块还能够提供测试，部署等功能。云模块使用Docker进行虚拟化。
命令行程序
即wiot-cli。是wiot在开发者终端上提供的操作工具集。通过wiot-cli，开发者可以实现对wiot程序的测试，部署，恢复等功能。此外，wiot-cli也支持一系列debug等常用功能。详见下方wiot-cli命令。
用户操作步骤
- 用户下载安装并配置好NodeJS环境。
- 用户通过命令行运行
npm i -g wiot-cli指令安装wiot命令行工具
- - 用户运行命令
wiot init my-wiot-proj在当前目录新建并配置一个wiot项目文件夹，项目名称为my-wiot-proj。此时，会提示用户填写此项目的一些信息，比如项目描述，作者信息，WiFi账户密码，wiot云模块地址，项目主脚本等。
+ - 用户运行命令
wiot init my-wiot-proj在当前目录新建并配置一个wiot项目文件夹，项目名称为my-wiot-proj。此时，会提示用户填写此项目的一些信息，比如项目描述，作者信息，路由器WiFi账户密码，wiot云模块地址，项目主脚本等。 - 用户进入到项目目录，将nodeMCU通过数据线连接到电脑，运行
wiot node init my-first-node [--type=<master|slave|bridge|debug>]。这将自动配置并将wiot固件烧录到nodeMCU开发板，并将其命名为my-first-node。type为可选参数，可设置为master或slave或bridge或debug，默认为master。 - 依次按照此方法烧录好所有的开发板，将其部署在生产环境。
- 在项目文件夹运行指令
wiot status查看是否所有节点均已在线。如果没有，使用指令wiot log配合grep工具查找日志定位问题。
@@ -491,7 +491,8 @@ pjax_google_analytics = () => {
- 使用指令
wiot test将挂起云模块中正在运行的程序，并运行当前项目文件夹中的程序。此时，所有控制台输出将显示在你的命令行窗口。使用Ctrl+C终止当前测试并恢复云模块先前的程序。 - 使用指令
wiot push将本地的wiot程序部署到云端。
其它操作
部署自己的wiot云模块
安装docker并运行指令docker run -d --name=wiot-cloud -p 3594:3594 -v /var/wiot/data/:/var/wiot/data/ iotcat/wiot。
其它操作
部署自己的wiot云模块
默认使用wiot官方wiot云模块。你也可以部署自己的wiot云服务，方法如下：
+安装docker并运行指令docker run -d --name=wiot-cloud -p 3594:3594 -v /var/wiot/data/:/var/wiot/data/ iotcat/wiot。
wiot-cli命令
wiot help [command]查看帮助wiot clone <host:user/project>将项目从云模块克隆到本地
@@ -516,6 +517,7 @@ pjax_google_analytics = () => {
wiot debug sleep <nodeID> <pinID> <HIGH|LOW>debug模式下设置某节点轻度休眠，直到被某pin的高或低电平唤醒wiot debug dsleep <nodeID> <millisecond>debug模式下设置某节点深度休眠多少毫秒wiot debug reconnect [nodeID]debug模式下重新组网或断开重连某个节点
+wiot debug setphymode <nodeID> <b|g|n>debug模式下配置节点WiFi协议为802.11b|g|n
···
常用API
待设计，请参考一轮开发wiot文档
@@ -543,14 +545,14 @@ pjax_google_analytics = () => {
As shown in the figure above, the wiot architecture mainly consists of three parts: Node node, wiot Cloud Module, and wiot cli command line program. Among them, the Node node is the NodeMCU microcontroller with the wiot firmware burned. They use IEEE 802.11 WiFi for distributed communication, and connect to a router at a node to connect to the wiot cloud module. Users use NodeJS to call Wiot on their own PCs and rely on writing IoT programs. After completion, the user uses wiot cli to check, test and deploy the developed program. The deployed IoT program will run on the wiot cloud module, and can use the nodeJS interface to interact with other cloud services or databases.
Node node
Node node uses NodeMCU development board (expansion board based on ESP8266). After using wiot-cli to burn the wiot firmware, NodeMCU will become a wiot node.
-Mode
Wiot nodes have four modes: master mode, slave mode, bridge mode and debug mode. This mode can only be configured when burning firmware. In master mode and bridge mode, nodeMCU will enable STA and AP mode at the same time. In slave mode, only STA mode is enabled. The master needs to have a stable and unlimited power supply, which has a large power and is not suitable for low power consumption scenarios. Bridge and slave can flexibly adjust power, which can be used in low power consumption scenarios.
+Mode
Wiot nodes have four modes: master mode, slave mode, bridge mode and debug mode. This mode can only be configured when burning firmware. In master mode and bridge mode, nodeMCU will enable STA and AP mode at the same time. In slave mode, only STA mode is enabled. The master needs to have a stable and unlimited power supply, which has a large power and is not suitable for low power consumption scenarios. Bridge and slave can flexibly adjust power, which can be used in low power consumption scenarios.
In debug mode, the node works in STA and AP mode. Users can use mobile phones and other devices to connect to this node and open the root directory webpage. The web page will display various information about the current location of this node in real time, such as the signal strength received from other nodes, which is suitable for deployment scenarios.
-Low power consumption
Wiot nodes support Low Power state. But this state can only be opened in slave mode and bridge. This state can be turned on or off through wiot api or wiot-cli. The low power consumption state is realized by the sleep function of esp8266. In this state, it can be powered by dry batteries for several years [1].
-Networking
Wiot nodes use distributed networking. Where the router signal is strong, the master node will access the router WiFi network and bridge it. Where the router signal is not strong, each node will find another upstream master or bridge node with the strongest signal and bridge it (except slave).
+Low power
Wiot nodes support Low Power state. But this state can only be opened in slave mode and bridge. This state can be turned on or off through wiot api or wiot-cli. The low power consumption state is realized by the sleep function of esp8266. In this state, it can be powered by dry batteries for several years [1].
+Networking
Wiot nodes use distributed networking. Where the router signal is strong, the master node will access the router WiFi network and bridge it. Where the router signal is not strong, each node will find another upstream master or bridge node with the strongest signal and bridge it (except slave).
As shown in the figure above, the two master nodes close to the router are automatically connected to the router wifi. The other downstream nodes are respectively connected to the upstream node with the strongest signal.
-Certification
-
Wiot nodes support the use of RF Fingerprint Recognition2 to achieve downstream communication authentication. This method uses the RSSI function of esp8266 and scan return parameters. When the downstream device attempts to access the network, the upstream device will collect fingerprint information and report to the server. The server compares the fingerprint with the previous version stored in the database and makes a decision whether to allow access to the network.
+Certification
+
Wiot nodes support the use of RF Fingerprint Recognition[2] to achieve downstream communication authentication. This method uses the RSSI function of esp8266 and scan return parameters. When the downstream device attempts to access the network, the upstream device will collect fingerprint information and report to the server. The server compares the fingerprint with the previous version stored in the database and makes a decision whether to allow access to the network.
Cloud Module
The cloud module acts as the cloud part of Wiot and provides cloud functions. The cloud module can guard the wiot program running in the run-time state. In addition, the cloud module can also provide functions such as testing and deployment. The cloud module uses Docker for virtualization.
Command Line Program
That is wiot-cli. It is a set of operation tools provided by Wiot on the developer terminal. Through wiot-cli, developers can implement functions such as testing, deploying, and restoring wiot programs. In addition, wiot-cli also supports a series of common functions such as debug. See the
wiot-cli commandbelow for details.User operation steps