顺舟科技工业WIFI无线模块用户使用手册1.2.0.pdf

顺舟科技 wifi 模块用户手册（v1.2.0） 1 / 48 www.shuncom.com wifi 模块模块 使用使用手册手册 ( (r revisionevision 1.1.2 2. .0 0) ) 上海顺舟网络科技有限公司 更新时间 2012-3-28 顺舟科技 wifi 模块用户手册（v1.2.0） 2 / 48 www.shuncom.com 说明：说明： 顺舟 wifi 模块是专门用于将串口数据转换为 ip 数据或将 ip 数据转换 为串口数据通过无线通信网络进行传送的无线终端设备。顺舟科技 wifi 模 块就是用 wifi 网络来传输数据的设备，采用工业级嵌入式处理器，内嵌 tcp/ip 协议栈，为用户提供全透明数据收发，高速稳定可靠连接，数据终端 永远在线，多种协议支持的无线数据传输解决方案。 非常感谢您选择本公司的 wifi 模块， 安装和使用产品前请仔细阅读本手册， 这将更好的帮助您使用本产品。 版权：版权： 本手册包含的所有内容均受版权法的保护， 未经上海顺舟网络科技有限公司 的书面授权， 任何组织和个人不得以任何形式或手段对整个说明书和部分内容进 行复制和转载。 本公司保留在未作任何事先申明前对本手册的修改，解释和发布的权利。 顺舟科技 wifi 模块用户手册（v1.2.0） 3 / 48 www.shuncom.com 目录目录 版本记录. 4 第一部分 产品简介 . 5 第二部分 技术指标 . 6 第三部分 产品综述 . 7 3.1 概述 . 7 3.2 机械尺寸 . 8 3.3 外部接口 . 9 3.4 天线 . 10 3.5 无线网络模式的选择和部署 . 10 3.6 安全机制 . 11 3.7 串口透明传输 . 11 3.8 方便参数配置 . 12 3.9 at 指令配置参数 12 3.10 tcp/ip 协议栈 12 第四部分 快速开始向导 . 13 4.1 准备工作 . 13 4.3 工具参数配置 . 16 4.4 开始测试 . 20 第五部分 参数配置与配置工具使用 . 22 5.1 网络类型 . 22 5.2 无线设置 . 23 5.3 网络设置 . 26 5.4 工作模式设置 . 29 5.5 通信设置 . 31 5.6 提交参数 . 34 第六部分 嵌入式 web 配置 . 36 6.1 web 配置界面 37 6.2 web 控制界面 41 第七部分 at 指令 45 第八部分 辅助工具 . 48 8.1 概述 . 48 8.2 wifi 配置工具 48 8.3 服务器端测试工具 . 48 顺舟科技 wifi 模块用户手册（v1.2.0） 4 / 48 www.shuncom.com 版本记录版本记录 版本修订历史： 版本 日期 作者 原因 rev 1.0.0 2012/02/27 创建 rev 1.1.0 2012/03/12 增加嵌入式 web 配置功能 rev 1.2.0 2012/03/28 因硬件改版，对手册进行完善 顺舟科技 wifi 模块用户手册（v1.2.0） 5 / 48 www.shuncom.com 第一部分第一部分 产品简介产品简介 本产品为顺舟科技推出的一款新型嵌入式 wifi 模块。wifi 模块是基于 uart 接口的符合 wifi 无线网络标准的嵌入式模块，内置无线网络协议 ieee802.11 协议栈以及 tcp/ip 协议栈，能够实现用户串口数据到无线网络之间的转换。通 过 uart-wifi 模块，传统的串口设备也能轻松接入无线网络。 接口： 双排插针式接口 支持波特率范围：1200115200bps 供电：3.3v 和 5v 可选 无线： 兼容 ieee 标准 802.11b/g/n 符合 ieee 标准 802.11 的 rf 收发器 惟一的序列化 mac 地址 数据速率：1 和 2 mbps 范围：最大 400 米（1300 英尺） 工作于 ism 波段 2.4002.484 ghz 可对 14 个信道进行分别选择或域限制 支持 802.1x 和 802.1i 安全性：wep、wpa-psk 和 wpa2-psk 支持两种无线网络类型：基础网（infra）和自组网（adhoc） 可选配备超小型同轴（u.fl）连接器的外部天线 美国（fcc）、加拿大（ic）、欧洲（etsi）和日本（arib）的无线 电法规认证 通过 wi-fi 认证 其他： 支持多种网络协议：tcp、udp、dhcp、icmp、dns 等 支持串口透明传输模式 可提供上位机界面进行参数配置 支持简单的 at+控制指令集，进行参数配置 应用领域： 公共事业和智能能源：温控器、智能仪表、白色家电等 消费电子产品：遥控器、家庭安全、玩具等 工业控制：工业传感器、工业安全、m2m 通信等 远程设备管理：位置资产跟踪、汽车等 还可用于零售、医疗保健等众多物联网相关行业 顺舟科技 wifi 模块用户手册（v1.2.0） 6 / 48 www.shuncom.com 第二部分第二部分 技术指标技术指标 类类 别别 指标名称指标名称 wifi 无线模块无线模块 无线网络无线网络 无线标准 ieee802.11b 频率范围 2.4002.484 ghz 接收灵敏度 1 mbps 时的典型灵敏度为-91 dbm 数据速率 1 和 2 mbps 调制方式 dsss 调制 输出功率 典型输出功率为+10 dbm（实测+7dbm） 硬件部分硬件部分 接口类型 uart 接口速率 1200115200 bps 工作电压 5v 或 3.3v 天线连接 小型同轴外部天线 接收电流 160ma 发送电流 200ma(峰值 250ma) 待机电流 120ma 无线认证 通过美国（fcc）、加拿大（ic）、欧洲（etsi） 和日本（arib）的无线电法规认证 软件部分软件部分 网络类型 infra/adhoc 安全机制 wep/wpa-psk/wpa2-psk 网络协议 tcp/udp/icmp/dhcp/dns 串口命令 at+指令集 网络协议 tcp/ icmp/dhcp/dns 工作工作环境环境 工作温度 -20c 85c 储存温度 -40c 125c 顺舟科技 wifi 模块用户手册（v1.2.0） 7 / 48 www.shuncom.com 第三部分第三部分 产品综述产品综述 3.1 概述 本部分综合介绍顺舟科技 wifi 模块， 从硬件接口与产品功能等方面进行说明。 以方便和有效的帮助用户熟悉使用 wifi 模块，更好更快地投入使用。接口采用 标准 2.54 双排插针，与系统接口可以采用插座或接线座模式引出到用户系统。 如下图为模块的实物。 模块正面图 顺舟科技 wifi 模块用户手册（v1.2.0） 8 / 48 www.shuncom.com 模块反面图 3.2 机械尺寸 顺舟科技 wifi 模块用户手册（v1.2.0） 9 / 48 www.shuncom.com 嵌入模块尺寸：48mmx34mmx10mm（长 x 宽 x 厚） 3.3 外部接口 vcc： 电源+5v gnd: 地线 rx1： uart 接收端口(ttl) tx1： uart 发送端口(ttl) rx2： 232 或 485（可选）接收端口 tx2： 232 或 485（可选）发送端口 c485: 485 控制端口 cfg： 配置端口 rst: 复位端口 pgd、pgc：为程序调试端口 run: 当程序正常运行时，run 引脚接指示灯每秒闪一次 net: 当模块连网时此引脚指示灯常亮，当未连网时指示灯不亮。 顺舟科技 wifi 模块用户手册（v1.2.0） 10 / 48 www.shuncom.com io1、io2、io3、io4、io5 可以实现 5 路 pwm 输出（在后续版本中实现） ad1、ad2、ad3、ad4 可以实现 4 路的 10 位 ad 采样（在后续版本中实现） alm、slp、io7、io8 为普通 io 端口，可以实现普通 io 输入输出，另上面的其 他端口也可以复用为普通 io 口（在后续版本中实现） 注：现在只有透传功能，其它端口功能暂时不开放。 （其他功能在后续版本中实 现，或为客户定制开发） 3.4 天线 本产品提供一个 ipx 天线接口。 wifi 模块 经过法规认证，可使用多种天线。仅当使用以下天线，或使用的天线 在材料和功能上与以下天线等效时，模块化认证才有效。所有天线都通过超小型 同轴（u.fl 或 ipex）连接器连接到模块。 3.5 无线网络模式的选择和部署 无线网络连接分为基础网络（infra）连接和点对点（adhoc）网络连接，顺 舟 wifi 模块同时支持着 2 种连接模式。 下面引入 2 个基本的概念： ap，也就是无线接入点，是一个无线网络的创建者，是网络的中心节点。 我们一般家庭或办公室使用的无线路由器就一个ap，还有现在很多运营商也在 公共区域布置的wifi热点也是ap。 sta，站点，每一个连接到无线网络中的终端（如笔记本电脑、手机、wifi 模块及其它可以联网的用户设备）都可称之为一个站点。 顺舟科技 wifi 模块用户手册（v1.2.0） 11 / 48 www.shuncom.com 基础网络（infra）： 是由ap 创建，众多sta 加入所组成的无线网络，这种类型的网络的特点 是ap 是整个网络的中心，网络中所有的通信都通过ap 来转发完成。 基础网的一些特点如下： 1、可以通过无线路由器扩展信号覆盖范围； 2、ip地址可以通过路由器的dhcp功能动态分配； 3、可以设置高等级wpa2 加密，保障网络数据安全； 如果您使用顺舟的wifi模块，只要工作区域有无线网络可以接入，就可以 将顺舟wifi模块接入因特网。在其他任何地方，只要能够上因特网就可以通过 网络来控制顺舟的wifi模块。 点对点网络（adhoc） 也称为自组网，是仅由两个及以上sta 自己组成，网络中不存在ap，这种 类型的网络是一种松散的结构，网络中所有的sta 都可以直接通信。 自组网的一些特点如下： 1、无需路由器； 2、可以支持多模块接入； 3、需要静态设置ip； 该模式是一种低成本、方便的连接方式。用户可以不依赖于无线路由器，直 接使用笔记本连接模块。 如果您使用顺舟的wifi模块， 可以用笔记本或手机等终端直接去连接和控制 wifi模块。也可以用几个模块自己建立一个网络，来相互之间通信控制。 3.6 安全机制 本模块支持多种无线加密方式，可以保证用户数据安全。 加密方式包括： open(不加密) wep64 wep128 wpa-psk wpa2-psk 3.7 串口透明传输 本模块支持串口透明传输模式，可真正实现串口即插即用，最大程度的降低 用户使用的复杂度。在此模式下，用户只需预先设置好如下所示的联网必需的参 数： 无线网络参数，包括： 网络名称（ssid） 安全模式 密钥（如果需要） 顺舟科技 wifi 模块用户手册（v1.2.0） 12 / 48 www.shuncom.com 默认的 tcp/udp 连接参数，包括： 协议类型 连接类型 目的地址 目的端口 此后，模块每次上电后即可自动连接到预设的无线网络及服务器。模块的串 口始终工作在透明数据传输状态，因此用户只需把它看做一条虚拟的串口线，按 照使用普通串口的方式发送和接收数据就可以了。也就是说，用户原有的串口设 备， 直接把连接的串口线替换成本模块，用户设备无需作任何改动即可轻松实现 数据的无线传输。此工作模式下，模块支持用户可设置的自动组帧触发长度和触 发的时间。自动组帧触发长度是指，模块从串口接收的指定长度的数据后，组成 网络数据帧，并立即启动网络发送流程。自动组帧触发时间是指，当从串口接收 到的数据不足上述指定长度时，模块将在指定的超时时间后，强制将当前数据组 成网络帧并启动发送。 3.8 方便参数配置 顺舟 wifi 模块提供简单的 wifi 配置工具，让客户能够快速方便的对 wifi 模 块进行参数配置。每次配置后，配置参数会被写入芯片的 flash 中保存下来，直 到下次配置才用新的配置参数来替代旧的配置参数。 目前产品只支持基于串口的配置方式，关于无线配置将在后续版本中增加。 3.9 at 指令配置参数 顺舟 wifi 模块，除了能用 wifi 配置工具对其进行配置之外，还可以用简单 的 at 指令进行参数配置。详细配置方法请看后面 at 指令相关章节。 3.10 tcp/ip 协议栈 顺舟 wifi 模块内置一个完整的 tcp/ip 协议栈，支持 tcp/udp/icmp/ dhcp/dns 等协议。 顺舟科技 wifi 模块用户手册（v1.2.0） 13 / 48 www.shuncom.com 第第四四部分部分 快速开始向导快速开始向导 4.1 准备工作 硬件： 顺舟 wifi 模块 顺舟 wifi 底板 串口线 软件： wifi 配置工具 v1.0 串口调试助手 tcp/udp 调试软件 4.2 网页参数配置 如果用户有支持 wifi 的笔记本， 或支持 wifi 并支持 adhoc 功能的手机就可 以用网页参数方式进行配置。如没有则参照 4.3 节用串口工具进行配置。 如果是第一次对模块上电，模块会用默认参数配置建立一个点对点网络。默 认 ssid:shuncom_hoc 默认 ip 地址： 模块上电后，就可以用笔记本电脑搜索无线网络，如下图所示可以在网络列 表中看到能搜索到名为 shuncom_hoc 的点对点网络 此网络默认是没有加密的，直接连接此网络即可。 连接后，必须使计算机和模块在同一网段中才能进行配置，此时要改动计算 顺舟科技 wifi 模块用户手册（v1.2.0） 14 / 48 www.shuncom.com 机为静态 ip 地址，将 ip 地址改为：169.254.1.xxx, 如下图所示 配置好 ip 地址后， 就可以打开浏览器在地址栏中输入：“” ， 回车， 便可看到用户登录界面，输入缺省用户名：admin 与密码：shuncom 即可。 点击确认后，就可以看到模块的嵌入式 web 界面了。 如下： 顺舟科技 wifi 模块用户手册（v1.2.0） 15 / 48 www.shuncom.com 点击左边的 config 图标就可以进入配置界面了，如下 顺舟科技 wifi 模块用户手册（v1.2.0） 16 / 48 www.shuncom.com 界面中包含了各参数的配置，具体参数含义请参考其他各章节。注意配置完 成后点击 save config 按钮后，配置内容不会马上生效，必须重新上电后才会生 效。 4.3 工具参数配置 1、 将 wifi 模块插入 wifi 模块底板， 接好串口线， 接上电源， 按一下配置按键。 2、 启动 wifi 配置工具 v1.0 3、 选择与模块相连的串口，如下图编号 1 所示。点击“连接模块”按钮如下图 编号 2 所示，如下图编号 3 将会从“未连接”变为“已连接” 。 （如果点击连 接按钮无效，在底板上按下配置按钮的同时重新上电，再尝试点击按钮） 顺舟科技 wifi 模块用户手册（v1.2.0） 17 / 48 www.shuncom.com 4、 当点击“连接模块”按钮，成功后会出现如下界面。在网络类型的下拉菜单 中选择基础网络。 根据所在路由器 （ap） 的设置， 来配置 wifi 的参数设置 （包 括网络名称、安全模式、密钥） 。如需启动自动获得 ip 功能，请在启动 dhcp 前小方框中打钩。 如需自己指定 ip 等参数， 请在下方填写 ip 地址、 子网掩码、 网关地址、dns 服务器等。 顺舟科技 wifi 模块用户手册（v1.2.0） 18 / 48 www.shuncom.com 5、 在工作模式设置中根据你的需要配置相关参数。建议：协议类型为 tcp、c/s 模式为客户端、服务器地址为电脑 ip 地址、端口号（请配置为大于 1024） 。 6、 在通信设置中配置串口参数，包括波特率、检验位、数据位、停止位。 7、 点击“提交参数”按钮，会跳出参数已保存对话框（如下图） 。请点击“确 定”按钮。 顺舟科技 wifi 模块用户手册（v1.2.0） 19 / 48 www.shuncom.com 顺舟科技 wifi 模块用户手册（v1.2.0） 20 / 48 www.shuncom.com 4.4 开始测试 1、启动 tcp/udp 调试工具，本例中用的是顺舟数据中心演示助手。创建一 个监听端口为 12349 的 tcp server 如下图所示。 如果模块与主机之间建立 了 tcp 连接，服务器状态区会有相应的显示。 2、启动串口调试助手，本例中使用的是 sscom32 的调试工具。配置好与上 面相同的波特率、校验位、数据位、停止位。 3、当模块与电脑主机建立 tcp 连接后，就可以通过演示助手和串口工具之 间进行数据传输的演示。如下图所示 顺舟科技 wifi 模块用户手册（v1.2.0） 21 / 48 www.shuncom.com 顺舟科技 wifi 模块用户手册（v1.2.0） 22 / 48 www.shuncom.com 第第五五部分部分 参数配置参数配置与与配置工具配置工具使用使用 5.1 网络类型 是指 wifi 模块将要选择的网络模式，包括基础网络和自组网络 2 个选项。 缺省值为基础网络，当需要模块去连接无线路由和 wifi 热点等 ap 时，请选择此 模式。 当需要模块用于点对点网络时（例如笔记本或手机等终端直接连接模块，或 2 个模块之间连接） ， 请选择自组网络模式。 顺舟 wifi 模块在使用点对点模式时， 如果网络存在将会自动去连接网络，如果网络不存在会自己去创建一个网络。 用配置工具配置此参数，如下图，在网络类型的下拉菜单下进行选择即可。 顺舟科技 wifi 模块用户手册（v1.2.0） 23 / 48 www.shuncom.com 5.2 无线设置 无线设置包括：网络名称、安全模式、密钥格式、密钥索引、密钥。无线设 置在配置工具的位置如下图所示。 网络名称：网络名称： wifi 网络的网络标识，长度为 132 个 ascii 字符 在配置工具中对网络名称的配置如下图所示，在后面的空白框中填入需要连 接的网络名称。 顺舟科技 wifi 模块用户手册（v1.2.0） 24 / 48 www.shuncom.com 安全模式：安全模式： wifi 网络的加密类型，包括 open、wep64、wep128、wpa-psk、wpa2-psk。 在配置工具中对安全模式进行配置如下图所示，在安全模式选项的下拉菜下 选择需要的安全加密模式即可。 密钥格式：密钥格式： 此配置只对 wep64 和 wep128 加密方式下有效， 包括 hex 与 ascii 2 种格式。 他们的区别仅在于密钥的显示格式不同， 如 wep64 加密， 其输入密钥可以为 5 个 ascii 字符（如 12345）或 10 个十六进制数字（31323333435）。 在配置工具中对密钥格式进行配置如下图所示，在密钥格式后的下拉菜单中 选择十六进制或者 ascii。 密钥索引：密钥索引： wifi网络的密钥索引号，本参数仅在wep64和wep128加密方式下有效，可选 范围为14，其它加密方式下无意义。 在配置工具中对密钥索引进行配置如下图所示，在密钥索引后的下拉菜单中 选择所需要的索引。 密钥：密钥： wifi网络的密钥字符串，不同的加密方式及密钥格式，密钥有不同的长度要 顺舟科技 wifi 模块用户手册（v1.2.0） 25 / 48 www.shuncom.com 求, wep64（十六进制）： 10 个字符 wep64（ascii）： 5 个字符 wep128（十六进制）： 26 个字符 wep128（ascii）： 13 个字符 wpa/wpa2-psk（ascii）： 863 个字符 说明，wpa/wpa2-psk加密模式时，需要用对字符型密钥进行转换这个过程 大概需要30秒的时间。所以模块第一次联网时，需要花较长的时间，但是模块会 将计算后的内容保存下来。所以在使用顺舟wifi模块时，配置后的第一次联网 需要较长的时间，之后就可以很快联网了。 在配置工具中对密钥进行配置如下图所示，在密钥后的方框中填写密钥。 顺舟科技 wifi 模块用户手册（v1.2.0） 26 / 48 www.shuncom.com 5.3 网络设置 网络设置包括：是否使用 dhcp（自动获取 ip 地址） 、ip 地址、子网掩码、网 关地址、dns 服务器。网络设置在配置工具的位置如下图所示。 启动 dhcp（自动获取 ip 地址）: 用于指定本端的网络地址类型，勾选本参数后，模块将通过dhcp 协议动态 获取本端的网络地址。启动本功能后，后面的ip地址、子网掩码、网关地址、dns 服务器将会无效。 说明：在点对点模式时，请不要选用此功能，必须自己定义固定ip地址、子 网掩码、网关地址、dns服务器。 在配置工具中使用如要使用dhcp功能，只要在前面的小方格中打钩即可。如 果启动dhcp功能后，下面的4个项就不可用，如下图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 27 / 48 www.shuncom.com ip地址： 用于指定本端网络地址中的静态ip 地址， 在未勾选 “启动dhcp”的情况下效。 在配置工具中对ip地址配置时，只需要在ip地址后面的框中填入ip地址即可， 如下图所示。 子网掩码： 用于指定本端网络地址中的子网掩码，在未勾选“启动dhcp”的情况下效。 在配置工具中对子网掩码配置时，只需要在子网掩码后面的框中填入掩码地 址即可，如下图所示。 网关地址： 用于指定本端网络地址中的网关地址，在未勾选“启动dhcp”的情况下效。 在配置工具中对网关地址配置时，只需要在网关地址后面的框中填入网关地 址即可，如下图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 28 / 48 www.shuncom.com dns服务器： 用于指定本端网络地址中的dns 服务器地址，在未勾选“启动dhcp”的情况 下效。 在配置工具中对dns服务器配置时，只需要在dns服务器后面的框中填入dns 服务器地址即可，如下图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 29 / 48 www.shuncom.com 5.4 工作模式设置 工作模式设置包括：协议类型、c/s 模式、服务器地址、端口号。工作模式 设置在配置工具的位置如下图所示。 协议类型协议类型： 为模块创建的默认连接的协议类型，可选项包括：tcp 和 udp。 在配置工具中对协议类型选择，在协议类型后的下拉菜单中进行选择，如下 图所示。 c/sc/s 模式模式： 为模块创建的默认连接的 c/s 模式，可选项包括：服务器和客户端。 在配置工具中对 c/s 模式选择，在 c/s 模式后的下拉菜单中进行选择，如 顺舟科技 wifi 模块用户手册（v1.2.0） 30 / 48 www.shuncom.com 下图所示。 服务器地址服务器地址: 当模块创建的默认连接cs 模式为client 时，所要连接的服务器，输入格式 可以是ip 地址或域名。在server模式时此选项无效。 在配置工具中对服务器地址进行配置，在服务器地址选项后直接填入，如下 图所示。 端口号端口号： 为模块创建的默认连接的端口号。 在配置工具中对端口号进行配置，在端口号选项后直接填入，如下图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 31 / 48 www.shuncom.com 5.5 通信设置 通信设置是指当模块处于透传状态时对通信相关参数设置，包括波特率、检 验位、数据位、停止位、组帧长度、组帧周期。 通信设置在配置工具中的位置如下图所示。 波特率：波特率： 串口波特率设置，可选项范围：1200115200bps，系统缺省设置为19200bps 在配置工具中对波特率进行配置，在波特率选项下拉菜单下进行选择，如下 图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 32 / 48 www.shuncom.com 检验位：检验位： 串口校验位设置，可选项包括：无校验、奇校验和偶校验，系统缺省设置为 无校验。 在配置工具中对校验位进行配置，在校验位选项下拉菜单下进行选择，如下 图所示。 数据位：数据位： 串口数据位长度设置，可选项包括：8位和9位，系统缺省设置为8位数据位。 在配置工具中对数据位进行配置，在数据位选项下拉菜单下进行选择，如下 图所示。 停止停止位：位： 顺舟科技 wifi 模块用户手册（v1.2.0） 33 / 48 www.shuncom.com 串口停止位长度设置，可选项包括：1位和2位，系统缺省设置为1位数据位。 在配置工具中对停止位进行配置，在停止位选项下拉菜单下进行选择，如下 图所示。 组帧长度：组帧长度： 当接收数据长度达到本参数时，将强制组成网络帧并发送。现阶段的可选范 围只支持0-1023，只支持tcp传输模式，udp时无效。 在配置工具中对组帧长度进行配置，在组帧长度选项后直接填入字节数，如 下图所示。 组帧周期：组帧周期： 当接收数据长度不足组帧长度，若时间超时达到组帧周期时，也将强制发送 所接收数据。所输入数值的单位为毫秒。只支持tcp传输模式，udp时无效。 在配置工具中对组帧周期进行配置，在组帧周期选项后直接填入周期数，如 下图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 34 / 48 www.shuncom.com 5.6 提交参数 提交以上所有配置信息，并保存到主芯片flash中。提交的同时会跳出“参 数已保存”信息，点击确认按钮即可完成配置，模块也会自动重启。 说明：每次提交时，请确保所有参数都已输入，提交时会对所有参数重新保 存。如果有些参数没有填入，就会保存为空，可能导致模块无法正常工作。 配置工具中“提交参数”按钮位置如下图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 35 / 48 www.shuncom.com 当点击“提交参数”按钮后，会跳出“参数已提交”对话框，请点击确定按 钮，如下图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 36 / 48 www.shuncom.com 第第六六部分部分 嵌入式嵌入式 web 配置配置 本产品内置嵌入式web服务器，支持用ie浏览器进行远程访问，可以实现对 模块的远程配置和控制。 注意：只有当模块连入到网络后才能访问到模块的嵌入式web。 进入嵌入式web的方式很简单，只要所使用的终端和顺舟wifi模块处于同一 网络中，在浏览器中输入模块的ip地址即可访问模的web。在浏览器中输入模块 ip地址后会出现如下界面： 此界面中要输入访问wifi模块的用户名和密码，初始状态下没有用户名和密 码。此用户名和密码可以在web配置界面中做修改。 输入用户名和密码后会进入如下界面： 顺舟科技 wifi 模块用户手册（v1.2.0） 37 / 48 www.shuncom.com 此界面下有2个图标：config和control。点击config图标可以进入配置界面 对wifi模块的参数进行配置。点击control图标可以进入控制界面，可以对wifi 模块的某些参数和进行监控和控制。 6.1 web配置界面 点击config图标可以进入配置界面，如下图所示。 顺舟科技 wifi 模块用户手册（v1.2.0） 38 / 48 www.shuncom.com 顺舟科技 wifi 模块用户手册（v1.2.0） 39 / 48 www.shuncom.com 以上参数显示的wifi模块中保存的值，各参数具体情况介绍如下： 注：用web配置和配置工具配置实现功能是一样的。 1、网络类型（nettype） 其中，infra表示基础网，adhoc表示自组网 2、无线设置 ssid: 网络名称 securitymode: 安全模式 keymode: 密钥格式 keyindex: 密钥索引 key: 密钥 具体参数含义和配置方法请参照第5部分相关内容。 3.网络设置 enable dhcp: 是否启动自动分配 ip 地址，dhcp 功能 ip address: ip 地址 subnet mask: 子网掩码 gateway: 网关地址 dns address: dns 服务器 具体参数含义和配置方法请参照第5部分相关内容。 4、工作模式设置 顺舟科技 wifi 模块用户手册（v1.2.0） 40 / 48 www.shuncom.com tcp/udp: 网络连接方式选择tcp或udp c/s mode: 模块做服务器（server）或客户端（client） serverip: 如模块做客户端，服务器ip地址 port: 要连接的端口 具体参数含义和配置方法请参照第5部分相关内容。 5、通信设置 baudrate: 波特率 checkbit: 检验位 datebit: 数据位 stopbit: 停止位 datelen: 组帧长度 datatime: 组帧周期 具体参数含义和配置方法请参照第5部分相关内容。 6、web用户名和密码 username：访问网页用户名 password：访问网页密码 初始值是不设置用户名和密码的，用户设置之后请记住所设置的用户名和密 码，否则将无法访问web界面。如果忘记所设置的用户名和密码，请用第5部分的 配置工具对模块进行配置，此项会回到初始状态，不设置用户名和密码。 7、保存配置 顺舟科技 wifi 模块用户手册（v1.2.0） 41 / 48 www.shuncom.com 当所有内容都配置好后请点击save config按钮，所有参数会保存到芯片的 flash中。但在网页下的保存按钮与配置工具的保存按钮有一个地方不同，就是 在网页下保存参数后，不会立即生效，程序会按照原来的参数继续运行。只有对 模块断电和重新上电后保存的参数才会生效。 6.2 web控制界面 当登陆网页后点击control图标可以进入到网页监控和控制界面。如下图所 示： 顺舟科技 wifi 模块用户手册（v1.2.0） 42 / 48 www.shuncom.com 如上图，控制页面的内容包括5路pwm，16路ad采样，所有io端口的采集以及 10个开关量的控制。这其中有些pwm和io口复用，ad口与io口复用。 控制界面的相关功能并非所有模块的通用功能，现阶段只做演示使用，后续 可以为客户做定制化服务。 关于网页控制功能后续会不断完善。 顺舟科技 wifi 模块用户手册（v1.2.0） 43 / 48 www.shuncom.com 下面对各控制选项做具体的介绍： 1、pwm控制部分 pwm_frequency: pwm频率（默认值是5000） pwm1-5后面的方框中输入0-100之间任意值，代表占空比的百分比。 后面on或off下拉菜单是用来控制相应pwm的开关功能。on代表使用pwm 功能，off关闭pwm功能。 以上所有pwm配置都是可以人为改动的。 2、adc监控部分 adc监控部分只是对adc采样值进行监控，本芯片的ad采样是10位的，所以检 测到的ad采样值除以1024再乘3.3v就是相应的引脚采到的电压值。 adc监控部分只能显示采集到的值，用户不能对其做任何修改。 注意：由于引脚复用的原因，这里虽然列出了所有引脚的采样值，但并不是 所有引脚都可做adc使用，有些引脚可能会用于其他地方。 3、所有io口的开关量监控 顺舟科技 wifi 模块用户手册（v1.2.0） 44 / 48 www.shuncom.com io口开关监控显示原理是以芯片引脚的命名来显示的，每个方框后面显示的 是16个io口的状态。 后面方框中是16进制显示， 与芯片寄存器的值一致。 例如iog 为0040则表示，g6引脚是高电平，其他都是低电平。 特别说明，这里虽然列出了所有的io口的值，但是其中有些io是不存在的。 此处io监控只是做备用，使用者暂时可以忽略此部分，更不用花时间深究芯片引 脚寄存器的编号。如果以后有用到会做特殊说明。 4、开关控制 这里只是列出了10个开关，后面下拉菜单有on和off两种选择，on代表打开 开关，off代表关闭开关。这些开关暂时还没有与相应的引脚进行对应，后续会 根据不同的情况来进行配对。 特别说明：控制界面目前只做演示作用，和后续为客户进行定制化服务，如 用不到的客户可以忽略此部分。 顺舟科技 wifi 模块用户手册（v1.2.0） 45 / 48 www.shuncom.com 第第七七部分部分 at 指令指令 为让客户更好的嵌入式的使用本模块，顺舟wifi模块提供简单的at指令集对 模块进行配置。用户可以通过mcu的串口直接对模块进行配置。 at指令如下： 1 1、at+sz_ssid=at+sz_ssid= 此at指令用于设置网络名称，在“=”后面加入网络名称即可。例如网络名 称为shuncom，则完整的at指令为at+sz_ssid=shuncom/r/n 2 2、at+sz_networktype=at+sz_networktype= 此at指令用于设置网络类型， 如果是基础网络则在 “=” 后面infrastructure， 如果是自组网络则在“=”后面adhoc。例如： 基础网：at+sz_networktype=infrastructure/r/n 自组网：at+sz_networktype=adhoc/r/n 3 3、at+sz_security=at+sz_security= 此at指令用于设置安全模式，“=”后面可加4种模式，包括：open、wep64、 wep128、wpa/wpa2phase。例如： open: at+sz_security=open/r/n wep64: at+sz_security= wep64/r/n wep128: at+sz_security= wep128/r/n wpa-psk: at+sz_security= wpa/wpa2phase/r/n wpa2-psk: at+sz_security= wpa/wpa2phase/r/n 4 4、at+sz_wepindex=at+sz_wepindex= 此at指令只在wep64和wep128时有效，用于配置密钥格式和密钥索引。“=” 后面由2个连续的字符组成。前一个字符可以为“0”、“1”、“2”、“3”分 别代表索引1、索引2、索引3、索引4。后一个字符可以为“a”、“h”，a代表 密钥为ascii，h代表密钥为十六进制。例如， 索引为1密钥为ascii: at+sz_wepindex=0a/r/n 索引为3密钥为十六进制: at+sz_wepindex=2h/r/n 5 5、at+sz_security_key=at+sz_security_key= 此at指令用于配置网络密钥，直接在“=”后面加上网络密钥即可。例如： 若为wep64,ascii,密码为12345：at+sz_security_key=12345/r/n 若为wep64，十六进制，密码为12345：at+sz_security_key=3132333435/r/n 若为wpa/wpa2-psk,密码为123456789: at+sz_security_key=123456789/r/n 6 6、at+sz_dhcp=at+sz_dhcp= 此at指令用于选择是否使用自动分配ip地址。在“=”后面可以加enable或 disable来决定是否使能自动分配ip地址功能。例如： 使用自动分配ip地址：at+sz_dhcp=enable/r/n 不使用自动分配，由自己指定ip地址：at+sz_dhcp= disable/r/n 顺舟科技 wifi 模块用户手册（v1.2.0） 46 / 48 www.shuncom.com 7 7、at+sz_ip_default=at+sz_ip_default= 此 at 指令在不使用 dhcp 时有效，用于给顺舟 wifi 模块指定固定 ip 地址。 在“=”后面直接加 ip 地址即可，例如： 若指定 ip 地址为 23：at+sz_ip_default=23/r/n 8 8、at+sz_mask_default=at+sz_mask_default= 此 at 指令在不使用 dhcp 时有效， 用于给顺舟 wifi 模块指定固定子网掩码。 在“=”后面直接加子网掩码即可，例如： 若指定子网掩码为 ： at+sz_mask_default =/r/n 9 9、at+sz_gate_defaultat+sz_gate_default= = 此 at 指令在不使用 dhcp 时有效，用于给顺舟 wifi 模块指定网关地址。在 “=”后面直接加网关地址即可，例如： 若指定网关地址为 ：at+sz_gate_default =/r/n 1010、at+sz_dns_defaultat+sz_dns_default= = 此 at 指令在不使用 dhcp 时有效，用于给顺舟 wifi 模块指定 dns 服务器。 在“=”后面直接加 dns 服务器即可，例如： 若 dns 服务器为 ：at+sz_dns_default=/r/n 1111、sz_tcpudp_model=sz_tcpudp_model= 此 at 指令用于设置工作协议类型，“=”后面可以加 tcp 和 udp 两种类型。 例如： 用 tcp 协议工作：sz_tcpudp_model=tcp/r/n 用 udp 协议工作：sz_tcpudp_model=udp/r/n 1212、at+sz_s_c_model=at+sz_s_c_model= 此at指令用于配置wifi模块建立连接形式，“=” 后面可以加server和client 两种模式，分别代表模块做服务器或客户端。例如： 模块做服务器：at+sz_s_c_model=server/r/n 模块做客户端：at+sz_s_c_model= client/r/n 1313、at+sz_tcp_server_ip=at+sz_tcp_server_ip= 此 at 指令在模块做客户端时有效， 用于设置要连接服务器的 ip 地址。 在 “=” 后面直接加上 ip 地址即可。例如： 若服务器 ip 地址为 00： at+sz_tcp_server_ip=00/r/n 1414、at+sz_s_c_port=at+sz_s_c_port= 此 at 指令用于配置连