{{:do:do_front2.jpg?600|单路wifi继电器}}
====== 一、快速开始 ======
==== 1.供电 ====
**有两种供电方式：**
  - 使用microUSB数据线供电（安卓手机数据线），可插在手机充电器或者电脑USB端口上；
  - 使用5V直流电源供电，通过板子上的Vin和GND供电。
//注：供电电流需600mA。//
==== 2.联网 ====
  - 上电后，模块会自动检查是否已经联网，没有联网将进入配网模式。**进入配网模式时，LED3会闪烁**。
  - 用手机搜索名为BGT_xxxxxx的wifi名，并连接，该wifi的密码为**bigiot.net**，//注：连接后不要更换wifi，有的手机主动提示，此wifi无法连接网络，请求切换，此时**不要切换wifi**。//
  - 打开手机浏览器（上网浏览网页用的APP，譬如UC浏览器、百度浏览器等），在网址栏输入http://192.168.4.1，进行访问。输入wifi信息后点击**确定**，核对信息无误后**保存设备码**，然后点击**确定重启**。如果wifi信息正确，且可以正常联网，设备LED3会**常亮**。

{{:do:do_webconfig:connect_wifi.png?300|连接wifi}}{{:do:do_webconfig:wifi_info.png?300|输入wifi信息}}{{:do:do_webconfig:dev_code.png?300|保存设备码}}

注意事项：
  * 模块无法连接5G路由器的wifi，只能连接2.4G的wifi。
  * wifi信息内不要含有中文字符，或其他特殊字符。
  * 配置过程中不要切换手机所连接的wifi（BGT_xxxxxxx）,配置成功后此wifi自动消失，手机就可以连接其他wifi。

==== 3.获取设备 ====
//注意：在完成配网，并且LED3常亮后，进行如下操作。//

1.打开贝壳物联微信小程序，可在微信里搜索**贝壳物联**小程序，或者用微信扫描下面二维码打开。

{{:do:xcx_qrcode.jpg?250|贝壳物联微信小程序}}

2.打开贝壳物联小程序后，点击 **我的** ，**注册/登录** 小程序。

{{:common:xcx:wode.png?nolink&300|我的}}{{:common:xcx:login.png?nolink&300|登录/注册}}

3.登录后，使用配网时记录的 **设备码** 获取设备。

{{:do:do_webconfig:obtain.png?nolink&300|获取设备}}{{:do:do_webconfig:apikey_obtain.png?nolink&300|通过设备信息获取}}{{:do:do_webconfig:devcode_obtain.png?nolink&300|通过设备码获取}}

4.获取成功后，返回 **首页** 即可看到设备。点击设备名称，进入控制界面，控制界面下面有**设置**。

{{:do:do_webconfig:index.png?nolink&300|首页}}{{:do:do_webconfig:control.png?nolink&300|控制界面}}{{:do:do_webconfig:setting.png?nolink&300|设置界面}}

//注：//

//自锁模式——继电器一直维持当前状态，直到控制其切换状态，或模块断电断开；//

//点动模式——继电器在吸合后1秒自动断开（吸合时间可以设置）。//

====== 二、按钮及指示灯作用 ======
{{:do:do_front2.jpg?nolink&500|正面}}

按钮1——短按1秒左右控制继电器工作状态，吸合或断开；

按钮2——功能按键

  * 长按6秒以上使模块进入配网模式，此时LED3闪烁；
  * 短按1秒左右切换继电器1工作模式，点动或自锁模式。

LED1——模块电源指示灯，正常供电时常亮；

LED2——继电器工作状态指示灯，吸合时亮，断开时灭；

LED3——网络状态指示灯
  * 常亮——联网正确，正常工作；
  * 闪烁——模块处于配网模式；
  * 灭——尝试联网中。

====== 三、接口及针脚说明 ======
{{:do:do_back.jpg?nolink&500|}}

^序号	^名称	^功能说明^
|1	|Vin	|接5V电源输入，在用microUSB供电时，可作为5V输出|
|2	|GND	|GND|
|3	|3V3	|3.3V电源输出（150mA）|
|4	|RST	|拉低复位模块|
|5	|GND	|GND|
|6	|IO0	|GPIO0;拉低进入烧录模式|
|7	|IO2	|GPIO2; UART1_TXD|
|8	|IO4	|GPIO4;SDA|
|9	|IO5	|GPIO5;SCL|
|10	|ADC	|A/D 转换结果。输入电压范围 0～1V，读取数值范围：0～1024|
|11	|RX	|UART0_RXD|
|12	|TX	|UART0_TXD|
|13	|NC	|继电器常闭接线端|
|14	|COM	|继电器公共端|
|15	|NO	|继电器常开接线端|
|16	|microUSB	|USB供电接口5V|

====== 四、原理图 ======

{{:do:do_sck.jpg?800|}}

{{ :do:esp-delay1-open.pdf |PDF下载}}

====== 五、外形尺寸 ======

长6.5cm X 宽3cm X 高1.6cm

注：高度不含底部针脚突出部分

====== 六、主要硬件特性 ======

1、继电器采用松乐 {{ :do:do2g_1.0.pdf |SRD-05VDC-SL-C}}

控制能力：

AC 10A 250V

DC 10A 30V

有常开、常闭两个触点可选。不了解继电器的可以看看**[[https://baijiahao.baidu.com/s?id=1611095990135506323&wfr=spider&for=pc | 继电器原理介绍]]**。


2、联网和主控模块采用安信可 {{ :do:esp-12s.pdf |ESP-12S}}

主要参数如下：

{{:do:12s.jpg?600|ESP-12s}}

//注：不支持5G WiFi//

====== 七、接线举例 ======

可以先了解下 **[[https://baijiahao.baidu.com/s?id=1611095990135506323&wfr=spider&for=pc|继电器原理介绍]]**。

**传统台灯改造接线原理图**

{{:do:wifi_relay_connect.jpg?600|}}

**实物图**

{{:do:jiexian.jpg?600|}}

{{:do:wancheng.jpg?600|}}

**其中220V~5V降压模块，可选用**

{{:do:220v_5v.jpg?400|}}

变压模块购买链接：[[https://item.taobao.com/item.htm?id=559589858998]]

**改造台灯示例教程：[[https://www.bigiot.net/talk/241.html]]**

====== 八、通过贝壳物联平台接口控制 ======

=== 1、概述 ===

通过贝壳物联云平台的开放接口可以有多种方式控制继电器，根据通讯方式可以分为tcp、websocket、https三种方式，根据登录模式可以分为设备与设备通讯控制，用户与设备通讯控制。

=== 2、设备与设备实时通讯控制 ===

通讯协议：https://www.bigiot.net/help/1.html

此方式是以设备形式登录贝壳物联云平台，然后通过设备发送 say 指令，控制继电器。

指令内容（即 C 值）说明：

^内容	^作用	^备注^
|play	|继电器吸合	||
|stop	|继电器断开	||
|pause	|切换工作模式	|点动、自锁|
|DD+n	|设置点动间隔时间	|n为间隔秒数，取值范围[1,1800]，例如：DD+10，将继电器的点动间隔设置为10秒。使用url传递参数时指令中的 + 需转义为 %2B|

=== 3、用户与设备实时通讯控制 ===

通讯协议：https://www.bigiot.net/help/33.html
此方式是以用户形式登录贝壳物联云平台，安全等级更高，需要使用加密端口（8585、8484）登录，然后发送 say 指令，控制继电器。
指令格式及内容说明同上。
=== 4、通过传统API（https）模式控制 ===

通讯协议：https://www.bigiot.net/help/34.html

此方式是通过调用特定URL（ https://www.bigiot.net/oauth/say ），传递参数进行控制继电器。

参数中的 c 指令作用同上。
====== 九、自行开发固件 ======

**！！注意：自行开发刷固件之后，将失去默认固件功能，且无法恢复。**

=== 1、Arduino ESP866开发环境 ===

参见 [[:arduino_esp8266_install|Arduino ESP866开发环境]]

=== 2、示例代码 ===

在购买模块之后联系客服提供ESP8266 Arduino示例代码（包括本地按钮控制和连接贝壳物联平台远程控制示例代码）和Arduino IDE库文件（对板载LED、继电器控制的封装）。
=== 3、烧录模式接线 ===
^继电器模块	^USB转TTL	^电源^
|RX	|TX	||
|TX	|RX	||
|GND	|GND	|GND|
|Vin	|	|5V|
|IO0	|	|GND|

5V电源也可以直接使用USB转TTL的5V提供，不稳定时可考虑使用独立电源。

io0可直接短接继电器模块上的GND。

=== 4、开发参考文档 ===

  - 贝壳物联平台通讯协议（中文）：https://www.bigiot.net/category/1.html
  - Arduino ESP866官方说明手册（英文）：https://arduino-esp8266.readthedocs.io/en/latest/
  - NodeMCU开发官方文档（英文）：http://nodemcu.readthedocs.io/en/dev/
  - 安信可ESP8266文档中心（中文）：http://wiki.ai-thinker.com/esp8266/docs
  - 乐鑫官方资料（中英文）：http://espressif.com/zh-hans/support/download/documents
  - micropython for esp8266 文档（英文）：http://docs.micropython.org/en/latest/esp8266/quickref.html