JL打包工具 V1.0.0 使用說明JL打包工具是一款用于杰理固件交付文件整理的桌面工具。它可以根據(jù)客戶代碼、項(xiàng)目名稱、芯片型號(hào)、軟件版本、藍(lán)牙名稱、校驗(yàn)碼等信息自動(dòng)生成規(guī)范文件名并支持輸出 FW、UFW、ZIP 升級(jí)包和 LOG 日志。適用場景固件版本交付前的統(tǒng)一命名自動(dòng)生成update.ufw升級(jí)包生成帶校驗(yàn)碼、版本號(hào)、項(xiàng)目名的交付文件輸出累計(jì)或單次 LOG 記錄按 KEY 文件生成授權(quán)后的固件文件1. 軟件啟動(dòng)雙擊運(yùn)行JL打包工具_(dá)V1.0.0.exe。圖1說明主界面左側(cè)用于填寫打包字段、選擇輸出目錄、設(shè)置固件授權(quán)模式和輸出選項(xiàng)右側(cè)用于填寫打包日志。頂部包含路徑層級(jí)、文件名順序、主題和著作信息。2. 填寫打包信息常用字段包括自定義備注客戶代碼項(xiàng)目名稱芯片型號(hào)ROM容量硬件版本軟件版本藍(lán)牙名稱校驗(yàn)碼生成日期字段左側(cè)的勾選框決定該字段是否參與最終文件名。未勾選的字段不會(huì)出現(xiàn)在輸出文件名中。圖2說明根據(jù)項(xiàng)目實(shí)際情況填寫字段。軟件會(huì)盡量自動(dòng)識(shí)別部分信息例如藍(lán)牙名稱、芯片型號(hào)、校驗(yàn)碼和日期用戶手動(dòng)修改后的內(nèi)容優(yōu)先生效。如果手動(dòng)填寫后又調(diào)整路徑層級(jí)則以最新路徑層級(jí)識(shí)別結(jié)果為準(zhǔn)。3. 選擇輸出目錄在輸出路徑下方點(diǎn)擊選擇輸出目錄選擇本次打包文件保存的位置。軟件會(huì)在輸出目錄下自動(dòng)創(chuàng)建日期編號(hào)文件夾例如20260724-001 20260724-002每次打包會(huì)自動(dòng)遞增編號(hào)方便區(qū)分不同批次。圖3說明建議為每個(gè)客戶或項(xiàng)目單獨(dú)建立輸出目錄后續(xù)查找歷史版本會(huì)更清晰。4. 選擇固件授權(quán)模式固件授權(quán)模式有三種無授權(quán)直接復(fù)制原始固件輸出無限制授權(quán)生成無限制授權(quán)后的固件文件機(jī)器碼授權(quán)根據(jù)機(jī)器碼和授權(quán)數(shù)量生成授權(quán)后的固件文件選擇無授權(quán)時(shí)KEY 文件、機(jī)器碼和數(shù)量輸入項(xiàng)會(huì)自動(dòng)收起。選擇無限制授權(quán)時(shí)需要選擇 KEY 文件。選擇機(jī)器碼授權(quán)時(shí)需要選擇 KEY 文件并填寫機(jī)器碼和授權(quán)數(shù)量。圖4說明如果選擇了固件授權(quán)模式工具會(huì)同時(shí)輸出授權(quán)前文件和授權(quán)后文件。授權(quán)后文件名會(huì)自動(dòng)帶有授權(quán)標(biāo)識(shí)授權(quán)文件本身不會(huì)額外生成壓縮包。授權(quán)文件名示例JL0001_[已授權(quán)_無限制].fw JL0001_[已授權(quán)7-機(jī)器碼CRC[D471]].fw5. 選擇輸出內(nèi)容輸出選項(xiàng)包括輸出 FW輸出 UFW生成 ZIP(update.ufw)生成 LOG.txtLOG方式累加 / 不累加打包后打開目錄圖5說明如果沒有勾選生成 LOG.txtZIP 內(nèi)不會(huì)包含 LOG 文件如果勾選了生成 LOG.txtZIP 內(nèi)會(huì)同時(shí)打包LOG.txt。固件授權(quán)輸出不會(huì)影響原有 FW、UFW、ZIP 和 LOG 的生成規(guī)則。6. 填寫打包日志右側(cè)打包日志區(qū)域用于記錄本次修改內(nèi)容和備注。默認(rèn)格式如下/***************20260724-001***************/ [V]0.0.1 校驗(yàn)碼: [ 6DA1-F7A9FA50 ] 藍(lán)牙名: [ BT_NAME ] 日期 : [ 20260724 ] 型號(hào) : [ AC6323A4 ] 項(xiàng)目 : [ Mayn-JL0001 ] 修改內(nèi)容: 1. 2. 3. 備注: [NULL]-FIXLOG方式支持兩種模式累加新記錄在上歷史記錄在下不累加只輸出本次日志圖6說明累加模式適合長期維護(hù)同一個(gè)項(xiàng)目可以在一個(gè) LOG 文件中保留多個(gè)版本的修改記錄。7. 開始打包確認(rèn)字段、輸出目錄、固件授權(quán)模式、輸出選項(xiàng)和日志內(nèi)容無誤后點(diǎn)擊底部開始打包。打包完成后輸出目錄中會(huì)生成對應(yīng)文件。常見輸出示例圖7說明ZIP 內(nèi)部的升級(jí)文件名保持為update.ufw。8. 文件名順序調(diào)整頂部點(diǎn)擊文件名順序旁邊的顯示可以展開字段排序列表。拖動(dòng)字段即可調(diào)整最終文件名中各字段的順序。圖8說明如果客戶有固定命名規(guī)范可以通過拖動(dòng)排序快速適配。9. 路徑層級(jí)設(shè)置頂部點(diǎn)擊路徑與層級(jí)旁邊的顯示可以設(shè)置從路徑中自動(dòng)識(shí)別客戶代碼和項(xiàng)目名稱的層級(jí)。圖9說明如果項(xiàng)目目錄結(jié)構(gòu)固定可以通過路徑層級(jí)減少手動(dòng)填寫工作。10. 主題工具支持主題切換11. 常見問題11.1 提示 KEY 文件不匹配說明當(dāng)前選擇的 KEY 文件與固件不匹配。請重新選擇正確的 KEY 文件。11.2 ZIP 里沒有 LOG.txt只有勾選生成 LOG.txt時(shí)ZIP 內(nèi)才會(huì)包含LOG.txt。11.3 授權(quán)后為什么還有原始文件選擇固件授權(quán)模式后工具會(huì)同時(shí)輸出授權(quán)前的原始文件和授權(quán)后的新文件。這樣既方便內(nèi)部存檔也便于交付時(shí)進(jìn)行核對。11.4 LOG 累加順序是什么累加模式下新版本記錄在最上方舊版本記錄在下方。 杰理打包工具
JL打包工具 V1.0.0 使用說明JL打包工具是一款用于杰理固件交付文件整理的桌面工具。它可以根據(jù)客戶代碼、項(xiàng)目名稱、芯片型號(hào)、軟件版本、藍(lán)牙名稱、校驗(yàn)碼等信息自動(dòng)生成規(guī)范文件名并支持輸出 FW、UFW、ZIP 升級(jí)包和 LOG 日志。適用場景固件版本交付前的統(tǒng)一命名自動(dòng)生成update.ufw升級(jí)包生成帶校驗(yàn)碼、版本號(hào)、項(xiàng)目名的交付文件輸出累計(jì)或單次 LOG 記錄按 KEY 文件生成授權(quán)后的固件文件1. 軟件啟動(dòng)雙擊運(yùn)行JL打包工具_(dá)V1.0.0.exe。圖1說明主界面左側(cè)用于填寫打包字段、選擇輸出目錄、設(shè)置固件授權(quán)模式和輸出選項(xiàng)右側(cè)用于填寫打包日志。頂部包含路徑層級(jí)、文件名順序、主題和著作信息。2. 填寫打包信息常用字段包括自定義備注客戶代碼項(xiàng)目名稱芯片型號(hào)ROM容量硬件版本軟件版本藍(lán)牙名稱校驗(yàn)碼生成日期字段左側(cè)的勾選框決定該字段是否參與最終文件名。未勾選的字段不會(huì)出現(xiàn)在輸出文件名中。圖2說明根據(jù)項(xiàng)目實(shí)際情況填寫字段。軟件會(huì)盡量自動(dòng)識(shí)別部分信息例如藍(lán)牙名稱、芯片型號(hào)、校驗(yàn)碼和日期用戶手動(dòng)修改后的內(nèi)容優(yōu)先生效。如果手動(dòng)填寫后又調(diào)整路徑層級(jí)則以最新路徑層級(jí)識(shí)別結(jié)果為準(zhǔn)。3. 選擇輸出目錄在輸出路徑下方點(diǎn)擊選擇輸出目錄選擇本次打包文件保存的位置。軟件會(huì)在輸出目錄下自動(dòng)創(chuàng)建日期編號(hào)文件夾例如20260724-001 20260724-002每次打包會(huì)自動(dòng)遞增編號(hào)方便區(qū)分不同批次。圖3說明建議為每個(gè)客戶或項(xiàng)目單獨(dú)建立輸出目錄后續(xù)查找歷史版本會(huì)更清晰。4. 選擇固件授權(quán)模式固件授權(quán)模式有三種無授權(quán)直接復(fù)制原始固件輸出無限制授權(quán)生成無限制授權(quán)后的固件文件機(jī)器碼授權(quán)根據(jù)機(jī)器碼和授權(quán)數(shù)量生成授權(quán)后的固件文件選擇無授權(quán)時(shí)KEY 文件、機(jī)器碼和數(shù)量輸入項(xiàng)會(huì)自動(dòng)收起。選擇無限制授權(quán)時(shí)需要選擇 KEY 文件。選擇機(jī)器碼授權(quán)時(shí)需要選擇 KEY 文件并填寫機(jī)器碼和授權(quán)數(shù)量。圖4說明如果選擇了固件授權(quán)模式工具會(huì)同時(shí)輸出授權(quán)前文件和授權(quán)后文件。授權(quán)后文件名會(huì)自動(dòng)帶有授權(quán)標(biāo)識(shí)授權(quán)文件本身不會(huì)額外生成壓縮包。授權(quán)文件名示例JL0001_[已授權(quán)_無限制].fw JL0001_[已授權(quán)7-機(jī)器碼CRC[D471]].fw5. 選擇輸出內(nèi)容輸出選項(xiàng)包括輸出 FW輸出 UFW生成 ZIP(update.ufw)生成 LOG.txtLOG方式累加 / 不累加打包后打開目錄圖5說明如果沒有勾選生成 LOG.txtZIP 內(nèi)不會(huì)包含 LOG 文件如果勾選了生成 LOG.txtZIP 內(nèi)會(huì)同時(shí)打包LOG.txt。固件授權(quán)輸出不會(huì)影響原有 FW、UFW、ZIP 和 LOG 的生成規(guī)則。6. 填寫打包日志右側(cè)打包日志區(qū)域用于記錄本次修改內(nèi)容和備注。默認(rèn)格式如下/***************20260724-001***************/ [V]0.0.1 校驗(yàn)碼: [ 6DA1-F7A9FA50 ] 藍(lán)牙名: [ BT_NAME ] 日期 : [ 20260724 ] 型號(hào) : [ AC6323A4 ] 項(xiàng)目 : [ Mayn-JL0001 ] 修改內(nèi)容: 1. 2. 3. 備注: [NULL]-FIXLOG方式支持兩種模式累加新記錄在上歷史記錄在下不累加只輸出本次日志圖6說明累加模式適合長期維護(hù)同一個(gè)項(xiàng)目可以在一個(gè) LOG 文件中保留多個(gè)版本的修改記錄。7. 開始打包確認(rèn)字段、輸出目錄、固件授權(quán)模式、輸出選項(xiàng)和日志內(nèi)容無誤后點(diǎn)擊底部開始打包。打包完成后輸出目錄中會(huì)生成對應(yīng)文件。常見輸出示例圖7說明ZIP 內(nèi)部的升級(jí)文件名保持為update.ufw。8. 文件名順序調(diào)整頂部點(diǎn)擊文件名順序旁邊的顯示可以展開字段排序列表。拖動(dòng)字段即可調(diào)整最終文件名中各字段的順序。圖8說明如果客戶有固定命名規(guī)范可以通過拖動(dòng)排序快速適配。9. 路徑層級(jí)設(shè)置頂部點(diǎn)擊路徑與層級(jí)旁邊的顯示可以設(shè)置從路徑中自動(dòng)識(shí)別客戶代碼和項(xiàng)目名稱的層級(jí)。圖9說明如果項(xiàng)目目錄結(jié)構(gòu)固定可以通過路徑層級(jí)減少手動(dòng)填寫工作。10. 主題工具支持主題切換11. 常見問題11.1 提示 KEY 文件不匹配說明當(dāng)前選擇的 KEY 文件與固件不匹配。請重新選擇正確的 KEY 文件。11.2 ZIP 里沒有 LOG.txt只有勾選生成 LOG.txt時(shí)ZIP 內(nèi)才會(huì)包含LOG.txt。11.3 授權(quán)后為什么還有原始文件選擇固件授權(quán)模式后工具會(huì)同時(shí)輸出授權(quán)前的原始文件和授權(quán)后的新文件。這樣既方便內(nèi)部存檔也便于交付時(shí)進(jìn)行核對。11.4 LOG 累加順序是什么累加模式下新版本記錄在最上方舊版本記錄在下方。