1. 项目概述与核心思路最近在工作室捣鼓桌面摆件总想弄点既有科技感又实用的东西。之前看到过一些智能镜子的项目要么是树莓派加显示器体积庞大要么是纯软件模拟少了点硬核的乐趣。直到我发现了Adafruit的PyPortal开发板这块自带屏幕、Wi-Fi、光传感器还能用CircuitPython编程的小板子简直就是为这种创意项目量身定做的。于是一个想法冒了出来能不能用它做一个迷你智能镜子平时它就是一面普通的镜子当你需要看时间或天气时挥挥手信息就像魔法一样浮现在镜面上过几秒又自动隐去回归镜子的本质。这个项目的核心就是利用PyPortal的硬件特性结合物联网IoT思维打造一个“隐形”的信息终端。PyPortal作为大脑负责联网获取天气数据、控制显示单向镜面膜是实现“魔法”视觉效果的关键它让屏幕在关闭时是镜子点亮时则能透出图像光传感器则充当了交互的“眼睛”通过检测光线变化来感知你的手势实现非接触式唤醒。整个系统运行在CircuitPython上这是一种对初学者极其友好的微控制器编程语言让你能像在电脑上写Python脚本一样操控硬件。无论你是想入门嵌入式开发和物联网还是寻找一个有趣的周末DIY项目这个智能镜子都是一个绝佳的选择。它涵盖了硬件组装、软件编程、API调用和交互设计等多个环节做完之后摆在桌上既是一个独特的装饰品也是一个实实在在的天气时钟。2. 硬件选型与物料清单解析动手之前理清需要哪些东西至关重要。这个项目的硬件部分可以清晰地分为核心控制、光学组件、结构外壳和连接配件四大类。每一件的选择都直接影响到最终的效果和制作体验。2.1 核心控制单元为什么是PyPortal市面上能跑Python的开发板不少比如ESP32、树莓派Pico但PyPortal的集成度是它最大的优势。我们来看看它的核心配置微控制器基于ATSAMD51这是一颗Cortex-M4内核的芯片性能足以流畅运行CircuitPython并处理网络请求。显示与触摸集成了一块3.2英寸的TFT触摸屏分辨率320x240。这是我们信息的最终输出窗口。无线连接板载ESP32协处理器专门负责Wi-Fi连接稳定且省电让主控芯片能专注于应用逻辑。传感器自带一个光敏电阻光线传感器这是我们实现挥手交互的硬件基础。其他接口MicroSD卡槽、蜂鸣器、三个按钮和一个NeoPixel RGB LED扩展性很强。选择PyPortal意味着你无需再单独购买屏幕、Wi-Fi模块也不用费力地去焊接光敏电阻和分压电路。它提供了一个“开箱即用”的完整硬件平台让我们能把精力集中在创意和编程上大大降低了项目的入门门槛和失败率。2.2 光学魔法核心镜面膜的选择与原理智能镜子的视觉效果九成功劳在这张膜上。这里用的是单向镜面膜也叫双向透视膜。它的原理很简单膜上镀有一层非常稀薄的金属层通常是铝。这层金属能反射一部分光线同时允许另一部分光线透过。镜子模式屏幕关闭当镜子一侧的环境光比如房间灯光比屏幕一侧强得多时大部分光线被膜反射回你的眼睛你看到的就是自己的镜像屏幕的黑色背景几乎不可见。显示模式屏幕点亮当屏幕发出的光强于环境光时光线就能穿透这层薄膜让你清晰地看到屏幕上的内容。选购要点尺寸项目所需亚克力尺寸为96.5mm x 55mm但膜需要裁得比这更大一些以便覆盖和操作。原文推荐12英寸宽约305mm的卷材剪下一小块即可非常经济。透光率与反射率通常透光率在20%-30%反射率在50%-60%的膜效果比较均衡。透光率太高镜子效果会变差太低则屏幕需要很亮才能看清。背胶类型一定要选择静电吸附或水贴型的膜。这种膜依靠水和肥皂液的润滑来粘贴可以反复调整位置贴坏了也能揭下来重贴对新手极其友好。千万避免用那种撕开即粘的永久性背胶膜一旦贴歪就无法挽回。2.3 结构件与辅助材料为了让一切稳固且美观我们需要一个外壳和支架。原文提供了3D打印文件这是最便捷的方式。3D打印外壳包含主壳体、后盖和支架三个零件。建议使用PLA或PETG材料打印层高0.2mm填充率20%-25%即可保证强度。打印时无需支撑注意确保打印床平整以获得光滑的贴合面。亚克力镜片厚度为1/8英寸约3.17mm需要按照提供的DXF或SVG文件进行激光切割。这是镜面的本体切割边缘务必光滑否则会影响装入外壳。五金件M3x6mm 螺丝x4用于将PyPortal主板固定到外壳上。M3x7mm 拇指螺丝x2 M3尼龙防松螺母x2用于连接支架和外壳拇指螺丝方便手拧拆卸。辅助工具美工刀或裁纸刀用于裁剪镜面膜。刮板贴膜时刮除气泡和水渍通常买膜会附赠。喷壶装入肥皂水16盎司水加6滴洗手液贴膜时润滑用。无尘布、酒精棉片清洁亚克力表面。美纹纸胶带用于帮助揭开镜面膜的保护层以及后续遮挡屏幕漏光。物料清单汇总表类别物品名称规格/说明数量关键作用核心控制Adafruit PyPortal或 PyPortal Pynt1主控、显示、联网、传感光学组件单向镜面膜静电吸附/水贴型宽12英寸1卷实现镜面与显示切换透明亚克力板厚3.17mm96.5x55mm1块膜的承载基板结构外壳3D打印外壳包含壳体、后盖、支架1套固定所有组件连接件M3x6mm 螺丝圆头或沉头4颗固定PyPortalM3x7mm 拇指螺丝2颗连接支架M3尼龙防松螺母2颗配合拇指螺丝辅助工具Micro USB数据线必须能传数据1根供电与编程5V USB电源适配器或充电宝1个长期供电美工刀、尺子1套裁剪薄膜喷壶、刮板1套贴膜工具异丙醇、无尘布若干清洁表面3. 软件环境搭建与CircuitPython固件烧录硬件准备就绪后我们要让PyPortal“活”起来。这一步的核心是给它安装“操作系统”——CircuitPython并准备好编程环境。3.1 安装CircuitPython固件CircuitPython是Adafruit主导开发的一个微控制器Python实现它的最大特点是让开发板在电脑上显示为一个U盘名为CIRCUITPY你可以直接编辑里面的Python文件来运行程序无需复杂的编译上传过程。烧录步骤详解下载固件访问 CircuitPython官网 找到对应PyPortal的最新版本.uf2文件并下载。务必确认型号匹配PyPortal 和 PyPortal Pynt 的固件不同。进入引导加载模式用一条可靠的数据线很多手机充电线只能充电无法传输数据务必确认将PyPortal连接到电脑。快速双击PyPortal板载的Reset按钮板子中间顶部有一个红色箭头指向的那个小按钮。成功标志板载的NeoPixel RGB LEDReset按钮旁边会变成绿色并且电脑上会出现一个名为PORTALBOOT或类似的U盘盘符。如果LED变红说明进入引导模式失败请检查USB线或接口。拖放烧录将下载好的.uf2文件直接拖入PORTALBOOT盘符。此时LED会闪烁PORTALBOOT盘符消失稍等片刻会出现一个新的名为CIRCUITPY的盘符。这表明CircuitPython已经成功安装并运行。注意第一次进入CIRCUITPY驱动器你可能只看到一个boot_out.txt文件这是正常的。我们的代码和库文件需要后续手动放入。3.2 获取项目代码与库文件智能镜子的代码并非从头编写Adafruit提供了完整的项目包Project Bundle。这个包包含了主程序、图形库、字体和图标等所有必要文件。下载项目包从项目页面找到“Download Project Bundle”按钮点击后会下载一个ZIP压缩包。解压与文件结构解压后你会看到如下关键文件和文件夹code.py项目的主程序文件。CircuitPython启动时会自动执行这个文件。openweather_graphics.py一个处理天气数据显示和图形绘制的辅助类库封装了复杂的绘图逻辑。lib/文件夹存放项目依赖的CircuitPython库文件例如adafruit_pyportal。fonts/和icons/文件夹存放显示所需的字体文件和天气图标。部署到PyPortal将CIRCUITPY驱动器中的所有默认文件如果有备份后把解压得到的lib、fonts、icons两个文件夹以及openweather_graphics.py和code.py文件全部复制到CIRCUITPY驱动器的根目录下。文件部署后的CIRCUITPY驱动器根目录应类似这样CIRCUITPY/ ├── code.py ├── openweather_graphics.py ├── boot_out.txt ├── lib/ │ ├── adafruit_pyportal/ │ ├── adafruit_bitmap_font/ │ ├── adafruit_display_text/ │ └── ... (其他依赖库) ├── fonts/ │ └── ... (字体文件) └── icons/ └── ... (PNG图标文件)3.3 关键配置settings.toml文件为了让PyPortal能连接你的Wi-Fi并获取天气数据需要创建一个名为settings.toml的配置文件。这个文件包含了所有的敏感信息和个性化设置。创建文件在CIRCUITPY驱动器根目录下新建一个文本文件将其重命名为settings.toml注意扩展名。编辑内容用任何文本编辑器如VS Code、Notepad打开填入以下信息CIRCUITPY_WIFI_SSID 你的Wi-Fi名称 CIRCUITPY_WIFI_PASSWORD 你的Wi-Fi密码 openweather_token 你的OpenWeather API密钥 timezone Asia/Shanghai # 根据你的时区修改例如America/New_York参数详解与获取方法CIRCUITPY_WIFI_SSID/PASSWORD你的家庭或工作室Wi-Fi凭证。确保2.4GHz网络可用PyPortal不支持5GHz。openweather_token这是从OpenWeatherMap网站申请的免费API密钥。访问 OpenWeatherMap 注册一个免费账户。登录后在“API Keys”选项卡下系统会生成一个默认的密钥一串类似b6907d289e10d714a6e88b30761fae22的字符复制它即可。免费套餐通常足够个人使用。timezone时区设置用于正确显示本地时间。可以从 时区列表 中查找你所在城市的时区字符串。重要安全提示settings.toml文件包含了你的网络密码和API密钥。请勿将此文件上传到公开的代码仓库如GitHub。CircuitPython会安全地读取这些信息。4. 代码原理深度剖析与定制修改把文件拷进去镜子就能工作了吗差不多但理解代码如何工作才能让你真正掌控这个项目并根据自己的需求进行定制。我们来深入看看code.py的核心逻辑。4.1 主程序框架与初始化程序开头进行了必要的导入和设置。关键点在于PyPortal对象的初始化它封装了网络请求、显示控制等复杂功能。# 初始化pyportal对象指定数据源、JSON解析路径等 pyportal PyPortal(urlDATA_SOURCE, json_pathDATA_LOCATION, status_neopixelboard.NEOPIXEL, default_bg0x000000) # 背景设为黑色 display board.DISPLAY display.rotation 270 # 将屏幕旋转270度变为竖屏显示display.rotation 270因为我们的镜子是竖屏形态所以需要将默认的横屏显示旋转过来。default_bg0x000000将默认背景设为纯黑色。在镜面下黑色像素点相当于“关闭”反射环境光看起来就是镜子的一部分而其他颜色的像素点发光才能穿透镜面膜被看到。因此UI设计应以深色背景为主。4.2 光传感器交互逻辑如何感知“挥手”这是本项目最精妙的部分。PyPortal的光传感器返回的是一个模拟电压值0-3.3V对应环境光强度。但直接读这个值来判断手势很不稳定因为室内基础光照可能不同。代码采用了一种巧妙的差分比较算法来检测光线的快速变化即手挥过造成的阴影。# 每0.1秒读取一次光传感器 if (time.monotonic() - switch_clock) 0.1: reading getVoltage(analogin) # 读取电压值 # 计算一个0-1之间的比例值反映“黑暗程度” ratio ((ratio pow(1.0 - reading / 3.3, 4.0)) / 2.0) # 创建一个用于比较的阈值last_ratio last_ratio^2 power_ratio last_ratio pow(last_ratio, 2.0)getVoltage(pin)将传感器的16位ADC原始值0-65535转换为实际的电压值0-3.3V。ratio的计算1.0 - reading / 3.3得到的是“无光”的比例电压越低环境越亮此值越小。对其进行4次方运算pow(..., 4.0)是一个非线性放大过程目的是让较小的变化如手的阴影在数值上产生更明显的波动提高检测灵敏度。最后与上一次的ratio取平均起到一定的平滑滤波作用。power_ratio这是一个动态阈值。当环境较亮last_ratio较小时power_ratio也较小环境较暗时power_ratio会迅速增大因为平方项。这个设计让系统在不同环境光下都能自适应。唤醒判断逻辑if power_ratio 1: # 环境相对较亮的情况 if ratio power_ratio: # 当前“暗度”超过动态阈值 pyportal.set_backlight(1) # 开屏 light_clock time.monotonic() else: # 环境相对较暗的情况 if ratio - last_ratio 0.003: # “暗度”发生一个微小但快速的正向跳变 pyportal.set_backlight(1) light_clock time.monotonic()亮环境策略主要看ratio是否超过了power_ratio。挥手遮光会导致ratio突然增大从而触发。暗环境策略在已经很暗的环境里ratio和power_ratio的绝对值都很大比较绝对值可能不敏感。因此改为检测ratio的瞬时变化量ratio - last_ratio 0.003。手快速挥过引起的微小变化也能被捕捉到。自动熄屏无论以何种方式点亮屏幕都会重置一个10秒的计时器light_clock。10秒无新手势则pyportal.set_backlight(0)关闭背光镜子恢复反射状态。4.3 数据获取与显示更新智能镜子的信息来自网络但频繁请求会浪费资源也可能触发API限制。代码里设置了合理的更新间隔。# 每小时从网络获取一次时间首次运行立即获取 if (not localtile_refresh) or (time.monotonic() - localtile_refresh) 3600: pyportal.get_local_time() # 每10分钟更新一次天气数据首次运行立即获取 if (not weather_refresh) or (time.monotonic() - weather_refresh) 600: value pyportal.fetch() gfx.display_weather(value)时间同步pyportal.get_local_time()会通过Wi-Fi从Adafruit IO的服务器获取精确的互联网时间并据此更新板载RTC实时时钟。之后屏幕上的时间就由这个本地RTC每30秒更新一次gfx.update_time()无需频繁联网。天气获取pyportal.fetch()会向我们在DATA_SOURCE中设置的OpenWeatherMap API地址发起HTTP GET请求返回一个JSON格式的天气数据。gfx.display_weather(value)则负责解析这个JSON并将温度、天气状况、图标等绘制到屏幕上。自定义你的位置修改code.py开头的LOCATION变量即可。格式为“城市名, 国家代码”国家代码需遵循ISO 3166标准如“Beijing, CN”、“London, GB”。5. 镜面制作与硬件组装实战软件部分搞定后我们来处理最需要耐心和细心的硬件部分贴膜和组装。这一步做得好最终效果会非常惊艳做得不好则可能满是气泡和皱纹。5.1 亚克力镜片的准备与贴膜贴膜是成败的关键遵循“湿贴法”能极大提高容错率。清洁与准备用异丙醇和无尘布彻底清洁亚克力板确保表面无灰尘、油脂和指纹。全程佩戴手套操作避免二次污染。在工作台上铺上毛巾或使用托盘防止肥皂水漫延。按比例约500毫升水加6滴洗手液配制肥皂水装入喷壶。裁剪镜面膜从卷材上裁下一片比亚克力板四周各大出至少3-5厘米的薄膜。多裁几片备用以防失手。用美纹纸胶带在薄膜保护层的四个角各粘一小段做成“提手”方便后续分离。湿贴过程湿润基材将亚克力板平放用喷壶将肥皂水均匀喷满整个表面形成一层水膜。揭膜与湿润利用胶带“提手”小心揭去薄膜的保护层立即将薄膜的粘合面也喷满肥皂水。这一步要快防止灰尘附着。对位与贴合将湿润的薄膜轻轻平铺在湿润的亚克力板上。由于有水膜此时薄膜可以轻松滑动。仔细调整位置使其居中。刮除水与气泡用刮板或银行卡包上软布从中心向四周刮压将水和气泡彻底赶出。用力要均匀、持续看到有水被从边缘挤出为止。静置与修边将贴好的镜片放在通风处静置至少30分钟让水分完全蒸发、粘合剂固化。之后用锋利的美工刀沿着亚克力板边缘小心地裁掉多余薄膜。实操心得环境是关键尽量在无风、灰尘少的环境操作比如浴室先除尘并关闭排风。水要多肥皂水是润滑剂宁多勿少。足够的水膜能让薄膜有充足的调整时间。气泡处理如果产生小气泡可以尝试用刮板将其推到边缘如果气泡顽固或进了灰尘不要犹豫趁水未干时揭起重贴。这就是为什么建议多裁几片备用。耐心等待修边前务必确保边缘已干透否则裁切时薄膜容易收缩或起皱。5.2 外壳组装与光路处理组装过程相对简单但有一个细节直接影响显示效果防止屏幕漏光。组装支架将两个M3尼龙防松螺母放入外壳侧面的六角形凹槽内从外侧穿过支架孔拧上M3拇指螺丝。尼龙螺母能防止螺丝因震动松动。安装亚克力镜片再次清洁镜片仅触摸边缘将其有膜的一面朝外对准外壳前面的凹槽轻轻按压直至卡入到位。听到轻微的“咔哒”声即表示安装牢固。处理PyPortal漏光PyPortal屏幕边缘与外壳之间可能存在微小缝隙在黑暗环境下屏幕点亮时这些缝隙会漏出光线破坏镜面的“隐形”效果。解决方法剪一小条黑色电工胶带或美纹纸胶带贴在PyPortal屏幕的上边缘即装入后朝向镜片的那一侧让胶带稍微包裹住屏幕边缘。这能有效吸收和阻挡从侧面漏出的光。固定PyPortal将PyPortal贴胶带的一边朝上放入外壳对齐四个安装孔用4颗M3x6mm螺丝固定。切勿过度拧紧以免压坏PCB或导致屏幕受力不均。合上后盖将后盖对准外壳四周均匀用力按压直至所有卡扣啮合。通电测试插入Micro USB线供电。首次启动PyPortal会连接Wi-Fi并获取数据。此时你可以用手在光传感器前挥动测试屏幕唤醒和熄灭是否正常。6. 调试优化与常见问题排查即使完全按照步骤第一次也可能遇到些小问题。这里汇总了一些常见情况及排查思路。6.1 屏幕显示相关问题现象可能原因排查与解决步骤屏幕完全不亮1. 供电不足或USB线仅能充电。2. 背光被代码强制关闭或亮度设为0。3. 硬件故障。1. 更换已知良好的数据线和5V/2A以上的电源适配器。2. 检查code.py中pyportal.set_backlight()的值应为1开或0关。尝试在代码开头加pyportal.set_backlight(1)测试。3. 重新烧录CircuitPython固件排除软件问题。屏幕常亮挥手不熄灭1. 光传感器检测逻辑未触发熄屏条件。2.light_clock计时器逻辑错误。3. 环境光太暗传感器始终认为处于“需点亮”状态。1. 在代码中打印ratio和power_ratio的值通过串行终端观察挥手时数值变化是否正常。2. 检查if (time.monotonic() - light_clock) 10:这行代码确认计时器在挥手时被重置light_clock time.monotonic()。3. 适当调整ratio - last_ratio 0.003中的阈值如改为0.005降低在暗环境下的灵敏度。挥手无法唤醒屏幕1. 光传感器被遮挡或损坏。2. 唤醒判断阈值不合适。3. 环境光变化过于复杂如闪烁的灯光。1. 确认PyPortal上的光传感器一个小黑点未被外壳或胶带遮挡。2. 在亮环境下尝试增大手势幅度在暗环境下尝试减小0.003这个变化量阈值。3. 尝试在代码中增加一个简单的print(reading)通过串口监视器观察挥手时电压值是否有明显跌落。显示内容模糊或对比度差1. 镜面膜质量不佳或贴反。2. 屏幕亮度设置过低。3. UI背景色不是纯黑。1. 确保膜的有反射层的一面朝外通常摸起来更光滑。在屏幕点亮时从侧面观察膜是否平整无皱。2. CircuitPython中可通过display.brightness调整背光亮度0.0-1.0适当调高。3. 检查openweather_graphics.py中绘制的背景色是否为0x000000纯黑。6.2 网络与数据获取问题现象可能原因排查与解决步骤无法连接Wi-Fi1.settings.toml中SSID或密码错误。2. 网络是5GHz频段。3. Wi-Fi信号太弱。1. 仔细检查settings.toml文件确保没有多余空格使用英文引号。2. PyPortal仅支持2.4GHz Wi-Fi请将路由器设置为双频混合或单独连接2.4GHz网络。3. 将PyPortal靠近路由器测试。可在代码pyportal PyPortal(...)初始化后添加pyportal.network._wifi.radio.connect(...)并捕捉异常打印具体错误。无法获取天气数据1. OpenWeather API密钥无效或未设置。2.LOCATION格式错误。3. 网络连接超时。1. 确认settings.toml中的openweather_token正确且OpenWeather账户的API Key状态正常免费套餐有调用频率限制。2. 确保LOCATION格式为“City, CountryCode”城市名用英文国家代码两个字母。可在浏览器中直接访问DATA_SOURCE拼接的URL看能否返回JSON数据。3. 增加网络请求的超时时间在PyPortal初始化参数中可设置。时间显示不正确1. 时区timezone设置错误。2. 未能成功从网络获取时间。1. 核对settings.toml中的timezone值确保是有效的时区字符串如Asia/Shanghai。2. 查看串口输出确认是否有“Getting time from internet!”的成功提示或相关的错误信息。6.3 机械与外观问题现象可能原因排查与解决步骤镜面膜有气泡或皱纹1. 贴膜时水太少或刮压不充分。2. 环境灰尘多。3. 薄膜本身有瑕疵。1.预防优于治疗贴膜时喷足肥皂水刮板用力均匀、缓慢。2. 小气泡可用刮板推向边缘大气泡或灰尘需揭起重贴。3. 裁切新的一片重试。亚克力板无法卡入外壳1. 亚克力板尺寸切割有误差。2. 3D打印外壳收缩导致卡槽变小。3. 贴膜后厚度增加。1. 用游标卡尺测量亚克力板尺寸确保是96.5mm x 55mm。2. 轻微打磨外壳卡槽的内侧边缘或稍微打磨亚克力板的边缘。3. 如果膜贴得太靠边导致边缘增厚需更精细地修边。屏幕在镜面后亮度不均或有光晕屏幕漏光处理不当。1. 确保在PyPortal屏幕的上边缘贴了足够宽的黑胶带。2. 检查外壳内部是否为深色可涂黑减少内部反射。3. 在屏幕与外壳之间垫一圈黑色海绵或绒布条彻底密封缝隙。完成所有组装和调试后给你的智能镜子找一个合适的角落放好。它不仅仅是一个显示天气和时间的工具更是一个展示了硬件、软件与设计巧妙结合的作品。每当有朋友好奇地挥手看到信息浮现时惊讶的表情就是对这个项目最好的肯定。你可以在此基础上继续扩展比如增加日程显示、新闻摘要或者连接其他传感器让它变得更加智能。
基于PyPortal与单向镜面膜的智能镜子DIY：手势交互与物联网应用
1. 项目概述与核心思路最近在工作室捣鼓桌面摆件总想弄点既有科技感又实用的东西。之前看到过一些智能镜子的项目要么是树莓派加显示器体积庞大要么是纯软件模拟少了点硬核的乐趣。直到我发现了Adafruit的PyPortal开发板这块自带屏幕、Wi-Fi、光传感器还能用CircuitPython编程的小板子简直就是为这种创意项目量身定做的。于是一个想法冒了出来能不能用它做一个迷你智能镜子平时它就是一面普通的镜子当你需要看时间或天气时挥挥手信息就像魔法一样浮现在镜面上过几秒又自动隐去回归镜子的本质。这个项目的核心就是利用PyPortal的硬件特性结合物联网IoT思维打造一个“隐形”的信息终端。PyPortal作为大脑负责联网获取天气数据、控制显示单向镜面膜是实现“魔法”视觉效果的关键它让屏幕在关闭时是镜子点亮时则能透出图像光传感器则充当了交互的“眼睛”通过检测光线变化来感知你的手势实现非接触式唤醒。整个系统运行在CircuitPython上这是一种对初学者极其友好的微控制器编程语言让你能像在电脑上写Python脚本一样操控硬件。无论你是想入门嵌入式开发和物联网还是寻找一个有趣的周末DIY项目这个智能镜子都是一个绝佳的选择。它涵盖了硬件组装、软件编程、API调用和交互设计等多个环节做完之后摆在桌上既是一个独特的装饰品也是一个实实在在的天气时钟。2. 硬件选型与物料清单解析动手之前理清需要哪些东西至关重要。这个项目的硬件部分可以清晰地分为核心控制、光学组件、结构外壳和连接配件四大类。每一件的选择都直接影响到最终的效果和制作体验。2.1 核心控制单元为什么是PyPortal市面上能跑Python的开发板不少比如ESP32、树莓派Pico但PyPortal的集成度是它最大的优势。我们来看看它的核心配置微控制器基于ATSAMD51这是一颗Cortex-M4内核的芯片性能足以流畅运行CircuitPython并处理网络请求。显示与触摸集成了一块3.2英寸的TFT触摸屏分辨率320x240。这是我们信息的最终输出窗口。无线连接板载ESP32协处理器专门负责Wi-Fi连接稳定且省电让主控芯片能专注于应用逻辑。传感器自带一个光敏电阻光线传感器这是我们实现挥手交互的硬件基础。其他接口MicroSD卡槽、蜂鸣器、三个按钮和一个NeoPixel RGB LED扩展性很强。选择PyPortal意味着你无需再单独购买屏幕、Wi-Fi模块也不用费力地去焊接光敏电阻和分压电路。它提供了一个“开箱即用”的完整硬件平台让我们能把精力集中在创意和编程上大大降低了项目的入门门槛和失败率。2.2 光学魔法核心镜面膜的选择与原理智能镜子的视觉效果九成功劳在这张膜上。这里用的是单向镜面膜也叫双向透视膜。它的原理很简单膜上镀有一层非常稀薄的金属层通常是铝。这层金属能反射一部分光线同时允许另一部分光线透过。镜子模式屏幕关闭当镜子一侧的环境光比如房间灯光比屏幕一侧强得多时大部分光线被膜反射回你的眼睛你看到的就是自己的镜像屏幕的黑色背景几乎不可见。显示模式屏幕点亮当屏幕发出的光强于环境光时光线就能穿透这层薄膜让你清晰地看到屏幕上的内容。选购要点尺寸项目所需亚克力尺寸为96.5mm x 55mm但膜需要裁得比这更大一些以便覆盖和操作。原文推荐12英寸宽约305mm的卷材剪下一小块即可非常经济。透光率与反射率通常透光率在20%-30%反射率在50%-60%的膜效果比较均衡。透光率太高镜子效果会变差太低则屏幕需要很亮才能看清。背胶类型一定要选择静电吸附或水贴型的膜。这种膜依靠水和肥皂液的润滑来粘贴可以反复调整位置贴坏了也能揭下来重贴对新手极其友好。千万避免用那种撕开即粘的永久性背胶膜一旦贴歪就无法挽回。2.3 结构件与辅助材料为了让一切稳固且美观我们需要一个外壳和支架。原文提供了3D打印文件这是最便捷的方式。3D打印外壳包含主壳体、后盖和支架三个零件。建议使用PLA或PETG材料打印层高0.2mm填充率20%-25%即可保证强度。打印时无需支撑注意确保打印床平整以获得光滑的贴合面。亚克力镜片厚度为1/8英寸约3.17mm需要按照提供的DXF或SVG文件进行激光切割。这是镜面的本体切割边缘务必光滑否则会影响装入外壳。五金件M3x6mm 螺丝x4用于将PyPortal主板固定到外壳上。M3x7mm 拇指螺丝x2 M3尼龙防松螺母x2用于连接支架和外壳拇指螺丝方便手拧拆卸。辅助工具美工刀或裁纸刀用于裁剪镜面膜。刮板贴膜时刮除气泡和水渍通常买膜会附赠。喷壶装入肥皂水16盎司水加6滴洗手液贴膜时润滑用。无尘布、酒精棉片清洁亚克力表面。美纹纸胶带用于帮助揭开镜面膜的保护层以及后续遮挡屏幕漏光。物料清单汇总表类别物品名称规格/说明数量关键作用核心控制Adafruit PyPortal或 PyPortal Pynt1主控、显示、联网、传感光学组件单向镜面膜静电吸附/水贴型宽12英寸1卷实现镜面与显示切换透明亚克力板厚3.17mm96.5x55mm1块膜的承载基板结构外壳3D打印外壳包含壳体、后盖、支架1套固定所有组件连接件M3x6mm 螺丝圆头或沉头4颗固定PyPortalM3x7mm 拇指螺丝2颗连接支架M3尼龙防松螺母2颗配合拇指螺丝辅助工具Micro USB数据线必须能传数据1根供电与编程5V USB电源适配器或充电宝1个长期供电美工刀、尺子1套裁剪薄膜喷壶、刮板1套贴膜工具异丙醇、无尘布若干清洁表面3. 软件环境搭建与CircuitPython固件烧录硬件准备就绪后我们要让PyPortal“活”起来。这一步的核心是给它安装“操作系统”——CircuitPython并准备好编程环境。3.1 安装CircuitPython固件CircuitPython是Adafruit主导开发的一个微控制器Python实现它的最大特点是让开发板在电脑上显示为一个U盘名为CIRCUITPY你可以直接编辑里面的Python文件来运行程序无需复杂的编译上传过程。烧录步骤详解下载固件访问 CircuitPython官网 找到对应PyPortal的最新版本.uf2文件并下载。务必确认型号匹配PyPortal 和 PyPortal Pynt 的固件不同。进入引导加载模式用一条可靠的数据线很多手机充电线只能充电无法传输数据务必确认将PyPortal连接到电脑。快速双击PyPortal板载的Reset按钮板子中间顶部有一个红色箭头指向的那个小按钮。成功标志板载的NeoPixel RGB LEDReset按钮旁边会变成绿色并且电脑上会出现一个名为PORTALBOOT或类似的U盘盘符。如果LED变红说明进入引导模式失败请检查USB线或接口。拖放烧录将下载好的.uf2文件直接拖入PORTALBOOT盘符。此时LED会闪烁PORTALBOOT盘符消失稍等片刻会出现一个新的名为CIRCUITPY的盘符。这表明CircuitPython已经成功安装并运行。注意第一次进入CIRCUITPY驱动器你可能只看到一个boot_out.txt文件这是正常的。我们的代码和库文件需要后续手动放入。3.2 获取项目代码与库文件智能镜子的代码并非从头编写Adafruit提供了完整的项目包Project Bundle。这个包包含了主程序、图形库、字体和图标等所有必要文件。下载项目包从项目页面找到“Download Project Bundle”按钮点击后会下载一个ZIP压缩包。解压与文件结构解压后你会看到如下关键文件和文件夹code.py项目的主程序文件。CircuitPython启动时会自动执行这个文件。openweather_graphics.py一个处理天气数据显示和图形绘制的辅助类库封装了复杂的绘图逻辑。lib/文件夹存放项目依赖的CircuitPython库文件例如adafruit_pyportal。fonts/和icons/文件夹存放显示所需的字体文件和天气图标。部署到PyPortal将CIRCUITPY驱动器中的所有默认文件如果有备份后把解压得到的lib、fonts、icons两个文件夹以及openweather_graphics.py和code.py文件全部复制到CIRCUITPY驱动器的根目录下。文件部署后的CIRCUITPY驱动器根目录应类似这样CIRCUITPY/ ├── code.py ├── openweather_graphics.py ├── boot_out.txt ├── lib/ │ ├── adafruit_pyportal/ │ ├── adafruit_bitmap_font/ │ ├── adafruit_display_text/ │ └── ... (其他依赖库) ├── fonts/ │ └── ... (字体文件) └── icons/ └── ... (PNG图标文件)3.3 关键配置settings.toml文件为了让PyPortal能连接你的Wi-Fi并获取天气数据需要创建一个名为settings.toml的配置文件。这个文件包含了所有的敏感信息和个性化设置。创建文件在CIRCUITPY驱动器根目录下新建一个文本文件将其重命名为settings.toml注意扩展名。编辑内容用任何文本编辑器如VS Code、Notepad打开填入以下信息CIRCUITPY_WIFI_SSID 你的Wi-Fi名称 CIRCUITPY_WIFI_PASSWORD 你的Wi-Fi密码 openweather_token 你的OpenWeather API密钥 timezone Asia/Shanghai # 根据你的时区修改例如America/New_York参数详解与获取方法CIRCUITPY_WIFI_SSID/PASSWORD你的家庭或工作室Wi-Fi凭证。确保2.4GHz网络可用PyPortal不支持5GHz。openweather_token这是从OpenWeatherMap网站申请的免费API密钥。访问 OpenWeatherMap 注册一个免费账户。登录后在“API Keys”选项卡下系统会生成一个默认的密钥一串类似b6907d289e10d714a6e88b30761fae22的字符复制它即可。免费套餐通常足够个人使用。timezone时区设置用于正确显示本地时间。可以从 时区列表 中查找你所在城市的时区字符串。重要安全提示settings.toml文件包含了你的网络密码和API密钥。请勿将此文件上传到公开的代码仓库如GitHub。CircuitPython会安全地读取这些信息。4. 代码原理深度剖析与定制修改把文件拷进去镜子就能工作了吗差不多但理解代码如何工作才能让你真正掌控这个项目并根据自己的需求进行定制。我们来深入看看code.py的核心逻辑。4.1 主程序框架与初始化程序开头进行了必要的导入和设置。关键点在于PyPortal对象的初始化它封装了网络请求、显示控制等复杂功能。# 初始化pyportal对象指定数据源、JSON解析路径等 pyportal PyPortal(urlDATA_SOURCE, json_pathDATA_LOCATION, status_neopixelboard.NEOPIXEL, default_bg0x000000) # 背景设为黑色 display board.DISPLAY display.rotation 270 # 将屏幕旋转270度变为竖屏显示display.rotation 270因为我们的镜子是竖屏形态所以需要将默认的横屏显示旋转过来。default_bg0x000000将默认背景设为纯黑色。在镜面下黑色像素点相当于“关闭”反射环境光看起来就是镜子的一部分而其他颜色的像素点发光才能穿透镜面膜被看到。因此UI设计应以深色背景为主。4.2 光传感器交互逻辑如何感知“挥手”这是本项目最精妙的部分。PyPortal的光传感器返回的是一个模拟电压值0-3.3V对应环境光强度。但直接读这个值来判断手势很不稳定因为室内基础光照可能不同。代码采用了一种巧妙的差分比较算法来检测光线的快速变化即手挥过造成的阴影。# 每0.1秒读取一次光传感器 if (time.monotonic() - switch_clock) 0.1: reading getVoltage(analogin) # 读取电压值 # 计算一个0-1之间的比例值反映“黑暗程度” ratio ((ratio pow(1.0 - reading / 3.3, 4.0)) / 2.0) # 创建一个用于比较的阈值last_ratio last_ratio^2 power_ratio last_ratio pow(last_ratio, 2.0)getVoltage(pin)将传感器的16位ADC原始值0-65535转换为实际的电压值0-3.3V。ratio的计算1.0 - reading / 3.3得到的是“无光”的比例电压越低环境越亮此值越小。对其进行4次方运算pow(..., 4.0)是一个非线性放大过程目的是让较小的变化如手的阴影在数值上产生更明显的波动提高检测灵敏度。最后与上一次的ratio取平均起到一定的平滑滤波作用。power_ratio这是一个动态阈值。当环境较亮last_ratio较小时power_ratio也较小环境较暗时power_ratio会迅速增大因为平方项。这个设计让系统在不同环境光下都能自适应。唤醒判断逻辑if power_ratio 1: # 环境相对较亮的情况 if ratio power_ratio: # 当前“暗度”超过动态阈值 pyportal.set_backlight(1) # 开屏 light_clock time.monotonic() else: # 环境相对较暗的情况 if ratio - last_ratio 0.003: # “暗度”发生一个微小但快速的正向跳变 pyportal.set_backlight(1) light_clock time.monotonic()亮环境策略主要看ratio是否超过了power_ratio。挥手遮光会导致ratio突然增大从而触发。暗环境策略在已经很暗的环境里ratio和power_ratio的绝对值都很大比较绝对值可能不敏感。因此改为检测ratio的瞬时变化量ratio - last_ratio 0.003。手快速挥过引起的微小变化也能被捕捉到。自动熄屏无论以何种方式点亮屏幕都会重置一个10秒的计时器light_clock。10秒无新手势则pyportal.set_backlight(0)关闭背光镜子恢复反射状态。4.3 数据获取与显示更新智能镜子的信息来自网络但频繁请求会浪费资源也可能触发API限制。代码里设置了合理的更新间隔。# 每小时从网络获取一次时间首次运行立即获取 if (not localtile_refresh) or (time.monotonic() - localtile_refresh) 3600: pyportal.get_local_time() # 每10分钟更新一次天气数据首次运行立即获取 if (not weather_refresh) or (time.monotonic() - weather_refresh) 600: value pyportal.fetch() gfx.display_weather(value)时间同步pyportal.get_local_time()会通过Wi-Fi从Adafruit IO的服务器获取精确的互联网时间并据此更新板载RTC实时时钟。之后屏幕上的时间就由这个本地RTC每30秒更新一次gfx.update_time()无需频繁联网。天气获取pyportal.fetch()会向我们在DATA_SOURCE中设置的OpenWeatherMap API地址发起HTTP GET请求返回一个JSON格式的天气数据。gfx.display_weather(value)则负责解析这个JSON并将温度、天气状况、图标等绘制到屏幕上。自定义你的位置修改code.py开头的LOCATION变量即可。格式为“城市名, 国家代码”国家代码需遵循ISO 3166标准如“Beijing, CN”、“London, GB”。5. 镜面制作与硬件组装实战软件部分搞定后我们来处理最需要耐心和细心的硬件部分贴膜和组装。这一步做得好最终效果会非常惊艳做得不好则可能满是气泡和皱纹。5.1 亚克力镜片的准备与贴膜贴膜是成败的关键遵循“湿贴法”能极大提高容错率。清洁与准备用异丙醇和无尘布彻底清洁亚克力板确保表面无灰尘、油脂和指纹。全程佩戴手套操作避免二次污染。在工作台上铺上毛巾或使用托盘防止肥皂水漫延。按比例约500毫升水加6滴洗手液配制肥皂水装入喷壶。裁剪镜面膜从卷材上裁下一片比亚克力板四周各大出至少3-5厘米的薄膜。多裁几片备用以防失手。用美纹纸胶带在薄膜保护层的四个角各粘一小段做成“提手”方便后续分离。湿贴过程湿润基材将亚克力板平放用喷壶将肥皂水均匀喷满整个表面形成一层水膜。揭膜与湿润利用胶带“提手”小心揭去薄膜的保护层立即将薄膜的粘合面也喷满肥皂水。这一步要快防止灰尘附着。对位与贴合将湿润的薄膜轻轻平铺在湿润的亚克力板上。由于有水膜此时薄膜可以轻松滑动。仔细调整位置使其居中。刮除水与气泡用刮板或银行卡包上软布从中心向四周刮压将水和气泡彻底赶出。用力要均匀、持续看到有水被从边缘挤出为止。静置与修边将贴好的镜片放在通风处静置至少30分钟让水分完全蒸发、粘合剂固化。之后用锋利的美工刀沿着亚克力板边缘小心地裁掉多余薄膜。实操心得环境是关键尽量在无风、灰尘少的环境操作比如浴室先除尘并关闭排风。水要多肥皂水是润滑剂宁多勿少。足够的水膜能让薄膜有充足的调整时间。气泡处理如果产生小气泡可以尝试用刮板将其推到边缘如果气泡顽固或进了灰尘不要犹豫趁水未干时揭起重贴。这就是为什么建议多裁几片备用。耐心等待修边前务必确保边缘已干透否则裁切时薄膜容易收缩或起皱。5.2 外壳组装与光路处理组装过程相对简单但有一个细节直接影响显示效果防止屏幕漏光。组装支架将两个M3尼龙防松螺母放入外壳侧面的六角形凹槽内从外侧穿过支架孔拧上M3拇指螺丝。尼龙螺母能防止螺丝因震动松动。安装亚克力镜片再次清洁镜片仅触摸边缘将其有膜的一面朝外对准外壳前面的凹槽轻轻按压直至卡入到位。听到轻微的“咔哒”声即表示安装牢固。处理PyPortal漏光PyPortal屏幕边缘与外壳之间可能存在微小缝隙在黑暗环境下屏幕点亮时这些缝隙会漏出光线破坏镜面的“隐形”效果。解决方法剪一小条黑色电工胶带或美纹纸胶带贴在PyPortal屏幕的上边缘即装入后朝向镜片的那一侧让胶带稍微包裹住屏幕边缘。这能有效吸收和阻挡从侧面漏出的光。固定PyPortal将PyPortal贴胶带的一边朝上放入外壳对齐四个安装孔用4颗M3x6mm螺丝固定。切勿过度拧紧以免压坏PCB或导致屏幕受力不均。合上后盖将后盖对准外壳四周均匀用力按压直至所有卡扣啮合。通电测试插入Micro USB线供电。首次启动PyPortal会连接Wi-Fi并获取数据。此时你可以用手在光传感器前挥动测试屏幕唤醒和熄灭是否正常。6. 调试优化与常见问题排查即使完全按照步骤第一次也可能遇到些小问题。这里汇总了一些常见情况及排查思路。6.1 屏幕显示相关问题现象可能原因排查与解决步骤屏幕完全不亮1. 供电不足或USB线仅能充电。2. 背光被代码强制关闭或亮度设为0。3. 硬件故障。1. 更换已知良好的数据线和5V/2A以上的电源适配器。2. 检查code.py中pyportal.set_backlight()的值应为1开或0关。尝试在代码开头加pyportal.set_backlight(1)测试。3. 重新烧录CircuitPython固件排除软件问题。屏幕常亮挥手不熄灭1. 光传感器检测逻辑未触发熄屏条件。2.light_clock计时器逻辑错误。3. 环境光太暗传感器始终认为处于“需点亮”状态。1. 在代码中打印ratio和power_ratio的值通过串行终端观察挥手时数值变化是否正常。2. 检查if (time.monotonic() - light_clock) 10:这行代码确认计时器在挥手时被重置light_clock time.monotonic()。3. 适当调整ratio - last_ratio 0.003中的阈值如改为0.005降低在暗环境下的灵敏度。挥手无法唤醒屏幕1. 光传感器被遮挡或损坏。2. 唤醒判断阈值不合适。3. 环境光变化过于复杂如闪烁的灯光。1. 确认PyPortal上的光传感器一个小黑点未被外壳或胶带遮挡。2. 在亮环境下尝试增大手势幅度在暗环境下尝试减小0.003这个变化量阈值。3. 尝试在代码中增加一个简单的print(reading)通过串口监视器观察挥手时电压值是否有明显跌落。显示内容模糊或对比度差1. 镜面膜质量不佳或贴反。2. 屏幕亮度设置过低。3. UI背景色不是纯黑。1. 确保膜的有反射层的一面朝外通常摸起来更光滑。在屏幕点亮时从侧面观察膜是否平整无皱。2. CircuitPython中可通过display.brightness调整背光亮度0.0-1.0适当调高。3. 检查openweather_graphics.py中绘制的背景色是否为0x000000纯黑。6.2 网络与数据获取问题现象可能原因排查与解决步骤无法连接Wi-Fi1.settings.toml中SSID或密码错误。2. 网络是5GHz频段。3. Wi-Fi信号太弱。1. 仔细检查settings.toml文件确保没有多余空格使用英文引号。2. PyPortal仅支持2.4GHz Wi-Fi请将路由器设置为双频混合或单独连接2.4GHz网络。3. 将PyPortal靠近路由器测试。可在代码pyportal PyPortal(...)初始化后添加pyportal.network._wifi.radio.connect(...)并捕捉异常打印具体错误。无法获取天气数据1. OpenWeather API密钥无效或未设置。2.LOCATION格式错误。3. 网络连接超时。1. 确认settings.toml中的openweather_token正确且OpenWeather账户的API Key状态正常免费套餐有调用频率限制。2. 确保LOCATION格式为“City, CountryCode”城市名用英文国家代码两个字母。可在浏览器中直接访问DATA_SOURCE拼接的URL看能否返回JSON数据。3. 增加网络请求的超时时间在PyPortal初始化参数中可设置。时间显示不正确1. 时区timezone设置错误。2. 未能成功从网络获取时间。1. 核对settings.toml中的timezone值确保是有效的时区字符串如Asia/Shanghai。2. 查看串口输出确认是否有“Getting time from internet!”的成功提示或相关的错误信息。6.3 机械与外观问题现象可能原因排查与解决步骤镜面膜有气泡或皱纹1. 贴膜时水太少或刮压不充分。2. 环境灰尘多。3. 薄膜本身有瑕疵。1.预防优于治疗贴膜时喷足肥皂水刮板用力均匀、缓慢。2. 小气泡可用刮板推向边缘大气泡或灰尘需揭起重贴。3. 裁切新的一片重试。亚克力板无法卡入外壳1. 亚克力板尺寸切割有误差。2. 3D打印外壳收缩导致卡槽变小。3. 贴膜后厚度增加。1. 用游标卡尺测量亚克力板尺寸确保是96.5mm x 55mm。2. 轻微打磨外壳卡槽的内侧边缘或稍微打磨亚克力板的边缘。3. 如果膜贴得太靠边导致边缘增厚需更精细地修边。屏幕在镜面后亮度不均或有光晕屏幕漏光处理不当。1. 确保在PyPortal屏幕的上边缘贴了足够宽的黑胶带。2. 检查外壳内部是否为深色可涂黑减少内部反射。3. 在屏幕与外壳之间垫一圈黑色海绵或绒布条彻底密封缝隙。完成所有组装和调试后给你的智能镜子找一个合适的角落放好。它不仅仅是一个显示天气和时间的工具更是一个展示了硬件、软件与设计巧妙结合的作品。每当有朋友好奇地挥手看到信息浮现时惊讶的表情就是对这个项目最好的肯定。你可以在此基础上继续扩展比如增加日程显示、新闻摘要或者连接其他传感器让它变得更加智能。
