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

互換性

初めての設定ですか？

このページは、セットアップの手順ではなく、バージョン互換性に関する参照です。

標準の SDK をインストールすると、互換性のあるデフォルト設定が自動的に適用されます。初めてセットアップする場合は、まず DevKit ソフトウェアのバージョンを確認し、次に Palette SDK（およびそのホストの要件）を確認してください。以下の表は、バージョンを固定する場合、異なるファームウェアバージョン間でコンポーネントを組み合わせる場合、または互換性の問題を診断する場合にのみ使用してください。

正確なバージョンを選択する必要がある場合、特定のコンポーネントのみを個別にアップグレードする場合、バージョン不整合のトラブルシューティングを行う場合、またはリリースを準備する場合に、このページを参照してください。Palette SDK を初めてセットアップする場合は、Palette SDK および Neat Library のページから開始してください。これらの手順では、サポートされているデフォルトの組み合わせがインストールされます。

Palette SDK には、いくつかのバージョン管理されたコンポーネントがあります。ほとんどの場合、互換性は次の 2 つのルールに依存します。

  1. Neat LibraryとPalette SDKは、両方とも互換性がある必要があります。 使用している、または開発に使用している DevKit ソフトウェアのバージョンによって。
  2. Model Compiler は、Palette SDK と互換性がある必要があります。 または、インストールされているホスト環境。

各Palette SDKリリースシリーズは、特定のDevKitソフトウェアバージョンを対象としています。SDKのパッチリビジョンでは、新しいDevKitイメージを必要とせずに、ツールに関する修正が追加される場合があります。たとえば、2.1.3.0を含むPalette SDK 2.1.3.xリリースは、DevKitソフトウェア2.1.3と互換性があります。

SDKを再インストールせずに、より新しい互換性のあるNeat Libraryをインストールすることもできます。ただし、以下の表に示すペアリングを使用する必要があります。たとえば、Neat Library 0.6.1とPalette SDK 3.0.0.1を組み合わせて使用します。

注記

このページに記載されているバージョンは、サポート対象のバージョン組み合わせです。

DevKit​

すべての Modalix DevKit には、特定のバージョンのソフトウェア DevKit が付属しています。Palette SDK または Neat Library のバージョンを選択する前に、そのバージョンを確認してください。

以下の互換性表は、DevKit ソフトウェアのバージョンに基づいて構成されています。これは、デバイス上のランタイム、ファームウェア、およびシステムパッケージが、一連のパッケージとしてインストールされるためです。

DevKit へのシェルアクセスを確立した後、インストールされているソフトウェアのバージョンを確認してください。DevKit がネットワーク経由でアクセス可能な場合、またはシリアルコンソール経由で、SSH を使用してシェルを開くことができます。シリアルアクセスに関する手順については、シリアルアクセスを設定する を参照してください。

devkit$cat /etc/buildinfo

インストールしようとしている Neat Library のバージョンと、DevKit のソフトウェアバージョンが互換性がない場合、sima-cli neat install は、デバイス上で互換性のないランタイムコンポーネントを混在させるのではなく、インストールをブロックします。その場合は、現在の DevKit ソフトウェアをサポートするバージョンの Neat Library をインストールするか、最初に DevKit のファームウェアを更新してください。

DevKit のファームウェアの確認と更新の手順については、ファームウェアの更新 を参照してください。

Palette SDK​

以下の表を使用して、お使いの Palette SDK が、お使いの DevKit のソフトウェアバージョンと一致していることを確認してください。

Palette SDK対応するホスト環境対応する DevKit ソフトウェア
2.0.0WSL を介した Windows 11、Ubuntu 22.04 または 24.04、Apple Silicon 搭載の最新 macOS2.0.0
2.1.2.3WSL を介した Windows 11、Ubuntu 22.04 または 24.04、Apple Silicon 搭載の最新 macOS2.1.2
2.1.3.0WSL を介した Windows 11、Ubuntu 22.04 または 24.04、Apple Silicon 搭載の最新 macOS2.1.3
2.1.3.1WSL を介した Windows 11、Ubuntu 22.04 または 24.04、Apple Silicon 搭載の最新 macOS2.1.3
3.0.0.0WSL を介した Windows 11、Ubuntu 22.04 または 24.04、Apple Silicon 搭載の最新 macOS3.0.0
3.0.0.1WSL を介した Windows 11、Ubuntu 22.04 または 24.04、Apple Silicon 搭載の最新 macOS3.0.0

DevKit ソフトウェアと互換性のある特定の SDK バージョンをインストールしてください。たとえば、DevKit ソフトウェア 3.0.0 用の Palette SDK 3.0.0.1 をホストからインストールするには、次のコマンドを実行します。

host$sima-cli neat install sdk@v3.0.0.1

特定の SDK バージョンをインストールするで、特定のタグとリリースチャネルについて確認してください。

2段階のSDKインストールが必要なのは、SDK 2.0.0、2.1.2.0、2.1.2.1 のみです。

Neat Library​

以下の表を参照して、ご自身の Palette SDK および DevKit にインストールまたは更新する Neat Library のバージョンを選択してください。

Neat Library対応：Palette SDK対応する DevKit ソフトウェア備考
0.1.02.0.02.0.0バージョン2.0のファームウェアで維持されます。
0.2.22.1.2.22.1.2最新の 0.2 バージョンをリリースしました。
0.3.02.1.2.32.1.2最新の 0.3 バージョン。
0.4.02.1.3.02.1.3サポート対象のリリース。
0.5.02.1.3.12.1.3サポート対象のリリース。
0.6.03.0.0.03.0.0サポート対象のリリース。
0.6.13.0.0.13.0.0現在のリリース。

DevKitのソフトウェアバージョンは重要です。なぜなら、デバイス上のランタイム、ファームウェア、およびシステムパッケージが、互いに対応したセットとしてインストールされるからです。異なるファームウェアバージョン間でコンポーネントを混在させると、アプリケーションのビルド時に予期しない動作が発生する可能性があります。

通常、これらのコマンドは初回セットアップ時に実行する必要はありません。SDKが互換性のあるNeat Libraryを自動的にインストールします。特定のNeat Libraryバージョンを、互換性のあるPalette SDK内から、またはDevKit上で直接指定する場合にのみ使用してください。

Neat Library 0.6.1の場合：

sdk or devkit$sima-cli neat install core@v0.6.1

Neat Library 0.1.0 の変更点：

sdk or devkit$sima-cli neat install core@v0.1.0

Neat アプリ​

Neat アプリのバージョンは、Neat Library のバージョンとは独立しています。アプリをインストールすると、互換性のあるNeat Libraryバージョンが自動的にインストールされます。

Neat アプリ対応：Neat Library
0.4.00.3.0
0.5.00.4.0
0.5.10.5.0
0.6.00.6.0
0.6.10.6.1

互換性のある Palette SDK または DevKit から、Apps 0.6.1 をインストールしてください。

sdk or devkit$sima-cli neat install apps@v0.6.1

Model Compiler​

Model Compiler は、GenAIモデルを含むモデルを自分でコンパイルまたは量子化する場合に必要であり、事前にコンパイルされたモデルパッケージのみを使用する場合はオプションです。必要な場合は、以下の表を参照してください。

Model Compiler は、次の 2 つの方法でインストールできます。

  • 互換性のある Palette SDK の内部で。このモードでは、任意のホストを使用してください。 そのバージョンの Palette SDK がサポートする OS。これは、Model Compiler をインストールしてください。 に記載されているパスです。
  • 対応する Ubuntu ホストマシンまたは仮想マシンに直接インストールします。このモードでは、ホスト OS が 以下のModel Compilerのホスト要件と一致する必要があります。インストール手順については、Model Compiler をインストールしてください。を参照してください。

SDKのインストール/設定中に、設定プロセスでは、環境で利用可能な場合に、対応するModel Compilerバージョンを自動的にインストールするように促されます。

Model Compiler対応：Palette SDK対応するホスト環境備考
2.0.02.0.0Ubuntu 22.04 x86_64Apple Silicon や aarch64/Linux のサポートはありません。
2.1.22.1.2.3Ubuntu 24.04 x86_64 / aarch64Apple Silicon は、Palette SDK をインストールすることでサポートされます。
2.1.32.1.3.0Ubuntu 24.04 x86_64 / aarch64Apple Silicon は、Palette SDK をインストールすることでサポートされます。
2.1.3.12.1.3.1Ubuntu 24.04 x86_64 / aarch64Apple Silicon は、Palette SDK をインストールすることでサポートされます。
3.0.03.0.0.0Ubuntu 24.04 x86_64 / aarch64Apple Silicon は、Palette SDK をインストールすることでサポートされます。
3.0.0.13.0.0.1Ubuntu 24.04 x86_64 / aarch64Apple Silicon は、Palette SDK をインストールすることでサポートされます。

「ホスト環境」列は、スタンドアロンの Model Compiler のインストールに適用されます。たとえば、Ubuntu 22.04 ホストを使用しているお客様は、Palette SDK 2.1.3.0 内にインストールすることで、Model Compiler 2.1.3 を引き続き使用できます。これは、Palette SDK が互換性のある Ubuntu 24.04 ベースのコンテナ環境を提供するためです。

インストール手順については、Model Compiler をインストールしてください。 を参照してください。

バージョンを確認する​

Palette SDK の内部、または DevKit 上で、次のコマンドを実行します。

sdk or devkit$neat

以下に示す出力例は、アクティブな環境、Palette SDK のバージョン、インストールされているコンポーネントのバージョン、および更新プログラムが利用可能かどうかを示しています。

Neat Environment
  Mode               Palette SDK
  SDK Version        3.0.0_Palette_SDK_neat_v3.0.0.1
  Platform Version   3.0.0
  Sysroot            /opt/toolchain/aarch64/modalix
  Update check       online

Components
  Neat core              0.6.1 channel=release env=prod latest=0.6.1
  PyNeat                 0.6.1
  neat-runtime           0.6.1
  neat-gst-plugins       0.6.1
  neat-llima             0.6.1
  neat-insight           0.0.9 channel=release status=Running venv=/opt/neat-insight/venv
  Model Compiler         not installed

  Update available: yellow component versions indicate available updates.
  Run: neat update.

この出力を確認し、お使いの Neat Library、DevKit ソフトウェア、およびオプションの Model Compiler が、サポートされているバージョン組み合わせのものであることを確認してください。