Buildroot에서 사용자 정의 패키지 작성법 및 Config.in 설정

Buildroot에서 사용자 정의 패키지 작성법 및 Config.in 설정

1. 개요

Buildroot는 경량 임베디드 리눅스 시스템을 구축하는 데 널리 사용되는 도구로, 기본적으로 제공되는 패키지 외에도 사용자 정의 애플리케이션을 추가할 수 있습니다. 이를 위해서는 Buildroot 패키지 작성법과 함께 Config.in 파일을 설정하는 방법을 이해해야 합니다.

이번 글에서는 Buildroot에서 새로운 패키지를 작성하는 방법과 Config.in을 설정하여 빌드 옵션을 추가하는 과정을 설명합니다. 이를 통해 사용자가 필요로 하는 애플리케이션을 Buildroot 환경에 통합할 수 있도록 안내하겠습니다.

---

2. Buildroot 패키지 개념

Buildroot에서 패키지는 package 디렉터리 아래에 위치하며, 각 패키지는 소스 코드 다운로드, 빌드, 설치 등의 작업을 정의하는 스크립트로 구성됩니다. 새로운 패키지를 추가하려면 다음과 같은 파일들을 작성해야 합니다.

필수 파일 목록

1. 패키지 디렉터리 생성: package/myapp/ 형태로 새로운 디렉터리를 생성합니다.
2. 패키지 메이크파일 (myapp.mk): 패키지의 빌드 과정을 정의하는 파일입니다.
3. Config.in 파일 (Config.in): 패키지의 설정 옵션을 지정합니다.
4. 패키지 선언 파일 (package/Config.in) 수정: 새로운 패키지를 Buildroot에 인식시키기 위해 package/Config.in 파일을 수정합니다.

---

3. 사용자 정의 패키지 작성 방법

3.1 패키지 디렉터리 생성

우선 package 디렉터리 아래에 새로운 패키지 폴더를 생성합니다.

mkdir -p package/myapp

이제 패키지와 관련된 설정 파일을 작성할 수 있습니다.

3.2 패키지 메이크파일 (myapp.mk) 작성

메이크파일은 패키지의 다운로드, 빌드, 설치 단계를 정의하는 핵심 파일입니다. 아래 예제는 myapp이라는 간단한 애플리케이션의 메이크파일을 나타냅니다.

########################################################################
# myapp
########################################################################

MYAPP_VERSION = 1.0.0
MYAPP_SITE = $(BR2_EXTERNAL_MYAPP_PATH)/myapp-src
MYAPP_SITE_METHOD = local

define MYAPP_BUILD_CMDS
    $(MAKE) -C $(@D)
endef

define MYAPP_INSTALL_TARGET_CMDS
    $(INSTALL) -D $(@D)/myapp $(TARGET_DIR)/usr/bin/myapp
endef

$(eval $(generic-package))

위 코드에서:

• MYAPP_VERSION은 패키지 버전을 정의합니다.
• MYAPP_SITE는 소스 코드 위치를 지정합니다.
• MYAPP_SITE_METHOD은 소스 코드의 다운로드 방식을 나타냅니다. (local로 설정하여 로컬 소스를 사용함)
• MYAPP_BUILD_CMDS는 빌드 명령을 정의합니다.
• MYAPP_INSTALL_TARGET_CMDS는 빌드된 바이너리를 TARGET_DIR로 복사합니다.
• $(eval $(generic-package))를 사용하여 Buildroot의 일반적인 패키지 처리 규칙을 적용합니다.

3.3 Config.in 파일 작성

Config.in 파일은 make menuconfig에서 패키지를 활성화할 수 있도록 정의하는 설정 파일입니다.

menu "My Custom Applications"

config BR2_PACKAGE_MYAPP
    bool "myapp"
    help
      사용자 정의 애플리케이션 myapp을 활성화합니다.

endmenu

이 파일을 package/myapp/Config.in에 저장합니다.

3.4 패키지 목록에 추가하기

package/Config.in 파일을 열고 다음 라인을 추가합니다.

source "package/myapp/Config.in"

이제 make menuconfig를 실행하면 My Custom Applications 메뉴에서 myapp을 활성화할 수 있습니다.

---

4. 패키지 빌드 및 테스트

패키지를 성공적으로 작성한 후에는 다음 단계로 진행합니다.

4.1 make menuconfig에서 패키지 활성화

make menuconfig

• My Custom Applications → myapp을 선택한 후 저장(exit and save)합니다.

4.2 Buildroot 빌드 실행

make

패키지가 정상적으로 빌드되면 output/target/usr/bin/myapp 경로에서 바이너리를 확인할 수 있습니다.

4.3 타겟 환경에서 실행

임베디드 보드나 QEMU에서 다음 명령을 실행하여 패키지가 정상적으로 동작하는지 확인합니다.

/usr/bin/myapp

---

5. 결론

이번 글에서는 Buildroot에서 사용자 정의 패키지를 작성하는 방법과 Config.in을 설정하여 make menuconfig에서 패키지를 활성화하는 방법을 살펴보았습니다.

정리하자면:

1. package/ 디렉터리 아래에 새로운 패키지를 위한 폴더를 생성합니다.
2. myapp.mk 메이크파일을 작성하여 패키지의 빌드 및 설치 과정을 정의합니다.
3. Config.in 파일을 생성하여 Buildroot의 설정 인터페이스에서 패키지를 선택할 수 있도록 합니다.
4. package/Config.in 파일을 수정하여 새로운 패키지를 Buildroot에 추가합니다.
5. make menuconfig에서 패키지를 활성화한 후 make를 실행하여 빌드를 진행합니다.

이 과정을 통해 사용자가 원하는 애플리케이션을 Buildroot에 통합하여 효율적으로 관리할 수 있습니다.