第17周成员操作平台
支持 Windows 10/11 64 位、ESP32-C3 / CH343 同型号开发板,4 MB Flash、UART TX21/RX20。保留原项目的绿色界面与六步真实加密流程。日常收发不需安装 Python、VS Code、ESP-IDF,也不用执行 pip。
首次使用
1. 完整解压运行 ZIP 到可写目录,双击“启动平台.cmd”。不要在压缩包预览窗口里运行。启动成功才打开本机网页。重复启动复用同一份平台;另一份平台占用14605时提示关闭对应平台,不抢占。
2. 插入开发板,在“首次配置”刷新并选择 CH343。多个串口必须自己选择。没有匹配串口时检查 USB 数据线与设备管理器;已能识别时跳过驱动安装。需要驱动时先阅读 drivers/驱动来源与安装.md;本候选包暂未取得官方安装器,可从其中的 WCH 官方页面手动下载。平台不会自动安装或提权。
3. 点击“检查设备”,审阅范围后勾选确认并执行。旧固件提示“待更新固件”。点击“准备烧录通用固件”,核对串口、固定镜像 SHA-256、4 MB 参数和复位范围,再确认执行一次烧录。最多120秒、不自动重试、不擦除 NVS。工具成功后仍需再次“检查设备”,并不等于通信成功。
4. 手机开启2.4G、WPA2个人热点,让电脑连接它。在平台填写热点名称及密码,准备并明确执行热点配置。名称1–32个 UTF-8 字节,中文和空格按原样保留;密码8–63个可打印 ASCII 字符(含空格)。USB 配网不要求板端事先入网,最长60秒。不支持第一版 WPA3-only、企业认证、开放热点或5G-only。
5. 点击“准备 USB 配对”并确认,为这块板写入独立两方向 AES 密钥。电脑用当前 Windows 用户 DPAPI 保存;平台仅显示 SHA-256 指纹,不导出密钥。配对期间保持 USB 连接。超时后先检查设备,可恢复匹配的加密草稿;不要盲目重复配对。更换热点无需换密钥或重新编译。
6. 在会话设置里选择电脑当前热点网卡的 IPv4(输入框提供候选),准备范围并明确开启会话。输入消息,等待“原文一致”和“开发板最终确认”。只有完整链路才显示“通信验证通过”。导出 CSV 并结束会话。
日常使用与记录
启动平台 → 连接自己的热点 → 选择串口与电脑 IP → 准备、确认并开启会话 → 发送。IP 变化后重新选择;重新配置热点时先断开设备会话。
消息来源目前为网页手动输入。板端接收依据由加密发送反馈或通过认证的返回报文确认,串口写入成功仅表示已提交。开发板执行 AES-GCM 加密;Wi-Fi 密文是加密后的内容,认证标签用于校验密文及附加数据。电脑先认证,再解密并严格按 UTF-8 字节比对原文。空格、换行和中文都参与比对;认证失败不显示明文,原文不一致不发送成功 ACK。最后的 ACK 是电脑用另一方向密钥加密、由板端验证的独立步骤。
点击消息表中的记录可查看对应过程。“历史实验”查看本电脑保存的会话。刷新、选择记录不会重发或打开串口。记录增加设备身份、固件版本、密钥指纹与比对结果;CSV和网页采用同一判断。CSV 对公式开头内容做电子表格防护,原始消息字节在 JSON/payload_hex 中保留。旧字段缺失时显示“未记录”,不编造成功。
统一入口与更新
统一入口:ESP32-C3 成员平台下载。下载 v3 运行包或源码包,自己的USB/热点通信由本机平台执行,实验记录留在本机。v3网页顶部显示成员平台版本,首次配置与会话使用同一设备选择,刷新/设备身份变化会作废旧确认。
v3已配置 HTTPS 清单 https://esp32-member-platform.pages.dev/latest.json 。本机“检查平台更新”→有新版本时“下载并校验更新”→结束设备会话→明确“关闭平台并应用更新”。新版本独立目录启动,旧程序和data保留,原入口转接到新版本;不会自动烧录或重新配对。
旧v1/v2的GitHub渠道匿名404,不能当可用更新入口。第一次使用下载完整v3即可。已有旧版data时先关闭旧平台并备份完整目录。技术人员将已核对SHA/CRC的新包放在旧目录data/updates的独立子目录内,再使用新入口start_member.py的--apply-from与已退出旧服务的--wait-pid执行迁移;两目录均须同一Windows用户且来源经过校验。目录外的新包、正在运行的旧服务或已有内容的新data会拒绝迁移。不要改旧包根目录受校验文件,不把DPAPI文件直接转给其他用户。旧Python默认下载标识可能被Cloudflare1010拦截,v3使用明确平台标识;更新失败不能忽略校验。
本站只分发软件和说明。线上/本机软件/真实设备验收以 validation.html 最新状态分别判断。
数据备份与安全边界
关闭设备会话及平台后备份完整目录,至少保留 data。DPAPI 配对只能由同一 Windows 用户解密,复制到其他电脑/用户不等于配对迁移。数据缺失可恢复该用户的备份或明确重新配对;重新配对会更换板端密钥,旧电脑配对将失效。
USB 配对需要可信数据线和实体设备,板端 NVS 存储密钥;本版本没有声称安全启动、Flash加密或生产级密钥保护。成员标识17不降级到旧实验标识9。不要擦除 NVS 后继续沿用相同密钥(会破坏 nonce 单调性),需要明确重新配对。提供的板端固件仅供本项目功能实验。
软件打包通过不等于各成员实机复现通过。每位成员需在自己的电脑、热点和板上完成一次完整网页收发并导出 CSV;本轮制作没有替成员烧录、复位或发送真实消息。