marax_timer 的安装和配置教程

1. 项目基础介绍

marax_timer 项目是一个为 Lelit MaraX 咖啡机设计的计时器项目。它能够记录咖啡机振动泵的工作时间，并且显示在一个 OLED 屏幕上。此项目是基于 ESP8266 NodeMCU 开发板，适用于任何带有振动泵的咖啡机。主要编程语言是 C++。

2. 项目使用的关键技术和框架

本项目使用以下关键技术：

• ESP8266 NodeMCU：作为项目的核心控制器。
• 0.96" OLED 显示屏：用于显示计时信息。
• reed sensor：检测振动泵的启动和停止。
• Adafruit SSD1306 库：用于驱动 OLED 显示屏。
• Adafruit GFX 库：提供绘图功能。
• Timer 库：用于计时功能。

3. 安装和配置准备工作

在开始安装和配置之前，请确保以下准备工作已完成：

• 一台 ESP8266 NodeMCU 开发板。
• 一个 0.96" OLED 显示屏。
• 一个 reed sensor（磁簧开关）。
• 相应的连接线和必要的 3D 打印外壳（可选）。
• 安装有 Arduino IDE 的计算机，用于编程 NodeMCU。

安装步骤

1. 安装 Arduino IDE

   • 访问 Arduino 官方网站下载并安装 Arduino IDE。
   • 在 Arduino IDE 中安装 ESP8266 开发板支持。这可以通过“文件”->“首选项”->“板管理器”中搜索并安装“ESP8266 Community”来完成。

2. 连接 NodeMCU 开发板

   • 使用 USB 线将 NodeMCU 连接到计算机。
   • 在 Arduino IDE 中选择正确的端口和板型（NodeMCU）。

3. 安装所需的库

   • 在 Arduino IDE 中，通过“管理库”搜索并安装以下库：
     • Adafruit_BusIO
     • Adafruit_GFX_Library
     • Adafruit_SSD1306
     • Timer

4. 下载项目代码

   • 克隆或下载 marax_timer 项目代码到本地计算机。

5. 配置 OLED 显示屏

   • 根据你的 OLED 屏幕版本，正确连接 OLED 屏幕的引脚到 NodeMCU 开发板。
   • 在 timer.ino 文件中配置 OLED 屏幕的地址和引脚。

6. 配置 reed sensor

   • 将 reed sensor 连接到 NodeMCU 的 D7 引脚和地（GND）。
   • 根据实际使用的传感器类型，在 timer.ino 文件中适当配置 reedOpenSensor 变量。

7. 上传代码到 NodeMCU

   • 打开 timer.ino 文件。
   • 在 Arduino IDE 中编译并上传代码到 NodeMCU 开发板。

8. 测试

   • 上电并激活振动泵，OLED 屏幕应该开始显示计时信息。
   • 如果屏幕立即开始计时，即使咖啡机关闭，则需要更换 reed sensor 或者在代码中更改正常开/正常闭的设置。

完成以上步骤后，marax_timer 应该可以正常运行，为您的咖啡机提供计时功能。