升級專案
TouchGFX Generator的相關參數儲存在STM32CubeMX專案的.ioc檔案當中。 發佈新版TouchGFX Generator時,舊版參數可能與新版參數不相容,此時便需要進行轉移。 本節說明所需步驟,以便在STM32CubeMX之中成功轉移及更新專案。
STM32CubeMX不支援X-CUBE版本之間的升級。按下Generate Code(產生程式碼)時,TouchGFX Designer會自動執行升級,原因在於.touchgfx
檔案內PostGenerateTargetCommand
區段中的下列指令。
.touchgfx
"PostGenerateTargetCommand" : "touchgfx update_project --project-file=../upgrade.ioc --platform=m7"
這道指令將讀取.ioc
檔案並更新參數以適應X-CUBE-TOUCHGFX目前的版本。 以下範例可以看到如何在X-CUBE-TOUCHGFX 4.13.0所建立的.ioc檔案,以手動方式執行X-CUBE-TOUCHGFX 4.14.0的指令碼進行升級。
使用STM32F746 DISCO TouchGFX開發板設定從4.13.0到4.14.0的升級範例
$ touchgfx update_project --project-file=../STM32F746G_DISCO.ioc
TouchGFX Generator 4.13.0 found
Creating backup of ../STM32F746G_DISCO.ioc as ../backup_STM32F746G_DISCO.ioc
Performing upgrade 4.13.0 -> 4.14.0 ... OK
以STM32CubeMX開啟升級過的專案時,STM32CubeMX會提示使用者要安裝.ioc檔案所指定的X-CUBE-TOUCHGFX版本(若指定版本尚未安裝的情況下)。 點擊Download now(立即下載)後將下載並安裝新版的X-CUBE-TOUCHGFX。
升級期間會保留TouchGFX Generator中的所有設定,.ioc檔案的備份會以前置檔名backup_
的方式置於原始檔旁。
要使用TouchGFX Generator所提供的新功能,必須在STM32CubeMX中再執行Generate Code (產生程式碼)。
Caution
如果透過STM32CubeMX(而不是透過TouchGFX Designer)為現有的TouchGFX專案升級X-CUBE-TOUCHGFX,TouchGFX Generator參數將重設為預設值,因為這些參數適用於不同版本。