1. 项目概述为什么我们需要一个“半片药”提醒器在智能硬件和物联网项目里我们见过太多复杂的、功能繁多的设备。但有时候真正能解决问题的恰恰是那些最简单、最直接的设计。今天我想分享的这个“Half Pill”项目就是一个典型的例子。它的核心功能只有一个在你需要吃药的时候用最不打扰的方式提醒你。这个名字“Half Pill”很有意思它暗示着这个设备就像半片药一样小巧、精准、只做它该做的事——提醒而不是管理你的整个药盒或者健康数据。我自己就有过忘记吃药的经历尤其是那些需要长期服用的维生素或者慢性病药物。手机闹钟太容易被忽略或随手关掉而市面上那些智能药盒要么太贵要么功能过于复杂设置起来让人头疼。这个项目的灵感就是源于这种最朴素的需求一个放在桌面上能通过Wi-Fi自动对时在指定时间点亮一盏小灯或发出轻微蜂鸣的提醒器。它不联网上报数据不连接手机App就做一个安静的、可靠的“时间哨兵”。整个项目的硬件核心是Seeed Studio的XIAO ESP32-C3这是一款集成了Wi-Fi和蓝牙的RISC-V开发板尺寸极小但功能齐全非常适合这种嵌入式物联网应用。软件上我们主要依赖Arduino IDE进行开发利用其丰富的库来驱动硬件、连接网络NTP对时以及保存用户的定时设置EEPROM存储。整个系统设计追求极简和低功耗确保设备可以长时间插电或使用电池工作。2. 核心硬件选型与电路设计思路2.1 为什么是XIAO ESP32-C3选择Seeed Studio XIAO ESP32-C3作为主控是经过多方面权衡的。首先它的尺寸是极致的21.5 x 17.5mm比一枚硬币还小这保证了最终产品可以做得非常迷你不占桌面空间。其次它基于乐鑫ESP32-C3芯片这是一颗单核32位RISC-V处理器主频160MHz性能对于处理网络请求、驱动外设绰绰有余。最重要的是它原生集成了2.4GHz Wi-Fi和蓝牙5.0我们项目中关键的NTP网络对时功能就依赖于此。与经典的ESP8266或ESP32相比ESP32-C3的功耗控制更好在深度睡眠模式下电流可以降到10微安以下。虽然我们这个桌面提醒器大概率会一直插着USB供电但良好的功耗设计意味着未来如果你想把它改成电池供电的便携版本会非常容易。此外XIAO系列引出了全部可用的GPIO并以邮票孔和排针两种方式呈现对于原型制作和小批量生产都非常友好。注意XIAO ESP32-C3的工作电压是3.3V所有GPIO的电平也是3.3V。在连接外部传感器或执行器时务必确认其兼容性避免损坏芯片。2.2 外围电路与执行单元设计一个完整的提醒器除了主控还需要“提醒”的载体。这里我设计了两种可选的方案你可以根据个人喜好和场景选择其一或组合使用。方案一视觉提醒LED指示灯这是最安静、最不打扰的方案。我选用了一个常见的5mm漫射LED颜色上推荐暖白色或淡黄色光线柔和即使在夜晚也不会刺眼。LED的驱动很简单由于XIAO ESP32-C3的GPIO驱动能力有限典型值20mA我们需要串联一个限流电阻。假设LED正向压降为2.0V我们希望工作电流在10mA左右那么限流电阻R (3.3V - 2.0V) / 0.01A 130欧姆。我们可以选择一个标准的150欧姆电阻。将LED正极通过电阻连接到GPIO例如D0负极接地。方案二听觉提醒有源蜂鸣器对于在嘈杂环境或担心错过灯光提示的用户可以增加一个蜂鸣器。务必选择“有源蜂鸣器”因为它内部集成了振荡电路只需要给高电平就会持续发声编程非常简单。连接方式同样是通过一个GPIO例如D1控制但建议在GPIO和蜂鸣器正极之间加一个NPN三极管如S8050来驱动因为蜂鸣器的工作电流可能达到30-50mA超过了GPIO的直接驱动能力。三极管的基极通过一个1k电阻接GPIO集电极接蜂鸣器正极和电源发射极接地蜂鸣器负极接地。电源部分最方便的是通过XIAO ESP32-C3板载的Type-C接口进行5V供电。板载的稳压芯片会将其转换为3.3V供系统使用。如果你想追求极致简洁甚至可以省略外部电路直接利用板载的那颗用户LED连接在D10作为提醒灯但它的亮度和位置可能不如外接的LED理想。3. 软件开发环境搭建与核心库解析3.1 Arduino IDE环境配置要点虽然现在有PlatformIO等更强大的选择但Arduino IDE对于快速原型开发依然非常友好。首先你需要去Arduino官网下载并安装最新版的Arduino IDE。安装完成后打开软件进入“文件”-“首选项”在“附加开发板管理器网址”中填入以下地址https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json这个URL是乐鑫官方的ESP32系列开发板支持包地址里面就包含了我们需要的ESP32-C3。接着打开“工具”-“开发板”-“开发板管理器”搜索“esp32”。你应该能看到由“Espressif Systems”发布的“esp32”平台。点击安装。这个过程可能会比较慢因为需要下载大量的工具链和库文件请保持网络通畅。安装完成后在“工具”-“开发板”列表中你就能找到“XIAO_ESP32C3”这个选项了。实操心得在安装过程中如果遇到下载失败大概率是网络问题。可以尝试将首选项中的链接换成国内镜像源例如https://espressif.github.io/arduino-esp32/package_esp32_index.json。如果还是不行可能需要配置一下系统的网络代理或者使用其他网络环境。3.2 项目依赖的核心库与原理我们这个项目主要依赖三个核心的Arduino库理解它们的工作原理对编程和调试至关重要。1. WiFi库 (WiFi.h)这是ESP32-C3连接无线网络的基础。它提供了扫描、连接、断开等基本操作。在我们的代码里主要使用WiFi.begin(ssid, password)来连接路由器并使用WiFi.status()来检查连接状态。一个稳健的连接流程应该包含超时重试机制比如尝试连接30秒后如果仍未成功则重启设备或进入错误状态。2. NTPClient库这是一个第三方库用于从网络时间协议NTP服务器获取精确的UTC时间。你需要通过库管理器搜索“NTPClient by Fabrice Weinberg”并安装。NTP协议工作在UDP 123端口客户端向服务器发送一个时间请求包服务器回复一个包含时间戳的数据包。这个库帮我们封装了所有这些网络通信和时间解析的细节。 初始化时你需要指定一个NTP服务器地址如pool.ntp.org时区偏移以秒为单位例如东八区是8*3600以及更新间隔。库内部会定期如下午夜自动同步时间保证设备时钟的长期准确性。这是实现精准定时提醒的基石。3. EEPROM库 (EEPROM.h)ESP32-C3的Flash存储器中模拟出了一块EEPROM电可擦可编程只读存储器用于存储断电后需要保存的数据比如我们设置的闹钟时间。需要注意的是ESP32的EEPROM模拟是基于Flash的而Flash有擦写寿命通常10万次。因此我们不能在程序循环中频繁地写入EEPROM。 我们的策略是只在用户通过某种方式比如长按某个按钮修改了闹钟时间后才将新的时间值写入EEPROM。每次设备启动时从EEPROM中读取保存的时间。这样在整个设备生命周期内EEPROM的写入次数可能只有几十上百次远低于其寿命极限。4. 核心功能实现与代码逐行解析4.1 系统初始化与网络连接设备上电后第一步是进行系统初始化核心是连接Wi-Fi和同步网络时间。以下是关键代码段和解析#include WiFi.h #include NTPClient.h #include WiFiUdp.h #include EEPROM.h // 配置你的网络信息 const char* ssid Your_SSID; const char* password Your_PASSWORD; // NTP客户端配置 WiFiUDP ntpUDP; NTPClient timeClient(ntpUDP, pool.ntp.org, 8*3600, 60000); // 东八区60秒更新一次 // 闹钟时间存储地址在EEPROM中 #define ALARM_HOUR_ADDR 0 #define ALARM_MINUTE_ADDR 1 int alarmHour 9; // 默认闹钟时间 9:00 int alarmMinute 0; void setup() { Serial.begin(115200); EEPROM.begin(512); // 初始化EEPROM申请512字节空间 // 1. 从EEPROM读取保存的闹钟时间 alarmHour EEPROM.read(ALARM_HOUR_ADDR); alarmMinute EEPROM.read(ALARM_MINUTE_ADDR); // 首次运行或数据损坏时EEPROM读出的值可能是255需要做校验 if(alarmHour 23 || alarmMinute 59) { alarmHour 9; alarmMinute 0; EEPROM.write(ALARM_HOUR_ADDR, alarmHour); EEPROM.write(ALARM_MINUTE_ADDR, alarmMinute); EEPROM.commit(); // 对EEPROM的写操作必须调用commit()才能生效 } // 2. 连接Wi-Fi Serial.print(Connecting to ); Serial.println(ssid); WiFi.begin(ssid, password); int attempts 0; while (WiFi.status() ! WL_CONNECTED attempts 30) { // 尝试30次约15秒 delay(500); Serial.print(.); attempts; } if (WiFi.status() WL_CONNECTED) { Serial.println(\nWiFi connected!); Serial.print(IP address: ); Serial.println(WiFi.localIP()); // 3. 初始化并强制更新NTP时间 timeClient.begin(); if(timeClient.forceUpdate()) { // forceUpdate会阻塞直到获取成功或超时 Serial.println(NTP time synchronized.); Serial.print(Current UTC8 time: ); Serial.println(timeClient.getFormattedTime()); } else { Serial.println(Failed to get NTP time.); } } else { Serial.println(\nWiFi connection FAILED. Device will run on internal clock.); } // 4. 初始化提醒输出引脚例如D0接LEDD1接蜂鸣器控制 pinMode(D0, OUTPUT); digitalWrite(D0, LOW); // 初始状态关闭 // pinMode(D1, OUTPUT); // 如果使用蜂鸣器则启用 // digitalWrite(D1, LOW); }这段代码完成了系统的启动准备。关键点在于对EEPROM数据的校验防止无效数据导致程序异常。网络连接部分加入了超时机制即使连接失败设备也能依靠内部RTC实时时钟继续运行只是时间可能会有漂移。4.2 时间比对与提醒触发逻辑主循环loop()的核心任务是不断检查当前时间是否到达预设的闹钟时间并控制提醒输出。这里有一个非常重要的细节如何避免在提醒触发后的同一分钟内重复触发// 全局变量用于记录上次触发提醒的日期避免同一天内重复触发 int lastTriggeredDay -1; bool alarmActive false; void loop() { // 每隔一段时间如1秒更新一次NTP时间。非阻塞方式。 timeClient.update(); // 获取当前的小时、分钟和日期从1970年1月1日至今的天数 int currentHour timeClient.getHours(); int currentMinute timeClient.getMinutes(); int currentDay timeClient.getDay(); // NTPClient的getDay()返回星期几我们需要自己计算天数 // 更准确的天数计算从epoch时间换算 unsigned long epochTime timeClient.getEpochTime(); int daysSinceEpoch epochTime / 86400L; // 检查是否到达闹钟时间 if (currentHour alarmHour currentMinute alarmMinute) { // 关键检查今天是否已经触发过 if (lastTriggeredDay ! daysSinceEpoch !alarmActive) { Serial.println(Alarm Triggered!); triggerAlarm(); lastTriggeredDay daysSinceEpoch; // 标记今天已触发 alarmActive true; } } else { // 当时间走过闹钟分钟重置激活状态为下一次触发做准备 alarmActive false; // 可以在这里关闭提醒输出实现提醒持续一段时间后自动停止 // digitalWrite(D0, LOW); } // 这里可以添加其他功能如按钮检测用于设置时间等 delay(1000); // 每秒检查一次 } void triggerAlarm() { // 视觉提醒LED闪烁 for(int i0; i10; i) { // 闪烁10次约持续10秒 digitalWrite(D0, HIGH); delay(500); digitalWrite(D0, LOW); delay(500); } // 听觉提醒蜂鸣器响如果启用 // digitalWrite(D1, HIGH); // delay(5000); // 响5秒 // digitalWrite(D1, LOW); }这个逻辑的核心是lastTriggeredDay变量。它记录了上一次成功触发提醒的“天数”从某个固定起点开始计算。只有当当前时间匹配闹钟时间并且当前天数与记录的天数不同时才会执行触发动作。这就完美解决了在currentMinute alarmMinute这一整分钟内loop()函数每次循环都会触发提醒的问题。提醒只会每天发生一次。4.3 用户交互与闹钟时间设置一个实用的设备必须允许用户修改闹钟时间。由于我们追求极简不配备屏幕因此我设计了一个通过单个按钮进行设置的交互方案。我们需要一个额外的按钮连接到某个GPIO如D2并启用上拉电阻。设置逻辑采用状态机模式待机状态长按按钮3秒进入设置模式LED快速闪烁指示。设置小时进入后LED常亮。每次短按按钮小时数加10-23循环。长按2秒确认并进入下一项。设置分钟LED以较慢频率闪烁。每次短按按钮分钟数加10-59循环。长按2秒确认。保存并退出将设置好的小时和分钟写入EEPROMLED熄灭返回正常模式。#define BUTTON_PIN D2 int setMode 0; // 0:正常1:设小时2:设分钟 unsigned long buttonPressTime 0; bool buttonActive false; void checkButton() { int buttonState digitalRead(BUTTON_PIN); // 按钮按下为LOW假设接上拉 if (buttonState LOW) { if (!buttonActive) { buttonActive true; buttonPressTime millis(); // 记录按下时刻 } } else { if (buttonActive) { buttonActive false; unsigned long pressDuration millis() - buttonPressTime; if (setMode 0) { // 正常模式下长按3秒进入设置 if (pressDuration 3000) { setMode 1; Serial.println(Enter Hour Setting); } } else if (setMode 1) { // 设置小时模式下 if (pressDuration 2000) { // 短按小时加1 alarmHour (alarmHour 1) % 24; Serial.print(Alarm Hour set to: ); Serial.println(alarmHour); } else { // 长按2秒确认小时进入设分钟 setMode 2; Serial.println(Enter Minute Setting); } } else if (setMode 2) { // 设置分钟模式下 if (pressDuration 2000) { // 短按分钟加1 alarmMinute (alarmMinute 1) % 60; Serial.print(Alarm Minute set to: ); Serial.println(alarmMinute); } else { // 长按2秒确认并保存 // 保存到EEPROM EEPROM.write(ALARM_HOUR_ADDR, alarmHour); EEPROM.write(ALARM_MINUTE_ADDR, alarmMinute); EEPROM.commit(); Serial.println(Alarm time saved to EEPROM.); setMode 0; // 返回正常模式 } } } } }在主循环中调用checkButton()函数并根据setMode改变LED的指示状态常亮、快闪、慢闪就能实现一个无需屏幕的直观设置界面。这种交互方式虽然学习成本略高但一旦掌握就非常高效且极大简化了硬件。5. 系统优化与进阶功能探讨5.1 低功耗设计与电池供电方案虽然桌面提醒器通常插电使用但将其改造为便携的电池供电版本会大大扩展其应用场景比如可以放在包里、贴在冰箱上。XIAO ESP32-C3在这方面有天然优势。首先在软件上我们需要让设备在非提醒时段进入深度睡眠。ESP32-C3的深度睡眠模式会关闭CPU、大部分RAM和所有外设仅保留RTC计时器和少量RTC内存功耗可低至10μA左右。我们可以利用其内置的RTC定时器在睡眠前计算到下一个闹钟时间需要多少微秒然后调用esp_deep_sleep_start()函数进入睡眠。到达时间后芯片会重启从头执行setup()函数。这时我们需要在setup()里判断是否是定时唤醒然后快速检查时间如果接近闹钟时间就保持唤醒状态等待触发如果还早就再次计算睡眠时间并进入深度睡眠。注意事项深度睡眠时GPIO状态会丢失。这意味着如果你用GPIO控制一个LED作为状态指示睡眠后LED会熄灭。如果需要保持某个状态可以考虑使用具有锁存功能的电路或者选择在深度睡眠下仍能保持输出的GPIO需要查阅芯片数据手册有些GPIO在深度睡眠下可通过配置保持电平。其次在硬件上需要选择一款合适的电池。考虑到尺寸一块200mAh的锂聚合物电池是理想选择。XIAO ESP32-C3的输入电压范围是3.3V-5.5V所以需要一块3.7V的锂电池并配合一个简单的充电管理电路很多锂电池保护板自带。你可以将电池直接接到板子的“BAT”引脚如果支持或通过一个低压差稳压器LDO接到5V引脚。在深度睡眠模式下假设平均电流为50μA200mAh的电池理论上可以续航200mAh / 0.05mA 4000小时约166天超过5个月。这完全满足实用需求。5.2 提升时间可靠性的策略依赖NTP对时是获取高精度时间的好方法但网络可能不稳定。为了提升系统的鲁棒性我们可以采用“混合时钟”策略。设备内部有一个RTC但它精度不高可能会漂移每天误差几秒甚至几分钟。我们的策略是以NTP时间为权威时间源每次成功获取后不仅更新系统时间还校准内部RTC的漂移系数。具体来说我们可以记录每次NTP同步的时间t_ntp和当时芯片自启动以来的微秒数t_micros。当下一次NTP同步时得到新的t_ntp2和t_micros2。那么实际经过的秒数应该是t_ntp2 - t_ntp1而芯片自己认为经过的秒数是(t_micros2 - t_micros1) / 1e6。这两个值的比值就是内部时钟的漂移率。我们可以用一个简单的比例-积分PI控制器来平滑地调整后续基于微秒数计算时间的系数。这样即使在两次NTP同步之间比如间隔1小时我们通过校准过的内部微秒计时来推算当前时间其误差也会远远小于未经校准的内部RTC。当网络断开时设备依然能依靠这个高精度的“软件RTC”维持数小时甚至数天的时间准确性直到下一次网络连接成功。5.3 外壳设计与用户体验细节硬件项目除了电路和代码外壳和用户体验同样重要。对于Half Pill这样的桌面小设备外壳设计应该遵循几个原则小巧、稳固、不突兀。你可以使用3D打印来制作外壳。设计时要为Type-C接口、LED指示灯和设置按钮预留开口。LED开口处最好加一个半透明的亚克力或塑料片作为柔光罩让光线均匀柔和。底部可以贴上防滑硅胶垫。如果使用蜂鸣器要在外壳上为声音预留出音孔。在用户体验上可以通过LED的闪烁模式传达更多信息缓慢呼吸亮度渐变设备正常运行已连接网络。快速双闪正在连接Wi-Fi或同步NTP时间。常亮进入时间设置模式设置小时。1秒间隔闪烁进入时间设置模式设置分钟。急促闪烁Wi-Fi连接失败或NTP同步失败。这些丰富的状态指示能让用户一眼就了解设备的工作状态无需连接串口查看日志。一个考虑周全的细节设计往往比强大的功能更能提升产品的质感。6. 常见问题排查与调试技巧在实际制作和调试过程中你肯定会遇到各种各样的问题。这里我总结了一些常见坑点和解决方法希望能帮你节省时间。6.1 Wi-Fi连接不稳定或失败这是物联网项目中最常见的问题。现象WiFi.status()始终无法返回WL_CONNECTED串口打印一直显示连接中。排查步骤检查SSID和密码最基础也最容易出错。确保代码中的SSID和密码与路由器设置完全一致注意大小写。检查路由器设置有些路由器会设置“隐藏SSID”或“MAC地址过滤”。如果是隐藏网络需要在WiFi.begin(ssid, password)后额外调用WiFi.setScanMethod(WIFI_ALL_CHANNEL_SCAN)并设置WiFi.hidden(1)。如果启用了MAC过滤需要将ESP32-C3的MAC地址可以通过WiFi.macAddress()获取并打印添加到路由器的白名单中。信号强度问题ESP32-C3的Wi-Fi接收能力在复杂环境中可能较弱。尝试让设备靠近路由器。可以在代码中加入Serial.println(WiFi.RSSI());打印信号强度一般低于-70dBm就可能导致连接不稳定。路由器兼容性问题极少情况下某些老旧路由器或企业级AP的加密方式可能与ESP32不兼容。尝试将路由器的加密方式暂时改为WPA2-PSK (AES)。代码逻辑问题确保你的连接代码有足够的重试时间和重试次数。我提供的示例中用了30次、每次500毫秒的重试总共15秒。对于某些网络可能需要更长时间。6.2 NTP时间获取失败现象Wi-Fi已连接但timeClient.forceUpdate()返回false或timeClient.getFormattedTime()返回空值或错误时间。排查步骤检查NTP服务器地址pool.ntp.org是通用的但在某些网络环境下可能被屏蔽或延迟很高。可以尝试备用服务器如time.google.com、time.windows.com或ntp.aliyun.com阿里云。检查时区设置时区偏移参数单位是秒。东八区是8*3600如果你设成了8那时间会差8秒而不是8小时。防火墙/UDP端口限制NTP使用UDP 123端口。确保你的网络尤其是公司或学校网络没有封锁此端口。可以在电脑上用命令行工具测试ntpdate -q pool.ntp.org。增加超时时间forceUpdate()默认有超时。如果网络延迟高可能超时。你可以修改NTPClient库源码或者尝试多次调用update()而非阻塞的forceUpdate()。验证网络连通性在setup()里Wi-Fi连接成功后可以尝试用WiFiClient去连接一个已知的HTTP网站如http://example.com看是否能成功以排除DNS等问题。6.3 EEPROM数据读取错误或丢失现象设备重启后之前设置的闹钟时间恢复成了默认值。排查步骤忘记调用EEPROM.begin()必须在setup()中调用EEPROM.begin(size)来初始化EEPROM空间。忘记调用EEPROM.commit()调用EEPROM.write()只是修改了内存中的缓存必须调用EEPROM.commit()才会将数据实际写入Flash。确保在每次修改数据后都执行了commit()。地址冲突或越界确保你定义的地址如ALARM_HOUR_ADDRALARM_MINUTE_ADDR没有重叠并且都在EEPROM.begin(size)申请的空间范围内。Flash寿命耗尽虽然概率极低但如果你在循环中疯狂写入EEPROM可能导致该Flash扇区损坏。务必遵循“仅在需要时写入”的原则。首次运行的数据校验如我在代码中所示首次运行时EEPROM里是空白全0xFF即十进制255。必须对读出的值进行有效性校验小时0-23分钟0-59如果无效则使用默认值并写入。6.4 提醒触发逻辑异常现象闹钟不响或者在应该响的时间之外乱响。排查步骤时区问题确认NTP获取的时间已经正确加上了时区偏移。打印出timeClient.getFormattedTime()看是否是当地的正确时间。时间比对逻辑缺陷仔细检查if (currentHour alarmHour currentMinute alarmMinute)这行代码。确保currentHour和currentMinute是24小时制。同时务必使用我前面提到的lastTriggeredDay防重触发机制否则会在一分钟内触发几十次。系统延时导致错过loop()函数中如果有一些耗时很长的操作比如长时间的delay()可能会导致代码在检查时间时已经跳过了闹钟的那一分钟。确保主循环尽可能快非必要的长时间延迟用millis()进行非阻塞管理。引脚配置错误检查你连接LED或蜂鸣器的GPIO引脚号是否正确并且在setup()中正确设置为OUTPUT模式。调试时最强大的工具就是串口打印。在各个关键节点如连接Wi-Fi成功/失败、获取NTP时间、读取EEPROM、触发闹钟等添加详细的Serial.println()语句输出相关变量值可以让你清晰地看到程序的执行流程和状态快速定位问题所在。