본문으로 건너뛰기

Palette SDK 시스템 스택 이해하기

Palette SDK는 Modalix용 소프트웨어 개발 도구를 제공합니다. Palette Image Builder(PIB)는 그 소프트웨어를 사용자 지정 eLxr 운영체제 이미지로 구성합니다. 두 컨테이너는 독립적입니다. 애플리케이션 개발에는 SDK를, 디바이스 이미지 사용자 지정에는 PIB를 사용하세요.

이 가이드는 이미지 패키징과 하위 소프트웨어를 다루는 시스템 엔지니어를 위한 문서입니다. 애플리케이션 API와 개발 절차는 developer.sima.ai/software를 참고하세요.

각 구성 요소의 실행 위치​

구성 요소실행 위치역할
sima-cli사용자 컴퓨터패키지 설치, 개발 환경 시작 및 설정
Palette SDK 컨테이너사용자 컴퓨터의 DockerARM64 sysroot를 대상으로 크로스 컴파일하고 개발 도구 제공
PIB 컨테이너사용자 컴퓨터의 Docker이미지 명세에 따라 루트 파일시스템, 패키지, 디스크 이미지, 서명된 SWU 생성
Modalix DevKit대상 디바이스ARM64 애플리케이션과 설치된 eLxr 이미지 실행

SDK와 PIB 모두 네이티브 x86 및 ARM64 컨테이너를 제공합니다. Docker가 호스트에 맞는 변형을 선택합니다. 대상 애플리케이션과 디바이스 이미지는 ARM64입니다. x86 호스트에서 이미지를 구성할 때 PIB는 ARM64 에뮬레이션을 자동 사용합니다.

시스템 소프트웨어 툴체인 열기​

SDK를 설치하고 개발 환경을 설정합니다.

sima-cli neat install sdk@develop
sima-cli sdk setup
sima-cli sdk neat

설정할 때 DevKit을 페어링하려면 주소를 지정합니다.

sima-cli sdk setup --devkit 192.0.2.10

예제 주소를 실제 DevKit 주소로 바꾸세요. 소프트웨어 빌드에 페어링이 필수는 아니지만 하드웨어 배포와 테스트에 유용합니다.

SDK에는 크로스 툴체인, 대상 sysroot, 헤더, 라이브러리, 개발 도우미가 포함됩니다. 작업 공간은 컨테이너의 /workspace에 마운트되므로 컴퓨터에서 파일을 편집하고 SDK 안에서 빌드할 수 있습니다.

이미지용 결과물 패키징​

Modalix ARM64 sysroot를 대상으로 빌드하세요. 애플리케이션과 필요한 파일을 아키텍처 arm64인 Debian 패키지로 만듭니다. 스크립트 등 아키텍처 독립적인 콘텐츠는 all을 사용할 수 있습니다.

애플리케이션 컨테이너와 디바이스 운영체제 이미지는 용도가 다릅니다. 애플리케이션 Docker 이미지를 빌드해도 SWU가 생성되거나 보드의 eLxr 루트 파일시스템이 교체되지는 않습니다.

PIB로 디바이스 이미지 구성​

PIB를 별도로 설치합니다.

sima-cli neat install sdk/pib
pib doctor
pib init my-image --flavor minimal
cd my-image

프로젝트는 다음 항목을 조합합니다.

  • image.yaml: 이미지 유형, 버전, 패키지, 서명 정보.
  • custom-debs/: 서명된 ARM64 또는 아키텍처 독립 패키지.
  • overlay/: 이미지에 root 소유로 추가할 설정과 파일.
  • hooks/: 패키지 설치 후 수행할 변경 사항.
  • keys/: 서명 정보와 공개 신뢰 자료.

PIB는 설정된 저장소에서 패키지를 다운로드하고 새 루트 파일시스템을 구성합니다. 업데이트용 서명된 .swu와 전체 디스크 프로비저닝/복구용 .img.gz를 생성합니다. 기본 SDK 컨테이너를 실행할 필요는 없습니다.

완전한 사용자 지정 이미지 예제에서 애플리케이션 패키징, 서비스, 설치 후 훅을 함께 확인하세요.

툴체인·이미지·보드 버전 맞추기​

컨테이너의 플랫폼 릴리스가 호환되는 이미지 입력을 결정합니다. PIB는 다른 플랫폼 릴리스용 프로젝트를 거부합니다. 이미지 버전에는 3.0.0.1처럼 숫자 빌드 번호가 추가되며 업데이트 정책에 사용됩니다.

릴리스마다 빌드 매니페스트, SBOM, 체크섬, 서명 정보를 보관하세요. 출하한 내용을 식별하고 같은 신뢰 CA로 후속 업데이트를 제공하는 데 필요합니다. 공개 빌더 컨테이너에는 서명 키가 포함되지 않습니다.

다음 단계 선택​

  • 첫 이미지는 PIB 시작 가이드를 따라 만드세요.
  • 동작하는 애플리케이션 예제는 샘플 안내를 확인하세요.
  • 사용자 지정 커널, 외부 서명, 보드 업데이트는 PIB 참조를 확인하세요.