我的文档

Appearance

已为你生成DOCX文件，请查收

Arduino UNO R4 WiFi 热点直连控制开发指南 ​

1. 项目简介与硬件需求 ​

项目简介 ​

本项目演示如何利用 Arduino UNO R4 WiFi 开发板作为无线接入点（AP 模式），建立独立的局域网。手机或电脑 APP 无需连接外部路由器，即可直接连接该热点，并通过 HTTP 请求实现对板载 LED 等外设的远程控制。该方案适用于无网络环境下的设备调试、便携式控制及快速原型验证。

硬件需求 ​

  • 主控板：Arduino UNO R4 WiFi（基于 Renesas RA4M1 微控制器与 ESP32-S3 协处理器）。
  • 控制终端：智能手机、平板或电脑（用于连接热点并发送控制指令）。
  • 外设（可选）：板载 LED 即可满足演示需求，也可外接继电器或电机进行扩展。
  • 数据线：USB-C 数据线（用于供电与程序烧录）。

2. 电路连接说明 ​

本示例主要依赖 UNO R4 WiFi 的板载资源，无需复杂的外部接线：

  • 板载 LED：UNO R4 WiFi 的板载 LED 默认连接在数字引脚 D13。
  • 供电方式：通过 USB-C 接口连接电脑或 5V 电源适配器即可。
  • 外部负载（扩展）：若需控制外部设备，可将负载正极接 D13（或其他自定义引脚），负极接 GND。注意 UNO R4 WiFi 的 GPIO 最大输出电流有限，驱动大功率设备需加装驱动模块。

3. Arduino 代码示例 ​

以下代码配置 UNO R4 WiFi 为 AP 模式，并启动一个简易 HTTP 服务器。当终端访问特定 URL 时，即可控制板载 LED。

cpp
#include "WiFiS3.h" // UNO R4 WiFi 官方 WiFi 库

// AP 配置信息
const char* ssid = "UNO_R4_AP";
const char* password = "12345678"; // 密码至少8位

WiFiServer server(80); // 创建 HTTP 服务器，监听 80 端口
const int ledPin = 13; // 板载 LED 引脚

void setup() {
  Serial.begin(9600);
  pinMode(ledPin, OUTPUT);
  digitalWrite(ledPin, LOW);

  // 启动 AP 模式
  Serial.print("正在创建热点...");
  WiFi.beginAP(ssid, password);
  
  while (WiFi.status() != WL_AP_LISTENING) {
    Serial.print(".");
    delay(1000);
  }
  
  Serial.println("\n热点已启动！");
  Serial.print("AP IP 地址: ");
  Serial.println(WiFi.localIP()); // 通常为 192.168.4.1

  server.begin(); // 启动 HTTP 服务器
}

void loop() {
  WiFiClient client = server.available(); // 监听客户端连接

  if (client) {
    String currentLine = "";
    String request = "";
    
    while (client.connected()) {
      if (client.available()) {
        char c = client.read();
        request += c;
        
        // 读取到空行表示 HTTP 请求头结束
        if (c == '\n' && currentLine.length() == 0) {
          // 解析 HTTP GET 请求
          if (request.indexOf("GET /led/on") >= 0) {
            digitalWrite(ledPin, HIGH);
          } else if (request.indexOf("GET /led/off") >= 0) {
            digitalWrite(ledPin, LOW);
          }

          // 返回 HTTP 响应
          client.println("HTTP/1.1 200 OK");
          client.println("Content-type: text/html; charset=utf-8");
          client.println("Connection: close");
          client.println();
          client.println("<h2>UNO R4 WiFi 控制面板</h2>");
          client.println("<p><a href='/led/on'><button>开灯</button></a></p>");
          client.println("<p><a href='/led/off'><button>关灯</button></a></p>");
          break;
        }
        
        if (c == '\n') {
          currentLine = "";
        } else if (c != '\r') {
          currentLine += c;
        }
      }
    }
    client.stop(); // 关闭连接
  }
}

4. APP 端连接与控制说明 ​

连接步骤 ​

  1. 将代码烧录至 UNO R4 WiFi，打开串口监视器获取 AP 的 IP 地址（默认通常为 192.168.4.1）。
  2. 打开手机或电脑的 WLAN 设置，搜索并连接名为 UNO_R4_AP 的热点，输入密码 12345678。
  3. 连接成功后，打开浏览器或网络调试工具。

控制方式 ​

  • 浏览器控制：直接在浏览器地址栏输入 http://192.168.4.1，页面会显示“开灯”和“关灯”按钮，点击即可通过 HTTP GET 请求控制 LED。
  • 网络调试助手：若使用自定义 APP 或网络调试助手，配置 TCP Client 模式，目标 IP 设为 192.168.4.1，端口设为 80。发送以下原始 HTTP 请求即可：
    • 开灯：GET /led/on HTTP/1.1\r\nHost: 192.168.4.1\r\n\r\n
    • 关灯：GET /led/off HTTP/1.1\r\nHost: 192.168.4.1\r\n\r\n

5. 常见问题排查 ​

  • 无法搜索到热点：检查密码长度是否达到 8 位及以上；确认 USB 供电稳定；尝试更换 USB 线缆或接口。
  • 连接热点后无法访问网页：确认终端设备已关闭移动数据（部分手机在连接无互联网 AP 时会拒绝访问）；检查 IP 地址是否正确，可在串口监视器中重新确认 WiFi.localIP() 的输出。
  • 控制响应延迟或失败：HTTP 服务器为单线程阻塞处理，若请求过于频繁可能导致丢包；建议 APP 端增加请求间隔，或改用 WebSocket/UDP 协议以提升实时性。
  • 编译报错找不到库：确保在 Arduino IDE 中安装了 Arduino UNO R4 WiFi Boards 核心板包，该库已内置于核心包中，无需额外安装。