1. 下载项目到本地

在 Linux 或 macOS 系统中，你可以直接通过命令行下载示例项目：

git clone <https://github.com/EffectsMachine/robot_driver_with_esp32s3_lite.git>
cd robot_driver_with_esp32s3_lite

💡 如果未安装 Git，可先执行：

sudo apt install git      # Ubuntu / Debian
brew install git          # macOS (使用 Homebrew)

该项目包含多个上位机控制示例，本教程将使用其中的 HTTP 示例 文件夹。

2. HTTP 控制简介

驱动板内置了一个轻量级 HTTP 服务器（默认端口为 80），你可以通过浏览器或 Python 脚本发送 HTTP 请求来控制机器人

2.1 为什么使用 HTTP？

⚠️ 注意：HTTP 通信不是实时控制方式，频率一般在 40 条指令/秒，适用于一般动作控制与状态读取，不适合需要毫秒级响应的高精度运动控制

3. 原理概述

驱动板在启动时会启动 HTTP 服务器（端口：80）。

设备可能以两种方式联网：

1. 作为热点（AP 模式）

   • 驱动板创建名为 Robot 的 Wi-Fi 热点

   • 上位机连接此热点后，访问地址固定为：

     <http://192.168.4.1:80>
     

2. 连接已有 Wi-Fi（STA 模式）

   • 驱动板连接路由器

   • 在 OLED 屏幕上显示由路由器分配的 IP 地址

   • 例如：

     <http://192.168.0.105:80>
     

上位机通过发送 JSON 指令（POST 请求）与驱动板通信，例如：

{"T":202,"line":1,"text":"http cmd test","update":1}

该方式无需安装驱动，任何联网设备（笔记本、树莓派、服务器）都可直接通信。