AI Desk Phone

AI Desk Phone 是一个把老式座机改造成 Windows 语音通话控制器的开源项目。

项目分成两条独立链路：

• 控制链路：ESP32-C3 读取座机摘挂机/按压机构，通过 BLE HID 键盘 AIDeskPhoneKB 向 Windows 发送快捷键。
• 音频链路：CSR8645 蓝牙音频模块连接听筒麦克风和喇叭，作为 Windows 蓝牙耳机输入/输出使用。

本项目只保留一个调试入口：本地网页控制台。串口日志、板子状态、ADC 曲线、动作日志、阈值调整和快捷键配置都在控制台里完成。

硬件边界

• CSR8645 蓝牙音频模块需要 3.7V 供电。不要用 ESP32-C3 的 3.3V 给它供电，也不要把 5V 直接接到 BAT+。
• RJ9/R9/4P4C 听筒线是四芯线，通常拆成一对喇叭线和一对麦克风线。线序以转接板标注、万用表通断和录音/播放检查为准。
• 当前方案不接电话外线。电话外线可能有振铃高压和未知线路状态。

仓库结构

README.md                         项目说明和快速开始
requirements.txt                  Python 依赖
config/ai_desk_phone_console.json 控制台默认配置
firmware/esp32c3_ble_gpio/        ESP32-C3 PlatformIO 固件
tools/ai_desk_phone_console.py    本地网页控制台和串口桥
docs/BUILD_MANUAL.md              制作与维护手册
docs/electronics/                 硬件照片和照片索引

快速开始

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\platformio.exe run -d firmware\esp32c3_ble_gpio -t upload
.\.venv\Scripts\python.exe tools\ai_desk_phone_console.py --port COM3 --web-port 8765

打开：

http://127.0.0.1:8765

如果 ESP32-C3 不在 COM3，把命令中的 COM3 换成设备管理器里看到的串口号。

使用方式

1. 打开目标 Windows 软件，确认它用于语音输入、接听、挂断或静音的快捷键。
2. 在控制台中观察摘挂机/按压动作对应的 ADC 变化。
3. 调整阈值，让真实电话动作能稳定触发按下和释放状态。
4. 把目标软件的快捷键填入控制台的按下/释放动作。
5. 保存配置并配对 AIDeskPhoneKB。
6. 用电话动作验证目标软件是否按预期响应。

完整制作顺序见 制作与维护手册。

发布前检查

.\.venv\Scripts\python.exe -m py_compile tools\ai_desk_phone_console.py
.\.venv\Scripts\platformio.exe run -d firmware\esp32c3_ble_gpio

许可证

当前还没有选择开源许可证。正式公开前请先添加 LICENSE 文件。