1. 项目概述与核心价值如果你对智能家居自动化感兴趣并且想亲手打造一个既实用又有趣的照明项目那么这个基于Adafruit FunHouse和LIFX智能灯泡的运动感应照明系统绝对是一个绝佳的起点。它不仅仅是一个“开灯关灯”的简单触发器而是一个融合了硬件感知、嵌入式编程、网络通信和云API调用的完整物联网IoT微型项目。通过它你可以深入理解现代智能设备是如何协同工作的。这个项目的核心逻辑非常直观一个微型被动红外PIR传感器负责“看”当它检测到范围内有物体比如人移动时就会发出一个信号。Adafruit FunHouse这块开发板作为“大脑”接收到信号后通过你家里的Wi-Fi网络向互联网上的LIFX云服务发送指令。LIFX云服务再把这个指令转发给你指定的智能灯泡最终实现灯泡颜色和亮度的自动切换。整个过程从物理世界的运动到数字世界的信号再到物理世界的光线变化形成了一个完整的闭环。为什么选择这个组合FunHouse是一块为家庭自动化场景量身定制的开发板集成了显示屏、按钮、RGB灯带和丰富的传感器接口开箱即用极大地降低了硬件连接的门槛。LIFX作为一款无需额外网关、直接通过Wi-Fi连接的智能灯泡提供了稳定且对开发者友好的云API让我们可以用几行代码就实现远程控制。而CircuitPython则是连接硬件与逻辑的桥梁它是一种在微控制器上运行的Python 3语言实现语法简单库丰富特别适合快速原型开发和教育。这个项目的价值在于它的“全栈”体验。你将从零开始经历硬件组装、开发环境搭建、网络配置、API调用、逻辑编程到最终调试的完整流程。无论你是嵌入式开发新手想了解物联网的运作机制还是有一定经验的Maker希望为自己的工作室或走廊添加一个酷炫的自动氛围灯这个项目都能提供扎实的实践知识和满满的成就感。接下来我将带你一步步拆解这个系统不仅告诉你怎么做更会解释每一个步骤背后的“为什么”。2. 硬件选型与核心组件解析动手之前我们先来仔细看看这个项目的“演员表”。理解每个组件的角色和能力是确保项目成功的第一步也能帮助你在未来举一反三替换或升级其中的部件。2.1 控制中枢Adafruit FunHouse开发板FunHouse是本次项目的绝对核心。它基于ESP32-S2芯片这是一颗集成了Wi-Fi功能的强大微控制器。对于这个项目我们主要利用它的以下几个特性计算与控制运行我们编写的CircuitPython程序处理传感器输入做出逻辑判断并发出控制指令。Wi-Fi连接内置的Wi-Fi模块允许它直接接入你的家庭局域网这是与LIFX云服务通信的基础。用户交互界面板载的1.14英寸彩色LCD显示屏和三个物理按钮为我们提供了绝佳的人机交互接口。我们可以用它来显示当前状态如“感应中”、“已触发”、倒计时并通过按钮调整参数如触发后的亮灯时长而无需依赖电脑或手机。外围设备接口它提供了专门连接PIR传感器的3针插座以及控制板载5颗DotStar RGB LED的接口。这让我们无需焊接和复杂的连线就能快速集成传感器和获得视觉反馈。供电与编程通过一根USB-C线缆既能为其供电也能将编写好的代码上传到板载的存储中。注意选择FunHouse而非普通的ESP32开发板最大的优势在于其高度集成性和针对性。它省去了你单独连接显示屏、按钮的麻烦并且其Python库adafruit_funhouse对所有这些硬件进行了优雅的封装让代码非常简洁。2.2 环境感知器Mini PIR运动传感器PIRPassive Infrared传感器即被动式红外传感器是本项目的“眼睛”。它的工作原理是探测特定波长人体或动物体温辐射的红外线的变化。当有热源在传感器探测范围内移动时传感器表面的热电元件会产生微弱的电荷变化经过内部芯片放大和比较后输出一个高电平信号。我们选用的是一款“面包板友好”的迷你PIR传感器。它体积小巧但探测距离可达5米左右视角大约120度。其输出是简单的数字信号未检测到运动时输出低电平0检测到运动时输出高电平1。这种“非接触式”和“二值化”的特性使其成为自动照明、安防报警等场景的理想选择。实操心得PIR传感器对突然的温度变化如阳光直射、暖气开启也可能有反应。因此在安装时应尽量避免将其正对窗户、空调出风口或热源。同时它的探测模式是“区域变化”而非“图像识别”所以缓慢移动的物体可能无法触发。2.3 执行终端LIFX智能Wi-Fi灯泡LIFX灯泡是本项目的“手”负责最终的光线输出。它有几个关键特点使其适合DIY项目无中心网关直接连接Wi-Fi无需像Zigbee或Z-Wave设备那样需要额外的网关桥接器。这简化了系统架构降低了成本和复杂度。开放的云APILIFX提供了完善的HTTP REST API和官方维护的Python库adafruit_lifx。我们只需要一个从官网获取的访问令牌Token就可以通过互联网向灯泡发送指令控制其开关、颜色、色温、亮度等。丰富的产品线从标准A19灯泡到灯带、射灯选择多样。本项目代码针对其API设计因此理论上兼容所有LIFX产品。为什么不用本地局域网LAN控制LIFX也支持本地UDP协议控制但这需要你的控制设备如FunHouse和灯泡在同一个子网内且需要处理设备发现等更复杂的网络编程。对于初学者或希望从任意网络位置都能查看状态的场景使用经过验证的云API是更稳定、更简单的方式。2.4 辅助材料清单除了三大核心你还需要USB-C数据线用于连接FunHouse和电脑进行编程及供电。5V 2A USB电源适配器项目部署后需要稳定的电源供电。FunHouse的功耗不高但为保证Wi-Fi稳定运行建议使用可靠的电源。LIFX灯泡的灯座当然你需要一个E26或E27取决于你的地区的标准螺口灯座来安装灯泡。3. 系统搭建与硬件连接实操硬件连接是整个项目中最简单的一环但细节决定成败。正确的连接是后续所有软件工作的基础。3.1 LIFX灯泡的初始化配置在写代码之前我们需要先让LIFX灯泡“上线”。物理安装将LIFX灯泡拧入灯座并打开墙壁开关通电。灯泡会开始闪烁表示处于待配网状态。手机App配网在手机上下载官方LIFX AppiOS/Android均有。按照App内的指引为灯泡连接到你家庭的Wi-Fi网络。这个过程会让灯泡记住你的Wi-Fi密码并注册到你的LIFX账户下。关键一步重命名灯泡在LIFX App中找到新添加的灯泡将其名称修改为Lamp。这个名称非常重要因为后续我们的代码将通过label:Lamp这个“选择器”来精确控制这个特定的灯泡。如果你有多个灯泡可以通过不同的标签来区分。获取云API令牌用电脑浏览器访问 LIFX Cloud 网站使用你注册App时的同一账户登录。进入账户设置页面找到“Generate New Token”或类似按钮创建一个新的个人访问令牌。这个令牌是一长串看似随机的字母数字组合它是你代码与LIFX服务通信的“密码”。请立即将其妥善保存到一个安全的地方比如一个本地的文本文件。注意API令牌拥有控制你账户下所有灯泡的权限切勿泄露。我们稍后会将其存入FunHouse的配置文件中。3.2 PIR传感器与FunHouse的连接FunHouse板的设计非常贴心为PIR传感器预留了专用的3针插座。识别极性拿起迷你PIR传感器观察其电路板。你会看到三个引脚通常旁边会印有-、、OUT的标识。-代表接地GND代表电源正极VCC通常是3.3V或5VOUT是信号输出。对准插座在FunHouse板的正面找到标有“PIR”字样的3针排母插座。仔细看插座旁边也印有-、、S的符号。这里的S就对应传感器的OUT引脚。插入连接确保传感器引脚与插座孔位对齐-对-对OUT对S。第一次插入可能会比较紧这是为了防止松动。用手捏住传感器两侧垂直向下均匀用力按压同时可以轻微左右晃动直到传感器完全插入并贴合板面。连接检查点连接完成后给FunHouse通电。PIR传感器上通常有一个小LED指示灯。当传感器初始化完成约30-60秒后如果你在它前方挥手LED应该会闪烁一下表示传感器工作正常。这个自带的指示灯对于后续调试非常有帮助。3.3 开发环境准备CircuitPython固件与编辑器我们的代码将运行在CircuitPython环境中因此需要先为FunHouse安装“操作系统”。安装CircuitPython固件访问 Adafruit CircuitPython官网在下载页面找到“FunHouse”对应的最新版本.uf2文件。用USB线将FunHouse连接至电脑。先按住FunHouse板上的“BOOT”按钮或根据板子说明再按一下“RESET”按钮然后释放“BOOT”按钮。此时电脑上会出现一个名为FUNHOUSEBOOT或类似的可移动磁盘。将下载好的.uf2文件拖入这个磁盘。完成后板子会自动重启磁盘名称会变为CIRCUITPY。这表明CircuitPython固件已安装成功。选择代码编辑器Mu EditorAdafruit官方推荐的一款轻量级编辑器内置了CircuitPython模式和串行监视器非常适合初学者。它可以直接在CIRCUITPY盘上编辑code.py文件并实时看到打印输出。任何文本编辑器你也可以使用VS Code、Thonny或任何你喜欢的编辑器编写代码然后手动将文件保存到CIRCUITPY盘中。我个人更习惯用VS Code编写用Mu的串行监视器来调试。4. 核心代码详解与编程逻辑实现硬件就绪后我们来深入剖析项目的“灵魂”——代码。我将逐段解释提供的代码并补充一些关键细节和优化思路。4.1 项目文件结构与秘密配置在开始编写主程序前我们需要设置两个关键文件。settings.toml- 配置文件 在CIRCUITPY盘的根目录下创建一个名为settings.toml的文本文件。这个文件用于安全地存储你的敏感信息避免将其硬编码在代码中。# 你的Wi-Fi网络名称 CIRCUITPY_WIFI_SSID 你的Wi-Fi名称 # 你的Wi-Fi密码 CIRCUITPY_WIFI_PASSWORD 你的Wi-Fi密码 # 你的LIFX云API令牌 lifx_token 你的LIFX令牌CircuitPython启动时会自动读取这个文件我们可以通过os.getenv()函数来获取这些值。code.py- 主程序 这是CircuitPython板子启动后自动运行的主文件。我们将把主要逻辑写在这里。你可以先清空默认的code.py内容。4.2 代码逐行解析与原理剖析让我们结合原始代码深入理解每一部分的作用。第一部分导入与初始化from os import getenv import time import ssl import socketpool import wifi import adafruit_requests from displayio import CIRCUITPYTHON_TERMINAL import adafruit_lifx from adafruit_funhouse import FunHousegetenv: 用于从settings.toml读取配置。ssl: 提供安全套接字层支持用于建立安全的HTTPS连接。socketpool,wifi,adafruit_requests: 这三个库协同工作负责管理Wi-Fi连接、网络套接字和发送HTTP请求。adafruit_requests的API设计模仿了著名的Pythonrequests库非常易用。adafruit_lifx: 官方提供的LIFX API库封装了复杂的HTTP请求让我们可以用简单的函数如set_color控制灯泡。adafruit_funhouse: FunHouse的专用库提供了访问显示屏、按钮、PIR传感器、DotStar LED等所有板载资源的简便方法。第二部分读取配置与网络连接ssid getenv(CIRCUITPY_WIFI_SSID) password getenv(CIRCUITPY_WIFI_PASSWORD) if None in [ssid, password]: raise RuntimeError(WiFi settings are kept in settings.toml...) wifi.radio.connect(ssid, password) pool socketpool.SocketPool(wifi.radio) http_session adafruit_requests.Session(pool, ssl.create_default_context())这里先读取Wi-Fi配置如果为空则报错。然后使用wifi.radio.connect进行连接。成功连接后创建一个网络套接字池和一个HTTP会话。这个会话对象http_session将在后续与LIFX API通信时被重复使用以提高效率。第三部分颜色定义与LIFX客户端设置default_bulb_color #002010 default_led_color 0x002010 tripped_bulb_color #440044 tripped_led_color 0x440044 lifx_token getenv(lifx_token) lifx_light label:Lamp lifx adafruit_lifx.LIFX(http_session, lifx_token) lights lifx.list_lights()颜色格式注意LIFX API期望的颜色字符串是HTML格式的#RRGGBB而FunHouse的DotStar LED库期望的是十六进制整数0xRRGGBB。这里分别定义了默认状态和触发状态的颜色。LIFX选择器label:Lamp告诉LIFX API我们要控制标签为“Lamp”的灯泡。选择器非常灵活你还可以用group:房间名控制一组灯或用id:灯泡ID精确控制。list_lights(): 这个调用会查询你的LIFX账户下所有灯泡的信息。在调试时可以取消注释print(lights)来查看返回的详细信息确认连接和令牌是否有效。第四部分FunHouse界面与状态初始化funhouse FunHouse(default_bg0x000F20, scale3) pir_state 0 running_state False trip_time 30 funhouse.peripherals.dotstars.fill(default_led_color)创建FunHouse对象设置深蓝色背景和文字缩放。pir_state: 记录PIR传感器上一次的状态0未触发1已触发用于检测状态变化而不是持续的高电平。这是避免重复触发的关键。running_state: 系统总开关。False为暂停True为运行。trip_time: 触发后亮灯的持续时间秒可通过按钮调整。第五部分创建屏幕显示标签def set_label_color(conditional, index, on_color): if conditional: funhouse.set_text_color(on_color, index) else: funhouse.set_text_color(0x606060, index) funhouse.display.root_group CIRCUITPYTHON_TERMINAL up_label funhouse.add_text(text, text_position(3, 6), text_color0x606060) down_label funhouse.add_text(text-, text_position(3, 40), text_color0x606060) running_label funhouse.add_text(textpaused, text_position(2, 68), text_color0x606060) time_label funhouse.add_text(texttrip_time, text_scale2, text_position(30, 25), text_color0x606060) funhouse.display.root_group funhouse.splash这段代码构建了用户界面。add_text创建文本标签并返回一个索引。set_label_color是一个辅助函数用于根据条件如按钮是否被按下改变标签颜色。界面布局了一个“”按钮标签、一个“-”按钮标签、一个状态标签显示paused/sensing…/tripped和一个居中放大的时间标签。第六部分主循环逻辑——事件处理与状态机主循环while True是程序的核心它不断扫描三个按钮和PIR传感器的状态并据此更新系统。按钮事件处理if funhouse.peripherals.button_up: trip_time trip_time 1 funhouse.set_text(trip_time, time_label) funhouse.set_text_color(0xFFFFFF, up_label) time.sleep(0.2) else: funhouse.set_text_color(0x606060, up_label)当“上”按钮被按下时trip_time加1更新时间显示并将“”标签高亮为白色。time.sleep(0.2)是一个简单的防抖延迟防止一次按压被误判为多次。按钮释放后标签恢复灰色。中间按钮button_sel用于减少时间逻辑类似。系统启停控制if funhouse.peripherals.button_down: if running_state is False: running_state True funhouse.set_text(..prepping.., running_label) time.sleep(6) funhouse.set_text(sensing..., running_label) else: running_state False funhouse.set_text(paused, running_label) time.sleep(0.5)按下“下”按钮切换系统运行状态。这里有一个精妙的细节当从暂停转为运行时先显示“..prepping..”并等待6秒。这6秒是留给用户离开传感器探测区域的避免系统一启动就因用户站在面前而立即触发。这是一个非常实用的用户体验设计。运动检测与灯光控制if running_state is True and funhouse.peripherals.pir_sensor and pir_state 0: # 触发处理 pir_state 1 ... elif running_state is True and not funhouse.peripherals.pir_sensor and pir_state 1: # 恢复处理 pir_state 0 ...这是整个系统的状态机。仅当系统在运行状态running_state is True时才处理PIR事件。触发条件PIR传感器输出为真检测到运动且上一次状态为未触发pir_state 0。这确保了每次运动只触发一次动作而不是持续触发。触发动作将DotStar LED和LIFX灯泡颜色改为触发色显示“tripped”然后开始倒计时。倒计时循环中每秒更新屏幕上的时间。倒计时结束后状态不会立即恢复而是等待另一个条件。恢复条件PIR传感器输出为假无运动且上一次状态为已触发pir_state 1。这意味着即使在倒计时结束前运动停止灯光也会保持触发色直到倒计时结束。倒计时结束后一旦传感器检测到“无运动”系统立即恢复到默认状态准备下一次检测。这种设计逻辑更符合“有人进入房间亮灯一段时间”的实际场景。5. 部署、调试与高级优化指南代码理解透彻后让我们将其部署到硬件上并解决可能遇到的问题甚至进行一些个性化升级。5.1 完整部署流程文件传输将编写好的settings.toml和code.py文件以及项目依赖的库文件如adafruit_lifx、adafruit_funhouse等可通过Adafruit的库捆绑包获取全部复制到CIRCUITPY磁盘的根目录。硬件上电用USB电源适配器为FunHouse供电。观察板载的RGB LED它们应该亮起默认的蓝绿色。屏幕也会点亮并显示“paused”和初始时间“30”。网络连接观察FunHouse启动后会自动连接Wi-Fi。你可以通过Mu Editor的串行监视器查看输出。连接成功后通常会打印出IP地址。同时代码中lifx.list_lights()的调用会尝试与LIFX API通信如果一切正常你的LIFX灯泡应该会亮起并呈现default_bulb_color定义的颜色。功能测试按钮测试按下“上”、“下”按钮观察屏幕中间的时间显示是否增减。按下“中”按钮观察系统状态是否在“paused”和“sensing…”之间切换切换时有6秒准备期。传感器测试将系统设为“sensing…”状态等待6秒准备期结束。然后在PIR传感器前挥手观察DotStar LED颜色是否变为紫色LIFX灯泡是否同步变色屏幕是否显示“tripped”并开始倒计时。5.2 常见问题排查速查表问题现象可能原因排查步骤与解决方案FunHouse屏幕不亮或LED不亮供电不足或USB线仅支持充电更换为可靠的5V 2A电源和高质量的数据线。检查USB-C口是否插紧。屏幕显示但Wi-Fi连接失败settings.toml配置错误或网络问题1. 检查CIRCUITPY_WIFI_SSID和CIRCUITPY_WIFI_PASSWORD拼写是否正确密码是否包含特殊字符建议先用简单密码测试。2. 打开Mu串行监视器查看具体的错误信息。3. 确保你的Wi-Fi是2.4GHz网络ESP32-S2不支持5GHz。LIFX灯泡无反应API令牌错误、灯泡未在线或选择器错误1. 在串行监视器中取消注释print(lights)查看API返回信息。如果返回错误检查lifx_token是否正确。2. 打开LIFX App确认名为“Lamp”的灯泡在线且可控。3. 确认代码中lifx_light “label:Lamp”的标签与App中完全一致区分大小写。PIR传感器一直触发或不触发传感器安装环境不佳或灵敏度/延时调节不当1.检查环境避免传感器对准窗户、通风口、发热电器。2.观察指示灯传感器上的LED在检测到运动时应闪烁。如果不闪检查连接如果常亮可能处于持续触发状态等待1分钟看是否稳定。3.调节电位器有些PIR传感器有两个可调电阻分别控制灵敏度Sx和触发后输出信号的持续时间Tx。可微调以适配环境。按钮操作无反应代码中防抖延迟过长或按钮扫描逻辑问题1. 尝试长按按钮超过0.2秒。2. 检查代码中funhouse.peripherals.button_up/down/sel的拼写是否正确。3. 在串行监视器中打印按钮状态确认硬件是否正常。倒计时结束后灯光不恢复PIR传感器仍检测到运动或状态机逻辑未满足恢复条件1. 确保在倒计时结束后你已离开传感器探测区域并且没有其他热源如宠物在活动。2. 理解代码逻辑恢复需要同时满足running_state is True、not funhouse.peripherals.pir_sensor和pir_state 1。5.3 项目优化与扩展思路基础版本运行稳定后你可以尝试以下优化和扩展让项目更强大、更智能增加亮度调节除了颜色你还可以通过LIFX API的set_brightness函数在触发时同时调整亮度。例如夜间模式可以设置为低亮度白天模式设置为高亮度。你可以在代码中定义两个亮度变量并在触发和恢复时分别设置。多灯泡与场景控制LIFX选择器非常强大。你可以将lifx_light改为group:Bedroom来控制整个卧室的灯泡。或者你可以创建一个lights列表里面包含多个选择器如[“label:Lamp1”, “label:Lamp2”]然后在循环中遍历列表对每个灯泡执行相同的操作实现多灯联动。环境光传感器集成FunHouse板载了光传感器你可以利用它来实现“仅在环境光较暗时启动运动感应”的功能。在代码中读取funhouse.peripherals.light的值并在主循环的判断条件中加入光强阈值判断例如if running_state is True and light_value 100 and …。状态持久化目前每次重启FunHousetrip_time都会重置为30秒。你可以使用CircuitPython的storage模块将用户设置的trip_time和running_state保存到板载的存储中下次启动时自动读取提升用户体验。网络容错处理当前的代码假设网络始终畅通。在实际环境中Wi-Fi可能偶尔断开。你可以增加网络重连逻辑。在wifi.radio.connect处使用try-except块并在主循环中定期检查wifi.radio.connected如果断开则尝试重连并在屏幕上显示连接状态。更丰富的UI反馈利用FunHouse的DotStar LED可以做出更炫酷的反馈。比如网络连接中让LED呼吸闪烁触发时让LED跑马灯倒计时时让LED逐个熄灭等。这个项目是一个完美的物联网入门沙盒。它麻雀虽小五脏俱全涵盖了传感器数据采集、嵌入式逻辑处理、无线网络通信、云服务API调用和本地人机交互等关键环节。通过动手实践和后续的扩展思考你不仅能获得一个实用的智能小工具更能建立起对现代物联网系统架构的直观理解。
基于PIR传感器与LIFX智能灯泡的物联网运动感应照明系统实战
发布时间：2026/5/17 8:06:08
1. 项目概述与核心价值如果你对智能家居自动化感兴趣并且想亲手打造一个既实用又有趣的照明项目那么这个基于Adafruit FunHouse和LIFX智能灯泡的运动感应照明系统绝对是一个绝佳的起点。它不仅仅是一个“开灯关灯”的简单触发器而是一个融合了硬件感知、嵌入式编程、网络通信和云API调用的完整物联网IoT微型项目。通过它你可以深入理解现代智能设备是如何协同工作的。这个项目的核心逻辑非常直观一个微型被动红外PIR传感器负责“看”当它检测到范围内有物体比如人移动时就会发出一个信号。Adafruit FunHouse这块开发板作为“大脑”接收到信号后通过你家里的Wi-Fi网络向互联网上的LIFX云服务发送指令。LIFX云服务再把这个指令转发给你指定的智能灯泡最终实现灯泡颜色和亮度的自动切换。整个过程从物理世界的运动到数字世界的信号再到物理世界的光线变化形成了一个完整的闭环。为什么选择这个组合FunHouse是一块为家庭自动化场景量身定制的开发板集成了显示屏、按钮、RGB灯带和丰富的传感器接口开箱即用极大地降低了硬件连接的门槛。LIFX作为一款无需额外网关、直接通过Wi-Fi连接的智能灯泡提供了稳定且对开发者友好的云API让我们可以用几行代码就实现远程控制。而CircuitPython则是连接硬件与逻辑的桥梁它是一种在微控制器上运行的Python 3语言实现语法简单库丰富特别适合快速原型开发和教育。这个项目的价值在于它的“全栈”体验。你将从零开始经历硬件组装、开发环境搭建、网络配置、API调用、逻辑编程到最终调试的完整流程。无论你是嵌入式开发新手想了解物联网的运作机制还是有一定经验的Maker希望为自己的工作室或走廊添加一个酷炫的自动氛围灯这个项目都能提供扎实的实践知识和满满的成就感。接下来我将带你一步步拆解这个系统不仅告诉你怎么做更会解释每一个步骤背后的“为什么”。2. 硬件选型与核心组件解析动手之前我们先来仔细看看这个项目的“演员表”。理解每个组件的角色和能力是确保项目成功的第一步也能帮助你在未来举一反三替换或升级其中的部件。2.1 控制中枢Adafruit FunHouse开发板FunHouse是本次项目的绝对核心。它基于ESP32-S2芯片这是一颗集成了Wi-Fi功能的强大微控制器。对于这个项目我们主要利用它的以下几个特性计算与控制运行我们编写的CircuitPython程序处理传感器输入做出逻辑判断并发出控制指令。Wi-Fi连接内置的Wi-Fi模块允许它直接接入你的家庭局域网这是与LIFX云服务通信的基础。用户交互界面板载的1.14英寸彩色LCD显示屏和三个物理按钮为我们提供了绝佳的人机交互接口。我们可以用它来显示当前状态如“感应中”、“已触发”、倒计时并通过按钮调整参数如触发后的亮灯时长而无需依赖电脑或手机。外围设备接口它提供了专门连接PIR传感器的3针插座以及控制板载5颗DotStar RGB LED的接口。这让我们无需焊接和复杂的连线就能快速集成传感器和获得视觉反馈。供电与编程通过一根USB-C线缆既能为其供电也能将编写好的代码上传到板载的存储中。注意选择FunHouse而非普通的ESP32开发板最大的优势在于其高度集成性和针对性。它省去了你单独连接显示屏、按钮的麻烦并且其Python库adafruit_funhouse对所有这些硬件进行了优雅的封装让代码非常简洁。2.2 环境感知器Mini PIR运动传感器PIRPassive Infrared传感器即被动式红外传感器是本项目的“眼睛”。它的工作原理是探测特定波长人体或动物体温辐射的红外线的变化。当有热源在传感器探测范围内移动时传感器表面的热电元件会产生微弱的电荷变化经过内部芯片放大和比较后输出一个高电平信号。我们选用的是一款“面包板友好”的迷你PIR传感器。它体积小巧但探测距离可达5米左右视角大约120度。其输出是简单的数字信号未检测到运动时输出低电平0检测到运动时输出高电平1。这种“非接触式”和“二值化”的特性使其成为自动照明、安防报警等场景的理想选择。实操心得PIR传感器对突然的温度变化如阳光直射、暖气开启也可能有反应。因此在安装时应尽量避免将其正对窗户、空调出风口或热源。同时它的探测模式是“区域变化”而非“图像识别”所以缓慢移动的物体可能无法触发。2.3 执行终端LIFX智能Wi-Fi灯泡LIFX灯泡是本项目的“手”负责最终的光线输出。它有几个关键特点使其适合DIY项目无中心网关直接连接Wi-Fi无需像Zigbee或Z-Wave设备那样需要额外的网关桥接器。这简化了系统架构降低了成本和复杂度。开放的云APILIFX提供了完善的HTTP REST API和官方维护的Python库adafruit_lifx。我们只需要一个从官网获取的访问令牌Token就可以通过互联网向灯泡发送指令控制其开关、颜色、色温、亮度等。丰富的产品线从标准A19灯泡到灯带、射灯选择多样。本项目代码针对其API设计因此理论上兼容所有LIFX产品。为什么不用本地局域网LAN控制LIFX也支持本地UDP协议控制但这需要你的控制设备如FunHouse和灯泡在同一个子网内且需要处理设备发现等更复杂的网络编程。对于初学者或希望从任意网络位置都能查看状态的场景使用经过验证的云API是更稳定、更简单的方式。2.4 辅助材料清单除了三大核心你还需要USB-C数据线用于连接FunHouse和电脑进行编程及供电。5V 2A USB电源适配器项目部署后需要稳定的电源供电。FunHouse的功耗不高但为保证Wi-Fi稳定运行建议使用可靠的电源。LIFX灯泡的灯座当然你需要一个E26或E27取决于你的地区的标准螺口灯座来安装灯泡。3. 系统搭建与硬件连接实操硬件连接是整个项目中最简单的一环但细节决定成败。正确的连接是后续所有软件工作的基础。3.1 LIFX灯泡的初始化配置在写代码之前我们需要先让LIFX灯泡“上线”。物理安装将LIFX灯泡拧入灯座并打开墙壁开关通电。灯泡会开始闪烁表示处于待配网状态。手机App配网在手机上下载官方LIFX AppiOS/Android均有。按照App内的指引为灯泡连接到你家庭的Wi-Fi网络。这个过程会让灯泡记住你的Wi-Fi密码并注册到你的LIFX账户下。关键一步重命名灯泡在LIFX App中找到新添加的灯泡将其名称修改为Lamp。这个名称非常重要因为后续我们的代码将通过label:Lamp这个“选择器”来精确控制这个特定的灯泡。如果你有多个灯泡可以通过不同的标签来区分。获取云API令牌用电脑浏览器访问 LIFX Cloud 网站使用你注册App时的同一账户登录。进入账户设置页面找到“Generate New Token”或类似按钮创建一个新的个人访问令牌。这个令牌是一长串看似随机的字母数字组合它是你代码与LIFX服务通信的“密码”。请立即将其妥善保存到一个安全的地方比如一个本地的文本文件。注意API令牌拥有控制你账户下所有灯泡的权限切勿泄露。我们稍后会将其存入FunHouse的配置文件中。3.2 PIR传感器与FunHouse的连接FunHouse板的设计非常贴心为PIR传感器预留了专用的3针插座。识别极性拿起迷你PIR传感器观察其电路板。你会看到三个引脚通常旁边会印有-、、OUT的标识。-代表接地GND代表电源正极VCC通常是3.3V或5VOUT是信号输出。对准插座在FunHouse板的正面找到标有“PIR”字样的3针排母插座。仔细看插座旁边也印有-、、S的符号。这里的S就对应传感器的OUT引脚。插入连接确保传感器引脚与插座孔位对齐-对-对OUT对S。第一次插入可能会比较紧这是为了防止松动。用手捏住传感器两侧垂直向下均匀用力按压同时可以轻微左右晃动直到传感器完全插入并贴合板面。连接检查点连接完成后给FunHouse通电。PIR传感器上通常有一个小LED指示灯。当传感器初始化完成约30-60秒后如果你在它前方挥手LED应该会闪烁一下表示传感器工作正常。这个自带的指示灯对于后续调试非常有帮助。3.3 开发环境准备CircuitPython固件与编辑器我们的代码将运行在CircuitPython环境中因此需要先为FunHouse安装“操作系统”。安装CircuitPython固件访问 Adafruit CircuitPython官网在下载页面找到“FunHouse”对应的最新版本.uf2文件。用USB线将FunHouse连接至电脑。先按住FunHouse板上的“BOOT”按钮或根据板子说明再按一下“RESET”按钮然后释放“BOOT”按钮。此时电脑上会出现一个名为FUNHOUSEBOOT或类似的可移动磁盘。将下载好的.uf2文件拖入这个磁盘。完成后板子会自动重启磁盘名称会变为CIRCUITPY。这表明CircuitPython固件已安装成功。选择代码编辑器Mu EditorAdafruit官方推荐的一款轻量级编辑器内置了CircuitPython模式和串行监视器非常适合初学者。它可以直接在CIRCUITPY盘上编辑code.py文件并实时看到打印输出。任何文本编辑器你也可以使用VS Code、Thonny或任何你喜欢的编辑器编写代码然后手动将文件保存到CIRCUITPY盘中。我个人更习惯用VS Code编写用Mu的串行监视器来调试。4. 核心代码详解与编程逻辑实现硬件就绪后我们来深入剖析项目的“灵魂”——代码。我将逐段解释提供的代码并补充一些关键细节和优化思路。4.1 项目文件结构与秘密配置在开始编写主程序前我们需要设置两个关键文件。settings.toml- 配置文件 在CIRCUITPY盘的根目录下创建一个名为settings.toml的文本文件。这个文件用于安全地存储你的敏感信息避免将其硬编码在代码中。# 你的Wi-Fi网络名称 CIRCUITPY_WIFI_SSID 你的Wi-Fi名称 # 你的Wi-Fi密码 CIRCUITPY_WIFI_PASSWORD 你的Wi-Fi密码 # 你的LIFX云API令牌 lifx_token 你的LIFX令牌CircuitPython启动时会自动读取这个文件我们可以通过os.getenv()函数来获取这些值。code.py- 主程序 这是CircuitPython板子启动后自动运行的主文件。我们将把主要逻辑写在这里。你可以先清空默认的code.py内容。4.2 代码逐行解析与原理剖析让我们结合原始代码深入理解每一部分的作用。第一部分导入与初始化from os import getenv import time import ssl import socketpool import wifi import adafruit_requests from displayio import CIRCUITPYTHON_TERMINAL import adafruit_lifx from adafruit_funhouse import FunHousegetenv: 用于从settings.toml读取配置。ssl: 提供安全套接字层支持用于建立安全的HTTPS连接。socketpool,wifi,adafruit_requests: 这三个库协同工作负责管理Wi-Fi连接、网络套接字和发送HTTP请求。adafruit_requests的API设计模仿了著名的Pythonrequests库非常易用。adafruit_lifx: 官方提供的LIFX API库封装了复杂的HTTP请求让我们可以用简单的函数如set_color控制灯泡。adafruit_funhouse: FunHouse的专用库提供了访问显示屏、按钮、PIR传感器、DotStar LED等所有板载资源的简便方法。第二部分读取配置与网络连接ssid getenv(CIRCUITPY_WIFI_SSID) password getenv(CIRCUITPY_WIFI_PASSWORD) if None in [ssid, password]: raise RuntimeError(WiFi settings are kept in settings.toml...) wifi.radio.connect(ssid, password) pool socketpool.SocketPool(wifi.radio) http_session adafruit_requests.Session(pool, ssl.create_default_context())这里先读取Wi-Fi配置如果为空则报错。然后使用wifi.radio.connect进行连接。成功连接后创建一个网络套接字池和一个HTTP会话。这个会话对象http_session将在后续与LIFX API通信时被重复使用以提高效率。第三部分颜色定义与LIFX客户端设置default_bulb_color #002010 default_led_color 0x002010 tripped_bulb_color #440044 tripped_led_color 0x440044 lifx_token getenv(lifx_token) lifx_light label:Lamp lifx adafruit_lifx.LIFX(http_session, lifx_token) lights lifx.list_lights()颜色格式注意LIFX API期望的颜色字符串是HTML格式的#RRGGBB而FunHouse的DotStar LED库期望的是十六进制整数0xRRGGBB。这里分别定义了默认状态和触发状态的颜色。LIFX选择器label:Lamp告诉LIFX API我们要控制标签为“Lamp”的灯泡。选择器非常灵活你还可以用group:房间名控制一组灯或用id:灯泡ID精确控制。list_lights(): 这个调用会查询你的LIFX账户下所有灯泡的信息。在调试时可以取消注释print(lights)来查看返回的详细信息确认连接和令牌是否有效。第四部分FunHouse界面与状态初始化funhouse FunHouse(default_bg0x000F20, scale3) pir_state 0 running_state False trip_time 30 funhouse.peripherals.dotstars.fill(default_led_color)创建FunHouse对象设置深蓝色背景和文字缩放。pir_state: 记录PIR传感器上一次的状态0未触发1已触发用于检测状态变化而不是持续的高电平。这是避免重复触发的关键。running_state: 系统总开关。False为暂停True为运行。trip_time: 触发后亮灯的持续时间秒可通过按钮调整。第五部分创建屏幕显示标签def set_label_color(conditional, index, on_color): if conditional: funhouse.set_text_color(on_color, index) else: funhouse.set_text_color(0x606060, index) funhouse.display.root_group CIRCUITPYTHON_TERMINAL up_label funhouse.add_text(text, text_position(3, 6), text_color0x606060) down_label funhouse.add_text(text-, text_position(3, 40), text_color0x606060) running_label funhouse.add_text(textpaused, text_position(2, 68), text_color0x606060) time_label funhouse.add_text(texttrip_time, text_scale2, text_position(30, 25), text_color0x606060) funhouse.display.root_group funhouse.splash这段代码构建了用户界面。add_text创建文本标签并返回一个索引。set_label_color是一个辅助函数用于根据条件如按钮是否被按下改变标签颜色。界面布局了一个“”按钮标签、一个“-”按钮标签、一个状态标签显示paused/sensing…/tripped和一个居中放大的时间标签。第六部分主循环逻辑——事件处理与状态机主循环while True是程序的核心它不断扫描三个按钮和PIR传感器的状态并据此更新系统。按钮事件处理if funhouse.peripherals.button_up: trip_time trip_time 1 funhouse.set_text(trip_time, time_label) funhouse.set_text_color(0xFFFFFF, up_label) time.sleep(0.2) else: funhouse.set_text_color(0x606060, up_label)当“上”按钮被按下时trip_time加1更新时间显示并将“”标签高亮为白色。time.sleep(0.2)是一个简单的防抖延迟防止一次按压被误判为多次。按钮释放后标签恢复灰色。中间按钮button_sel用于减少时间逻辑类似。系统启停控制if funhouse.peripherals.button_down: if running_state is False: running_state True funhouse.set_text(..prepping.., running_label) time.sleep(6) funhouse.set_text(sensing..., running_label) else: running_state False funhouse.set_text(paused, running_label) time.sleep(0.5)按下“下”按钮切换系统运行状态。这里有一个精妙的细节当从暂停转为运行时先显示“..prepping..”并等待6秒。这6秒是留给用户离开传感器探测区域的避免系统一启动就因用户站在面前而立即触发。这是一个非常实用的用户体验设计。运动检测与灯光控制if running_state is True and funhouse.peripherals.pir_sensor and pir_state 0: # 触发处理 pir_state 1 ... elif running_state is True and not funhouse.peripherals.pir_sensor and pir_state 1: # 恢复处理 pir_state 0 ...这是整个系统的状态机。仅当系统在运行状态running_state is True时才处理PIR事件。触发条件PIR传感器输出为真检测到运动且上一次状态为未触发pir_state 0。这确保了每次运动只触发一次动作而不是持续触发。触发动作将DotStar LED和LIFX灯泡颜色改为触发色显示“tripped”然后开始倒计时。倒计时循环中每秒更新屏幕上的时间。倒计时结束后状态不会立即恢复而是等待另一个条件。恢复条件PIR传感器输出为假无运动且上一次状态为已触发pir_state 1。这意味着即使在倒计时结束前运动停止灯光也会保持触发色直到倒计时结束。倒计时结束后一旦传感器检测到“无运动”系统立即恢复到默认状态准备下一次检测。这种设计逻辑更符合“有人进入房间亮灯一段时间”的实际场景。5. 部署、调试与高级优化指南代码理解透彻后让我们将其部署到硬件上并解决可能遇到的问题甚至进行一些个性化升级。5.1 完整部署流程文件传输将编写好的settings.toml和code.py文件以及项目依赖的库文件如adafruit_lifx、adafruit_funhouse等可通过Adafruit的库捆绑包获取全部复制到CIRCUITPY磁盘的根目录。硬件上电用USB电源适配器为FunHouse供电。观察板载的RGB LED它们应该亮起默认的蓝绿色。屏幕也会点亮并显示“paused”和初始时间“30”。网络连接观察FunHouse启动后会自动连接Wi-Fi。你可以通过Mu Editor的串行监视器查看输出。连接成功后通常会打印出IP地址。同时代码中lifx.list_lights()的调用会尝试与LIFX API通信如果一切正常你的LIFX灯泡应该会亮起并呈现default_bulb_color定义的颜色。功能测试按钮测试按下“上”、“下”按钮观察屏幕中间的时间显示是否增减。按下“中”按钮观察系统状态是否在“paused”和“sensing…”之间切换切换时有6秒准备期。传感器测试将系统设为“sensing…”状态等待6秒准备期结束。然后在PIR传感器前挥手观察DotStar LED颜色是否变为紫色LIFX灯泡是否同步变色屏幕是否显示“tripped”并开始倒计时。5.2 常见问题排查速查表问题现象可能原因排查步骤与解决方案FunHouse屏幕不亮或LED不亮供电不足或USB线仅支持充电更换为可靠的5V 2A电源和高质量的数据线。检查USB-C口是否插紧。屏幕显示但Wi-Fi连接失败settings.toml配置错误或网络问题1. 检查CIRCUITPY_WIFI_SSID和CIRCUITPY_WIFI_PASSWORD拼写是否正确密码是否包含特殊字符建议先用简单密码测试。2. 打开Mu串行监视器查看具体的错误信息。3. 确保你的Wi-Fi是2.4GHz网络ESP32-S2不支持5GHz。LIFX灯泡无反应API令牌错误、灯泡未在线或选择器错误1. 在串行监视器中取消注释print(lights)查看API返回信息。如果返回错误检查lifx_token是否正确。2. 打开LIFX App确认名为“Lamp”的灯泡在线且可控。3. 确认代码中lifx_light “label:Lamp”的标签与App中完全一致区分大小写。PIR传感器一直触发或不触发传感器安装环境不佳或灵敏度/延时调节不当1.检查环境避免传感器对准窗户、通风口、发热电器。2.观察指示灯传感器上的LED在检测到运动时应闪烁。如果不闪检查连接如果常亮可能处于持续触发状态等待1分钟看是否稳定。3.调节电位器有些PIR传感器有两个可调电阻分别控制灵敏度Sx和触发后输出信号的持续时间Tx。可微调以适配环境。按钮操作无反应代码中防抖延迟过长或按钮扫描逻辑问题1. 尝试长按按钮超过0.2秒。2. 检查代码中funhouse.peripherals.button_up/down/sel的拼写是否正确。3. 在串行监视器中打印按钮状态确认硬件是否正常。倒计时结束后灯光不恢复PIR传感器仍检测到运动或状态机逻辑未满足恢复条件1. 确保在倒计时结束后你已离开传感器探测区域并且没有其他热源如宠物在活动。2. 理解代码逻辑恢复需要同时满足running_state is True、not funhouse.peripherals.pir_sensor和pir_state 1。5.3 项目优化与扩展思路基础版本运行稳定后你可以尝试以下优化和扩展让项目更强大、更智能增加亮度调节除了颜色你还可以通过LIFX API的set_brightness函数在触发时同时调整亮度。例如夜间模式可以设置为低亮度白天模式设置为高亮度。你可以在代码中定义两个亮度变量并在触发和恢复时分别设置。多灯泡与场景控制LIFX选择器非常强大。你可以将lifx_light改为group:Bedroom来控制整个卧室的灯泡。或者你可以创建一个lights列表里面包含多个选择器如[“label:Lamp1”, “label:Lamp2”]然后在循环中遍历列表对每个灯泡执行相同的操作实现多灯联动。环境光传感器集成FunHouse板载了光传感器你可以利用它来实现“仅在环境光较暗时启动运动感应”的功能。在代码中读取funhouse.peripherals.light的值并在主循环的判断条件中加入光强阈值判断例如if running_state is True and light_value 100 and …。状态持久化目前每次重启FunHousetrip_time都会重置为30秒。你可以使用CircuitPython的storage模块将用户设置的trip_time和running_state保存到板载的存储中下次启动时自动读取提升用户体验。网络容错处理当前的代码假设网络始终畅通。在实际环境中Wi-Fi可能偶尔断开。你可以增加网络重连逻辑。在wifi.radio.connect处使用try-except块并在主循环中定期检查wifi.radio.connected如果断开则尝试重连并在屏幕上显示连接状态。更丰富的UI反馈利用FunHouse的DotStar LED可以做出更炫酷的反馈。比如网络连接中让LED呼吸闪烁触发时让LED跑马灯倒计时时让LED逐个熄灭等。这个项目是一个完美的物联网入门沙盒。它麻雀虽小五脏俱全涵盖了传感器数据采集、嵌入式逻辑处理、无线网络通信、云服务API调用和本地人机交互等关键环节。通过动手实践和后续的扩展思考你不仅能获得一个实用的智能小工具更能建立起对现代物联网系统架构的直观理解。
相关文章
如何快速掌握智慧树自动刷课：面向新手的终极指南
如何快速掌握智慧树自动刷课：面向新手的终极指南 【免费下载链接】Autovisor 2025智慧树刷课脚本 基于Python Playwright的自动化程序 [有免安装版] 项目地址: https://gitcode.com/gh_mirrors/au/Autovisor 还在为智慧树网课的手动操作而烦恼吗？…
如何用Hitboxer彻底解决键盘方向冲突：新手零延迟游戏体验指南
如何用Hitboxer彻底解决键盘方向冲突：新手零延迟游戏体验指南 【免费下载链接】socd Key remapper for epic gamers 项目地址: https://gitcode.com/gh_mirrors/so/socd 还在为游戏中的键盘操作冲突而烦恼吗？当你同时按下W和S键时，角色…
基于MCP协议集成Namecheap API：AI驱动的域名自动化管理实践
1. 项目概述与核心价值最近在折腾AI Agent的开发，发现一个挺有意思的项目：ziggythebot/namecheap-mcp。简单来说，这是一个Model Context Protocol（MCP）服务器，专门用来把Namecheap域名注册商的API能力&…
词达人自动化助手：3分钟完成30分钟任务的智能学习解放者
词达人自动化助手：3分钟完成30分钟任务的智能学习解放者 【免费下载链接】cdr 微信词达人，高正确率，高效简洁。支持班级任务及自选任务 项目地址: https://gitcode.com/gh_mirrors/cd/cdr 还在为词达人的重复性词汇练习感到疲惫吗&…
突破平台壁垒：一站式跨平台Steam创意工坊模组获取方案
突破平台壁垒：一站式跨平台Steam创意工坊模组获取方案 【免费下载链接】WorkshopDL WorkshopDL - The Best Steam Workshop Downloader 项目地址: https://gitcode.com/gh_mirrors/wo/WorkshopDL 你是否曾在Epic Games Store或GOG平台购买了心仪的游戏&#…
LrcHelper：网易云音乐双语歌词下载终极指南 - 轻松获取精准歌词的免费神器
LrcHelper：网易云音乐双语歌词下载终极指南 - 轻松获取精准歌词的免费神器 【免费下载链接】LrcHelper 从网易云音乐下载带翻译的歌词 Walkman 适配 项目地址: https://gitcode.com/gh_mirrors/lr/LrcHelper LrcHelper是一款专为网易云音乐用户设计的歌词下载…
【限时公开】后印象派专属--ar 16:9 --style raw --stylize 800参数组合包（含塞尚构图/修拉点彩/劳特累克动态线共12套已验证prompt模板）
更多请点击： https://intelliparadigm.com 第一章：后印象派艺术精神与Midjourney风格迁移的本质逻辑 后印象派并非对印象派的简单延续，而是对主观表达、结构重构与象征张力的自觉回归——梵高旋转的星云、塞尚凝练的几何体、高更原始的色域&…
高性能键盘映射与SOCD清理架构解析：解决游戏输入冲突的技术方案
高性能键盘映射与SOCD清理架构解析：解决游戏输入冲突的技术方案 【免费下载链接】socd Key remapper for epic gamers 项目地址: https://gitcode.com/gh_mirrors/so/socd 在竞技游戏和高速动作游戏中，键盘输入的处理方式直接影响玩家的操作精度和…
3DS游戏格式转换终极指南：5分钟学会.3ds转CIA的完整教程
3DS游戏格式转换终极指南：5分钟学会.3ds转CIA的完整教程 【免费下载链接】3dsconv Python script to convert Nintendo 3DS CCI (".cci", ".3ds") files to the CIA format 项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv 还在为…
【实用小程序】超轻量级文件上传下载中心 (File Download Server)
站内源码及jar包下载 一、项目概述 文件下载中心一个基于 Java 内置 HTTP 服务器（com.sun.net.httpserver）构建的轻量级文件管理服务。它零第三方依赖，单 JAR 包即可运行，适合在内网环境或临时场景中快速搭建文件共享站点。 你的团队需要临时共享一批日志文件或交付物，…
py每日spider案例之某website之xin东方选课搜索接口(难度一般 扣取代码即可)
加密位置: 逆向接口参数: 逆向接口: const g = globalThis; g.window = g; g.self = g; g.location = {<
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南 【免费下载链接】markor Text editor - Notes & ToDo (for Android) - Markdown, todo.txt, plaintext, math, .. 项目地址: https://gitcode.com/gh_mirrors/ma/markor 在移动设备上寻找一款…
【实用小程序】超轻量级文件上传下载中心 (File Download Server)
站内源码及jar包下载 一、项目概述 文件下载中心一个基于 Java 内置 HTTP 服务器（com.sun.net.httpserver）构建的轻量级文件管理服务。它零第三方依赖，单 JAR 包即可运行，适合在内网环境或临时场景中快速搭建文件共享站点。 你的团队需要临时共享一批日志文件或交付物，…
py每日spider案例之某website之xin东方选课搜索接口(难度一般 扣取代码即可)
加密位置: 逆向接口参数: 逆向接口: const g = globalThis; g.window = g; g.self = g; g.location = {<
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南 【免费下载链接】markor Text editor - Notes & ToDo (for Android) - Markdown, todo.txt, plaintext, math, .. 项目地址: https://gitcode.com/gh_mirrors/ma/markor 在移动设备上寻找一款…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…