2026-012 便携式自动冷萃咖啡机

一套便携式自动冷萃咖啡机原型,采用上下双舱结构和两路独立泵,通过 ESP32-S3 控制咖啡液在上下舱之间循环,并配套 Windows 上位机完成设备联调、手动控制、循环配方与运行记录。

便携式自动冷萃咖啡机渲染图

项目概览

项目覆盖从产品结构到软硬件联调的完整原型资料:

  • 机械结构:上下舱体、中部电气仓、泵、电池、管路及整机装配模型。
  • 电子硬件:ESP32-S3 主控、电源与继电器驱动原理图、PCB 和接线资料。
  • 嵌入式固件:基于 Arduino / PlatformIO,实现安全初始化、双泵互锁和串口控制。
  • Windows 上位机:基于 .NET 8 / WPF,支持模拟与实机模式、手动上液/降液、固定循环、命名配方和历史记录。
  • 项目交付:产品渲染图、汇报文件、用户手册、串口协议及工程设计源文件。

工作原理

机器由上舱体、电气仓和下舱体组成。两只泵分别负责两个方向的液体输送:

上液:下舱体 -- GPIO15 / 泵 1 --> 上舱体
降液:上舱体 -- GPIO16 / 泵 2 --> 下舱体

上位机按照“上液 -> 停留 -> 降液 -> 停留”的顺序执行可配置循环。当前原型没有液位、温度或压力传感器,运行过程以人工标定的时间为依据,界面中的液位为模拟或估算值。

当前状态

模块 状态 主要内容
机械结构 已完成原型设计 Solid Edge / SolidWorks 模型、整机装配和 KeyShot 渲染
电路设计 已完成原型资料 Altium Designer 原理图、PCB、元件库和接线依据
ESP32 固件 已完成联调版本 115200 波特率 JSON Lines 协议、状态上报和双泵互锁
Windows 上位机 v0.4.0-M4 模拟/设备控制、循环编排、配方、历史记录和故障显示
文档 已整理 汇报文件、用户手册、产品规划、串口协议和引脚定义

本仓库是工程原型资料,不是可直接量产的定版方案。接线或上电前请先阅读“安全与硬件确认”章节。

快速开始

1. 运行 Windows 上位机

环境要求:Windows 10/11、.NET 8 SDK。

cd "b-Code-上位机程序"
dotnet restore APPShell.sln
dotnet run --project src/App/App.csproj

程序可在没有硬件时使用模拟模式。连接 ESP32 时,在右侧控制面板刷新并选择对应串口;默认通讯参数为 115200 / UTF-8 / JSON Lines。详细操作见上位机用户手册。

2. 编译并烧录 ESP32 固件

环境要求:VS Code + PlatformIO,目标板为 ESP32-S3 DevKitC-1 兼容板。

cd "b-Code-引脚定义和esp32程序/coffee_cold_brew"
pio run
pio run --target upload
pio device monitor --baud 115200

固件启动后默认关闭两路继电器,并周期性输出状态快照。实际烧录前请核对 platformio.ini 中的开发板环境以及引脚定义表。

核心控制定义

功能 GPIO 电平 说明
泵 1 继电器 / 上液 15 HIGH 有效 下舱体向上舱体输送
泵 2 继电器 / 降液 16 HIGH 有效 上舱体向下舱体输送
泵 1 PWM 1 待标定 启动时保持 0%
泵 2 PWM 2 待标定 启动时保持 0%
模式开关 4 输入 外部 10k 上拉
电池电压采样 5 ADC 100k / 47k 分压

GPIO15 与 GPIO16 必须保持互斥。方向切换时应先将两路关闭,经过安全死区后再开启目标输出;停机时先将 PWM 降至 0%,再释放继电器。

目录结构

目录 内容 推荐打开方式
b-Altium-Designer 原理图、PCB、元件库及设计历史 Altium Designer
b-Code-上位机程序 Windows 上位机、说明文档和串口协议 Visual Studio 2022 / .NET 8 SDK
b-Code-引脚定义和esp32程序 ESP32-S3 固件、引脚表和联调资料 VS Code + PlatformIO
b-Module-SE 整机及零部件结构模型 Solid Edge
b-Module-SW SolidWorks 装配与零件文件 SolidWorks
b-Module-GE 通用件和外购件三维模型 对应 CAD 软件
b-KeyShot 渲染工程目录 KeyShot
b-Picture 产品渲染、原理图、PCB 图和过程图片 图片查看器
b-Office 项目汇报文件 PowerPoint
b-References 参考资料 对应文档工具
Unused 历史方案及未采用资料 仅供追溯

关键文档

安全与硬件确认

  • 上电、复位、断连和程序退出时,两路泵输出都应回到关闭状态;上位机的软件停止不能替代硬件保护。
  • 当前原理图中的继电器驱动需在硬件定版前复核 NPN 基极限流电阻及线圈续流二极管的实际网络。
  • PWM 频率、极性、最小启动占空比和换向死区需要结合实装泵及驱动电路标定。
  • 电池 ADC 换算、板级压降及满电阈值需要通过实测校准,不能直接使用理论值作为保护阈值。
  • 未连接到原理图的 GPIO 视为保留资源;新增功能应同步更新原理图、引脚表和固件命名。

数据位置

上位机的命名配方和运行历史默认保存在:

%AppData%\ColdBrewMachine\data\brew-m4.json

应用最多保留 500 条历史记录,界面显示最近 80 条。重新安装或迁移电脑前,请按需备份该文件。

项目信息

  • 项目编号:2026-012
  • 当前上位机版本:0.4.0-M4
  • 项目类型:便携式自动冷萃咖啡机工程原型
  • 原模板作者:Pinavia(2025)

保留内容

logo与作者

  • 作者:pinavia
  • logo

学习许可与权利保留

  • 本项目允许个人、学校和研究者进行非商业性的学习、研究和引用。
  • 未经著作权人书面许可,不得将项目内容用于商业开发、产品制造、商业服务、商业宣传、投标交付、毕业设计成品交付或再授权。
  • 不得删除作者、来源、版本历史和第三方许可证声明,不得将本项目或其衍生成果宣称为与作者无关的原创项目。
  • 软件源码适用 PolyForm Noncommercial 1.0.0;机械模型、PCB、原理图、图片、文档、Unity 工程和其他非软件资料适用 CC BY-NC-ND 4.0。
  • SE、SW、STEP/STP 及其他三维模型仅允许个人或学校进行非商业学习、评审和研究;未经著作权人书面许可,不得用于加工、打样、制造、销售、量产、投标、产品交付、商业宣传、改作或再授权。
  • 第三方组件、模板、元件库、外购件模型和工具仍受其原始许可证约束;本声明不扩大作者对第三方内容的权利。

商业使用、产品化、公司内部长期使用、转让或排他性授权需另行取得著作权人的书面许可。

← 返回项目库 GitHub 仓库 ↗