U-Boot 포팅 가이드: 환경 설정부터 보드 초기화까지

임베디드 시스템 개발에서 새로운 하드웨어를 구동할 때 가장 먼저 마주하는 관문은 단연 U-Boot 포팅입니다. 보드 특성에 맞춰 부트로더를 최적화하는 과정은 단순히 부팅을 성공시키는 것을 넘어, 시스템의 전체적인 안정성을 결정짓는 핵심 단계입니다. 이번 글에서는 Rockchip RK3399 플랫폼을 예시로, U-Boot 포팅을 위해 반드시 거쳐야 할 필수 준비 요소와 단계별 포팅 전략을 체계적으로 정리해 보겠습니다.

Generated by Gemini AI.

핵심 요약

• U-Boot 포팅은 크로스 컴파일 환경 구축을 시작으로 defconfig 설정, 소스 코드 수정, Device Tree 작성의 단계를 거칩니다.
• 핵심 설정 파일인 헤더 파일과 보드 초기화 루틴, 그리고 하드웨어 명세인 DTS를 수정하는 것이 포팅의 본질입니다.
• 효율적인 포팅을 위해서는 기존 레퍼런스 코드를 분석하고, 플랫폼에 필요한 최소한의 변경 사항부터 반영하는 것이 좋습니다.

1. 개발 환경 준비: 크로스 컴파일러 설정

U-Boot는 호스트 PC에서 빌드하여 타겟 보드에서 실행되므로, ARM64 아키텍처에 맞는 크로스 컴파일러가 필요합니다.

구분	명령어	설명
컴파일러 설치	sudo apt install gcc-aarch64-linux-gnu	우분투 환경에서 툴체인 설치
환경 변수 설정	export CROSS_COMPILE=aarch64-linux-gnu-	컴파일러 접두어 지정
아키텍처 설정	export ARCH=arm64	타겟 CPU 아키텍처 명시

2. 프로젝트 설정 및 커스터마이징

기존 레퍼런스 보드 설정을 가져와 시작하면 작업 시간을 크게 줄일 수 있습니다.

• 기본 설정 적용: make rockchip_rk3399_defconfig 명령으로 베이스 설정을 불러옵니다.
• 상세 설정 변경: make menuconfig를 실행하여 UART, 저장 장치, 네트워크 기능을 UI 환경에서 조정합니다.
• 설정 저장: make savedefconfig를 통해 나만의 보드 전용 설정 파일로 저장합니다.

3. U-Boot 포팅 필수 수정 파일

새로운 보드를 지원하려면 소스 트리에 다음과 같은 핵심 정보들을 반영해야 합니다.

구성 요소	주요 경로	역할
Config 헤더	include/configs/.h	메모리 맵, UART 속도, 환경 변수 정의
Board 폴더	board///	핀 설정(Pinmux), DRAM 초기화 등
CPU 코드	arch/arm/cpu/armv8/	MMU 및 캐시 설정 등 아키텍처 공용 로직
Device Tree	arch/arm/dts/.dts	GPIO, I2C, SPI 등 하드웨어 구성 명세

4. 보드 초기화 루틴 및 환경 변수

초기화 코드는 시스템이 켜진 후 가장 먼저 실행되는 C 코드 영역입니다.

• board.c: board_init()에서 GPIO 방향이나 PMIC 전원 제어를 수행하고, board_late_init()에서 부팅 직전 필요한 환경 변수를 동적으로 수정합니다.
• 환경 변수 최적화: setenv 명령어를 통해 커널 부팅 파라미터를 설정합니다. 자주 사용하는 부팅 로직은 CONFIG_BOOTCOMMAND를 통해 defconfig에 고정하면 매번 입력하는 번거로움을 덜 수 있습니다.

5. 개발을 위한 팁

• 레퍼런스 코드 활용: RK3399는 오픈소스 레퍼런스가 매우 많습니다. 처음부터 새로 짜려 하지 말고, 유사한 보드의 설정을 찾아 비교하며 필요한 부분만 수정하십시오.
• 단계별 검증: 한꺼번에 많은 코드를 수정하지 마십시오. UART 초기화가 되는지 먼저 확인하고, 그다음 저장 장치를 인식시키는 방식으로 점진적으로 진행하는 것이 트러블슈팅에 유리합니다.

6. 흔히 하는 실수

• 디버그 시리얼 포트 설정: UART baud rate가 보드의 실제 하드웨어 사양과 맞지 않으면 부팅 로그가 깨져 나옵니다. 1500000 등 사용하는 보드의 표준 속도를 정확히 확인하십시오.
• Device Tree 누락: 커널 부팅 시 특정 장치가 잡히지 않는다면 대부분 DTS 설정 문제입니다. 전원 레일(Regulator) 정의가 빠졌는지, GPIO 핀맵이 실제 보드 설계와 일치하는지 반드시 다시 확인해야 합니다.

결론

U-Boot 포팅은 복잡해 보이지만, 설정 파일과 보드 코드, 그리고 Device Tree로 이어지는 흐름만 이해하면 충분히 정복할 수 있습니다. 이미 충분한 레퍼런스가 존재하는 RK3399 플랫폼인 만큼, 체계적인 접근으로 포팅 시간을 단축하시길 바랍니다. 다음 글에서는 빌드된 이미지를 직접 보드에 라이팅하고 실제 디버깅하는 과정을 다루겠습니다.