メインコンテンツまでスキップ

Palette SDK のシステムスタックを理解する

Palette SDK は Modalix 向けソフトウェアの開発ツールを提供します。Palette Image Builder(PIB)は、そのソフトウェアをカスタム eLxr OS イメージに組み込みます。独立したコンテナなので、アプリケーション開発には 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 を使用できます。

アプリケーションコンテナとデバイス OS イメージの用途は異なります。アプリケーションの 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 のもとで更新を続けるために必要です。公開されるビルダーコンテナに署名鍵は含まれません。

次のステップを選ぶ​