Repository navigation
Releases
uart2llm v0.2.0-preview.2 · Agent + ESP32 完整离线包
v0.2.0-preview.2 · Windows Agent + ESP32 完整离线包
首次使用推荐下载 Assets 中的 uart2llm-windows-x64-offline.zip。 解压即可得到 Agent EXE、两种 ESP32-S3 固件、配对和烧录工具、本文说明与校验清单。不需要下载 Source code,不需要克隆仓库,也不需要安装开发环境。
已有配对设备、只更新 Agent 时,可仅下载 uart2llm-agent-windows-x64.exe。
日常使用只需下载 uart2llm-agent-windows-x64.exe,放在固定目录并双击。Agent 自动启动后台和托盘,打开本地管理页面;重复启动会使用现有后台。Web 页面已嵌入 EXE,无需安装 Python、Node、Go 或 wxWidgets,也无需联网下载运行依赖。
首次使用仍需准备并配对 ESP32-S3。管理默认 http://localhost:8766,模型 API 默认 http://localhost:8765/v1。配置上游地址、key 和设备 Wi-Fi 后,在 IDE 中填写本地 API 地址与本地 token。
下载项
| 文件 | 用途 |
|---|---|
uart2llm-windows-x64-offline.zip |
推荐:一次下载所有运行与首次设备准备文件 |
uart2llm-agent-windows-x64.exe |
日常运行的单文件 Agent,含 Web、托盘和 CLI |
uart2llm-device-tools-windows-x64.zip |
首次烧录/配对所需的独立工具;包含运行依赖与对应源码 |
uart2llm-firmware-uart.zip |
GPIO UART 固件;默认 UART1 TX17/RX18,共地 |
uart2llm-firmware-usb-validation.zip |
原生 USB Serial/JTAG 验证固件,与 GPIO UART 构建不同 |
LICENSES.txt |
Agent 第三方通知;EXE 的 licenses 命令也可读取 |
SHA256SUMS |
所有发布附件的 SHA-256 |
设备要求 ESP32-S3、16 MiB Flash、8 MiB Octal PSRAM。首次烧录时选择匹配连接方式的一种固件,并保留该 ZIP 的目录结构;不要混用两种构建的分区与应用。串口驱动取决于硬件,工具包不包含未知 USB-UART 转换器驱动。
完整离线包的目录
uart2llm/
uart2llm-agent-windows-x64.exe
README.md
LICENSES.txt
SHA256SUMS
device-tools/
tools/esptool.exe
tools/provision-device.exe
licenses/ + source/ 工具许可与对应源码,不需要自行编译
firmware/
uart/ 外接 USB-UART 转换器使用
usb-validation/ 开发板原生 USB Serial/JTAG 使用
首次设备准备(不需要源码)
- 解压完整离线包,进入
uart2llm文件夹。在该文件夹打开 PowerShell。 - 连接开发板,确认烧录口(设备管理器中查看,下面以
COM4为例)。烧录前停止占用串口的 Agent。 - 选择固件目录:外接 USB-UART 使用
uart;开发板原生 USB Serial/JTAG 使用usb-validation。USB 验证固件保持预览性质。 - 执行下面的命令,生成本设备专属配对文件并烧录。首次烧录或重新配对使用;已经配对的设备更新前请先备份现有配对文件。
$flashPort = 'COM4' # 改为本机实际烧录口
$firmwareDir = '.\firmware\uart' # 原生 USB 改为 .\firmware\usb-validation
$privateDir = Join-Path $env:USERPROFILE 'uart2llm-device-private'
.\device-tools\tools\provision-device.exe --output $privateDir
if ($LASTEXITCODE -ne 0) { throw '配对文件生成失败;请检查输出目录(不会覆盖已有配对文件)' }
.\device-tools\tools\esptool.exe --chip esp32s3 --port $flashPort write-flash --flash-mode dio --flash-size 16MB --flash-freq 80m 0x0 "$firmwareDir/bootloader/bootloader.bin" 0x8000 "$firmwareDir/partition_table/partition-table.bin" 0xf000 "$firmwareDir/ota_data_initial.bin" 0x20000 "$firmwareDir/uart2llm.bin" 0x12000 "$privateDir/pairing.bin"
if ($LASTEXITCODE -ne 0) { throw '烧录失败,请检查端口和接线' }- 双击
uart2llm-agent-windows-x64.exe,在管理页面选择业务串口并导入刚生成的pairing.json。GPIO UART 使用外接转换器的业务口;原生 USB 使用开发板对应端口。 - 在管理页面配置 Wi-Fi、上游 Base URL 与上游 API key。应用 Wi-Fi 后检查取得 IP,并在确认窗口内确认。
- IDE 或客户端填写 Base URL
http://localhost:8765/v1,API key 使用下面命令显示的本地 token。该 token 不是上游密钥。
.\uart2llm-agent-windows-x64.exe token api设备与工具需要的运行文件已经包含在包内;ESP32 的 Wi-Fi 必须能访问所配置的上游。第三方 USB-UART 硬件可能需要厂商驱动,请提前准备匹配硬件的离线驱动。配对文件不会预置在发布包内,每台设备在本地生成,不应分享。
选择单独下载附件时
把设备工具和选定固件分别解压。以下示例在固件解压目录执行,将工具路径和 COMx 替换为实际值:
C:/uart2llm-tools/tools/provision-device.exe --output "$env:USERPROFILE/uart2llm-device-private"
C:/uart2llm-tools/tools/esptool.exe --chip esp32s3 --port COMx write-flash --flash-mode dio --flash-size 16MB --flash-freq 80m 0x0 bootloader/bootloader.bin 0x8000 partition_table/partition-table.bin 0xf000 ota_data_initial.bin 0x20000 uart2llm.bin 0x12000 "$env:USERPROFILE/uart2llm-device-private/pairing.bin"随后双击 Agent,在页面中选择业务串口并导入 pairing.json。GPIO UART 使用外接转换器的业务口;USB 验证版使用开发板原生 USB 口。配对文件只归自己的设备使用,不公开分享。
命令行和退出
./uart2llm-agent-windows-x64.exe version
./uart2llm-agent-windows-x64.exe token api
./uart2llm-agent-windows-x64.exe status
./uart2llm-agent-windows-x64.exe stop关闭浏览器不停止代理;从托盘退出或使用 stop。默认配置在 %APPDATA%/uart2llm,凭据归当前 Windows 用户。此单文件不创建系统服务、虚拟网卡或系统路由。升级前先退出旧 Agent,再替换 EXE。
当前发布边界
这是 pre-release,不是全功能验收完成的稳定版。当前支持四类 OpenAI 兼容 API;Responses API 仍是后续计划。Harness 独立联网搜索、网页读取和完整离线/24 小时验收尚未完成;详情见仓库验证文档。
GitHub Actions 编译与自动化测试不能替代目标板接线、掉电与持续负载验证。EXE 当前未作 Authenticode 代码签名;安全软件处理取决于设备策略,不承诺免告警。