1. 项目缘起当复古时钟遇见AI诗魂几年前我在一个旧货市场淘到了一个老式挂钟的机芯和表盘一直想把它改造成一个有点特别的东西。一个只会走时的钟在今天看来已经有些乏味了。我想要的是一个能讲故事、能带来一点意外惊喜的“伙伴”。这个想法一直搁置着直到我接触到了像ChatGPT这样的AI语言模型一个念头突然清晰起来能不能让一个时钟不仅显示时间还能根据时间、日期甚至天气自动生成一句应景的诗歌或箴言让冰冷的机械多一份人文的温度这就是“Poetic Ticks”诗意的滴答项目的起点。它本质上是一个智能诗歌时钟核心功能是每小时或根据设定自动从互联网获取一次由AI生成的、与当前时刻情境相关的短诗或句子并显示在电子墨水屏上。为了实现这个想法我需要几个关键部分一个负责逻辑控制和显示驱动的主控、一个稳定可靠的网络连接模块以调用AI接口、一块适合长时间静态显示的屏幕以及一个提供时间基准的模块。经过一番选型我最终敲定了以Raspberry Pi Pico作为主控搭配WIZnet的W5100S以太网模块构建网络能力并选用一块三色电子墨水屏e-Paper作为显示终端。选择Pico是因为其RP2040双核处理器性能对于本项目绰绰有余MicroPython生态完善开发调试极其便捷性价比无敌。而放弃Wi-Fi选择W5100S以太网模块则是出于对稳定性的极致追求——诗歌生成依赖网络API一个稳定的连接是体验的基石有线以太网在抗干扰和长期运行可靠性上远胜于大多数低成本Wi-Fi方案。e-Paper屏幕的选定更是顺理成章它超低功耗、类纸质感、保持显示不耗电的特性与“静谧展示一首诗”的意境完美契合。整个项目的乐趣不仅在于最终看到那句恰到好处的诗句出现在屏幕上更在于将硬件PicoW5100S、网络通信HTTP请求、API调用OpenAI ChatGPT和显示驱动e-Paper这几个原本独立的领域优雅地编织在一起的过程。下面我就把这其中的技术细节、踩过的坑和最终打磨成型的方案完整地分享出来。2. 硬件选型与核心电路设计解析一个稳定运行的硬件平台是所有软件功能的基础。在这一部分我将详细拆解每个核心元件的选型理由并给出具体的电路连接方案和注意事项。2.1 主控Raspberry Pi Pico 的 RP2040 优势Raspberry Pi Pico 的核心是一颗 RP2040 微控制器。对于本项目它的几个特性至关重要双核 Arm Cortex-M0 处理器虽然主频仅133MHz但双核架构允许我们将一些任务分离。例如一个核心专用于处理网络通信和API请求这类任务可能有等待时间另一个核心则可以专心管理屏幕刷新和用户交互从而提高系统的响应效率。丰富的IO与灵活的引脚功能Pico有26个多功能GPIO支持UART、I2C、SPI等通信协议。这为我们连接W5100SSPI、e-Paper屏幕SPI以及可能的传感器如I2C的温湿度传感器提供了充足的接口。MicroPython 支持这是让我决定使用Pico的关键。MicroPython允许我们使用Python语言进行嵌入式开发极大地降低了开发门槛。处理JSONAPI响应、字符串诗歌文本、定时任务等逻辑用Python比用C/C要直观和快速得多。低成本与高可获取性Pico的价格极具竞争力且货源相对充足非常适合个人项目和原型开发。注意Pico有两个版本带焊接排针的和不带排针的。建议购买已焊接好排针的版本或者自己具备焊接能力这样可以方便地使用面包板或杜邦线进行原型搭建。2.2 网络连接W5100S 以太网模块的稳定之道为什么不用更常见的ESP8266/ESP32 Wi-Fi模块原因在于项目对网络稳定性和连接持久性的要求很高。这个时钟理想状态是7x24小时运行数月甚至数年不去碰它。Wi-Fi连接可能会因为路由器重启、信道干扰、IP地址租约到期等问题而断开需要复杂的重连逻辑甚至有时需要物理干预。W5100S是一个硬件的TCP/IP协议栈芯片它通过SPI接口与主控通信。其最大优势在于硬件协议栈TCP/IP协议的处理如TCP/UDP/IP/ICMP由芯片硬件完成不占用主控的CPU资源响应更可靠。连接稳定有线以太网几乎不受无线环境干扰只要网线连通链路层就是稳定的上层连接不易意外断开。配置简单通常只需配置MAC地址、IP地址支持DHCP、网关和子网掩码即可通信比Wi-Fi的扫描、认证、关联过程更简单可控。我选用的是集成了W5100S芯片、网络变压器和RJ45接口的模块市面上常见价格在30-50元人民币左右。它通常需要5V供电并与主控通过SPI通信。2.3 显示终端电子墨水屏的静谧之美电子墨水屏是此项目的“门面”。我选择了一块7.5英寸、800x480分辨率的三色黑、白、红e-Paper屏幕。选型考虑如下尺寸与分辨率7.5英寸足够显示数行诗歌文本800x480的分辨率能保证字体清晰美观。三色显示除了基本的黑白红色可以用来高亮显示时间、日期或诗歌中的关键词增加视觉层次感。低功耗与视觉舒适只有刷新屏幕时才消耗电能刷新完成后完全断电屏幕依然保持显示。这符合时钟长期静置显示的特性且无背光阅读感舒适。需要注意的是e-Paper屏幕的驱动相对复杂刷新速度慢全刷需要2-3秒且对时序要求严格。好在厂商通常会提供对应的驱动库我们在MicroPython中移植或重写即可。2.4 电路连接详解与供电考量将以上三者连接起来是整个硬件搭建的核心。下图清晰地展示了主要元件的连接关系5V电源适配器 | -------------------------------------- | | | V V V ---------- ------------- ------------------ | | | | | | | 5V to | | Raspberry | | W5100S Ethernet| | 3.3V LDO |-----| Pi Pico |----| Module | | (可选) | | (3.3V) | (SPI)| | ---------- ------------- ------------------ | | | (SPI) | (RJ45 to Router) V V ----------------- ---------- | | | | | e-Paper Display| | Router | | (7.5 inch) | | /Switch | ----------------- ----------具体引脚连接方案请根据你的模块引脚定义调整Pico 与 W5100S 模块 (SPI0)Pico GP5 (SPI0 SCK)- W5100S SCKPico GP4 (SPI0 MOSI)- W5100S MOSIPico GP3 (SPI0 MISO)- W5100S MISOPico GP2 (任意GPIO)- W5100S CS (片选)Pico 3.3V- W5100S VCC (注意确认模块逻辑电压是3.3V还是5V部分模块需接5V)Pico GND- W5100S GNDPico 与 e-Paper 屏幕 (SPI1)为了避免冲突e-Paper使用另一组SPISPI1。Pico GP10 (SPI1 SCK)- e-Paper SCKPico GP11 (SPI1 MOSI)- e-Paper MOSI/DINPico GP8 (任意GPIO)- e-Paper CSPico GP9 (任意GPIO)- e-Paper DC (数据/命令选择)Pico GP7 (任意GPIO)- e-Paper RST (复位)Pico GP6 (任意GPIO)- e-Paper BUSYPico 3.3V- e-Paper VCCPico GND- e-Paper GND供电方案核心方案使用一个5V/2A的USB电源适配器通过Pico的USB口供电。Pico的VBUS引脚会输出5V可以引出一路给W5100S模块如果它需要5V。Pico自身的3.3V LDO可以为自身和e-Paper屏幕供电。重要提醒e-Paper屏幕在刷新瞬间需要较大的电流可能高达100mA以上。如果发现刷新时系统重启或显示异常很可能是供电不足。此时可以考虑使用外部的3.3V稳压模块如AMS1117-3.3单独为屏幕供电并与Pico共地。实操心得在面包板上搭建原型时务必确保所有GND连接在一起。SPI的时钟线SCK尽量短以减少干扰。首次上电前再三核对电源引脚接反极易烧毁芯片。3. 软件架构与MicroPython环境搭建硬件连接妥当后下一步就是构建软件的“大脑”。我们将使用MicroPython进行开发其交互式解释器和丰富的库支持能让开发过程事半功倍。3.1 MicroPython固件烧录与基础环境首先需要将MicroPython固件烧录到Pico上按住Pico板上的BOOTSEL按钮同时通过USB线将其连接到电脑。电脑会识别出一个名为RPI-RP2的可移动磁盘。从MicroPython官网下载适用于RP2040的最新稳定版.uf2固件文件。将该.uf2文件拖入RPI-RP2磁盘。Pico会自动重启并运行MicroPython。接下来我们需要一个代码编辑器和串口工具。我强烈推荐使用Thonny这款IDE。它集成了MicroPython管理、代码编辑、串口REPL交互式命令行和文件传输功能开箱即用。安装Thonny后在右下角选择解释器为“MicroPython (Raspberry Pi Pico)”。连接成功后你会在Shell窗口中看到MicroPython的提示符这里可以执行简单的Python命令例如print(“Hello Poetic Ticks”)。3.2 项目代码结构设计一个清晰的项目结构有助于管理代码。我们将在Pico的内部存储或通过Thonny上传文件中创建如下结构的文件/ ├── boot.py # 启动脚本可设置初始环境本项目需求简单可留空或默认 ├── main.py # 主程序入口项目核心逻辑 ├── config.py # 配置文件存放API密钥、网络参数等敏感信息 ├── w5100s_driver.py # W5100S模块的驱动封装 ├── epaper_driver.py # 电子墨水屏的驱动封装 ├── fonts/ # 字体文件目录 │ ├── font16.py │ └── font24.py └── lib/ # 第三方库目录如有 └── ...关键文件说明main.py这是MicroPython上电后自动运行的文件。我们的主循环、定时逻辑都在这里。config.py非常重要这里存放所有需要保密的配置如OpenAI API Key、网络SSID密码如果未来扩展Wi-Fi等。务必确保此文件不被上传到公开的代码仓库。示例内容# config.py OPENAI_API_KEY sk-你的真实API密钥 NETWORK_CONFIG { mac: (0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED), # 自定义MAC地址 ip: 192.168.1.200, # 静态IP或设置为None使用DHCP subnet: 255.255.255.0, gateway: 192.168.1.1, dns: 8.8.8.8 }w5100s_driver.py和epaper_driver.py这两个驱动文件需要我们从模块供应商提供的示例代码或社区开源库中移植。核心工作是封装初始化、发送接收数据、刷新屏幕等底层操作向上提供简洁的接口如w5100s.connect_tcp(host, port)epaper.display_text(text, x, y, color)。3.3 核心驱动移植W5100S与e-Paper驱动移植是项目中最需要耐心的一环。通常芯片厂商会提供Arduino C的示例库。我们需要参考其逻辑用MicroPython重写。对于W5100S理解通信协议W5100S通过SPI接受命令和数据。我们需要实现最基本的几个函数_spi_write()、_spi_read()、_write_reg()、_read_reg()来读写其内部寄存器。初始化流程参考数据手册初始化步骤通常包括复位芯片、设置MAC地址、设置子网掩码、网关、源IP地址、使能中断等。实现Socket抽象W5100S支持多个硬件Socket。我们需要封装一个Socket类包含connect(),send(),recv(),close()等方法使其用法接近Python标准的socket库。集成DHCP客户端可选但推荐为了实现自动获取IP需要实现一个简单的DHCP客户端协议。这有一定复杂度网上有开源的MicroPython DHCP客户端代码片段可以参考。如果网络环境固定使用静态IP更简单稳定。对于e-Paper屏幕获取时序参数从屏幕的数据手册或厂家示例代码中找到关键时序参数如复位脉冲宽度、数据/命令设置时间、忙信号等待超时等。实现底层GPIO控制用MicroPython的machine.Pin类来操作CS、DC、RST、BUSY等控制引脚。移植显示流程e-Paper刷新分为几个阶段初始化、清屏、发送黑白/红色位图数据、刷新显示、进入睡眠。核心是将要显示的图像或文字转换成的图像数据按照屏幕要求的格式通常是水平扫描、1位像素通过SPI发送出去。集成字体渲染我们需要一个简单的点阵字体库。可以将中英文字体转换成Python字节数组的形式存放在fonts/目录下。驱动中需要实现一个draw_text()函数根据字符编码从字体文件中取出点阵数据合并到显示缓冲区中。踩坑实录在移植e-Paper驱动时我最开始直接复制了Arduino代码的延时长度如delay_ms(200)。但在MicroPython中time.sleep(0.2)的精度和系统负载可能导致实际延时不足。这导致屏幕初始化失败显示乱码。解决办法是适当延长关键时序的延时并在忙信号等待处使用while busy_pin.value() 1:这样的主动等待循环而不是固定延时确保每一步硬件都准备就绪。4. 网络通信与OpenAI API集成实战驱动准备就绪后我们就可以让时钟“开口说话”了。这部分的核心是教会Pico通过W5100S接入互联网并与OpenAI的ChatGPT API进行对话。4.1 构建HTTP客户端从Socket到JSONMicroPython的标准库通常没有完整的requests库我们需要从底层的TCP Socket开始手动构建HTTP请求。首先在w5100s_driver.py中确保我们的Socket类能够建立TCP连接。然后在main.py或一个独立的http_client.py中我们可以编写一个简单的HTTP POST函数import json from w5100s_driver import W5100S, Socket def post_json_to_openai(api_key, prompt): 向OpenAI API发送请求并返回解析后的响应。 # 1. 准备HTTP请求数据 host api.openai.com port 443 # HTTPS端口 url_path /v1/chat/completions # 构建请求体JSON格式 request_body { model: gpt-3.5-turbo, # 选用性价比高的模型 messages: [ {role: system, content: 你是一位诗人请根据用户提供的时间、日期和情境创作一首简短优美的中文诗歌或一句富有哲理的箴言。回答只需包含诗歌或句子本身无需任何额外说明。}, {role: user, content: prompt} ], max_tokens: 150, temperature: 0.8, # 控制创造性0.7-0.9比较合适 } body_str json.dumps(request_body) # 构建HTTP请求头 headers fPOST {url_path} HTTP/1.1\r Host: {host}\r Authorization: Bearer {api_key}\r Content-Type: application/json\r Content-Length: {len(body_str)}\r Connection: close\r \r # 2. 建立TCP连接 (注意此处需要处理TLS/SSL见下文) # 伪代码socket.connect(host, port) # socket.send(headers body_str) # 3. 接收响应 response socket.recv(4096) # 接收数据 socket.close() # 4. 解析HTTP响应提取JSON部分 # 通常响应格式为HTTP/1.1 200 OK\r\n...\r\n\r\n{...JSON...} # 需要找到第一个“\r\n\r\n”后的内容 header_end response.find(b\r\n\r\n) if header_end ! -1: json_str response[header_end4:] # 跳过空行 try: data json.loads(json_str) # 提取AI生成的诗歌内容 poem data[choices][0][message][content].strip() return poem except (KeyError, json.JSONDecodeError) as e: print(Failed to parse OpenAI response:, e) return None return None关键点与挑战HTTPSTLS/SSLOpenAI API使用HTTPS这意味着我们的TCP连接需要进行TLS加密。MicroPython通常集成了ussl或ssl模块但W5100S是硬件TCP/IP栈标准的socketSSL包装可能不直接适用。解决方案有两种使用HTTPS代理搭建一个简单的HTTP代理服务器例如用Python的Flask写在云服务器或本地树莓派上让Pico以HTTP协议将请求发送给代理由代理负责转发HTTPS请求到OpenAI并返回结果。这绕开了Pico端的TLS复杂性。使用支持TLS的第三方网络库寻找社区开发的、针对特定硬件如W5500/W5100S并集成了TLS功能的MicroPython网络库。这需要一定的搜索和适配能力。个人建议在原型阶段使用方案一的代理方法是最快最稳定的。它简化了嵌入式端的逻辑将复杂的TLS握手和证书验证交给了性能更强的代理服务器。你只需要确保代理服务器本身稳定运行且网络可达。4.2 设计生成诗歌的提示词PromptPrompt的设计直接决定了AI输出内容的质量和相关性。我们的目标是让AI根据时间、日期等上下文生成应景的文字。在main.py中我们可以这样构建Promptimport utime def build_poem_prompt(): # 获取当前时间需要先通过NTP或其他方式同步时间见下一节 current_time utime.localtime() hour current_time[3] minute current_time[4] weekday current_time[6] # 0-6 for Monday-Sunday month current_time[1] day current_time[2] # 将时间转换为更有意境的中文描述 time_period 凌晨 if 5 hour 8: time_period 清晨 elif 8 hour 12: time_period 上午 elif 12 hour 14: time_period 中午 elif 14 hour 18: time_period 下午 elif 18 hour 22: time_period 夜晚 else: time_period 深夜 weekdays [星期一, 星期二, 星期三, 星期四, 星期五, 星期六, 星期日] weekday_str weekdays[weekday] # 构建Prompt prompt f现在是中国时间{month}月{day}日{weekday_str}{time_period}{hour}点{minute}分。 请创作一首与这个时刻的氛围、感受或象征意义相关的短诗或一句箴言。要求语言简洁优美富有诗意或哲理长度控制在4行以内。 # 可以进一步丰富上下文例如结合季节、天气如果接了传感器 # seasons [冬, 春, 夏, 秋] # season_idx (month % 12 3) // 3 # 简单计算季节 # prompt f 现在大约是{seasons[season_idx]}季。 return prompt这个Prompt明确了时间、日期信息并给出了具体的格式和风格要求“短诗”、“4行以内”、“简洁优美”能有效引导AI生成符合我们期望的内容。4.3 错误处理与网络重试机制网络请求不可能100%成功。我们必须设计健壮的错误处理机制。超时设置Socket连接和接收数据都应设置超时避免因网络阻塞导致程序永久挂起。重试逻辑对于网络错误、连接失败、HTTP非200响应等实现指数退避重试。例如第一次失败后等待2秒重试第二次失败等待4秒最多重试3次。降级方案当所有重试都失败或API调用返回无效内容时应该有一个本地的“诗句库”作为后备。可以从预先存储的几十条优美句子中随机选择一条显示保证时钟始终有内容展示而不是黑屏或报错。日志记录将重要的操作如获取时间、请求API、显示更新和发生的错误通过print语句输出到串口方便调试。在最终产品中可以简化或关闭部分日志。def get_poem_with_retry(api_key, prompt, max_retries3): for attempt in range(max_retries): try: poem post_json_to_openai(api_key, prompt) if poem and len(poem) 0: return poem # 成功则返回 else: print(fAttempt {attempt1}: Got empty response.) except Exception as e: print(fAttempt {attempt1} failed with error: {e}) # 重试前等待指数退避 wait_time 2 ** (attempt 1) print(fWaiting {wait_time} seconds before retry...) utime.sleep(wait_time) # 所有重试都失败返回后备诗句 print(All retries failed. Using fallback poem.) return get_fallback_poem()5. 时间同步、任务调度与低功耗优化一个合格的时钟准确的时间是根本。同时我们需要一个可靠的任务调度器来管理定时获取诗歌、刷新屏幕等任务。5.1 高精度时间同步NTP协议实现Pico本身没有实时时钟RTC断电后时间会丢失。因此我们需要通过网络定时从NTP服务器同步时间。实现NTP客户端NTP网络时间协议使用UDP通信。我们需要在W5100S驱动中实现UDP Socket功能。NTP协议数据包格式固定主要工作是构建一个请求包从0x1B开始填充48字节发送到NTP服务器如pool.ntp.org的123端口然后解析返回包中的时间戳。时间戳转换NTP返回的是自1900年1月1日以来的秒数UTC。我们需要将其转换为MicroPython的utime模块能处理的时间元组并考虑时区偏移例如北京时间是UTC8。定期同步在main.py中启动一个定时器或在一个循环中每过一段时间例如每6小时同步一次NTP时间。首次上电时必须先同步时间才能进行后续的定时任务。def sync_time_via_ntp(): NTP_SERVER pool.ntp.org NTP_PORT 123 NTP_DELTA 2208988800 # 秒数1900年与1970年之间的时间差 TIMEZONE_OFFSET 8 * 3600 # 北京时间 UTC8 # 创建UDP socket sock Socket(SOCK_DGRAM) # 假设我们的Socket类支持类型参数 sock.connect(NTP_SERVER, NTP_PORT) # 构建NTP请求数据包 ntp_packet bytearray(48) ntp_packet[0] 0x1B # LI, Version, Mode sock.send(ntp_packet) # 接收响应设置超时 response sock.recv(48) sock.close() if len(response) 48: # 解析响应包中的传输时间戳位于第40-43字节 secs int.from_bytes(response[40:44], big) secs - NTP_DELTA # 转换为Unix时间戳1970年起 secs TIMEZONE_OFFSET # 调整时区 # 设置Pico的系统时间 tm utime.gmtime(secs) # gmtime接受秒数 # 注意MicroPython的machine.RTC()可能用于设置硬件RTC如果外接了RTC模块 # 对于无RTC的Pico我们主要维护一个软件时间每次同步后更新一个基准变量。 return tm # 返回调整后的时间元组 return None5.2 主循环与任务调度设计我们的主程序需要长期稳定运行主要任务包括整点触发每分钟检查一次如果到了整点或设定的时间则触发诗歌获取与更新流程。时间显示更新虽然e-Paper不刷新也能保持但我们可能想在屏幕一角以较小字体实时显示当前时间每秒更新。这需要局部刷新功能以避免全屏闪烁。网络状态监测定期检查网络连接是否正常如果断开则尝试重新初始化W5100S。一个简单可靠的主循环结构如下import utime from machine import Timer last_hour -1 last_minute -1 def main_loop(): global last_hour, last_minute # 初始化硬件 w5100s.init() epaper.init() sync_time_via_ntp() # 首次同步时间 while True: # 1. 获取当前时间 current_time utime.localtime() hour current_time[3] minute current_time[4] # 2. 整点任务例如在每小时的第5分钟触发避开0分可能的高负载 if minute 5 and hour ! last_hour: print(fTriggering poem update for hour {hour}) prompt build_poem_prompt() poem get_poem_with_retry(config.OPENAI_API_KEY, prompt) if poem: # 清屏并显示新诗歌同时更新时间 epaper.clear() epaper.draw_text(poem, 10, 50, epaper.BLACK) epaper.draw_time(current_time, 700, 10, epaper.RED) # 在角落显示时间 epaper.display() last_hour hour # 记录已更新的小时 else: print(Failed to get poem, will retry next hour.) # 3. 每分钟更新时间显示局部刷新 if minute ! last_minute: epaper.partial_refresh_time(current_time) # 假设实现了局部刷新函数 last_minute minute # 4. 休眠以降低功耗Pico的RP2040支持休眠模式 utime.sleep(30) # 休眠30秒然后继续循环检查5.3 低功耗考量与优化虽然接入了电源但优化功耗仍是一个好习惯可以减少发热提升元件寿命。利用RP2040的休眠模式在utime.sleep()期间CPU处于低功耗状态。我们可以使用更深的休眠模式如machine.lightsleep()或machine.deepsleep()但需要注意这些模式可能会停掉外设或需要特定引脚唤醒需要根据外设情况谨慎使用。外设电源管理e-Paper屏幕在刷新完成后可以通过发送命令使其进入“深度睡眠”模式此时功耗极低约几微安。W5100S模块也通常有软件关断或低功耗模式可以在不进行网络通信时进入。降低刷新频率除非必要不要频繁刷新e-Paper屏幕。时间显示可以每分钟甚至每5分钟局部刷新一次。诗歌更是每小时只刷新一次。关闭调试输出在最终版本中减少或关闭print语句因为串口输出也会消耗一定的能量。通过以上步骤我们构建了一个从硬件连接到软件逻辑从网络通信到任务调度的完整智能诗歌时钟系统。每个环节都包含了选型理由、实现细节和避坑经验。这个项目不仅是一个有趣的创意实现更是一个综合运用嵌入式开发、网络编程和AI应用的良好范例。你可以在此基础上继续扩展例如增加温湿度传感器让诗歌结合天气或者加入物理按钮让用户手动触发诗歌生成让这个“诗意的滴答”声更加丰富多彩。