IronOS 焊台固件设置菜单深度解析：完整参数指南与固件设置系统实现

嵌入式固件硬件开发智能硬件【免费下载链接】IronOSOpen Source Soldering Iron firmware项目地址https://gitcode.com/gh_mirrors/ir/IronOS点击查看免费下载本文基于 IronOS 仓库中自动生成的设置菜单文档 Documentation/Settings.md逐一讲解焊台设置菜单中五大分类下全部设置项的含义、在机帮助文本与取值范围并结合 source/Settings/settings.yaml、source/Core/Inc/Settings.h 等源码剖析这些设置项在固件中如何被定义、存储到 Flash、以及通过仓库自带工具离线读写。读完本文后你可以理解每个设置项背后的默认值与硬件约束并能用仓库工具为 TS100/Pinecil/Pinecil V2/MHP30 等设备批量生成设置文件。一、文档来源自动生成的设置菜单参考Documentation/Settings.md 文件头部注明!-- This is an automatically generated file. DO NOT EDIT. Edit gen_menu_docs.py instead --也就是说这份“设置菜单字典”并非手写维护而是由 Translations/gen_menu_docs.py 从两个数据源自动拼装生成Translations/translations_definitions.json定义每个菜单组menuGroups、每个菜单项menuOptions的英文描述以及该菜单项在哪些硬件条件下可见如include: [POW_PD]、exclude: [NO_SLEEP_MODE]Translations/translation_EN.json提供菜单项显示名称与“在机帮助文本”description。生成脚本main()按“头部 → 菜单分类 → 菜单项”三段式写入文件因此文档中的“On device help text”与设备上实际滚动显示的提示文本完全同源。这带来一个实用结论当固件新增或修改设置项时文档会随之自动更新文档与设备行为天然保持一致。文档同时给出两条通用使用说明适用于所有设置项并非所有设置对每个设备都可见。例如 TS100 没有 USB-PD 设置。从定义文件可见可见性由编译期硬件特性控制POW_DCDC 供电、POW_QCQC3.0、POW_PDUSB-PD、HALL_SENSOR霍尔传感器、BLE_ENABLED、PROFILE_SUPPORT多阶段预热 Profile 模式、NO_SLEEP_MODE、NO_DISPLAY_ROTATE等特性开关决定某个设置项是否出现在对应设备的菜单里。在机上求助停留在某个设置项上不做任何操作延迟片刻后屏幕上会滚动显示该设置项的帮助文本即文档中所称的 “on device help text”。二、菜单分类Menu Categories设置菜单被划分为五个大类以保持列表可管理分类定义来自translations_definitions.json的menuGroups分类英文 ID说明Power settings电源设置PowerMenu与输入电压相关的主要设置仅在具备对应供电特性的设备上出现Soldering settings焊接设置SolderingMenu焊接模式相关Boost 温度、按钮调整步长、按键锁定等Sleep mode睡眠/省电PowerSavingMenu睡眠模式、睡眠温度与关机超时等省电设置User interface用户界面UIMenu单位制、显示方向、动画、亮度等界面相关设置Advanced settings高级设置AdvancedMenu其余设置的收纳项通常是使用前需要思考一下的选项校准、功率限制、蓝牙等三、全部设置项详解按分类继承文档并补充取值以下逐条继承 Documentation/Settings.md 的设置说明并在“取值/默认值”一列结合 source/Settings/settings.yaml设置项定义的唯一可读来源补充范围与默认值。3.1 电源类Power settingsPower sourceDC 低电压截止设备由电池/DC 供电时调整单元关闭加热以保护电池的低压阈值。 在机帮助文本Set cutoff voltage to prevent battery overdischarge (DC10V) (S3.3V per cell, disable PWR limit)对应设置MinDCVoltageCells取值 0–4默认CUT_OUT_SETTING即默认“禁用限制”语义的截止档位。Minimum voltage单格最低电压电池供电时关机前允许的每格最低电压实际值 该值 × 电池串数。 在机帮助文本Minimum allowed voltage per battery cell (3S: 3 - 3.7V | 4-6S: 2.4 - 3.7V)对应MinVoltageCells取值 24–38默认RECOM_VOL_CELL单位 0.1V/格。QC voltageQC3.0 目标电压调整 QC 协商允许达到的最大电压不影响 USB-PD。应根据电源适配器的电流额定值安全设置。 在机帮助文本Max QC voltage the iron should negotiate for对应QCIdealVoltage默认 90即 9.0V范围 90–QC_VOLTAGE_MAX步长 2单位 0.1V。PD timeoutUSB-PD 协商超时固件停止尝试 USB-PD 协商、转而去尝试 QC 前的等待时长单位为 100ms。更长的超时可能兼容老旧/劣质 PD 适配器更短则更快回退到 QC。文档建议保持较小值。 在机帮助文本PD negotiation timeout in 100ms steps for compatibility with some QC chargers对应PDNegTimeout默认 202 秒范围 0–50。PD ModeUSB-PD 工作模式调整 USB-PD 逻辑选择电压的方式No Dynamic 禁用 EPR 与 PPS 协议Safe 模式不使用压降补偿电阻会选出略低的电压。 在机帮助文本No Dynamic disables EPR PPS, Safe mode does not use padding resistance对应USBPDMode0–2默认 0。source/Core/Inc/Settings.h 中枚举usbpdMode_t明确了语义NO_DYNAMIC0仅固定 PDO禁 PPS/EPR、DEFAULT1PPSEPR并通过约 0.5Ω 的压降补偿请求更高电压以补偿线缆/PCB 损耗、SAFE2PPSEPR不做补偿请求。3.2 焊接类Soldering settingsBoost tempBoost 温度焊接模式下长按设备前端按钮可临时把温度覆盖到该值。注意它是设定温度而非在现值上叠加。 在机帮助文本Tip temperature used in boost mode对应BoostTemp默认BOOST_TEMP步长 10上限MAX_TEMP_F。Start-up behaviour开机行为决定通电后进入哪种模式直接进入焊接模式、睡眠模式或自动模式首次检测到移动才进入焊接。 在机帮助文本Sheat to soldering temp | Zstandby at sleep temp until moved | Rstandby without heating until moved对应AutoStartMode0–3默认AUTO_START_MODE。source/Core/Inc/Settings.h 中autoStartMode_t给出四种取值OFF禁用、SOLDER加热到焊接温度、SLEEP以睡眠温度待机移动后激活、ZERO只上电不加热移动后激活。Temp change short短按温变步长快速按一下按钮时温度改变的步长。 在机帮助文本Temperature-change-increment on short button press对应TempChangeShortStep1–TEMP_CHANGE_SHORT_STEP_MAX步长 1。Temp change long长按温变步长按住按钮不放时温度改变的步长。 在机帮助文本Temperature-change-increment on long button press对应TempChangeLongStep5–TEMP_CHANGE_LONG_STEP_MAX步长 5。Allow locking buttons允许锁定按键是否启用按键防误触锁定。 在机帮助文本While soldering, hold down both buttons to toggle locking them (Bboost mode only | Ffull locking)对应LockingMode0–2默认 0。lockingMode_t枚举DISABLED0不锁定、BOOST1仅锁定 Boost 键、FULL2Boost 与焊接模式全锁定。Profile 系列设置多阶段预热模式仅PROFILE_SUPPORT设备Profile 模式让焊台按“预热 → 阶段 1…5 → 冷却”的曲线运行温度适合需要分阶段升温的场景如 BGA/大面积敷铜的预热流程。设置项在机帮助文本对应项默认值/范围Profile Phases阶段数Number of phases in profile modeProfilePhases默认 4范围 1–5Preheat Temp预热温度Preheat to this temperature at the start of profile modeProfilePreheatTemp默认 90步长 5Preheat Speed预热速率Preheat at this rate (degrees per second)ProfilePreheatSpeed1–10 °C/s默认 1Phase 1 Temp / DurationTarget temperature for the end of this phase/Target duration of this phase (seconds)ProfilePhase1Temp/ProfilePhase1Duration默认 130 / 90s10–180sPhase 2 Temp / Duration同上原文档此两项帮助文本留空ProfilePhase2Temp/ProfilePhase2Duration默认 140 / 30sPhase 3 Temp / Duration同上ProfilePhase3Temp/ProfilePhase3Duration默认 165 / 30sPhase 4 Temp / Duration同上ProfilePhase4Temp/ProfilePhase4Duration默认 140 / 30sPhase 5 Temp / Duration同上ProfilePhase5Temp/ProfilePhase5Duration默认 90 / 30sCooldown Speed冷却速率Cooldown at this rate at the end of profile mode (degrees per second)ProfileCooldownSpeed1–10 °C/s默认 2文档对各阶段温度的解释是“该阶段结束时的目标温度”、时长为“目标时长秒”。文档特别强调实际阶段耗时会比设定值更长——若达到目标温度所需时间超过设定时长阶段会等待到温度到位为止。另外原文档中 “Phase 4” 两条的描述写作 “phase 5”属于生成源中的笔误source/Core/Inc/Settings.h 的注释Temperature to target for the end of phase 4/Target duration for phase 4可作准确参照。3.3 睡眠与省电Sleep modeMotion sensitivity运动灵敏度设备对运动的敏感程度数值越高越灵敏0 表示关闭运动检测。 在机帮助文本1least sensitive | ... | 9most sensitive对应Sensitivity0–9默认SENSITIVITY加速度计灵敏度。Sleep temp睡眠温度设备入睡后降温保持的温度通常取关机与焊接温度之间的中间值。 在机帮助文本Tip temperature while in sleep mode对应SleepTemp默认 150范围MIN_TEMP_C–MAX_TEMP_F步长 5。Sleep timeout睡眠超时多少时间没有运动/按键操作后降到睡眠温度。 在机帮助文本Interval before sleep mode starts (sseconds | mminutes)对应SleepTime0–15默认SLEEP_TIME。Shutdown timeout关机超时多少时间无运动/按键后彻底关闭烙铁头加热并回到主待机界面。 在机帮助文本Interval before the iron shuts down (mminutes)对应ShutdownTime0–60分钟默认SHUTDOWN_TIME。Hall sensor sensitivity霍尔传感器灵敏度仅 Pinecil 等带霍尔传感器的设备调整磁铁触发睡眠模式的灵敏度。 在机帮助文本Sensitivity to magnets (1least sensitive | ... | 9most sensitive)对应HallEffectSensitivity0–9默认 7。HallSensor SleepTime霍尔传感器睡眠超时霍尔信号超过阈值后多久才降到睡眠温度。 在机帮助文本Interval before sleep mode starts when hall effect is above threshold对应HallEffectSleepTime0–12默认 0。source/Core/Inc/Settings.h 注释将其单位标注为Seconds (/5)可按源码注释理解为以 1/5 秒为最小单位的计时。3.4 用户界面User interfaceTemperature unit温度单位°C 或 °F。在机帮助文本C°Celsius | F°Fahrenheit。对应TemperatureInF0/1上限与HasFahrenheit构建特性绑定。Display orientation显示方向屏幕是否随加速度计自动旋转或固定为左手/右手方向。在机帮助文本Rright-handed | Lleft-handed | Aautomatic。对应OrientationMode0–2orientationMode_t枚举为RIGHT0、LEFT1、AUTO2带NO_DISPLAY_ROTATE特性的设备不显示此项。Cooldown flashing冷却闪烁提示待机界面在烙铁头高于 50°C 时是否闪烁显示温度作为“烙铁头仍很烫”的提醒。在机帮助文本Flash temp reading at idle while tip is hot。对应CoolingTempBlink0/1。Scrolling speed帮助文本滚动速度菜单悬停说明文字滚动的速度。更快的速度可能导致画面撕裂但能更快读完整段描述。在机帮助文本Scrolling speed of info text (Sslow | Ffast)。对应DescriptionScrollSpeed0/1。Swap - keys交换 /− 键交换温度调整界面中“加”“减”的按钮分配。在机帮助文本Reverse assignment of buttons for temperature adjustment。对应ReverseButtonTempChangeEnabled0/1。Swap A B keys交换 A/B 键交换设置菜单中“确认/修改”与“滚动/返回”的按钮分配。在机帮助文本Reverse assignment of buttons for Settings menu。对应ReverseButtonSettings0/1。Anim. speed动画速度菜单图标动画的循环节奏或不循环。在机帮助文本Pace of icon animations in menu (Sslow | Mmedium | Ffast)。对应AnimationSpeed0–3settingOffSpeed_t枚举为OFF/SLOW/MEDIUM/FAST。Anim. loop动画循环菜单动画是否循环仅当动画速度不是 “Off” 时可见。在机帮助文本Loop icon animations in main menu。对应AnimationLoop0/1。Screen brightness屏幕亮度OLED 亮度。文档提示更高亮度会加速 OLED 烧屏老化不过这些屏幕大多先因其他原因失效。在机帮助文本Adjust the OLED screen brightness。对应OLEDBrightnessMIN_BRIGHTNESS–MAX_BRIGHTNESS默认DEFAULT_BRIGHTNESS。Invert screen反色显示翻转整个 OLED 颜色。在机帮助文本Invert the OLED screen colors。对应OLEDInversion0/1。Boot logo duration启动 Logo 时长启动 Logo 显示时长单位为秒。在机帮助文本Set boot logo duration (sseconds)。对应LOGOTime0–6source/Core/Inc/Settings.h 中logoMode_t表明取值有特殊语义0SKIP跳过 Logo、5ONETIME播放一次动画后停在末帧按键跳过、6INFINITY循环播放直到按键。Detailed idle screen详细待机界面待机界面是否用更小字号的文本显示更多细节代替图标。在机帮助文本Display detailed info in a smaller font on idle screen。对应DetailedIDLE0/1。Detailed solder screen详细焊接界面焊接界面是否使用纯文本的详细视图以牺牲图形效果换取更多信息。在机帮助文本Display detailed info in a smaller font on soldering screen。对应DetailedSoldering0/1。3.5 高级设置Advanced settingsBluetooth蓝牙/BLEBLE 模式——关闭、完整读写、只读R屏蔽所有经 BLE 的写入。在机帮助文本Enables BLE (full access | Rread-only)。对应BluetoothLE0–2默认 0仅在BLE_ENABLED设备上可见如 Pinecil V2。Power limit功率限制设定一个目标平均功率上限瓦让设备尽量维持在该值以下。文档强调无论如何设置设备都无法控制峰值功率MHP30 是个例外可以较好地收敛到该限制若正在使用 USB-PD实际限值会取“该设置”与“电源标称功率”的较小者。 在机帮助文本Average maximum power the iron can use (Wwatt)对应PowerLimit0–MAX_POWER_LIMIT步长POWER_LIMIT_STEPS。Calibrate CJC at next boot下次启动时校准冷端补偿这是高级设置中说明最详细的一项文档原文要点如下需严格遵守若目标温度与实测温度差小于 5°C则完全无需校准该复选框用于校准烙铁头 ADC 与运算放大器之间的偏移且只在下一次启动时执行理想情况是在开机时、内部元件升温之前完成。校准成功后复选框会自动取消若需重复校准必须再次勾选、拔掉电源、让设备冷却到室温后再上电理想状态是设备平放在桌面上校准还需同时满足两个条件才会执行烙铁头已安装且烙铁头与手柄温差小于 10°C约等于室温。条件不满足时校准会推迟到下一次同时满足两条件的开机除非复选框被取消因此切勿连续快速重复校准。在机帮助文本Calibrate Cold Junction Compensation at next boot (not required if Delta T is 5°C)对应CalibrateCJC0/1默认 0。Calibrate input voltage输入电压校准进入调整模式可逐步修正测得电压以补偿各设备之间分压电阻的个体差异。 在机帮助文本Start VIN calibration (long press to exit)对应VoltageDiv360–900默认VOLTAGE_DIV分压系数内部以 0.1% 精度表达。Power pulse保活脉冲功率开启并设定保活脉冲的功率。脉冲会让设备短暂开启加热丝拉取负载防止充电宝/移动电源进入睡眠。 在机帮助文本Intensity of power of keep-awake-pulse (Wwatt)对应KeepAwakePulse0–99单位 0.1W默认POWER_PULSE_DEFAULT。Power pulse delay保活脉冲间隔调整两次脉冲之间的时间间隔。间隔越长烙铁头意外升温越少但必须足够短才能维持充电宝唤醒状态。 在机帮助文本Delay before keep-awake-pulse is triggered (x 2.5s)对应KeepAwakePulseWait1–POWER_PULSE_WAIT_MAX每单位 2.5 秒默认POWER_PULSE_WAIT_DEFAULT。Power pulse duration保活脉冲时长每次脉冲持续多久。部分充电宝需要看到持续一段时间的取电才保持唤醒应尽量短以减少浪费与发热。 在机帮助文本Keep-awake-pulse duration (x 250ms)对应KeepAwakePulseDuration1–POWER_PULSE_DURATION_MAX每单位 250ms默认POWER_PULSE_DURATION_DEFAULT。Restore default settings恢复出厂设置把全部设置与校准恢复为工厂默认值不会擦除用户自定义的开机 Logo。 在机帮助文本Reset all settings to default它不是普通数值项而是触发resetSettings()的操作项。Language语言多语言固件上切换设备语言。对应UILanguage默认41431英文 EN 的代码范围 0–0xFFFFsource/Core/Inc/Settings.h 注释指出该字段在长度小于 8 字符时以空字符结尾存储语言代码。Soldering Tip Type烙铁头类型手动选择所装烙铁头的类型。 在机帮助文本Select the tip type fitted对应SolderingTipType0–TIP_TYPE_MAX-1。source/Core/Inc/Settings.h 中tipType_t定义了可选类型带TIP_TYPE_SUPPORT特性时T12_8_OHMTS100 型或 Hakko T12 头加适配器、T12_6_2_OHMPine64 短头、T12_4_OHMPTS200 用低阻长头以及硬件支持自动识别时的TIP_TYPE_AUTO。选择类型后getUserSelectedTipResistance()返回匹配的烙铁头电阻供热模型计算使用。另外source/Core/Inc/Settings.h 中还有两个不出现在菜单里的内部计数项AccelMissingWarningCounter、PDMissingWarningCounter分别记录“加速度计未检出”“PD 接口未检出”警告的已提示次数用于避免重复轰炸式警告。四、设置系统固件实现定义、存储与访问4.1 统一枚举与常量表固件把所有设置项收敛到 source/Core/Inc/Settings.h 的enum SettingsOptions共 56 项SettingsOptionsLength 56。每项在 source/Settings/settings.yaml 中都有对应条目声明其min、max、increment、default——这些正是菜单调节时上下限与步进的依据也即上文各设置项取值表的来源。每个设置项运行时需要一组常量typedef struct { const uint16_t min; // Inclusive minimum value const uint16_t max; // Inclusive maximum value const uint16_t increment; // Standard increment const uint16_t defaultValue; // Default vaue after reset } SettingConstants; extern const SettingConstants settingsConstants[(int)SettingsOptions::SettingsOptionsLength];而settingsConstants数组正是构建时由 source/Settings/generate_settings.py 基于settings.yaml按模板 source/Settings/settings_gen.cpp.template 生成的 C 代码构建链路保证“YAML 定义”与“固件常量表”永不漂移。4.2 Flash 存储结构设置持久化结构systemSettingsType同样定义在 source/Core/Inc/Settings.htypedef struct { uint16_t versionMarker; // 固件识别的版本标记 uint16_t length; // 后续有效字节数 uint16_t settingsValues[SettingsOptionsLength]; // 56 个 uint16_t 值 uint32_t padding; // 对齐到 32 字节简化驱动代码 } systemSettingsType;两个设计细节值得注意注释明确该结构必须按 2 字节的整数倍组织因为它是以 uint16_t 为单位读写 Flash的versionMarker使用固定的版本宏SETTINGSVERSION (0x55AA)Pinecil V2 因某次设置重置 PR 使用0x55AB且注释要求该数字冻结、不得修改。当固件版本不匹配时加载侧会检测到不一致并按需重置受影响的设置配合 Translations/translations_definitions.json 中SettingsResetMessage的“因固件不兼容而重置部分设置”提示。读写入口函数为saveSettings()、loadSettings()、resetSettings()单值访问则通过getSettingValue()/setSettingValue()/nextSettingValue()/prevSettingValue()nextSettingValue返回“是否已到最大值下次将回绕”等 API 完成菜单线程如 source/Core/Threads/UI/logic/SettingsMenu.cpp与 PID/供电等线程都通过这套统一接口取值。4.3 各型号的 Flash 地址设置块写入 Flash 的基址随设备不同。从 source/Settings/lib/settings_util.py 的get_base_address()可以看到完整映射设备设置区基址TS100 / TS80 / TS80P / S60 / S60P0x08000000 63KBTS101 / Pinecil / MHP300x08000000 127KBPinecilv20x23000000 1023KBQSPI Flash 地址空间这也解释了为何离线编辑工具必须知道目标型号——不同设备的设置块物理位置不同。五、离线读取与批量写入仓库自带设置工具source/Settings/README.md 说明了工具链能力与限制读取仅支持能经 USB 回读设备内存的设备若设备在编程模式下表现为 USB 存储设备则此方式不可用写入使用edit_settings.py生成可直接写入设备的.bin或.hex文件若设备支持读出当前内存可先导入现有设置文件再修改。工具结构source/Settings 目录source/Settings/settings.yaml设置项的“单一事实来源”人类可读source/Settings/generate_settings.py构建期 C 代码生成生成settingsConstants等source/Settings/edit_settings.py交互式编辑二进制设置文件按型号定位基址、解析表达式如VOLTAGE_DIV这类符号默认值后生成写入文件source/Settings/lib/ 下的settings_types.py、settings_util.py、settings_model.py、settings_parser.py、settings_cli.py分别承担类型常量、基址/表达式解析、数据模型、YAML 解析与 CLI 入口配套测试见 source/Settings/test_config_parser.py 等测试文件。典型工作流是从支持回读的设备导出当前设置文件 → 用edit_settings.py批量修改若干字段如把KeepAwakePulse统一设为 10、ShutdownTime设为 30→ 生成.hex/.bin→ 按 Documentation/Flashing/ 中对应型号的刷写指南写入。六、小结Documentation/Settings.md 以自动生成的方式保证了“文档—设备—源码”三者一致五个菜单分类覆盖了 TS100 到 Pinecil V2、MHP30 等设备的全部可调项每项的取值范围与默认值可在 source/Settings/settings.yaml 中查到固件侧由 source/Core/Inc/Settings.h 的枚举、常量表与 Flash 结构完成定义与持久化source/Settings 工具链则让设置支持离线读取、批量修改与回写。理解这套机制后无论是为团队统一刷写配置还是排查“某设置项在我的设备上不可见”看include/exclude特性开关这类问题都能直接定位到相应文件。赞分享嵌入式固件硬件开发智能硬件【免费下载链接】IronOSOpen Source Soldering Iron firmware项目地址https://gitcode.com/gh_mirrors/ir/IronOS点击查看免费下载相关推荐IronOS固件刷写指南MHP30焊台升级详解IronOS固件刷写指南MHP30焊台升级详解 前言 IronOS是一款开源的焊台固件项目为多款便携式焊台提供增强功能和优化体验。本文将详细介绍如何为MHP嵌入式固件硬件开发智能硬件IronOS项目TS80/TS80P焊台固件刷写指南IronOS项目TS80/TS80P焊台固件刷写指南 固件版本选择 在IronOS项目中开发者提供了三种类型的固件供用户选择 1. 稳定版Main rel嵌入式固件硬件开发智能硬件终极USB-PD通信指南IronOS开源焊台固件协议栈深度解析终极USB PD通信指南IronOS开源焊台固件协议栈深度解析 想要了解如何让焊台通过USB PD协议实现智能供电IronOS开源焊台固件为你揭开USB P嵌入式固件硬件开发智能硬件上一篇3步解锁BIM参数化设计Rhino.Inside.Revit让创意与工程完美融合下一篇Umi-OCR3步让你告别繁琐的文字录入工作创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考