[K10教程] 【花雕动手做】K10 实验之 UDP 广播双 K10 双向通信点亮LED

// 引入DF官方物联网WiFi驱动库，支持开启SoftAP自建热点、读取热点网关IP、WiFi状态管理
#include <DFRobot_Iot.h>
// 行空板K10整机硬件驱动库，封装屏幕、画布、A按键、RGB彩灯等全部板载外设
#include "unihiker_k10.h"
// WiFi UDP服务端专用库，用于搭建标准局域网UDP监听服务，接收客户端消息、广播回复数据
#include <DFRobot_UDPServer.h>

// 前置函数声明：编译器提前识别两个事件回调函数，用于绑定UDP接收、按键按下动作
void onButtonAPressed();
void onUdpServerRecvMsg(String message);

// 行空板K10全局硬件控制对象，统一调度屏幕、按键、RGB灯、绘图画布资源
UNIHIKER_K10      k10;
// 屏幕显示方向配置参数3，可根据设备摆放角度切换画面翻转
uint8_t           screen_dir=3;
// WiFi物联网管理实例，控制热点开启、IP查询、无线参数配置
DFRobot_Iot       myIot;
// UDP服务端通信实例，负责监听指定端口、绑定接收回调、向局域网发送UDP广播消息
DFRobot_UDPServer myserver;

/**
 * setup：上电仅执行一次的初始化入口函数
 * 执行顺序：硬件底层初始化→绑定UDP接收回调→屏幕画布初始化→绑定A按键触发事件→绘制白色背景标题→开启本机WiFi热点→屏幕打印热点网关IP→开启UDP8888监听端口
 */
void setup() {
    // 初始化K10全部底层硬件总线、IO引脚、屏幕驱动、RGB驱动、系统时钟
        k10.begin();

        // 为UDP服务端绑定消息接收回调函数：后台监听到客户端UDP数据包，自动执行onUdpServerRecvMsg
        myserver.setCallback(onUdpServerRecvMsg);

        // 根据预设数值3初始化屏幕显示朝向
        k10.initScreen(screen_dir);
        // 创建内存画布缓冲区，文字先写入缓存再一次性刷新屏幕，降低画面闪烁
        k10.creatCanvas();

        // 给板载A物理按键绑定按下中断回调：按下A键立刻运行onButtonAPressed发送消息函数
        k10.buttonA->setPressedCallback(onButtonAPressed);

        // 设置屏幕整体背景底色为纯白色（十六进制色值0xFFFFFF）
        k10.setScreenBackground(0xFFFFFF);
        // 在画布第3行写入红色标题文字，标记本机身份为UDP服务端
        k10.canvas->canvasText("        行空板K10-服务器", 3, 0xFF0000);

        // 开启本机SoftAP无线热点模式，本机变身小型无线路由器
        // 热点名称：AP ；连接密码：88888888
        myIot.setSoftAP("AP", "88888888");

        // 拼接字符串，读取并打印本机热点网关IP地址，放置在画布第5行蓝色字体
        k10.canvas->canvasText((String("   获取本机IP:") + String(myIot.getWiFiSoftIP())), 5, 0x0000FF);
        // 将画布内所有文字缓存一次性渲染刷新到实体显示屏
        k10.canvas->updateCanvas();

        // UDP服务端开启8888端口，持续监听局域网内客户端发来的UDP数据包
        myserver.setPort(8888);
}

/**
 * loop：程序无限主循环
 * 本程序采用纯事件驱动架构，WiFi热点、UDP数据包监听、按键检测全部由库后台反文旁虫立线程处理
 * 无需要循环轮询的业务逻辑，循环体空置即可稳定运行
 */
void loop() {

}

/**
 * A按键按下专属回调函数
 * 触发动作：按下A键，UDP服务端向局域网内所有接入热点、监听8888端口的设备广播文本消息
 */
void onButtonAPressed() {
        // 广播发送UDP字符串：hello,I am server
        myserver.sendUdpMsg("hello,I am server");
}

/**
 * UDP服务端消息接收回调函数
 * 入参message：客户端传输过来的完整字符串数据
 * 触发逻辑：收到任意客户端UDP消息，全部RGB灯点亮浅青蓝色，维持2秒后自动熄灭
 */
void onUdpServerRecvMsg(String message) {
        // 参数-1代表控制板载全部RGB灯珠，灯光颜色赋值浅青蓝色0x33FFFF
        k10.rgb->write(-1, 0x33FFFF);
        // 灯光保持点亮2000毫秒（2秒）
        delay(2000);
        // RGB全部赋值黑色，熄灭所有彩灯
        k10.rgb->write(-1, 0x000000);
}
复制代码

#include <DFRobot_Iot.h>

#include "unihiker_k10.h"

#include <DFRobot_UDPServer.h>
复制代码

// 提前声明两个事件回调函数

void onButtonAPressed();

void onUdpServerRecvMsg(String message);



UNIHIKER_K10      k10;       // 整机硬件总控制器

uint8_t           screen_dir=3; // 屏幕翻转方向3，适配摆放角度

DFRobot_Iot       myIot;      // WiFi热点管理对象

DFRobot_UDPServer myserver;   // UDP服务端通信对象
复制代码

void setup() {

        k10.begin();
复制代码

 myserver.setCallback(onUdpServerRecvMsg);
复制代码

 k10.initScreen(screen_dir);

        k10.creatCanvas();
复制代码

 k10.buttonA->setPressedCallback(onButtonAPressed);
复制代码

 k10.setScreenBackground(0xFFFFFF);

        k10.canvas->canvasText("        行空板K10-服务器", 3, 0xFF0000);
复制代码

 myIot.setSoftAP("AP", "88888888");
复制代码

 k10.canvas->canvasText((String("   获取本机IP:") + String(myIot.getWiFiSoftIP())), 5, 0x0000FF);

        k10.canvas->updateCanvas();
复制代码

 myserver.setPort(8888);

}
复制代码

void loop() {



}
复制代码

void onButtonAPressed() {

        myserver.sendUdpMsg("hello,I am server");

}
复制代码

void onUdpServerRecvMsg(String message) {

        k10.rgb->write(-1, 0x33FFFF); // -1 = 全部RGB灯，点亮浅青亮色

        delay(2000);                   // 灯光保持2秒

        k10.rgb->write(-1, 0x000000); // 熄灭所有彩灯

}
复制代码

// 引入DF物联网WiFi库，实现连接指定WiFi热点、查询本地IP、检测联网状态
#include <DFRobot_Iot.h>
// 行空板K10硬件驱动库，封装屏幕、画布、A按键、RGB彩灯所有板载外设接口
#include "unihiker_k10.h"
// WiFi UDP客户端专用库，用于主动连接UDP服务端、发送消息、绑定接收回调
#include <DFRobot_UDPClient.h>

// 前置声明两个事件回调函数，编译器预识别函数标识，用于绑定UDP接收、按键按下动作
void onUdpClientRecvMsg(String message);
void onButtonAPressed();

// 行空板整机硬件总控制对象，统一管理屏幕、按键、RGB灯、绘图画布硬件资源
UNIHIKER_K10      k10;
// 屏幕显示朝向参数3，根据设备摆放角度翻转画面显示
uint8_t           screen_dir=3;
// WiFi物联网管理实例，负责热点连接、IP读取、无线状态监测
DFRobot_Iot       myIot;
// UDP客户端通信实例，建立与服务端的UDP通信链路、收发数据包
DFRobot_UDPClient myclient;

/**
 * setup 上电初始化函数，设备开机仅运行一次
 * 执行流程：硬件底层初始化→绑定UDP接收回调→屏幕画布初始化→绑定A按键触发事件→绘制黑色背景标题界面→连接服务端开启的AP热点→阻塞等待WiFi联网成功→屏幕打印联网状态与本机IP→UDP客户端连接服务端192.168.4.1:8888→刷新屏幕所有文字
 */
void setup() {
    // 初始化K10全部底层硬件：屏幕驱动、按键IO、RGB灯驱动、系统时钟、总线资源
        k10.begin();

        // 为UDP客户端绑定消息接收回调：后台监听到服务端下发的UDP数据包，自动执行onUdpClientRecvMsg
        myclient.setCallback(onUdpClientRecvMsg);

        // 根据预设数值3初始化屏幕显示翻转方向
        k10.initScreen(screen_dir);
        // 创建内存绘图画布缓冲区，文字先存入缓存批量刷新，减少屏幕闪烁撕裂
        k10.creatCanvas();

        // 给板载A物理按键绑定按下中断回调：按下A键立刻运行发送UDP消息的函数
        k10.buttonA->setPressedCallback(onButtonAPressed);

        // 设置屏幕整体背景底色为纯黑色 0x000000
        k10.setScreenBackground(0x000000);
        // 画布第3行写入绿色标题文字，标记本机身份为UDP客户端
        k10.canvas->canvasText("        行空板K10-客户端", 3, 0x00FF00);
        // 第一次刷新画布，展示客户端标题
        k10.canvas->updateCanvas();

        // 发起WiFi连接：连接服务端板子创建的热点，热点名AP，密码88888888（必须与服务端热点参数完全一致）
        myIot.wifiConnect("AP", "88888888");
        // 阻塞死循环，不完成WiFi连接则程序暂停向下执行，保证网络就绪后再启动UDP客户端
        while (!myIot.wifiStatus()) {}

        // 第5行写入红色文字，提示热点连接成功
        k10.canvas->canvasText("         成功连接AP热点", 5, 0xFF0000);
        // 拼接字符串，读取本机被热点分配的局域网IP，第7行蓝色字体打印IP地址
        k10.canvas->canvasText((String("       配置 IP:") + String(myIot.getWiFiLocalIP())), 7, 0x0000FF);

        // UDP客户端主动对接UDP服务端
        // 目标服务端IP：192.168.4.1（服务端自建热点的固定网关IP），统一通信端口8888
        myclient.connectToServer("192.168.4.1",8888);
        // 二次刷新画布，把联网成功提示、本机IP全部渲染到屏幕
        k10.canvas->updateCanvas();
}

/**
 * loop 无限主循环
 * 程序采用纯事件驱动架构，WiFi连接状态、UDP数据包监听、按键中断检测全部由库后台反文旁虫立线程运行
 * 无循环轮询业务逻辑，循环体空置不影响整套通信稳定运行
 */
void loop() {

}

/**
 * UDP客户端消息接收回调函数
 * 入参message：服务端广播下发的完整字符串消息内容
 * 触发逻辑：收到服务端任意UDP消息，所有RGB灯点亮纯红色，持续2秒后熄灭彩灯
 */
void onUdpClientRecvMsg(String message) {
        // 参数-1代表控制全部板载RGB灯珠，灯光赋值纯红色0xFF0000
        k10.rgb->write(-1, 0xFF0000);
        // 灯光保持点亮2000毫秒（2秒）
        delay(2000);
        // RGB全部赋值黑色，关闭所有彩灯
        k10.rgb->write(-1, 0x000000);
}

/**
 * A按键按下专属回调函数
 * 触发动作：按下A键，UDP客户端向192.168.4.1:8888发送文本UDP数据包
 */
void onButtonAPressed() {
        // 发送字符串消息：hello,I am client
        myclient.sendUdpMsg("hello,I am client");
}
复制代码

// DFR物联网WiFi库：负责连接外部热点、查询本机IP、检测WiFi在线状态

#include <DFRobot_Iot.h>

// K10硬件驱动库：管理屏幕、画布、A按键、RGB彩灯全部外设

#include "unihiker_k10.h"

// WiFi UDP客户端库：实现标准UDP客户端连接、消息收发、接收事件绑定

#include <DFRobot_UDPClient.h>



// 提前声明两个回调函数，给编译器识别，用于绑定事件

void onUdpClientRecvMsg(String message);

void onButtonAPressed();



UNIHIKER_K10      k10;       // 整机硬件控制总对象

uint8_t           screen_dir=3; // 屏幕翻转方向3，适配设备摆放角度

DFRobot_Iot       myIot;      // WiFi管理实例

DFRobot_UDPClient myclient;   // UDP客户端通信实例

复制代码

void setup() {

        k10.begin();
复制代码

 myclient.setCallback(onUdpClientRecvMsg);
复制代码

 k10.initScreen(screen_dir);

        k10.creatCanvas();
复制代码

 k10.buttonA->setPressedCallback(onButtonAPressed);
复制代码

 k10.setScreenBackground(0x000000);

        k10.canvas->canvasText("        行空板K10-客户端", 3, 0x00FF00);

        k10.canvas->updateCanvas();
复制代码

 myIot.wifiConnect("AP", "88888888");

        while (!myIot.wifiStatus()) {}
复制代码

 k10.canvas->canvasText("         成功连接AP热点", 5, 0xFF0000);

        k10.canvas->canvasText((String("       配置 IP:") + String(myIot.getWiFiLocalIP())), 7, 0x0000FF);
复制代码

 myclient.connectToServer("192.168.4.1",8888);
复制代码

 k10.canvas->updateCanvas();

}
复制代码

void loop() {



}
复制代码

void onUdpClientRecvMsg(String message) {

        k10.rgb->write(-1, 0xFF0000); // -1=全部RGB灯，点亮纯红色

        delay(2000);                   // 灯光保持2秒

        k10.rgb->write(-1, 0x000000); // 熄灭所有彩灯

}
复制代码

void onButtonAPressed() {

        myclient.sendUdpMsg("hello,I am client");

}
复制代码