Zephyr 업스트림¶

sf32lb52_devkit_lcd 보드는 Zephyr v4.3.0부터 업스트림 Zephyr에서 지원되고 유지 관리되고 있습니다. v4.3.0 릴리스 노트와 SF32LB52 DevKit LCD 보드 문서를 참조하십시오. 이 가이드는 v4.3.0 워크스페이스를 만들고, 첫 샘플을 빌드한 다음, 보드에 플래싱합니다. 더 폭넓은 SF32 공식 기능 세트가 필요하면 SiFli-SDK를 사용하십시오.

보드 기능 목록 확인

업스트림 보드 정의만으로는 모든 주변 장치나 동작 모드가 활성화되었거나 제품용으로 검증되었다고 확인할 수 없습니다. 보드 문서의 지원 기능 표를 확인하고, 사용하는 보드 리비전에서 필요한 동작을 검증하십시오.

필요한 것¶

하드웨어

SF32LB52 DevKit LCD. SF32LB525UC6, 8 MB OPI-PSRAM, 128 Mb QSPI-NOR을 탑재한 SF32LB52x-MOD-N16R8 모듈을 기반으로 합니다.
보드의 USB-to-UART 경로에 연결한 USB Type-C 데이터 케이블.

소프트웨어

Zephyr v4.3.0과 해당 시작하기 안내에서 지원하는 호스트 OS.
Zephyr 호스트 의존성과 Zephyr SDK. 해당 가이드의 설명대로 ARM Cortex-M 타깃용으로 설치해야 합니다.
Git, Python 3, pip.

개발 환경 준비¶

먼저 Zephyr의 v4.3.0 시작하기 가이드에 따라 호스트 의존성과 Zephyr SDK 설정을 완료하십시오. 그런 다음 Python 환경을 만들고 같은 Zephyr 태그로 워크스페이스를 초기화하십시오.

python3 -m venv ~/zephyr-venv
source ~/zephyr-venv/bin/activate
pip install west
west init -m https://github.com/zephyrproject-rtos/zephyr --mr v4.3.0 ~/zephyrproject
cd ~/zephyrproject
west update
west zephyr-export
pip install -r zephyr/scripts/requirements.txt

아래의 빌드 및 플래시 단계에서도 이 환경을 활성 상태로 유지하십시오.

보드 확인¶

워크스페이스에 타깃이 포함되어 있는지 확인하십시오.

west boards

예상되는 보드 이름은 다음과 같습니다.

sf32lb52_devkit_lcd

Hello World 빌드¶

Zephyr의 표준 Hello World 샘플을 빌드하십시오.

west build -b sf32lb52_devkit_lcd samples/hello_world --pristine

빌드에 성공하면 워크스페이스에서 보드 타깃과 툴체인을 사용할 수 있음을 확인한 것입니다. 다만 모든 보드 주변 장치가 검증된 것은 아닙니다.

보드에 플래시 기록¶

업스트림 보드는 sftool을 기본 플래시 러너로 지정합니다. OpenSiFli sftool을 설치하고 PATH에서 실행할 수 있는지 확인하십시오. 이어서 보드 문서에 나온 절차에 따라 보드를 시리얼 다운로드 모드로 전환한 뒤 다음 명령을 실행하십시오.

west flash

플래시 기록에 실패하면 시리얼 포트 선택, 다운로드 모드, 그리고 보드 문서의 러너 안내를 확인하십시오.

시리얼 콘솔 열기¶

업스트림 보드 구성에서 Zephyr 콘솔은 1000000 보레이트의 usart1에 연결됩니다. 시리얼 터미널로 해당 UART를 열고 다음 출력이 나타나는지 확인하십시오.

Hello World! sf32lb52_devkit_lcd

다음 샘플 선택¶

업스트림 보드 문서의 지원 기능 표와 Zephyr 샘플 브라우저를 함께 사용하여 다음에 평가할 API 또는 주변 장치를 선택하십시오. 샘플을 제품 준비 상태의 증거로 간주하기 전에, 해당 기능이 이 보드에 나열되어 있는지와 필요한 구성이 활성화되어 있는지 확인하십시오.

문제 해결¶

표: 문제 해결

증상	확인 사항
`west boards`에 SF32 타깃이 표시되지 않음	워크스페이스가 업스트림 Zephyr v4.3.0 이상에서 초기화되었는지, `west update`가 완료되었는지 확인하십시오.
컴파일 전에 빌드가 실패함	Python 환경이 활성 상태인지, ARM Cortex-M용 Zephyr SDK가 설치되어 있는지, v4.3.0 요구 사항이 설치되었는지 확인하십시오.
보드는 빌드되지만 플래시에 기록되지 않음	`sftool`이 설치되어 `PATH`에서 실행 가능한지, 선택한 시리얼 포트가 올바른지, 보드가 시리얼 다운로드 모드인지 확인하십시오.
시리얼 출력이 없음	`usart1`, `1000000` 보레이트, USB-to-UART 연결, 다른 터미널이 해당 포트를 열고 있는지를 확인하십시오.
주변 장치 샘플이 실패함	보드의 지원 기능 표와 샘플 구성을 확인하십시오. 기본 보드 타깃에서 모든 주변 장치가 활성화된다고 가정하지 마십시오.

제품 통합 전 확인 사항¶

업스트림 보드의 지원 기능 표와 사용하려는 샘플의 정확한 구성을 확인하십시오.
타깃 보드와 제품 구성에서 필요한 인터페이스, 성능, 메모리 사용량, 전력 동작을 검증하십시오. Hello World 빌드 성공은 툴체인을 확인하는 스모크 테스트일 뿐입니다.
설계가 이 Zephyr 타깃에서 지원되거나 검증되지 않은 기능에 의존한다면, 업스트림 기능 범위를 SiFli-SDK와 비교하십시오.

최종 업데이트: 2026-10-19