JL打包工具 V1.0.0 使用说明JL打包工具是一款用于杰理固件交付文件整理的桌面工具。它可以根据客户代码、项目名称、芯片型号、软件版本、蓝牙名称、校验码等信息自动生成规范文件名并支持输出 FW、UFW、ZIP 升级包和 LOG 日志。适用场景固件版本交付前的统一命名自动生成update.ufw升级包生成带校验码、版本号、项目名的交付文件输出累计或单次 LOG 记录按 KEY 文件生成授权后的固件文件1. 软件启动双击运行JL打包工具_V1.0.0.exe。图1说明主界面左侧用于填写打包字段、选择输出目录、设置固件授权模式和输出选项右侧用于填写打包日志。顶部包含路径层级、文件名顺序、主题和著作信息。2. 填写打包信息常用字段包括自定义备注客户代码项目名称芯片型号ROM容量硬件版本软件版本蓝牙名称校验码生成日期字段左侧的勾选框决定该字段是否参与最终文件名。未勾选的字段不会出现在输出文件名中。图2说明根据项目实际情况填写字段。软件会尽量自动识别部分信息例如蓝牙名称、芯片型号、校验码和日期用户手动修改后的内容优先生效。如果手动填写后又调整路径层级则以最新路径层级识别结果为准。3. 选择输出目录在输出路径下方点击选择输出目录选择本次打包文件保存的位置。软件会在输出目录下自动创建日期编号文件夹例如20260724-001 20260724-002每次打包会自动递增编号方便区分不同批次。图3说明建议为每个客户或项目单独建立输出目录后续查找历史版本会更清晰。4. 选择固件授权模式固件授权模式有三种无授权直接复制原始固件输出无限制授权生成无限制授权后的固件文件机器码授权根据机器码和授权数量生成授权后的固件文件选择无授权时KEY 文件、机器码和数量输入项会自动收起。选择无限制授权时需要选择 KEY 文件。选择机器码授权时需要选择 KEY 文件并填写机器码和授权数量。图4说明如果选择了固件授权模式工具会同时输出授权前文件和授权后文件。授权后文件名会自动带有授权标识授权文件本身不会额外生成压缩包。授权文件名示例JL0001_[已授权_无限制].fw JL0001_[已授权7-机器码CRC[D471]].fw5. 选择输出内容输出选项包括输出 FW输出 UFW生成 ZIP(update.ufw)生成 LOG.txtLOG方式累加 / 不累加打包后打开目录图5说明如果没有勾选生成 LOG.txtZIP 内不会包含 LOG 文件如果勾选了生成 LOG.txtZIP 内会同时打包LOG.txt。固件授权输出不会影响原有 FW、UFW、ZIP 和 LOG 的生成规则。6. 填写打包日志右侧打包日志区域用于记录本次修改内容和备注。默认格式如下/***************20260724-001***************/ [V]0.0.1 校验码: [ 6DA1-F7A9FA50 ] 蓝牙名: [ BT_NAME ] 日期 : [ 20260724 ] 型号 : [ AC6323A4 ] 项目 : [ Mayn-JL0001 ] 修改内容: 1. 2. 3. 备注: [NULL]-FIXLOG方式支持两种模式累加新记录在上历史记录在下不累加只输出本次日志图6说明累加模式适合长期维护同一个项目可以在一个 LOG 文件中保留多个版本的修改记录。7. 开始打包确认字段、输出目录、固件授权模式、输出选项和日志内容无误后点击底部开始打包。打包完成后输出目录中会生成对应文件。常见输出示例图7说明ZIP 内部的升级文件名保持为update.ufw。8. 文件名顺序调整顶部点击文件名顺序旁边的显示可以展开字段排序列表。拖动字段即可调整最终文件名中各字段的顺序。图8说明如果客户有固定命名规范可以通过拖动排序快速适配。9. 路径层级设置顶部点击路径与层级旁边的显示可以设置从路径中自动识别客户代码和项目名称的层级。图9说明如果项目目录结构固定可以通过路径层级减少手动填写工作。10. 主题工具支持主题切换11. 常见问题11.1 提示 KEY 文件不匹配说明当前选择的 KEY 文件与固件不匹配。请重新选择正确的 KEY 文件。11.2 ZIP 里没有 LOG.txt只有勾选生成 LOG.txt时ZIP 内才会包含LOG.txt。11.3 授权后为什么还有原始文件选择固件授权模式后工具会同时输出授权前的原始文件和授权后的新文件。这样既方便内部存档也便于交付时进行核对。11.4 LOG 累加顺序是什么累加模式下新版本记录在最上方旧版本记录在下方。