# WIFI模组调试指南

# 1. 设备调试指南

# 1.1 Wi-Fi模组规格说明书

    CS-NM-E1W和CS-NM-E2W的主要差别在于:CS-NM-E1W是板载天线,而CS-NM-E2W是IPEX 天线,因此导致两者的大小也不同,CS-NM-E1W是(18.00±0.10) x (20.00±0.10) x (3.20±0.10) mm,而CS-NM-E2W是(18.00±0.10) x (14.30±0.10) x (3.20±0.10) mm。主要参数,例如认证、测试、软硬件参数等,两者并无差别。

# 1.1.1 管脚定义

# 1.1.1.1 管脚布局

    下图为CS-NM-E1W 管脚布局(俯视图),CS-NM-E2W 管脚布局与CS-NM-E1W 管脚布局一致。

# 1.1.1.2 管脚描述

    CS-NM-E1W有18 个管脚,具体的管脚定义描述参见下表(同CS-NM-E2W)

# 1.1.1.3 管脚定义

(1)Uart0(命令串口)的四个管脚:3.3v、rx、tx、GND;

(2)Uart1(日志串口)的四个管脚:3.3v、IO2(tx)、GND;

(3)烧录短接线:IO0;指示灯管脚输出:14;按键管脚:12;接地:15(02U);

(4)其他管脚接出备用:4、5、13;另外,EN需要短接3.3v; CS-NM-E1W和CS-NM-E2W所使用的固件和管脚定义均一致。

# 1.1.2 模组尺寸图

    下图为CS-NM-E1W 模组尺寸图:

    下图为CS-NM-E2W 模组尺寸图:

# 1.2模组使用指南

    此部分中,将介绍如何对整个的IoT链路进行调试。首先,MCU和模组之间是通过通信串口协议进行信令的透传,MCU可利用Xshell进行模拟,而模组则装载到开发板上,并通过数据线连接到电脑,APP端则提供了调试面板便于调试并定位错误。

# 1.2.1 驱动安装

    在驱动安装包中按电脑型号选择x64或者x86

# 1.2.2 模组进入配网

(1)利用数据线将模组通过开发板连接到电脑;

(2)安装并打开Xshell6,在文件中新建会话

(3)新建会话中协议选择SERIAL

(4)点击串口,选择对应的端口号,波特率选择115200,接着点击下方的连接Connect

(5)出现下图中的Connected则表明模组连接成功;

(6)打开Xshell,在查看-撰写-添加撰写栏

(7)向Xshell中的撰写栏(框1)中输入**ez+reboot**重启模组,得框2中的结果则表明模组重启成功;

(8)首先输入**ez+wifi_reset先让模组进入配网状态,再输入ez+net_stat查看状态,返回distribution**则表明模组正在配网中;

    至此,完成让模组进入配网状态的工作;

# 1.2.3 线上APP下载

(1)安卓手机:微信扫描下面的二维码,然后在浏览器中打开安装【萤石互联APP】;

(2)苹果手机:在APP Store中搜索【萤石互联】下载安装,安装完成后打开【萤石互联】;

# 1.2.4 模组配网功能

    本节主要实现:模组进入配网状态,并将设备端添加到移动端;

(1)注册登录后,点击右上角的【➕】添加设备;选择【彩光灯泡】;点击下一步; 注意:此处【彩光灯泡】仅作为配网入口;

(2)点击连接设备Wi-Fi,并连接到设备Wi-Fi;

(3)耐心等待设备进行完成配置;点击查看设备即返回首页,可见到成功添加设备; 点击进入设备,可看到所定义的5种常见的功能点;

至此,完成设备的配网工作,若此时向Xshell中再次输入_ez+net_stat_查看状态,返回Cloud则,表明设备已连上萤石云平台;

# 1.2.5 模组上传功能

    本节主要实现:移动端的命令下发到设备端,如下图所示;

(1)左上图中【布尔型】为【关】,【枚举型】为【2】,对应的左下图Xshell中的状态;在面板上调整【布尔型】为【开】,【枚举型】为【4】,得到右上图中结果,对应的Xshell中的状态变为右下图中的结果。

    至此,完成设备的上传功能测试,即改变APP中的参数,通过串口协议,可实现对MCU的控制;

# 1.2.6 模组下传功能

    本节主要实现:设备端的变化上传到移动端,如下图所示;

(1)左上图的【布尔型】为【开】,【枚举型】为【4】;

    此时向Xshell中输入**ez+properties_changed,, bool_test,再输入response bool_test 0 false,注意两次输入的间隔不能超过5S,否则会出现error 11字样;若成功输入上述的两个命令,则会返回ok;若_false_改为_ture_即调整【布尔型】为【开】;**

    再向Xshell中输入**ez+properties_changed,, test_countdown,再输入response test_countdown 0 "5",注意事项同上;若_5_改为_X_即调整【枚举型】为【X】,X为1-5的数字;**

    此时可得到右图,即通过上述命令将【布尔型】调为【关】,【枚举型】调为【5】;

至此,完成设备的下传功能测试,即MCU的变化,通过串口协议,可上传至APP;