1. 项目缘起从“看月亮”到“造月亮”的执念不知道你有没有过这样的经历晚上抬头看天想看看今晚的月亮是圆是缺结果要么是阴天要么是城市光污染太严重要么干脆就是忘了。作为一个对天文有点兴趣又喜欢动手鼓捣点东西的爱好者我一直觉得如果能有一个放在桌面上、能实时展示当前月相的小装置那该多酷。它不仅能当个有格调的摆件还能随时提醒你时间的流逝和宇宙的韵律。市面上当然有现成的月相灯但大多就是个固定的造型或者用简单的LED灯模拟一下明暗总觉得少了点灵魂。我想要的是一个能真正“动”起来的月相——一个球体一半被照亮另一半隐藏在阴影中并且这个明暗交界线天文学上叫“明暗界线”能像真实的月亮一样随着日期平滑地移动。这个想法听起来简单但真要实现涉及到机械结构、电子控制和软件算法的融合是个典型的创客项目。正好手头有一块行空板它集成了高性能的处理器、丰富的接口和一块高清屏幕简直就是为这种智能交互装置量身定做的“大脑”。再搭配上Mind这款对初学者极其友好的图形化编程软件当然也支持Python以及用来驱动球体旋转的舵机一个“智能月相演示装置”的蓝图就在我脑子里成型了。这个项目说白了就是用硬件“造”一个物理月亮用软件赋予它真实的灵魂。下面我就把自己从构思、选型、搭建到调试的完整过程以及踩过的那些坑毫无保留地分享出来。2. 核心设计如何让一个球体“演绎”月相在动手之前我们必须先想清楚最核心的机械和光学原理。月相变化的本质是太阳、地球、月球三者位置关系导致的。我们从地球上看月球被太阳照亮的部分有多少。这个项目是在地面上模拟所以我们需要做一个“替身”一个白色的球体代表月球一个固定的光源代表太阳而我们观察者的视角是固定的。2.1 机械结构方案选型要让月相动起来核心是让球体自转。这里有几种方案方案A球体直接旋转。用一个舵机直接带动球体绕轴心旋转。这是最直观的想法。但问题来了真实的月相变化周期大约是29.5天意味着我们的球体需要在近30天内缓慢旋转360度。这对于普通舵机是巨大的挑战。舵机通常用于需要快速、精准定位到特定角度的场景比如机器人关节让它以极低的速度连续旋转近一个月不仅精度难以保证舵机本身也可能发热损坏。方案B光源旋转球体静止。固定球体让代表太阳的光源绕球体旋转。这能解决舵机长期低速运行的问题但带来了新的麻烦你需要一个足够大、结构稳定的旋转支架来承载光源并且要确保光线能均匀照射球体结构复杂度飙升。方案C遮光片旋转方案本项目采用。这是我在权衡后选择的折中且巧妙的方案。球体本身保持静止在球体和固定光源之间加入一个可以旋转的圆形遮光片。这个遮光片一半涂黑不透光一半留白透光或镂空。当遮光片旋转时它就在球体上投下了一个移动的阴影边界模拟出月相明暗的变化。为什么最终选择方案C对舵机友好舵机只需要驱动一个轻质的遮光片旋转负载小。我们可以将一个月相周期360度的旋转分解为多次小角度的步进。例如每过1小时让舵机转动一个小角度比如0.5度。这样舵机大部分时间处于静止省电状态只在需要时短促动作一下完美避开了长期连续运行的痛点。结构简单稳定球体固定整个装置的重心和稳定性非常好。遮光片可以用亚克力或轻木板制作加工容易。效果可控遮光片的形状可以精确控制阴影边界的锐利程度甚至可以通过设计非标准的遮光图案来模拟特殊天象如月食扩展性强。2.2 电子与控制核心选型主控板行空板。我选择行空板而非Arduino或树莓派Pico主要看中三点一是其内置的Linux系统和Python环境让我能方便地编写复杂的日期计算和网络对时逻辑二是板载的彩色屏幕可以同步显示丰富的辅助信息如当前日期、农历、月相名称等交互体验直接拉满三是其丰富的GPIO、I2C、UART接口连接传感器和舵机驱动板毫无压力。编程环境Mind Python。Mind的图形化界面非常适合快速搭建项目原型和逻辑验证尤其是在和行空板搭配时连接和上传程序非常便捷。当逻辑稳定后可以无缝切换到Python代码模式进行深度优化和功能扩展这对从入门到进阶的学习路径非常友好。执行器舵机与驱动。需要一个舵机来驱动遮光片。对于这种慢速、精确定位的应用一个普通的SG90微型舵机就足够了。需要注意的是行空板的GPIO口输出电流有限通常需要一块单独的舵机驱动板或使用PCA9685这样的PWM驱动芯片来提供稳定的电源和控制信号以保护行空板。2.3 月相算法从日期到角度这是项目的“软件灵魂”。我们需要一个算法输入当前日期输出遮光片应该转到的角度。月相周期朔望月平均约为29.53059天。我们可以选择一个已知的“新月”朔时刻作为基准点例如一个标准的UTC时间。然后计算当前时间与基准点之间经过了多少个“天”包括小数部分的天数。当前月相天数 (当前UTC时间戳 - 基准新月UTC时间戳) / 86400秒 % 29.53059这里%是取模运算得到的结果是当前月相周期内的第几天0~29.53059。0代表新月29.53059也代表新月。接着将月相天数映射到遮光片的旋转角度0~360度目标角度 (当前月相天数 / 29.53059) * 360.0例如月相天数为7.38265天约为上弦月计算出的角度就是(7.38265 / 29.53059) * 360 ≈ 90度。这意味着遮光片需要从0度位置新月对应旋转90度使得球体上一半被照亮一半处于阴影完美呈现上弦月。注意这里有一个关键细节。由于我们采用遮光片方案遮光片0度位置全黑对准球体对应的是“新月”全黑。而真实的新月是看不见的。所以我们的角度映射关系需要和机械安装的初始位置严格对应。在程序初始化时必须有一个“归零校准”步骤确保物理零位和逻辑零位一致。3. 硬件搭建全记录从零件到装置理论通了接下来就是动手。我把硬件部分拆解为几个模块逐一攻克。3.1 材料清单与工具准备核心控制器行空板 1块执行机构SG90舵机 1个舵机驱动板或PCA9685模块1块结构部分白色乒乓球或小型白色塑料球 1个作为月球3mm厚亚克力板用于制作遮光片和支架激光切割机或手工用勾刀、电钻M3螺丝、螺母、铜柱若干小型LED灯珠暖白色及限流电阻 1套不透光的深色卡纸或盒子用于制作暗箱避免环境光干扰连接线杜邦线公对公、母对母电源5V/2A的USB电源适配器为行空板和舵机驱动板供电3.2 机械结构制作详解制作暗箱用一个深色的纸盒或木板搭一个大约20cm见方的小箱子。正面开一个观察窗。这个箱子的作用是隔绝大部分环境光让内部LED成为唯一光源确保月相投影效果清晰。固定“月球”将白色小球用热熔胶或支撑杆固定在暗箱中央偏后的位置。制作并安装遮光片用绘图软件如Inkscape画两个同心圆。外圆直径略小于暗箱宽度内圆直径比小球直径大1-2cm。将两个圆之间的圆环部分从某条直径线开始一半填充为黑色代表不透光另一半留空或画上密集的栅格线代表透光区。这就是我们的遮光片图案。将图案文件送去激光切割材料用3mm亚克力板。如果没有激光切割可以用手工仔细切割但精度会差一些。在遮光片的圆心位置开一个小孔用于固定在舵机的舵盘上。集成舵机与遮光片将舵机用螺丝固定在暗箱顶部或侧面的支架上确保其旋转轴心水平。将舵机臂舵盘安装到舵机上然后将制作好的遮光片用螺丝紧固在舵盘上。关键一步此时手动旋转舵盘将遮光片的“全黑”分界线调整到正好完全遮挡住后方的小球。拧紧螺丝这个位置就是舵机的“物理零位”。记住此时舵机的角度通常是舵机初始化时的中间位置即90度但具体取决于你的安装。布置光源将一颗暖白色LED灯珠串联一个220欧姆的限流电阻固定在暗箱内壁位置在遮光片和小球连线的外侧。确保灯光能透过遮光片的透光区均匀地照射到小球上。可以用一小段黑色吸管做遮光罩让光线更集中。3.3 电路连接电路连接相对简单但务必仔细行空板的5V和GND引脚连接到舵机驱动板的VCC和GND为其供电。行空板的任意一个GPIO口例如P21连接到舵机驱动板的信号输入口如PWM IN。舵机的三根线信号-黄/白电源-红地-棕/黑连接到舵机驱动板的对应输出通道如Channel 0。行空板通过USB线连接5V电源适配器。舵机驱动板的电源输入端也连接到同一个电源适配器注意共地。强烈建议舵机单独供电如果从行空板取电大电流可能会造成行空板重启。4. 软件编程让装置“智能”起来硬件是躯体软件是灵魂。我们的软件需要完成三件事获取精确时间、计算月相角度、控制舵机转动。4.1 环境准备与基础代码首先确保行空板连接到Wi-Fi。在Mind中选择“行空板”主控并连接设备。我们主要依赖两个Python库time/datetime用于时间处理pwn或gpiozero用于GPIO控制舵机信号。Mind的Python模式已经集成了这些库。下面是核心代码的结构解析# -*- coding: utf-8 -*- import time import datetime from pinpong.board import Board, Pin, Servo # 使用pinpong库控制舵机 import threading # 1. 初始化 Board().begin() # 初始化行空板 servo Servo(Pin.P21) # 舵机连接在P21 # 2. 月相计算参数 LUNAR_CYCLE 29.53059 # 朔望月周期天 # 设定一个已知的新月朔时间点例如2020年1月24日 21:42 UTC NEW_MOON_UTC datetime.datetime(2020, 1, 24, 21, 42, 0).timestamp() def calculate_moon_phase(): 计算当前时刻的月相角度0-360度 now_utc time.time() # 获取当前UTC时间戳 # 计算距离基准新月过去了多少天 days_since_new (now_utc - NEW_MOON_UTC) / 86400.0 # 取模得到当前周期内的天数 phase_days days_since_new % LUNAR_CYCLE # 将天数转换为角度 phase_angle (phase_days / LUNAR_CYCLE) * 360.0 return phase_angle def angle_to_servo_pulse(angle): 将月相角度0-360映射为舵机脉冲宽度通常500-2500微秒 # 假设舵机有效范围是0-180度对应500-2500微秒 # 我们需要将360度的月相映射到舵机的180度范围因为遮光片旋转180度即可完成半个周期的明暗变化对称性 # 更合理的映射月相角度0度新月- 舵机45度遮光片全遮 # 月相角度180度满月-舵机135度遮光片全开 servo_angle 45 (angle % 180) * (90 / 180.0) # 映射到45-135度区间 return servo_angle # 3. 舵机控制函数 def update_servo(): target_angle angle_to_servo_pulse(calculate_moon_phase()) servo.angle(target_angle) # 控制舵机转到目标角度 print(fUTC: {datetime.datetime.utcnow()} 月相角度: {calculate_moon_phase():.2f} 舵机角度: {target_angle:.2f}) # 4. 主循环与定时更新 def main(): last_update_day -1 while True: current_day datetime.datetime.now().day # 每天只在日期变更时更新一次减少不必要的机械磨损 if current_day ! last_update_day: update_servo() last_update_day current_day # 可以在行空板屏幕上显示信息需额外编写显示代码 # display_info(calculate_moon_phase()) time.sleep(60) # 每分钟检查一次日期 if __name__ __main__: main()4.2 关键逻辑剖析与优化时间获取的准确性代码中使用time.time()获取UTC时间。行空板联网后可以通过NTP网络时间协议自动同步时间确保基准准确。你可以在行空板的系统设置中开启NTP或者在代码中调用ntplib库进行同步。舵机映射逻辑这是最容易出错的地方。angle_to_servo_pulse函数中的映射关系必须和你的机械安装零位完全匹配。在上述代码中我假设舵机45度时遮光片处于“全遮”新月位置。你需要根据实际安装情况调整这个映射函数。调试方法先屏蔽月相计算手动设置舵机角度观察小球被遮挡的情况找到“全遮”和“全亮”对应的舵机角度值然后修改映射公式。更新策略优化月相变化很慢完全没必要每秒更新。我的策略是每天只在日期变更时更新一次if current_day ! last_update_day。这极大地减少了舵机动作次数延长了寿命。如果你追求极致平滑可以改为每小时更新一次计算量也微乎其微。屏幕信息显示行空板的屏幕是亮点。你可以使用ui模块或PIL库绘制界面显示当前公历日期、农历日期、月相名称如“朔”、“上弦”、“望”、“下弦”、月相图标等让装置的信息维度更加丰富。5. 调试、优化与踩坑实录项目从能跑到跑得稳、效果佳中间经历了大量的调试。这里分享几个最具代表性的坑和解决方案。5.1 舵机抖动与定位不准问题现象舵机在到达指定角度后会有轻微的持续抖动或“吱吱”声或者每次上电后位置有微小偏差。根因分析电源干扰舵机在动作时瞬间电流较大如果电源功率不足或线缆过长过细会引起电压跌落导致行空板或舵机控制信号不稳定。信号干扰控制线PWM信号线如果和电源线并行且过长可能引入噪声。机械阻力遮光片安装不水平或者轴心有摩擦导致舵机负载不均为了维持位置需要持续用力从而抖动。解决方案独立供电务必为舵机驱动板提供独立的5V/2A以上电源并与行空板电源共地。这是解决抖动问题最有效的一步。电源滤波在舵机驱动板的电源输入端并联一个100-470uF的电解电容可以平滑瞬间电流冲击。信号隔离尽量缩短舵机信号线并避免与电机电源线捆扎在一起。如果条件允许使用带光耦隔离的舵机驱动板。机械调校确保遮光片旋转顺畅无卡滞。可以在舵机轴和支架之间加一个小轴承减少摩擦。软件消抖在控制代码中到达目标角度后可以短暂延时并停止发送PWM信号如果库支持。或者使用gpiozero库的Servo类它通常有更好的阻尼控制。5.2 月相显示“跳变”或方向反了问题现象装置运行几天后某一天月相突然“跳”了一下或者明暗移动的方向和真实月亮相反比如真实月亮渐盈它却渐亏。根因分析基准时间错误代码中NEW_MOON_UTC这个基准新月时间不准确或者时区处理有误。time.time()返回UTC而你的基准时间如果用了本地时间就会产生每天约8小时的累积误差对中国时区而言。角度映射公式错误angle_to_servo_pulse函数中的系数或偏移量设置不对导致0-360度月相角没有正确映射到舵机的有效行程。机械零位未校准物理安装的“全遮”位置没有对应到程序中的“0度月相角”。解决方案校准基准时间从权威天文网站或软件如Stellarium获取一个非常精确的UTC时间新月时刻。确保代码中所有时间比较都在UTC下进行。系统化调试映射关系写一个简单的测试程序让舵机从最小角度运动到最大角度用马克笔在遮光片上标记出“全遮”和“全亮”时对应的舵机角度值。将这两个值代入线性映射公式servo_angle A * phase_angle B解出A和B。增加校准模式在最终的程序中可以增加一个通过行空板按钮触发的“校准模式”。进入该模式后用按钮微调舵机位置直到小球呈现“新月”状态然后程序记录下此时的舵机角度作为新的零位偏移量存入文件。这样即使硬件稍有变动也能轻松软件校准。5.3 网络时间同步失败问题现象行空板断网重启后系统时间恢复到出厂日期导致月相计算完全错误。解决方案增加离线守时行空板内部有RTC实时时钟但断电后需要电池维持。检查并确保RTC电池有效。在代码初始化时先尝试从RTC读取时间作为备用。双阶段时间获取def get_accurate_time(): try: # 尝试NTP同步 import ntplib ntp_client ntplib.NTPClient() response ntp_client.request(pool.ntp.org) return response.tx_time except: # 同步失败使用系统RTC时间需确保之前同步过 print(NTP同步失败使用系统时间) return time.time()状态提示在行空板屏幕上明确显示时间来源“NTP已同步”或“使用本地时钟”让用户知晓状态。6. 效果提升与扩展玩法基础功能实现后就可以琢磨怎么让它更酷、更实用了。光影效果升级光源将单颗LED换成一条LED灯带环绕在遮光片外侧这样照射到球体上的光线会更均匀阴影边缘更柔和更像真实的太阳平行光。球体将光滑的白球换成表面有凹凸纹理的球体例如3D打印一个月球地形模型在侧光照射下会产生更逼真的环形山阴影效果震撼。交互功能增强手动调节在行空板屏幕上增加滑动条或按钮允许用户手动切换查看不同日期的月相或者快速演示一个完整的月相周期。语音查询接入一个简单的离线语音识别模块实现“今天月亮什么样”的语音问答装置转动并屏幕显示答案。物联网接入通过行空板的网络能力将当前月相数据上传到物联网平台如SIoT、Home Assistant在其他设备上远程查看。美学与结构设计将整个暗箱结构进行精致的外观设计比如做成复古的望远镜造型、现代几何切割造型让它本身成为一件艺术品。使用步进电机代替舵机可以获得更安静、更精确的旋转控制彻底消除抖动噪音。这个“智能月相演示装置”项目从想法到实物的过程是一次完整的硬件、软件、算法融合的实践。它不像单纯的编程或焊接那样单一而是要求你综合考虑物理限制、控制逻辑和用户体验。最大的收获不是做出了一个会转的球而是学会了如何将一个抽象的天文概念通过工程化的思维一步步拆解、选型、实现和优化。当装置第一次准确地显示出上弦月的那道优美弧线时那种连接了宇宙韵律与指尖创造的感觉就是创客精神最好的回报。如果你也感兴趣不妨就从准备一个行空板和一个舵机开始吧最重要的永远是动手做起来。
1. 项目缘起从“看月亮”到“造月亮”的执念不知道你有没有过这样的经历晚上抬头看天想看看今晚的月亮是圆是缺结果要么是阴天要么是城市光污染太严重要么干脆就是忘了。作为一个对天文有点兴趣又喜欢动手鼓捣点东西的爱好者我一直觉得如果能有一个放在桌面上、能实时展示当前月相的小装置那该多酷。它不仅能当个有格调的摆件还能随时提醒你时间的流逝和宇宙的韵律。市面上当然有现成的月相灯但大多就是个固定的造型或者用简单的LED灯模拟一下明暗总觉得少了点灵魂。我想要的是一个能真正“动”起来的月相——一个球体一半被照亮另一半隐藏在阴影中并且这个明暗交界线天文学上叫“明暗界线”能像真实的月亮一样随着日期平滑地移动。这个想法听起来简单但真要实现涉及到机械结构、电子控制和软件算法的融合是个典型的创客项目。正好手头有一块行空板它集成了高性能的处理器、丰富的接口和一块高清屏幕简直就是为这种智能交互装置量身定做的“大脑”。再搭配上Mind这款对初学者极其友好的图形化编程软件当然也支持Python以及用来驱动球体旋转的舵机一个“智能月相演示装置”的蓝图就在我脑子里成型了。这个项目说白了就是用硬件“造”一个物理月亮用软件赋予它真实的灵魂。下面我就把自己从构思、选型、搭建到调试的完整过程以及踩过的那些坑毫无保留地分享出来。2. 核心设计如何让一个球体“演绎”月相在动手之前我们必须先想清楚最核心的机械和光学原理。月相变化的本质是太阳、地球、月球三者位置关系导致的。我们从地球上看月球被太阳照亮的部分有多少。这个项目是在地面上模拟所以我们需要做一个“替身”一个白色的球体代表月球一个固定的光源代表太阳而我们观察者的视角是固定的。2.1 机械结构方案选型要让月相动起来核心是让球体自转。这里有几种方案方案A球体直接旋转。用一个舵机直接带动球体绕轴心旋转。这是最直观的想法。但问题来了真实的月相变化周期大约是29.5天意味着我们的球体需要在近30天内缓慢旋转360度。这对于普通舵机是巨大的挑战。舵机通常用于需要快速、精准定位到特定角度的场景比如机器人关节让它以极低的速度连续旋转近一个月不仅精度难以保证舵机本身也可能发热损坏。方案B光源旋转球体静止。固定球体让代表太阳的光源绕球体旋转。这能解决舵机长期低速运行的问题但带来了新的麻烦你需要一个足够大、结构稳定的旋转支架来承载光源并且要确保光线能均匀照射球体结构复杂度飙升。方案C遮光片旋转方案本项目采用。这是我在权衡后选择的折中且巧妙的方案。球体本身保持静止在球体和固定光源之间加入一个可以旋转的圆形遮光片。这个遮光片一半涂黑不透光一半留白透光或镂空。当遮光片旋转时它就在球体上投下了一个移动的阴影边界模拟出月相明暗的变化。为什么最终选择方案C对舵机友好舵机只需要驱动一个轻质的遮光片旋转负载小。我们可以将一个月相周期360度的旋转分解为多次小角度的步进。例如每过1小时让舵机转动一个小角度比如0.5度。这样舵机大部分时间处于静止省电状态只在需要时短促动作一下完美避开了长期连续运行的痛点。结构简单稳定球体固定整个装置的重心和稳定性非常好。遮光片可以用亚克力或轻木板制作加工容易。效果可控遮光片的形状可以精确控制阴影边界的锐利程度甚至可以通过设计非标准的遮光图案来模拟特殊天象如月食扩展性强。2.2 电子与控制核心选型主控板行空板。我选择行空板而非Arduino或树莓派Pico主要看中三点一是其内置的Linux系统和Python环境让我能方便地编写复杂的日期计算和网络对时逻辑二是板载的彩色屏幕可以同步显示丰富的辅助信息如当前日期、农历、月相名称等交互体验直接拉满三是其丰富的GPIO、I2C、UART接口连接传感器和舵机驱动板毫无压力。编程环境Mind Python。Mind的图形化界面非常适合快速搭建项目原型和逻辑验证尤其是在和行空板搭配时连接和上传程序非常便捷。当逻辑稳定后可以无缝切换到Python代码模式进行深度优化和功能扩展这对从入门到进阶的学习路径非常友好。执行器舵机与驱动。需要一个舵机来驱动遮光片。对于这种慢速、精确定位的应用一个普通的SG90微型舵机就足够了。需要注意的是行空板的GPIO口输出电流有限通常需要一块单独的舵机驱动板或使用PCA9685这样的PWM驱动芯片来提供稳定的电源和控制信号以保护行空板。2.3 月相算法从日期到角度这是项目的“软件灵魂”。我们需要一个算法输入当前日期输出遮光片应该转到的角度。月相周期朔望月平均约为29.53059天。我们可以选择一个已知的“新月”朔时刻作为基准点例如一个标准的UTC时间。然后计算当前时间与基准点之间经过了多少个“天”包括小数部分的天数。当前月相天数 (当前UTC时间戳 - 基准新月UTC时间戳) / 86400秒 % 29.53059这里%是取模运算得到的结果是当前月相周期内的第几天0~29.53059。0代表新月29.53059也代表新月。接着将月相天数映射到遮光片的旋转角度0~360度目标角度 (当前月相天数 / 29.53059) * 360.0例如月相天数为7.38265天约为上弦月计算出的角度就是(7.38265 / 29.53059) * 360 ≈ 90度。这意味着遮光片需要从0度位置新月对应旋转90度使得球体上一半被照亮一半处于阴影完美呈现上弦月。注意这里有一个关键细节。由于我们采用遮光片方案遮光片0度位置全黑对准球体对应的是“新月”全黑。而真实的新月是看不见的。所以我们的角度映射关系需要和机械安装的初始位置严格对应。在程序初始化时必须有一个“归零校准”步骤确保物理零位和逻辑零位一致。3. 硬件搭建全记录从零件到装置理论通了接下来就是动手。我把硬件部分拆解为几个模块逐一攻克。3.1 材料清单与工具准备核心控制器行空板 1块执行机构SG90舵机 1个舵机驱动板或PCA9685模块1块结构部分白色乒乓球或小型白色塑料球 1个作为月球3mm厚亚克力板用于制作遮光片和支架激光切割机或手工用勾刀、电钻M3螺丝、螺母、铜柱若干小型LED灯珠暖白色及限流电阻 1套不透光的深色卡纸或盒子用于制作暗箱避免环境光干扰连接线杜邦线公对公、母对母电源5V/2A的USB电源适配器为行空板和舵机驱动板供电3.2 机械结构制作详解制作暗箱用一个深色的纸盒或木板搭一个大约20cm见方的小箱子。正面开一个观察窗。这个箱子的作用是隔绝大部分环境光让内部LED成为唯一光源确保月相投影效果清晰。固定“月球”将白色小球用热熔胶或支撑杆固定在暗箱中央偏后的位置。制作并安装遮光片用绘图软件如Inkscape画两个同心圆。外圆直径略小于暗箱宽度内圆直径比小球直径大1-2cm。将两个圆之间的圆环部分从某条直径线开始一半填充为黑色代表不透光另一半留空或画上密集的栅格线代表透光区。这就是我们的遮光片图案。将图案文件送去激光切割材料用3mm亚克力板。如果没有激光切割可以用手工仔细切割但精度会差一些。在遮光片的圆心位置开一个小孔用于固定在舵机的舵盘上。集成舵机与遮光片将舵机用螺丝固定在暗箱顶部或侧面的支架上确保其旋转轴心水平。将舵机臂舵盘安装到舵机上然后将制作好的遮光片用螺丝紧固在舵盘上。关键一步此时手动旋转舵盘将遮光片的“全黑”分界线调整到正好完全遮挡住后方的小球。拧紧螺丝这个位置就是舵机的“物理零位”。记住此时舵机的角度通常是舵机初始化时的中间位置即90度但具体取决于你的安装。布置光源将一颗暖白色LED灯珠串联一个220欧姆的限流电阻固定在暗箱内壁位置在遮光片和小球连线的外侧。确保灯光能透过遮光片的透光区均匀地照射到小球上。可以用一小段黑色吸管做遮光罩让光线更集中。3.3 电路连接电路连接相对简单但务必仔细行空板的5V和GND引脚连接到舵机驱动板的VCC和GND为其供电。行空板的任意一个GPIO口例如P21连接到舵机驱动板的信号输入口如PWM IN。舵机的三根线信号-黄/白电源-红地-棕/黑连接到舵机驱动板的对应输出通道如Channel 0。行空板通过USB线连接5V电源适配器。舵机驱动板的电源输入端也连接到同一个电源适配器注意共地。强烈建议舵机单独供电如果从行空板取电大电流可能会造成行空板重启。4. 软件编程让装置“智能”起来硬件是躯体软件是灵魂。我们的软件需要完成三件事获取精确时间、计算月相角度、控制舵机转动。4.1 环境准备与基础代码首先确保行空板连接到Wi-Fi。在Mind中选择“行空板”主控并连接设备。我们主要依赖两个Python库time/datetime用于时间处理pwn或gpiozero用于GPIO控制舵机信号。Mind的Python模式已经集成了这些库。下面是核心代码的结构解析# -*- coding: utf-8 -*- import time import datetime from pinpong.board import Board, Pin, Servo # 使用pinpong库控制舵机 import threading # 1. 初始化 Board().begin() # 初始化行空板 servo Servo(Pin.P21) # 舵机连接在P21 # 2. 月相计算参数 LUNAR_CYCLE 29.53059 # 朔望月周期天 # 设定一个已知的新月朔时间点例如2020年1月24日 21:42 UTC NEW_MOON_UTC datetime.datetime(2020, 1, 24, 21, 42, 0).timestamp() def calculate_moon_phase(): 计算当前时刻的月相角度0-360度 now_utc time.time() # 获取当前UTC时间戳 # 计算距离基准新月过去了多少天 days_since_new (now_utc - NEW_MOON_UTC) / 86400.0 # 取模得到当前周期内的天数 phase_days days_since_new % LUNAR_CYCLE # 将天数转换为角度 phase_angle (phase_days / LUNAR_CYCLE) * 360.0 return phase_angle def angle_to_servo_pulse(angle): 将月相角度0-360映射为舵机脉冲宽度通常500-2500微秒 # 假设舵机有效范围是0-180度对应500-2500微秒 # 我们需要将360度的月相映射到舵机的180度范围因为遮光片旋转180度即可完成半个周期的明暗变化对称性 # 更合理的映射月相角度0度新月- 舵机45度遮光片全遮 # 月相角度180度满月-舵机135度遮光片全开 servo_angle 45 (angle % 180) * (90 / 180.0) # 映射到45-135度区间 return servo_angle # 3. 舵机控制函数 def update_servo(): target_angle angle_to_servo_pulse(calculate_moon_phase()) servo.angle(target_angle) # 控制舵机转到目标角度 print(fUTC: {datetime.datetime.utcnow()} 月相角度: {calculate_moon_phase():.2f} 舵机角度: {target_angle:.2f}) # 4. 主循环与定时更新 def main(): last_update_day -1 while True: current_day datetime.datetime.now().day # 每天只在日期变更时更新一次减少不必要的机械磨损 if current_day ! last_update_day: update_servo() last_update_day current_day # 可以在行空板屏幕上显示信息需额外编写显示代码 # display_info(calculate_moon_phase()) time.sleep(60) # 每分钟检查一次日期 if __name__ __main__: main()4.2 关键逻辑剖析与优化时间获取的准确性代码中使用time.time()获取UTC时间。行空板联网后可以通过NTP网络时间协议自动同步时间确保基准准确。你可以在行空板的系统设置中开启NTP或者在代码中调用ntplib库进行同步。舵机映射逻辑这是最容易出错的地方。angle_to_servo_pulse函数中的映射关系必须和你的机械安装零位完全匹配。在上述代码中我假设舵机45度时遮光片处于“全遮”新月位置。你需要根据实际安装情况调整这个映射函数。调试方法先屏蔽月相计算手动设置舵机角度观察小球被遮挡的情况找到“全遮”和“全亮”对应的舵机角度值然后修改映射公式。更新策略优化月相变化很慢完全没必要每秒更新。我的策略是每天只在日期变更时更新一次if current_day ! last_update_day。这极大地减少了舵机动作次数延长了寿命。如果你追求极致平滑可以改为每小时更新一次计算量也微乎其微。屏幕信息显示行空板的屏幕是亮点。你可以使用ui模块或PIL库绘制界面显示当前公历日期、农历日期、月相名称如“朔”、“上弦”、“望”、“下弦”、月相图标等让装置的信息维度更加丰富。5. 调试、优化与踩坑实录项目从能跑到跑得稳、效果佳中间经历了大量的调试。这里分享几个最具代表性的坑和解决方案。5.1 舵机抖动与定位不准问题现象舵机在到达指定角度后会有轻微的持续抖动或“吱吱”声或者每次上电后位置有微小偏差。根因分析电源干扰舵机在动作时瞬间电流较大如果电源功率不足或线缆过长过细会引起电压跌落导致行空板或舵机控制信号不稳定。信号干扰控制线PWM信号线如果和电源线并行且过长可能引入噪声。机械阻力遮光片安装不水平或者轴心有摩擦导致舵机负载不均为了维持位置需要持续用力从而抖动。解决方案独立供电务必为舵机驱动板提供独立的5V/2A以上电源并与行空板电源共地。这是解决抖动问题最有效的一步。电源滤波在舵机驱动板的电源输入端并联一个100-470uF的电解电容可以平滑瞬间电流冲击。信号隔离尽量缩短舵机信号线并避免与电机电源线捆扎在一起。如果条件允许使用带光耦隔离的舵机驱动板。机械调校确保遮光片旋转顺畅无卡滞。可以在舵机轴和支架之间加一个小轴承减少摩擦。软件消抖在控制代码中到达目标角度后可以短暂延时并停止发送PWM信号如果库支持。或者使用gpiozero库的Servo类它通常有更好的阻尼控制。5.2 月相显示“跳变”或方向反了问题现象装置运行几天后某一天月相突然“跳”了一下或者明暗移动的方向和真实月亮相反比如真实月亮渐盈它却渐亏。根因分析基准时间错误代码中NEW_MOON_UTC这个基准新月时间不准确或者时区处理有误。time.time()返回UTC而你的基准时间如果用了本地时间就会产生每天约8小时的累积误差对中国时区而言。角度映射公式错误angle_to_servo_pulse函数中的系数或偏移量设置不对导致0-360度月相角没有正确映射到舵机的有效行程。机械零位未校准物理安装的“全遮”位置没有对应到程序中的“0度月相角”。解决方案校准基准时间从权威天文网站或软件如Stellarium获取一个非常精确的UTC时间新月时刻。确保代码中所有时间比较都在UTC下进行。系统化调试映射关系写一个简单的测试程序让舵机从最小角度运动到最大角度用马克笔在遮光片上标记出“全遮”和“全亮”时对应的舵机角度值。将这两个值代入线性映射公式servo_angle A * phase_angle B解出A和B。增加校准模式在最终的程序中可以增加一个通过行空板按钮触发的“校准模式”。进入该模式后用按钮微调舵机位置直到小球呈现“新月”状态然后程序记录下此时的舵机角度作为新的零位偏移量存入文件。这样即使硬件稍有变动也能轻松软件校准。5.3 网络时间同步失败问题现象行空板断网重启后系统时间恢复到出厂日期导致月相计算完全错误。解决方案增加离线守时行空板内部有RTC实时时钟但断电后需要电池维持。检查并确保RTC电池有效。在代码初始化时先尝试从RTC读取时间作为备用。双阶段时间获取def get_accurate_time(): try: # 尝试NTP同步 import ntplib ntp_client ntplib.NTPClient() response ntp_client.request(pool.ntp.org) return response.tx_time except: # 同步失败使用系统RTC时间需确保之前同步过 print(NTP同步失败使用系统时间) return time.time()状态提示在行空板屏幕上明确显示时间来源“NTP已同步”或“使用本地时钟”让用户知晓状态。6. 效果提升与扩展玩法基础功能实现后就可以琢磨怎么让它更酷、更实用了。光影效果升级光源将单颗LED换成一条LED灯带环绕在遮光片外侧这样照射到球体上的光线会更均匀阴影边缘更柔和更像真实的太阳平行光。球体将光滑的白球换成表面有凹凸纹理的球体例如3D打印一个月球地形模型在侧光照射下会产生更逼真的环形山阴影效果震撼。交互功能增强手动调节在行空板屏幕上增加滑动条或按钮允许用户手动切换查看不同日期的月相或者快速演示一个完整的月相周期。语音查询接入一个简单的离线语音识别模块实现“今天月亮什么样”的语音问答装置转动并屏幕显示答案。物联网接入通过行空板的网络能力将当前月相数据上传到物联网平台如SIoT、Home Assistant在其他设备上远程查看。美学与结构设计将整个暗箱结构进行精致的外观设计比如做成复古的望远镜造型、现代几何切割造型让它本身成为一件艺术品。使用步进电机代替舵机可以获得更安静、更精确的旋转控制彻底消除抖动噪音。这个“智能月相演示装置”项目从想法到实物的过程是一次完整的硬件、软件、算法融合的实践。它不像单纯的编程或焊接那样单一而是要求你综合考虑物理限制、控制逻辑和用户体验。最大的收获不是做出了一个会转的球而是学会了如何将一个抽象的天文概念通过工程化的思维一步步拆解、选型、实现和优化。当装置第一次准确地显示出上弦月的那道优美弧线时那种连接了宇宙韵律与指尖创造的感觉就是创客精神最好的回报。如果你也感兴趣不妨就从准备一个行空板和一个舵机开始吧最重要的永远是动手做起来。
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
