使用esp32 & WiFi接入

使用WiFi接入，当设备和手机在同一个局域网中，为局域网通信
其余情况，使用MQTT远程通信

硬件准备

esp32开发板

软件准备

Arduino IDE需安装好esp32扩展

Arduino IDE 1.8.7或更新版本
务必使用 2.0.0 或以上release版本的 ESP32 Arduino package
中国大陆安装方法(windows)
常规安装方法

下载并安装blinker APP

Android下载：
点击下载 或 在android应用商店搜索“blinker”下载安装
IOS下载：
点击下载 或 在app store中搜索“blinker”下载

下载并安装blinker Arduino库

• 点击下载
• 通过Arduino IDE 菜单>项目>加载库>添加.ZIP库 导入到库，如图：

在app中添加设备，获取Secret Key

• 进入App，点击右上角的“+”号，然后选择 添加设备
• 点击选择Arduino > WiFi接入
• 复制申请到的Secret Key

DIY界面

• 在设备列表页，点击设备图标，进入设备控制面板
• 首次进入设备控制面板，会弹出向导页
• 在向导页点击 载入示例，即可载入示例组件

编译并上传示例程序

打开Arduino IDE，通过 文件>示例>Blinker>Blinker_Hello/Hello_WiFi 打开例程
在程序中找到保存Secret Key、WiFi名称和密码的变量，填入您要连接的WiFi名和密码，如：

char auth[] = "abcdefghijkl"; //上一步中在app中获取到的Secret Key
char ssid[] = "abcdefg"; //您的WiFi热点名称
char pswd[] = "123456789"; //您的WiFi密码

例程中宏LED_BUILTIN为开发板厂家定义的连接板载LED的引脚，如果您选择的开发板没有定义LED_BUILTIN，可以自行修改为您要使用的引脚
编译并上传程序到esp32开发板，打开串口调试器
当看到提示“MQTT Connected!”，说明设备已经成功连接到MQTT服务器

恭喜！一切就绪

在APP中点击刚才您添加的设备，即可进入控制界面，点点按钮就可以控制Arduino上的LED灯开关
另一个按钮也点下试试，放心，您的手机不会爆炸~

完整示例程序

#define BLINKER_PRINT Serial
#define BLINKER_WIFI

#include <Blinker.h>

char auth[] = "Your Device Secret Key";
char ssid[] = "Your WiFi network SSID or name";
char pswd[] = "Your WiFi network WPA password or WEP key";

// 新建组件对象
BlinkerButton Button1("btn-abc");
BlinkerNumber Number1("num-abc");

int counter = 0;

// 按下按键即会执行该函数
void button1_callback(const String & state) {
    BLINKER_LOG("get button state: ", state);
    digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN));
}

// 如果未绑定的组件被触发，则会执行其中内容
void dataRead(const String & data)
{
    BLINKER_LOG("Blinker readString: ", data);
    counter++;
    Number1.print(counter);
}

void setup() {
    // 初始化串口
    Serial.begin(115200);

    #if defined(BLINKER_PRINT)
        BLINKER_DEBUG.stream(BLINKER_PRINT);
    #endif
    
    // 初始化有LED的IO
    pinMode(LED_BUILTIN, OUTPUT);
    digitalWrite(LED_BUILTIN, HIGH);
    // 初始化blinker
    Blinker.begin(auth, ssid, pswd);
    Blinker.attachData(dataRead);
    Button1.attach(button1_callback);
}

void loop() {
    Blinker.run();
}

ESP32注意事项

当前ESP32系列分四种芯片：ESP32、ESP32C3、ESP32S3、ESP32S2，乐鑫及各模块厂家又封装了多种模块。各芯片、各模块的使用方式、配置均有差异，请参考乐鑫官方文档了解。

为什么设备显示不在线？

0. blinker App如何判断设备是否在线？

blinker App在 App打开时、进入设备页面时、在设备页面中每隔一定时间 会向设备发送心跳请求，内容为 {“get”:”state”}。
设备收到请求后，会返回 {“state”:”online”} ，app接收到这个返回，即会显示设备在线。

1. 程序没有成功上传到开发板

解决办法：重新上传，上传后打开串口监视器，确认程序正确运行

2. 程序中没有设置正确的ssid和密码，导致没有连接上网络

解决办法：设置后再重新上传程序，上传后打开串口监视器，确认程序正确运行

3. 程序错误，导致程序运行不正确

解决办法：先使用并理解blinker例程，再自由发挥

4. 开发板供电不足

解决办法：换电源 或 换USB口

为什么无法切换到局域网通信？

1. 路由器开启了AP隔离功能或禁止了UDP通信，从而阻止了局域网中设备的发现和通信

解决办法：关闭路由器AP隔离功能 或 允许UDP通信；如果找不到相关设置，通常可重置路由器解决

2. mdns没有及时发现设备

解决办法：在首页下拉刷新，可以重新搜索局域网中的设备