주요 내용으로 건너뛰기

Upgrading Project

TouchGFX Generator 매개변수는 .ioc 파일(STM32CubeMX 프로젝트)에 저장됩니다. TouchGFX Generator의 새 버전이 출시된 경우에는 이전 버전의 매개변수가 새 버전과 호환되지 않아서 마이그레이션이 필요할 수 있습니다. 이 섹션에서는 STM32CubeMX에서 프로젝트를 성공적으로 마이그레이션 및 업데이트하는 데 필요한 단계들을 설명합니다.

STM32CubeMX에서는 X-CUBE 버전 간 업그레이드가 지원되지 않기 때문에 Generate Code를 누르면 .touchgfx 파일의 PostGenerateTargetCommand 섹션에서 다음과 같은 명령으로 인해 TouchGFX Designer에서 업그레이드가 자동으로 수행됩니다.

.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로 업데이트된 프로젝트를 열면 사용자에게 .ioc 파일로 표현되는 X-CUBE-TOUCHGFX 버전을 설치하라는 메시지가 표시됩니다(아직 설치되지 않은 경우). Download now를 클릭하면 X-CUBE-TOUCHGFX의 새 버전이 다운로드 및 설치됩니다.

추가 소프트웨어 구성 요소 누락: TouchGFX Generator 4.14.0

TouchGFX Generator의 모든 구성은 업그레이드 절차가 진행되는 동안 유지가 되며, .ioc 파일의 백업은 backup_이 앞에 추가되어 원본 옆에 배치됩니다.

기존 버전 출시 이후에 새 기능이 추가되거나 기존 기능의 옵션이 변경되는 경우 STM32CubeMX가 기존 및/또는 새 매개변수를 값으로 매핑하지 못할 수 있습니다. 따라서 프로젝트를 업그레이드한 후 STM32CubeMX 내부에 있는 TouchGFX Generator의 매개변수를 검사하여 모두 적절한 값을 가지고 있는지 항상 확인하는 것이 좋습니다.

TouchGFX Generator에서 제공되는 새로운 기능을 사용하려면 STM32CubeMX에서 Generate Code를 수행해야 합니다.
Caution
기존 TouchGFX 프로젝트에서 STM32CubeMX를 통해 X-CUBE-TOUCHGFX를 업그레이드를 할 때 TouchGFX Designer에서 업그레이드 프로세스가 실행되지 않는 경우에는 다른 버전에 적용될 수 있다는 점에서 TouchGFX Generator 매개변수가 기본값으로 재설정됩니다.