1. 项目概述与核心价值如果你和我一样是个重度Notion用户每天的任务、项目、笔记都泡在里面那你肯定也经历过这种时刻盯着屏幕上那条待办事项鼠标移过去点击那个小小的复选框完成。动作很轻但总觉得少了点什么。数字世界的任务完成似乎就缺了那一声清脆的“啪嗒”和一次实实在在的物理反馈。这个念头就是我动手做这个“TaskAPI”硬件任务管理装置的起点。简单说我想把Notion里那些虚拟的待办事项变成一个看得见、摸得着甚至能“一拳搞定”的实体玩意儿。这个项目的核心就是用Raspberry Pi树莓派作为大脑去调用Notion的API读取你的任务数据库然后把每条任务显示在一块小液晶屏上。你通过实体按钮上下浏览找到想完成的那条对准装置上的一个大按钮狠狠砸下去——伴随着一个物理开关的“咔哒”声Notion里对应的任务状态会自动被标记为“完成”同时装置上的一个LED灯也会亮起给你一个即时的、多感官的确认。它把软件API的灵活性与硬件交互的实在感结合了起来算是一次典型的“物理化数字信息”的物联网IoT实践。为什么选这套组合拳首先Notion API足够强大和稳定提供了对数据库增删改查的完整能力而且是基于标准的HTTP和JSON用Python操作起来非常顺手。其次Raspberry Pi Zero W这款微控制器简直是为此类项目而生的它身材小巧、功耗低自带Wi-FiGPIO通用输入输出引脚丰富价格还亲民完美承担了连接云端API和控制本地硬件的桥梁角色。最后LCD屏、按钮、LED这些外围元件都是电子爱好者手边的常客组合起来技术门槛可控但最终呈现的效果却足够有趣和有用。这个装置适合谁呢如果你是喜欢捣鼓硬件的软件开发者想找个项目练手API调用和硬件控制或者你是创客爱好者想给自己的工作流增加点仪式感亦或是你单纯觉得在屏幕上点复选框太无聊想给完成任务来点更带劲的反馈——那么这个项目会是一个很好的起点。接下来我会把从电路设计、代码编写到3D打印外壳、组装调试的全过程连同我踩过的坑和总结的经验毫无保留地拆解给你看。2. 整体系统架构与设计思路2.1 硬件选型与功能映射整个系统的硬件核心是一块Raspberry Pi Zero W。选择它而不是功能更全的3B/4B型号主要基于几点考量一是本项目对计算性能要求不高主要是网络请求和GPIO控制Zero W的CPU足够胜任二是其超小的体积和极低的功耗非常适合嵌入到最终成品那个紧凑的3D打印外壳里三是它内置的Wi-Fi模块省去了外接USB网卡的麻烦让设备可以独立联网与Notion API通信。外围硬件围绕“显示、选择、确认、反馈”这四个核心交互环节来配置显示单元一块1602 LCD液晶屏16字符×2行通过I2C接口模块驱动。选择I2C版本而非直接驱动是因为它只需要4根线VCC, GND, SDA, SCL就能工作极大节省了宝贵的GPIO引脚也简化了布线。屏幕负责实时显示从Notion获取的任务标题。选择单元两个轻触开关Push Button分别定义为“上翻”和“下翻”。用于在任务列表中导航。选择轻触开关是因为它成本低、体积小、手感明确且与GPIO的输入检测逻辑匹配简单。确认单元一个大型的瞬时按钮内部连接的是一个微动开关End of career即行程开关。这是整个装置的“灵魂”。用户用力按压这个大型按钮触发内部的微动开关向树莓派发送一个“任务完成”的信号。选用大型按钮并配合泡沫和织物包裹是为了创造一种独特的、带有宣泄感的按压体验这是鼠标点击无法比拟的。反馈单元一组LED指示灯。最初的设计是每个任务对应一个LED但考虑到硬件复杂度和成本在简化版本中可以只用一个LED来指示“当前选中任务”的状态或者用不同颜色的LED表示“待办”和“已完成”。在我的实现里我选择用两个LED一个绿色常亮表示系统运行正常一个红色当大按钮被按下任务标记成功后快速闪烁一下作为完成反馈。注意GPIO引脚分配需要提前规划好避免冲突。例如I2C接口固定使用GPIO2 (SDA) 和 GPIO3 (SCL)。按钮和LED可以分配其他空闲的GPIO如GPIO17, GPIO27等。务必在代码中与物理连接保持一致并做好记录。2.2 软件逻辑与数据流设计软件部分的核心是运行在Raspberry Pi上的一个Python脚本。它的工作流是一个清晰的循环初始化与认证脚本启动后首先加载Notion API的密钥Token和目标数据库的ID。这些是敏感信息绝对不要硬编码在代码里然后上传到公开仓库。我的做法是创建一个单独的config.py文件在里面定义这些变量并在.gitignore中忽略这个文件。数据获取与解析通过HTTP GET请求调用Notion API查询指定的数据库。Notion返回的是结构复杂的JSON数据。我们需要编写解析函数从中提取出任务的“标题”Title、“状态”Status等我们关心的属性。这里的关键是理解Notion API返回的数据结构特别是“properties”对象里各个属性的嵌套方式。本地状态管理将获取到的任务列表缓存在内存中并维护一个“当前选中任务索引”。这个索引会随着用户按下“上/下”翻页按钮而改变。显示刷新根据当前选中任务的索引将对应任务的标题可能需要进行截断以适应16字显示刷新到LCD屏幕上。输入监听事件驱动这是一个持续运行的循环。监听两个导航按钮如果检测到按下就更新“当前选中任务索引”并触发“显示刷新”。监听大按钮完成按钮如果检测到按下就获取当前选中任务在Notion中的唯一ID然后构造一个HTTP PATCH请求调用Notion API更新该条目的“状态”属性为“完成”。反馈执行在API更新请求发送后根据返回结果成功或失败控制LED做出相应的指示如成功则闪烁绿灯失败则闪烁红灯。这个循环确保了硬件状态、本地数据和云端数据三者之间的同步。整个设计的巧妙之处在于它用极低的硬件成本按钮、LED和直观的物理交互封装了对复杂云服务Notion API的调用用户体验非常直接。3. 核心硬件搭建与电路详解3.1 元器件清单与采购要点除了项目正文中提到的这里我补充一份更清晰、带有替代选项和注意事项的清单品类具体型号/规格数量说明与备选主控Raspberry Pi Zero W1务必确认是带无线功能的“W”版本。也可用Pi 3A/4但外壳需调整。显示1602 LCD with I2C模块1注意是“I2C接口”的版本通常带一个蓝色背板。直接驱动1602需要更多IO不推荐。输入6x6mm 轻触开关2用于上下导航。质量要好手感干脆避免粘连。输入大型瞬动按钮含内部微动开关1这是体验核心。可以买现成的巨型按钮也可以用普通按钮DIY加大帽。反馈5mm LED红、绿各1颜色自定。注意工作电压需串联限流电阻通常220Ω-1kΩ。限流电阻220Ω 或 330Ω 电阻2-4用于LED。阻值越大LED越暗。连接母对母、公对母杜邦线若干建议多备一些用于连接Pi GPIO与面包板或PCB。电源Micro USB 电源5V/2A1给树莓派供电。质量要可靠供电不足会导致系统不稳定。存储Micro SD卡16GB Class101用于安装树莓派系统。品牌建议SanDisk, Samsung。结构万能板洞洞板、3D打印外壳1套初期验证用面包板最终成品建议焊接在洞洞板上或自制PCB。其他泡沫板、织物、导线、焊锡适量用于制作大按钮的缓冲和外观。实操心得采购时特别是微动开关和轻触开关可以多买几个备用。这类机械元件在频繁测试中容易损坏。LED和电阻包通常很便宜可以买一套多种值的方便调试。3.2 电路连接与焊接实践电路原理并不复杂核心是树莓派GPIO与各元器件的正确连接。下图是连接的示意表以物理引脚编号为例代码中需使用BCM编号如GPIO17树莓派 GPIO (BCM编号)连接至说明3.3V(Pin 1)LCD I2C模块 VCC, 按钮一端为模块和按钮上拉供电。GND(Pin 6, 9等)LCD I2C模块 GND, LED阴极, 按钮另一端共地。GPIO2 (SDA)(Pin 3)LCD I2C模块 SDAI2C数据线。GPIO3 (SCL)(Pin 5)LCD I2C模块 SCLI2C时钟线。GPIO17(Pin 11)导航“上”按钮信号线配置为输入内部上拉。GPIO27(Pin 13)导航“下”按钮信号线配置为输入内部上拉。GPIO22(Pin 15)大按钮微动开关信号线配置为输入内部上拉。GPIO23(Pin 16)绿色LED阳极经220Ω电阻配置为输出控制状态灯。GPIO24(Pin 18)红色LED阳极经220Ω电阻配置为输出控制完成反馈。连接步骤与注意事项I2C LCD连接这是最简单的部分。将模块的VCC、GND、SDA、SCL分别接到树莓派的3.3V、GND、GPIO2、GPIO3。接好后在树莓派终端输入sudo i2cdetect -y 1如果能看到一个地址通常是0x27或0x3F就说明连接成功。按钮连接所有按钮都接成“上拉输入”模式。即按钮一脚接GPIO另一脚接GND。在代码中将该GPIO配置为输入并启用内部上拉电阻。这样按钮未按下时GPIO读到的是高电平1按下时引脚被拉到GND读到低电平0。这种接法可以省去外部上拉电阻。LED连接切记一定要串联限流电阻直接连接GPIO到LED会因电流过大烧毁LED或损坏GPIO口。接法树莓派GPIO - 电阻220Ω - LED阳极 - LED阴极 - 树莓派GND。焊接建议如果使用洞洞板做最终电路建议先布局再焊接。将树莓派排针延长到洞洞板上然后以排针为中心连接各元件。焊接时保持烙铁头干净时间不宜过长避免烫坏元件或焊盘。完成后务必用万用表通断档检查是否有短路或虚焊。踩坑记录我第一次测试时按钮响应不灵有时会连续触发多次。原因是机械按钮存在“抖动”Bounce即按下瞬间会产生一系列快速通断的脉冲。解决方法是在代码中做“消抖”Debounce可以简单地用time.sleep(0.05)延时或者检测到下降沿后等待一小段时间再读取状态。4. 软件环境配置与核心代码解析4.1 系统准备与依赖安装首先你需要一张安装了Raspberry Pi OS以前叫Raspbian的SD卡。建议使用官方的Raspberry Pi Imager工具来烧录选择“Raspberry Pi OS (Legacy, 32-bit)”这个轻量版即可它带有桌面环境但比较节省资源。系统启动并完成基础设置语言、时区、联网等后第一件事是更新软件包并启用I2C接口sudo apt update sudo apt upgrade -y sudo raspi-config在raspi-config工具中找到Interface Options-I2C选择“Yes”启用它。重启后生效。接下来安装Python3的包管理工具pip和本项目所需的库sudo apt install python3-pip python3-smbus -y pip3 install requests RPi.GPIOrequests用于发送HTTP请求调用Notion API这是核心中的核心。RPi.GPIOPython库用于控制树莓派的GPIO引脚操作LED和读取按钮状态。python3-smbus系统包提供了I2C通信的底层支持。对于LCD屏幕我们还需要一个驱动库。我推荐使用raspberrypi-lcd或自己找一个简单的I2C LCD库。你可以从GitHub克隆一个比如git clone https://github.com/the-raspberry-pi-guy/lcd.git然后将其中的lcddriver.py或类似文件拷贝到你的项目目录中。4.2 Notion API配置与密钥管理这是连接软件与硬件的关键一步。你需要先在Notion中创建一个“集成”Integration。访问 https://www.notion.so/my-integrations 并登录。点击“ New integration”给它起个名字比如“TaskAPI Hardware”。选择关联的工作区然后点击“Submit”。创建成功后你会看到“Internal Integration Token”。这个Token就是你的API密钥它只显示一次务必立即复制并妥善保存接下来你需要创建一个Notion数据库Database来管理任务。简单创建一个“Table”视图的数据库添加一些属性比如“Name”标题、“Status”状态可选“To Do”和“Done”。打开这个数据库点击右上角的“...”菜单选择“Add connections”然后找到你刚才创建的“TaskAPI Hardware”集成添加它。这一步是授权你的集成可以访问这个数据库。获取数据库ID在Notion中打开你的数据库浏览器地址栏的URL类似https://www.notion.so/your-workspace/a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8?v...。其中a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8这一长串就是数据库ID。复制它。安全警告绝对不要将Token和Database ID直接写在代码里然后上传到公开的Git仓库。正确做法是创建一个config.py文件# config.py NOTION_TOKEN secret_your_very_long_integration_token_here DATABASE_ID a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8然后在主程序all.py中导入from config import NOTION_TOKEN, DATABASE_ID并且确保将config.py添加到.gitignore文件中。4.3 核心代码模块拆解主程序all.py的结构可以分解为以下几个功能模块1. 导入与配置import requests import RPi.GPIO as GPIO import time from lcddriver import lcd # 假设你用的lcd驱动库 from config import NOTION_TOKEN, DATABASE_ID # GPIO引脚定义 (BCM模式) BTN_UP 17 BTN_DOWN 27 BTN_COMPLETE 22 LED_STATUS 23 LED_FEEDBACK 24 # Notion API 请求头 headers { Authorization: fBearer {NOTION_TOKEN}, Notion-Version: 2022-06-28, # 使用稳定的API版本 Content-Type: application/json }这里设置了API版本Notion API会更新指定一个稳定版本可以避免未来因API变更导致的错误。2. Notion API 交互函数def fetch_tasks_from_notion(): 从Notion数据库获取所有任务 url fhttps://api.notion.com/v1/databases/{DATABASE_ID}/query response requests.post(url, headersheaders) if response.status_code 200: data response.json() tasks [] for item in data[results]: props item[properties] # 解析任务标题 title props[Name][title][0][text][content] if props[Name][title] else Untitled # 解析任务状态 status props[Status][select][name] if props[Status][select] else To Do # 获取任务唯一ID task_id item[id] tasks.append({id: task_id, title: title, status: status}) return tasks else: print(fFailed to fetch tasks: {response.status_code}, {response.text}) return [] def mark_task_complete(task_id): 标记指定ID的任务为完成 url fhttps://api.notion.com/v1/pages/{task_id} update_data { properties: { Status: { select: { name: Done # 假设你的状态选项中有Done } } } } response requests.patch(url, headersheaders, jsonupdate_data) return response.status_code 200这里有两个关键点一是如何从复杂的Notion API响应中提取出我们需要的数据这需要你根据自己数据库的实际属性结构来调整props[Name]和props[Status]的访问路径。二是更新任务时需要构造符合API要求的JSON数据。3. 硬件控制函数def setup_gpio(): 初始化GPIO引脚 GPIO.setmode(GPIO.BCM) # 按钮设置为输入启用内部上拉电阻 for pin in [BTN_UP, BTN_DOWN, BTN_COMPLETE]: GPIO.setup(pin, GPIO.IN, pull_up_downGPIO.PUD_UP) # LED设置为输出 for pin in [LED_STATUS, LED_FEEDBACK]: GPIO.setup(pin, GPIO.OUT) GPIO.output(pin, GPIO.LOW) def button_pressed(pin): 简单的按钮消抖检测 if GPIO.input(pin) GPIO.LOW: time.sleep(0.05) # 消抖延时 if GPIO.input(pin) GPIO.LOW: return True return False4. 主循环逻辑def main(): lcd lcd() # 初始化LCD lcd.clear() setup_gpio() GPIO.output(LED_STATUS, GPIO.HIGH) # 状态灯常亮 tasks fetch_tasks_from_notion() current_index 0 if not tasks: lcd.message(No tasks found!) return def display_current_task(): 在LCD上显示当前选中的任务 task tasks[current_index] status_icon [X] if task[status] Done else [ ] # 1602屏幕每行16字符需要合理截断 display_text f{status_icon}{task[title][:13]} lcd.clear() lcd.message(display_text) display_current_task() try: while True: # 检查导航按钮 if button_pressed(BTN_UP): current_index (current_index - 1) % len(tasks) display_current_task() time.sleep(0.2) # 防止过快连续触发 elif button_pressed(BTN_DOWN): current_index (current_index 1) % len(tasks) display_current_task() time.sleep(0.2) # 检查完成按钮 if button_pressed(BTN_COMPLETE): current_task tasks[current_index] if current_task[status] ! Done: success mark_task_complete(current_task[id]) if success: # 成功反馈红色LED闪烁更新本地状态 for _ in range(3): GPIO.output(LED_FEEDBACK, GPIO.HIGH) time.sleep(0.1) GPIO.output(LED_FEEDBACK, GPIO.LOW) time.sleep(0.1) tasks[current_index][status] Done display_current_task() # 刷新显示 else: # 失败反馈红色LED长亮一秒 GPIO.output(LED_FEEDBACK, GPIO.HIGH) time.sleep(1) GPIO.output(LED_FEEDBACK, GPIO.LOW) time.sleep(0.5) # 完成操作后稍作延时 time.sleep(0.01) # 主循环短暂休眠降低CPU占用 except KeyboardInterrupt: lcd.clear() lcd.message(Goodbye!) GPIO.cleanup() if __name__ __main__: main()主循环是事件驱动的不断检查按钮状态根据按钮动作更新索引、刷新屏幕或调用API。try...except块保证了在按CtrlC退出时能清理GPIO状态这是一个好习惯。5. 结构设计与组装工艺5.1 3D建模与打印要点项目原文提供了几个STL文件底座BaseBottom、树莓派支架BaseRPi、按钮Boton和顶盖Tapa。如果你有自己的设计想法可以用Fusion 360、Tinkercad等工具建模。设计时需注意尺寸精确性务必根据你实际购买的元器件尺寸来设计卡槽和固定孔。例如LCD屏的尺寸、按钮的直径、树莓派的安装孔位等。最好先用卡尺测量并在建模软件中建立精确的参考模型。结构强度外壳需要承受按压大按钮的力。在按钮支柱、外壳连接处等受力点可以适当增加壁厚或添加加强筋。散热考虑树莓派Zero W发热不大但封闭空间仍需考虑空气流通。可以在顶盖或侧面设计一些小的通风孔。打印设置材料PLA即可它易于打印强度足够。层高0.2mm能在打印质量和时间间取得较好平衡。填充率15%-20%足够既能保证强度又节省材料和时间。支撑对于有悬垂结构的部分如按钮内部的空腔、顶盖内侧的卡扣一定要生成支撑。打印完成后仔细去除支撑并用小刀或砂纸处理干净。实操心得打印完成后不要急着组装。先进行“干装配”即不焊接只用元器件比划一下看所有东西是否都能严丝合缝地放进去按钮是否活动顺畅螺丝孔位是否对齐。这个步骤能提前发现设计或打印的偏差避免后续返工。5.2 大按钮的DIY制作这是提升项目趣味性和仪式感的关键。原文提到用泡沫、织物和转印纸来制作。泡沫核心根据你设计的按钮帽大小切割一块高密度泡沫如EVA泡沫。它要有足够的厚度比如3-5厘米来提供按压行程和缓冲手感。微动开关定位在底座上固定好微动开关。将泡沫块中心对应开关按压柱的位置挖一个凹槽或小孔确保按压时能准确触发开关。织物包裹设计图案可以在电脑上设计好“PUNCH!”或“DONE!”等字样或图案。转印打印使用喷墨打印机和专用的转印纸T-shirt transfer paper将图案镜像打印出来。熨烫将打印好的转印纸剪下图案面朝下覆盖在裁剪好的织物上。用高温熨斗关闭蒸汽功能用力、均匀地熨烫30-60秒。等待冷却后小心揭去背纸图案就转印到织物上了。组装将织物包裹在泡沫块上可以用胶水或双面胶固定边缘。然后将这个“按钮帽”粘或固定在底座上确保其能垂直按下并触发微动开关。这个过程需要一些手工耐心但成品效果会比一个光秃秃的塑料按钮好得多充满了手工制作的温度感。5.3 总装与走线管理电路固定将焊接好的洞洞板或PCB用螺丝或支柱固定在底座的相应位置。安装树莓派将树莓派锁在BaseRPi支架上再整体装入外壳。连接线缆将所有外围设备LCD、按钮、LED通过杜邦线连接到树莓派GPIO排针上。强烈建议使用不同颜色的线区分电源红、地黑和信号黄、绿等。走线整理使用扎带或胶布将过长的线缆捆扎整齐避免内部杂乱也防止线缆被运动部件如按钮夹住或扯脱。最终闭合检查所有连接无误后盖上顶盖上紧螺丝。一个整洁的内部不仅美观也更可靠。6. 系统调试与故障排查实录6.1 上电自检与分模块调试组装完成后不要急于运行完整程序。分步调试是保证成功的关键。最小系统测试只给树莓派上电通过SSH使用Putty或MobaXterm登录进去确保系统运行正常网络通畅可以ping google.com测试。I2C LCD测试在Python中写一个简单的测试脚本调用lcddriver库尝试显示“Hello World”。如果屏幕不亮或乱码检查电源是否接对3.3V vs 5V有些模块支持两者但信号电平要匹配I2C地址是否正确用i2cdetect确认接线是否牢固。GPIO输入/输出测试写脚本分别测试每个按钮和LED。对于按钮循环读取GPIO状态并打印对于LED尝试让其闪烁。确保每个硬件都能被正确控制。Notion API连通性测试在Python环境中单独运行一个只包含fetch_tasks_from_notion()函数的脚本打印出获取到的任务列表。如果失败检查Token和Database ID是否正确网络是否正常Notion集成是否已关联到目标数据库API版本Notion-Version是否正确。6.2 常见问题与解决方案速查表以下是我在开发过程中遇到的一些典型问题及解决方法现象可能原因排查步骤与解决方案LCD屏幕无显示1. 电源接错接5V到3.3V模块或反之2. I2C地址不对3. 背光未开启4. 对比度不合适1. 确认模块电压用万用表测量VCC引脚电压。2. 运行sudo i2cdetect -y 1扫描地址。3. 有些模块有背光控制引脚LED需接高电平。4. 模块上可能有电位器调节对比度。按钮按下无反应1. GPIO模式或编号设置错误BCM vs BOARD2. 内部上拉未启用或接线错误3. 机械故障或接触不良1. 确认代码中GPIO.setmode(GPIO.BCM)和使用BCM编号。2. 确认按钮接法一脚接GPIO一脚接GND。启用内部上拉GPIO.PUD_UP。3. 用万用表通断档测试按钮按下时是否导通。LED不亮或太暗/烧毁1. 未串联限流电阻或阻值过大/过小2. 正负极接反3. GPIO输出模式未设置或电平错误1.必须串联电阻220-470Ω。不接电阻极易烧毁LED或GPIO。2. LED长脚为正阳极接GPIO短脚为负阴极接GND。3. 确认GPIO.setup(pin, GPIO.OUT)并GPIO.output(pin, GPIO.HIGH)。无法获取Notion任务1. API Token或Database ID错误2. 网络问题3. 数据库未分享给集成4. API版本过时1. 仔细检查config.py中的字符串确保无多余空格。2. 在树莓派上curl -v https://api.notion.com测试网络。3. 在Notion数据库页面点击“Share”添加你的集成。4. 在代码请求头中更新Notion-Version为较新版本。更新任务状态失败1. 任务ID获取错误2. 更新的JSON结构不符合API要求3. 属性名或选项值不匹配1. 打印出fetch_tasks_from_notion()获取的task_id确认其与Notion页面URL中的ID一致。2. 参考Notion API文档仔细构造update_dataJSON。3. 确认Status属性名和Done选项值在你的数据库中确实存在。程序运行后CPU占用高主循环中没有延时空转导致CPU满载在while True循环末尾添加一个短暂的休眠如time.sleep(0.01)或0.05。按钮偶尔连击机械按键抖动在按钮检测函数中加入消抖逻辑如检测到低电平后延时10-50ms再确认。6.3 优化与扩展思路当基础功能稳定运行后你可以考虑以下优化和扩展让这个装置更强大状态持久化目前任务列表只在内存中重启程序后当前选中索引会重置。可以将其保存到一个本地小文件如current_index.txt中启动时读取。多列表支持通过增加一个模式切换按钮让设备可以管理多个Notion数据库如“工作”和“个人”。离线缓存考虑到网络可能不稳定可以在本地缓存一份任务列表。当网络断开时显示缓存的任务网络恢复后再同步状态。更丰富的反馈除了LED可以增加一个蜂鸣器为任务完成添加声音提示。或者用RGB LED用不同颜色表示不同任务优先级。美化与个性化设计更酷的外壳使用激光切割亚克力或者给3D打印件上色。LCD显示也可以增加更多动画效果。系统服务化目前程序需要在终端前台运行。你可以将其设置为一个系统服务systemd service这样树莓派开机就能自动启动它无需手动登录运行。这个项目最吸引我的地方就在于它从一个简单的想法出发融合了软件API调用、嵌入式硬件编程、3D设计与打印、甚至简单的手工制作最终创造出一个有实用价值也有情感温度的实体产品。它提醒我编程和创造不只是发生在屏幕里它们完全可以延伸出来与现实世界发生更有趣的碰撞。希望这份详细的拆解能帮你顺利复现它甚至激发出属于你自己的、更酷的硬件创意。
基于树莓派与Notion API的硬件任务管理装置设计与实现
1. 项目概述与核心价值如果你和我一样是个重度Notion用户每天的任务、项目、笔记都泡在里面那你肯定也经历过这种时刻盯着屏幕上那条待办事项鼠标移过去点击那个小小的复选框完成。动作很轻但总觉得少了点什么。数字世界的任务完成似乎就缺了那一声清脆的“啪嗒”和一次实实在在的物理反馈。这个念头就是我动手做这个“TaskAPI”硬件任务管理装置的起点。简单说我想把Notion里那些虚拟的待办事项变成一个看得见、摸得着甚至能“一拳搞定”的实体玩意儿。这个项目的核心就是用Raspberry Pi树莓派作为大脑去调用Notion的API读取你的任务数据库然后把每条任务显示在一块小液晶屏上。你通过实体按钮上下浏览找到想完成的那条对准装置上的一个大按钮狠狠砸下去——伴随着一个物理开关的“咔哒”声Notion里对应的任务状态会自动被标记为“完成”同时装置上的一个LED灯也会亮起给你一个即时的、多感官的确认。它把软件API的灵活性与硬件交互的实在感结合了起来算是一次典型的“物理化数字信息”的物联网IoT实践。为什么选这套组合拳首先Notion API足够强大和稳定提供了对数据库增删改查的完整能力而且是基于标准的HTTP和JSON用Python操作起来非常顺手。其次Raspberry Pi Zero W这款微控制器简直是为此类项目而生的它身材小巧、功耗低自带Wi-FiGPIO通用输入输出引脚丰富价格还亲民完美承担了连接云端API和控制本地硬件的桥梁角色。最后LCD屏、按钮、LED这些外围元件都是电子爱好者手边的常客组合起来技术门槛可控但最终呈现的效果却足够有趣和有用。这个装置适合谁呢如果你是喜欢捣鼓硬件的软件开发者想找个项目练手API调用和硬件控制或者你是创客爱好者想给自己的工作流增加点仪式感亦或是你单纯觉得在屏幕上点复选框太无聊想给完成任务来点更带劲的反馈——那么这个项目会是一个很好的起点。接下来我会把从电路设计、代码编写到3D打印外壳、组装调试的全过程连同我踩过的坑和总结的经验毫无保留地拆解给你看。2. 整体系统架构与设计思路2.1 硬件选型与功能映射整个系统的硬件核心是一块Raspberry Pi Zero W。选择它而不是功能更全的3B/4B型号主要基于几点考量一是本项目对计算性能要求不高主要是网络请求和GPIO控制Zero W的CPU足够胜任二是其超小的体积和极低的功耗非常适合嵌入到最终成品那个紧凑的3D打印外壳里三是它内置的Wi-Fi模块省去了外接USB网卡的麻烦让设备可以独立联网与Notion API通信。外围硬件围绕“显示、选择、确认、反馈”这四个核心交互环节来配置显示单元一块1602 LCD液晶屏16字符×2行通过I2C接口模块驱动。选择I2C版本而非直接驱动是因为它只需要4根线VCC, GND, SDA, SCL就能工作极大节省了宝贵的GPIO引脚也简化了布线。屏幕负责实时显示从Notion获取的任务标题。选择单元两个轻触开关Push Button分别定义为“上翻”和“下翻”。用于在任务列表中导航。选择轻触开关是因为它成本低、体积小、手感明确且与GPIO的输入检测逻辑匹配简单。确认单元一个大型的瞬时按钮内部连接的是一个微动开关End of career即行程开关。这是整个装置的“灵魂”。用户用力按压这个大型按钮触发内部的微动开关向树莓派发送一个“任务完成”的信号。选用大型按钮并配合泡沫和织物包裹是为了创造一种独特的、带有宣泄感的按压体验这是鼠标点击无法比拟的。反馈单元一组LED指示灯。最初的设计是每个任务对应一个LED但考虑到硬件复杂度和成本在简化版本中可以只用一个LED来指示“当前选中任务”的状态或者用不同颜色的LED表示“待办”和“已完成”。在我的实现里我选择用两个LED一个绿色常亮表示系统运行正常一个红色当大按钮被按下任务标记成功后快速闪烁一下作为完成反馈。注意GPIO引脚分配需要提前规划好避免冲突。例如I2C接口固定使用GPIO2 (SDA) 和 GPIO3 (SCL)。按钮和LED可以分配其他空闲的GPIO如GPIO17, GPIO27等。务必在代码中与物理连接保持一致并做好记录。2.2 软件逻辑与数据流设计软件部分的核心是运行在Raspberry Pi上的一个Python脚本。它的工作流是一个清晰的循环初始化与认证脚本启动后首先加载Notion API的密钥Token和目标数据库的ID。这些是敏感信息绝对不要硬编码在代码里然后上传到公开仓库。我的做法是创建一个单独的config.py文件在里面定义这些变量并在.gitignore中忽略这个文件。数据获取与解析通过HTTP GET请求调用Notion API查询指定的数据库。Notion返回的是结构复杂的JSON数据。我们需要编写解析函数从中提取出任务的“标题”Title、“状态”Status等我们关心的属性。这里的关键是理解Notion API返回的数据结构特别是“properties”对象里各个属性的嵌套方式。本地状态管理将获取到的任务列表缓存在内存中并维护一个“当前选中任务索引”。这个索引会随着用户按下“上/下”翻页按钮而改变。显示刷新根据当前选中任务的索引将对应任务的标题可能需要进行截断以适应16字显示刷新到LCD屏幕上。输入监听事件驱动这是一个持续运行的循环。监听两个导航按钮如果检测到按下就更新“当前选中任务索引”并触发“显示刷新”。监听大按钮完成按钮如果检测到按下就获取当前选中任务在Notion中的唯一ID然后构造一个HTTP PATCH请求调用Notion API更新该条目的“状态”属性为“完成”。反馈执行在API更新请求发送后根据返回结果成功或失败控制LED做出相应的指示如成功则闪烁绿灯失败则闪烁红灯。这个循环确保了硬件状态、本地数据和云端数据三者之间的同步。整个设计的巧妙之处在于它用极低的硬件成本按钮、LED和直观的物理交互封装了对复杂云服务Notion API的调用用户体验非常直接。3. 核心硬件搭建与电路详解3.1 元器件清单与采购要点除了项目正文中提到的这里我补充一份更清晰、带有替代选项和注意事项的清单品类具体型号/规格数量说明与备选主控Raspberry Pi Zero W1务必确认是带无线功能的“W”版本。也可用Pi 3A/4但外壳需调整。显示1602 LCD with I2C模块1注意是“I2C接口”的版本通常带一个蓝色背板。直接驱动1602需要更多IO不推荐。输入6x6mm 轻触开关2用于上下导航。质量要好手感干脆避免粘连。输入大型瞬动按钮含内部微动开关1这是体验核心。可以买现成的巨型按钮也可以用普通按钮DIY加大帽。反馈5mm LED红、绿各1颜色自定。注意工作电压需串联限流电阻通常220Ω-1kΩ。限流电阻220Ω 或 330Ω 电阻2-4用于LED。阻值越大LED越暗。连接母对母、公对母杜邦线若干建议多备一些用于连接Pi GPIO与面包板或PCB。电源Micro USB 电源5V/2A1给树莓派供电。质量要可靠供电不足会导致系统不稳定。存储Micro SD卡16GB Class101用于安装树莓派系统。品牌建议SanDisk, Samsung。结构万能板洞洞板、3D打印外壳1套初期验证用面包板最终成品建议焊接在洞洞板上或自制PCB。其他泡沫板、织物、导线、焊锡适量用于制作大按钮的缓冲和外观。实操心得采购时特别是微动开关和轻触开关可以多买几个备用。这类机械元件在频繁测试中容易损坏。LED和电阻包通常很便宜可以买一套多种值的方便调试。3.2 电路连接与焊接实践电路原理并不复杂核心是树莓派GPIO与各元器件的正确连接。下图是连接的示意表以物理引脚编号为例代码中需使用BCM编号如GPIO17树莓派 GPIO (BCM编号)连接至说明3.3V(Pin 1)LCD I2C模块 VCC, 按钮一端为模块和按钮上拉供电。GND(Pin 6, 9等)LCD I2C模块 GND, LED阴极, 按钮另一端共地。GPIO2 (SDA)(Pin 3)LCD I2C模块 SDAI2C数据线。GPIO3 (SCL)(Pin 5)LCD I2C模块 SCLI2C时钟线。GPIO17(Pin 11)导航“上”按钮信号线配置为输入内部上拉。GPIO27(Pin 13)导航“下”按钮信号线配置为输入内部上拉。GPIO22(Pin 15)大按钮微动开关信号线配置为输入内部上拉。GPIO23(Pin 16)绿色LED阳极经220Ω电阻配置为输出控制状态灯。GPIO24(Pin 18)红色LED阳极经220Ω电阻配置为输出控制完成反馈。连接步骤与注意事项I2C LCD连接这是最简单的部分。将模块的VCC、GND、SDA、SCL分别接到树莓派的3.3V、GND、GPIO2、GPIO3。接好后在树莓派终端输入sudo i2cdetect -y 1如果能看到一个地址通常是0x27或0x3F就说明连接成功。按钮连接所有按钮都接成“上拉输入”模式。即按钮一脚接GPIO另一脚接GND。在代码中将该GPIO配置为输入并启用内部上拉电阻。这样按钮未按下时GPIO读到的是高电平1按下时引脚被拉到GND读到低电平0。这种接法可以省去外部上拉电阻。LED连接切记一定要串联限流电阻直接连接GPIO到LED会因电流过大烧毁LED或损坏GPIO口。接法树莓派GPIO - 电阻220Ω - LED阳极 - LED阴极 - 树莓派GND。焊接建议如果使用洞洞板做最终电路建议先布局再焊接。将树莓派排针延长到洞洞板上然后以排针为中心连接各元件。焊接时保持烙铁头干净时间不宜过长避免烫坏元件或焊盘。完成后务必用万用表通断档检查是否有短路或虚焊。踩坑记录我第一次测试时按钮响应不灵有时会连续触发多次。原因是机械按钮存在“抖动”Bounce即按下瞬间会产生一系列快速通断的脉冲。解决方法是在代码中做“消抖”Debounce可以简单地用time.sleep(0.05)延时或者检测到下降沿后等待一小段时间再读取状态。4. 软件环境配置与核心代码解析4.1 系统准备与依赖安装首先你需要一张安装了Raspberry Pi OS以前叫Raspbian的SD卡。建议使用官方的Raspberry Pi Imager工具来烧录选择“Raspberry Pi OS (Legacy, 32-bit)”这个轻量版即可它带有桌面环境但比较节省资源。系统启动并完成基础设置语言、时区、联网等后第一件事是更新软件包并启用I2C接口sudo apt update sudo apt upgrade -y sudo raspi-config在raspi-config工具中找到Interface Options-I2C选择“Yes”启用它。重启后生效。接下来安装Python3的包管理工具pip和本项目所需的库sudo apt install python3-pip python3-smbus -y pip3 install requests RPi.GPIOrequests用于发送HTTP请求调用Notion API这是核心中的核心。RPi.GPIOPython库用于控制树莓派的GPIO引脚操作LED和读取按钮状态。python3-smbus系统包提供了I2C通信的底层支持。对于LCD屏幕我们还需要一个驱动库。我推荐使用raspberrypi-lcd或自己找一个简单的I2C LCD库。你可以从GitHub克隆一个比如git clone https://github.com/the-raspberry-pi-guy/lcd.git然后将其中的lcddriver.py或类似文件拷贝到你的项目目录中。4.2 Notion API配置与密钥管理这是连接软件与硬件的关键一步。你需要先在Notion中创建一个“集成”Integration。访问 https://www.notion.so/my-integrations 并登录。点击“ New integration”给它起个名字比如“TaskAPI Hardware”。选择关联的工作区然后点击“Submit”。创建成功后你会看到“Internal Integration Token”。这个Token就是你的API密钥它只显示一次务必立即复制并妥善保存接下来你需要创建一个Notion数据库Database来管理任务。简单创建一个“Table”视图的数据库添加一些属性比如“Name”标题、“Status”状态可选“To Do”和“Done”。打开这个数据库点击右上角的“...”菜单选择“Add connections”然后找到你刚才创建的“TaskAPI Hardware”集成添加它。这一步是授权你的集成可以访问这个数据库。获取数据库ID在Notion中打开你的数据库浏览器地址栏的URL类似https://www.notion.so/your-workspace/a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8?v...。其中a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8这一长串就是数据库ID。复制它。安全警告绝对不要将Token和Database ID直接写在代码里然后上传到公开的Git仓库。正确做法是创建一个config.py文件# config.py NOTION_TOKEN secret_your_very_long_integration_token_here DATABASE_ID a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8然后在主程序all.py中导入from config import NOTION_TOKEN, DATABASE_ID并且确保将config.py添加到.gitignore文件中。4.3 核心代码模块拆解主程序all.py的结构可以分解为以下几个功能模块1. 导入与配置import requests import RPi.GPIO as GPIO import time from lcddriver import lcd # 假设你用的lcd驱动库 from config import NOTION_TOKEN, DATABASE_ID # GPIO引脚定义 (BCM模式) BTN_UP 17 BTN_DOWN 27 BTN_COMPLETE 22 LED_STATUS 23 LED_FEEDBACK 24 # Notion API 请求头 headers { Authorization: fBearer {NOTION_TOKEN}, Notion-Version: 2022-06-28, # 使用稳定的API版本 Content-Type: application/json }这里设置了API版本Notion API会更新指定一个稳定版本可以避免未来因API变更导致的错误。2. Notion API 交互函数def fetch_tasks_from_notion(): 从Notion数据库获取所有任务 url fhttps://api.notion.com/v1/databases/{DATABASE_ID}/query response requests.post(url, headersheaders) if response.status_code 200: data response.json() tasks [] for item in data[results]: props item[properties] # 解析任务标题 title props[Name][title][0][text][content] if props[Name][title] else Untitled # 解析任务状态 status props[Status][select][name] if props[Status][select] else To Do # 获取任务唯一ID task_id item[id] tasks.append({id: task_id, title: title, status: status}) return tasks else: print(fFailed to fetch tasks: {response.status_code}, {response.text}) return [] def mark_task_complete(task_id): 标记指定ID的任务为完成 url fhttps://api.notion.com/v1/pages/{task_id} update_data { properties: { Status: { select: { name: Done # 假设你的状态选项中有Done } } } } response requests.patch(url, headersheaders, jsonupdate_data) return response.status_code 200这里有两个关键点一是如何从复杂的Notion API响应中提取出我们需要的数据这需要你根据自己数据库的实际属性结构来调整props[Name]和props[Status]的访问路径。二是更新任务时需要构造符合API要求的JSON数据。3. 硬件控制函数def setup_gpio(): 初始化GPIO引脚 GPIO.setmode(GPIO.BCM) # 按钮设置为输入启用内部上拉电阻 for pin in [BTN_UP, BTN_DOWN, BTN_COMPLETE]: GPIO.setup(pin, GPIO.IN, pull_up_downGPIO.PUD_UP) # LED设置为输出 for pin in [LED_STATUS, LED_FEEDBACK]: GPIO.setup(pin, GPIO.OUT) GPIO.output(pin, GPIO.LOW) def button_pressed(pin): 简单的按钮消抖检测 if GPIO.input(pin) GPIO.LOW: time.sleep(0.05) # 消抖延时 if GPIO.input(pin) GPIO.LOW: return True return False4. 主循环逻辑def main(): lcd lcd() # 初始化LCD lcd.clear() setup_gpio() GPIO.output(LED_STATUS, GPIO.HIGH) # 状态灯常亮 tasks fetch_tasks_from_notion() current_index 0 if not tasks: lcd.message(No tasks found!) return def display_current_task(): 在LCD上显示当前选中的任务 task tasks[current_index] status_icon [X] if task[status] Done else [ ] # 1602屏幕每行16字符需要合理截断 display_text f{status_icon}{task[title][:13]} lcd.clear() lcd.message(display_text) display_current_task() try: while True: # 检查导航按钮 if button_pressed(BTN_UP): current_index (current_index - 1) % len(tasks) display_current_task() time.sleep(0.2) # 防止过快连续触发 elif button_pressed(BTN_DOWN): current_index (current_index 1) % len(tasks) display_current_task() time.sleep(0.2) # 检查完成按钮 if button_pressed(BTN_COMPLETE): current_task tasks[current_index] if current_task[status] ! Done: success mark_task_complete(current_task[id]) if success: # 成功反馈红色LED闪烁更新本地状态 for _ in range(3): GPIO.output(LED_FEEDBACK, GPIO.HIGH) time.sleep(0.1) GPIO.output(LED_FEEDBACK, GPIO.LOW) time.sleep(0.1) tasks[current_index][status] Done display_current_task() # 刷新显示 else: # 失败反馈红色LED长亮一秒 GPIO.output(LED_FEEDBACK, GPIO.HIGH) time.sleep(1) GPIO.output(LED_FEEDBACK, GPIO.LOW) time.sleep(0.5) # 完成操作后稍作延时 time.sleep(0.01) # 主循环短暂休眠降低CPU占用 except KeyboardInterrupt: lcd.clear() lcd.message(Goodbye!) GPIO.cleanup() if __name__ __main__: main()主循环是事件驱动的不断检查按钮状态根据按钮动作更新索引、刷新屏幕或调用API。try...except块保证了在按CtrlC退出时能清理GPIO状态这是一个好习惯。5. 结构设计与组装工艺5.1 3D建模与打印要点项目原文提供了几个STL文件底座BaseBottom、树莓派支架BaseRPi、按钮Boton和顶盖Tapa。如果你有自己的设计想法可以用Fusion 360、Tinkercad等工具建模。设计时需注意尺寸精确性务必根据你实际购买的元器件尺寸来设计卡槽和固定孔。例如LCD屏的尺寸、按钮的直径、树莓派的安装孔位等。最好先用卡尺测量并在建模软件中建立精确的参考模型。结构强度外壳需要承受按压大按钮的力。在按钮支柱、外壳连接处等受力点可以适当增加壁厚或添加加强筋。散热考虑树莓派Zero W发热不大但封闭空间仍需考虑空气流通。可以在顶盖或侧面设计一些小的通风孔。打印设置材料PLA即可它易于打印强度足够。层高0.2mm能在打印质量和时间间取得较好平衡。填充率15%-20%足够既能保证强度又节省材料和时间。支撑对于有悬垂结构的部分如按钮内部的空腔、顶盖内侧的卡扣一定要生成支撑。打印完成后仔细去除支撑并用小刀或砂纸处理干净。实操心得打印完成后不要急着组装。先进行“干装配”即不焊接只用元器件比划一下看所有东西是否都能严丝合缝地放进去按钮是否活动顺畅螺丝孔位是否对齐。这个步骤能提前发现设计或打印的偏差避免后续返工。5.2 大按钮的DIY制作这是提升项目趣味性和仪式感的关键。原文提到用泡沫、织物和转印纸来制作。泡沫核心根据你设计的按钮帽大小切割一块高密度泡沫如EVA泡沫。它要有足够的厚度比如3-5厘米来提供按压行程和缓冲手感。微动开关定位在底座上固定好微动开关。将泡沫块中心对应开关按压柱的位置挖一个凹槽或小孔确保按压时能准确触发开关。织物包裹设计图案可以在电脑上设计好“PUNCH!”或“DONE!”等字样或图案。转印打印使用喷墨打印机和专用的转印纸T-shirt transfer paper将图案镜像打印出来。熨烫将打印好的转印纸剪下图案面朝下覆盖在裁剪好的织物上。用高温熨斗关闭蒸汽功能用力、均匀地熨烫30-60秒。等待冷却后小心揭去背纸图案就转印到织物上了。组装将织物包裹在泡沫块上可以用胶水或双面胶固定边缘。然后将这个“按钮帽”粘或固定在底座上确保其能垂直按下并触发微动开关。这个过程需要一些手工耐心但成品效果会比一个光秃秃的塑料按钮好得多充满了手工制作的温度感。5.3 总装与走线管理电路固定将焊接好的洞洞板或PCB用螺丝或支柱固定在底座的相应位置。安装树莓派将树莓派锁在BaseRPi支架上再整体装入外壳。连接线缆将所有外围设备LCD、按钮、LED通过杜邦线连接到树莓派GPIO排针上。强烈建议使用不同颜色的线区分电源红、地黑和信号黄、绿等。走线整理使用扎带或胶布将过长的线缆捆扎整齐避免内部杂乱也防止线缆被运动部件如按钮夹住或扯脱。最终闭合检查所有连接无误后盖上顶盖上紧螺丝。一个整洁的内部不仅美观也更可靠。6. 系统调试与故障排查实录6.1 上电自检与分模块调试组装完成后不要急于运行完整程序。分步调试是保证成功的关键。最小系统测试只给树莓派上电通过SSH使用Putty或MobaXterm登录进去确保系统运行正常网络通畅可以ping google.com测试。I2C LCD测试在Python中写一个简单的测试脚本调用lcddriver库尝试显示“Hello World”。如果屏幕不亮或乱码检查电源是否接对3.3V vs 5V有些模块支持两者但信号电平要匹配I2C地址是否正确用i2cdetect确认接线是否牢固。GPIO输入/输出测试写脚本分别测试每个按钮和LED。对于按钮循环读取GPIO状态并打印对于LED尝试让其闪烁。确保每个硬件都能被正确控制。Notion API连通性测试在Python环境中单独运行一个只包含fetch_tasks_from_notion()函数的脚本打印出获取到的任务列表。如果失败检查Token和Database ID是否正确网络是否正常Notion集成是否已关联到目标数据库API版本Notion-Version是否正确。6.2 常见问题与解决方案速查表以下是我在开发过程中遇到的一些典型问题及解决方法现象可能原因排查步骤与解决方案LCD屏幕无显示1. 电源接错接5V到3.3V模块或反之2. I2C地址不对3. 背光未开启4. 对比度不合适1. 确认模块电压用万用表测量VCC引脚电压。2. 运行sudo i2cdetect -y 1扫描地址。3. 有些模块有背光控制引脚LED需接高电平。4. 模块上可能有电位器调节对比度。按钮按下无反应1. GPIO模式或编号设置错误BCM vs BOARD2. 内部上拉未启用或接线错误3. 机械故障或接触不良1. 确认代码中GPIO.setmode(GPIO.BCM)和使用BCM编号。2. 确认按钮接法一脚接GPIO一脚接GND。启用内部上拉GPIO.PUD_UP。3. 用万用表通断档测试按钮按下时是否导通。LED不亮或太暗/烧毁1. 未串联限流电阻或阻值过大/过小2. 正负极接反3. GPIO输出模式未设置或电平错误1.必须串联电阻220-470Ω。不接电阻极易烧毁LED或GPIO。2. LED长脚为正阳极接GPIO短脚为负阴极接GND。3. 确认GPIO.setup(pin, GPIO.OUT)并GPIO.output(pin, GPIO.HIGH)。无法获取Notion任务1. API Token或Database ID错误2. 网络问题3. 数据库未分享给集成4. API版本过时1. 仔细检查config.py中的字符串确保无多余空格。2. 在树莓派上curl -v https://api.notion.com测试网络。3. 在Notion数据库页面点击“Share”添加你的集成。4. 在代码请求头中更新Notion-Version为较新版本。更新任务状态失败1. 任务ID获取错误2. 更新的JSON结构不符合API要求3. 属性名或选项值不匹配1. 打印出fetch_tasks_from_notion()获取的task_id确认其与Notion页面URL中的ID一致。2. 参考Notion API文档仔细构造update_dataJSON。3. 确认Status属性名和Done选项值在你的数据库中确实存在。程序运行后CPU占用高主循环中没有延时空转导致CPU满载在while True循环末尾添加一个短暂的休眠如time.sleep(0.01)或0.05。按钮偶尔连击机械按键抖动在按钮检测函数中加入消抖逻辑如检测到低电平后延时10-50ms再确认。6.3 优化与扩展思路当基础功能稳定运行后你可以考虑以下优化和扩展让这个装置更强大状态持久化目前任务列表只在内存中重启程序后当前选中索引会重置。可以将其保存到一个本地小文件如current_index.txt中启动时读取。多列表支持通过增加一个模式切换按钮让设备可以管理多个Notion数据库如“工作”和“个人”。离线缓存考虑到网络可能不稳定可以在本地缓存一份任务列表。当网络断开时显示缓存的任务网络恢复后再同步状态。更丰富的反馈除了LED可以增加一个蜂鸣器为任务完成添加声音提示。或者用RGB LED用不同颜色表示不同任务优先级。美化与个性化设计更酷的外壳使用激光切割亚克力或者给3D打印件上色。LCD显示也可以增加更多动画效果。系统服务化目前程序需要在终端前台运行。你可以将其设置为一个系统服务systemd service这样树莓派开机就能自动启动它无需手动登录运行。这个项目最吸引我的地方就在于它从一个简单的想法出发融合了软件API调用、嵌入式硬件编程、3D设计与打印、甚至简单的手工制作最终创造出一个有实用价值也有情感温度的实体产品。它提醒我编程和创造不只是发生在屏幕里它们完全可以延伸出来与现实世界发生更有趣的碰撞。希望这份详细的拆解能帮你顺利复现它甚至激发出属于你自己的、更酷的硬件创意。
