Marlin固件中实现编译时间戳显示功能的技术解析
2025-05-13 19:12:11作者:伍希望
背景介绍
在3D打印机固件Marlin的开发过程中,开发者经常需要频繁编译和测试不同版本的固件。当短时间内进行多次编译时,很难直观地区分当前运行的固件版本。为了解决这个问题,Marlin社区提出了一个功能需求:在打印机屏幕上显示固件的编译时间戳。
技术实现方案
核心思路
Marlin固件本身在编译时就会生成编译时间信息,这些信息通过预定义宏__DATE__
和__TIME__
记录。解决方案的核心在于将这些信息通过LCD菜单系统展示给用户。
具体实现
-
配置选项:
- 在
Configuration_adv.h
文件中添加BUILDDATE
宏定义,作为功能开关 - 确保
LCD_INFO_MENU
已启用,这是显示打印机信息菜单的前提
- 在
-
菜单系统扩展:
- 在
menu_info.cpp
中添加新的子菜单处理函数menu_info_build()
- 该函数使用
STATIC_ITEM_F
宏显示编译日期和时间 - 在"关于打印机"主菜单中添加新的子菜单项
- 在
-
代码结构优化:
- 将新功能封装在条件编译指令中,确保不需要时可以完全从代码中移除
- 保持与现有菜单系统的一致性
技术细节分析
预定义宏的使用
Marlin利用了C/C++标准的预定义宏:
__DATE__
:以"Mmm dd yyyy"格式表示编译日期__TIME__
:以"hh:mm:ss"格式表示编译时间
这些宏在编译时由编译器自动填充,准确记录了固件的生成时间。
菜单系统集成
Marlin的LCD菜单系统采用分层结构:
- 主菜单调用
menu_info()
函数 - 通过
SUBMENU
宏添加"Build Date"子菜单项 - 子菜单使用
START_SCREEN
和END_SCREEN
宏定义显示区域 - 静态文本项显示编译时间信息
用户界面考虑
设计时特别注意了:
- 不将时间戳放在主信息页面,避免与固件发布日期混淆
- 采用单独的子菜单,保持界面整洁
- 确保功能可配置,不影响资源受限的设备
实际应用价值
这一功能的加入为开发者带来了显著便利:
- 快速识别当前运行的固件版本
- 方便调试时确认是否加载了最新编译的固件
- 在多设备环境下准确区分不同设备运行的固件版本
- 无需连接电脑即可获取固件基本信息
兼容性说明
需要注意的是:
- 此功能仅适用于Marlin原生的LCD菜单系统
- 对于BTT等第三方触摸屏,需要相应修改触摸屏固件才能支持
- 功能默认不启用,需要手动配置
总结
Marlin固件通过简单的代码扩展实现了编译时间戳的显示功能,体现了其模块化设计的优势。这一改进虽然代码量不大,但为开发者日常调试提供了实用工具,展示了开源社区通过小改进解决实际问题的典型模式。对于频繁进行固件开发的用户来说,这一功能可以显著提高工作效率。
登录后查看全文
热门项目推荐
相关项目推荐
GLM-4.6
GLM-4.6在GLM-4.5基础上全面升级:200K超长上下文窗口支持复杂任务,代码性能大幅提升,前端页面生成更优。推理能力增强且支持工具调用,智能体表现更出色,写作风格更贴合人类偏好。八项公开基准测试显示其全面超越GLM-4.5,比肩DeepSeek-V3.1-Terminus等国内外领先模型。【此简介由AI生成】Jinja00- DDeepSeek-V3.2-ExpDeepSeek-V3.2-Exp是DeepSeek推出的实验性模型,基于V3.1-Terminus架构,创新引入DeepSeek Sparse Attention稀疏注意力机制,在保持模型输出质量的同时,大幅提升长文本场景下的训练与推理效率。该模型在MMLU-Pro、GPQA-Diamond等多领域公开基准测试中表现与V3.1-Terminus相当,支持HuggingFace、SGLang、vLLM等多种本地运行方式,开源内核设计便于研究,采用MIT许可证。【此简介由AI生成】Python00
openPangu-Ultra-MoE-718B-V1.1
昇腾原生的开源盘古 Ultra-MoE-718B-V1.1 语言模型Python00ops-transformer
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。C++0118AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02Spark-Chemistry-X1-13B
科大讯飞星火化学-X1-13B (iFLYTEK Spark Chemistry-X1-13B) 是一款专为化学领域优化的大语言模型。它由星火-X1 (Spark-X1) 基础模型微调而来,在化学知识问答、分子性质预测、化学名称转换和科学推理方面展现出强大的能力,同时保持了强大的通用语言理解与生成能力。Python00GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile011
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
项目优选
收起

deepin linux kernel
C
23
6

OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
225
2.27 K

React Native鸿蒙化仓库
JavaScript
211
287

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
9
1

暂无简介
Dart
526
116

🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
987
583

openGauss kernel ~ openGauss is an open source relational database management system
C++
148
197

GLM-4.6在GLM-4.5基础上全面升级:200K超长上下文窗口支持复杂任务,代码性能大幅提升,前端页面生成更优。推理能力增强且支持工具调用,智能体表现更出色,写作风格更贴合人类偏好。八项公开基准测试显示其全面超越GLM-4.5,比肩DeepSeek-V3.1-Terminus等国内外领先模型。【此简介由AI生成】
Jinja
45
0

ArkUI-X adaptation to Android | ArkUI-X支持Android平台的适配层
C++
39
55

ArkUI-X adaptation to iOS | ArkUI-X支持iOS平台的适配层
Objective-C++
19
44