호환성
정확한 버전을 선택하거나, 특정 구성 요소를 독립적으로 업그레이드하거나, 버전 불일치 문제를 해결하거나, 릴리스를 준비해야 할 때 이 페이지를 참고 자료로 활용하세요. Palette Neat을 처음 설정하는 경우, Neat 개발 환경(이하 Neat SDK) 및 Neat Library 페이지부터 시작하세요. 해당 절차는 지원되는 기본 조합을 설치합니다.
Palette Neat에는 여러 버전의 구성 요소가 있습니다. 대부분의 경우 호환성은 다음 두 가지 규칙에 따라 결정됩니다.
- Neat Library와 Neat SDK는 모두 호환되어야 합니다. 사용하는 또는 빌드하는 DevKit 소프트웨어 버전에 따라 달라집니다.
- Model Compiler는 Neat SDK와 호환되어야 합니다. 또는 설치된 호스트 환경입니다.
각 Neat SDK 릴리스 시리즈는 특정 DevKit 소프트웨어 버전을 대상으로 합니다. SDK의 패치 업데이트는 새로운 DevKit 이미지를 요구하지 않고도 도구 관련 문제를 해결할 수 있습니다. 예를 들어, 2.1.3.0을 포함한 Neat SDK 2.1.3.x 릴리스는 DevKit 소프트웨어 2.1.3과 호환됩니다.
아래 표에 표시된 페어링을 사용하는 한 SDK를 재설치하지 않고도 최신 호환 Neat Library를 설치할 수 있습니다. 예를 들어, Neat Library 0.4.0과 Neat SDK 2.1.3.0을 함께 사용하십시오.
이 페이지에 나열된 버전은 지원되는 버전 조합입니다.
DevKit
각 Modalix DevKit에는 특정 DevKit 소프트웨어 버전이 함께 제공됩니다. Neat SDK 또는 Neat Library 버전을 선택하기 전에 해당 버전을 확인하십시오.
아래 호환성 표는 DevKit 소프트웨어 버전을 기준으로 합니다. 이는 장치 내 런타임, 펌웨어 및 시스템 패키지가 일치하는 세트로 설치되기 때문입니다.
DevKit에 셸 액세스 권한을 얻은 후 설치된 소프트웨어 버전을 확인하십시오. DevKit가 네트워크에 연결되어 있는 경우 SSH를 통해 셸을 열거나 시리얼 콘솔을 통해 셸을 열 수 있습니다. 시리얼 액세스 방법에 대한 자세한 내용은 시리얼 액세스 설정를 참조하십시오.
cat /etc/buildinfo설치하려는 Neat Library 버전과 DevKit 소프트웨어 버전이 호환되지 않으면, sima-cli neat install은 장치에 호환되지 않는 런타임 구성 요소를 혼합하는 대신 설치를 차단합니다. 이 경우, 현재 DevKit 소프트웨어를 지원하는 Neat Library 버전을 설치하거나, 먼저 DevKit 펌웨어를 업데이트하십시오.
DevKit 펌웨어를 확인하고 업데이트하는 방법에 대한 지침은 펌웨어 업데이트를 참조하십시오.
Neat SDK
아래 표를 사용하여 Neat SDK가 사용 중인 DevKit 소프트웨어 버전과 일치하는지 확인하십시오.
| Neat SDK | 호환되는 호스트 환경 | 호환되는 DevKit 소프트웨어 |
|---|---|---|
| 2.0.0 | WSL을 통해 Windows 11, Ubuntu 22.04 또는 24.04, Apple Silicon 기반의 최신 macOS | 2.0.0 |
| 2.1.2.3 | WSL을 통해 Windows 11, Ubuntu 22.04 또는 24.04, Apple Silicon 기반의 최신 macOS | 2.1.2 |
| 2.1.3.0 | WSL을 통해 Windows 11, Ubuntu 22.04 또는 24.04, Apple Silicon 기반의 최신 macOS | 2.1.3 |
호스트에서 현재 배포된 Neat SDK를 설치합니다.
sima-cli neat install sdk@release-2.1현재 release-2.1 SDK 패키지는 Neat SDK 2.1.3.0으로 해결됩니다. 이 패키지는 DevKit 소프트웨어 2.1.3과 호환됩니다.
오래된 Neat SDK는 해당 펌웨어의 DevKit 소프트웨어를 사용하는 경우에만 사용하십시오. SDK 2.0.0, 2.1.2.0 또는 2.1.2.1의 경우 2단계 SDK 설치을 사용하십시오.
Neat Library
아래 표를 참조하여 Neat Library의 설치 또는 업데이트할 버전을 선택하세요. 이는 Neat SDK 및 DevKit에 적용됩니다.
| Neat Library | 호환되는 Neat SDK | 호환되는 DevKit 소프트웨어 | 참고 사항 |
|---|---|---|---|
| 0.1.0 | 2.0.0 | 2.0.0 | 2.0 펌웨어 버전에서 유지됩니다. |
| 0.2.2 | 2.1.2.2 | 2.1.2 | 최신 0.2 버전 출시. |
| 0.3.0 | 2.1.2.3 | 2.1.2 | 최신 0.3 버전입니다. |
| 0.4.0 | 2.1.3.0 | 2.1.3 | 현재 최신 버전입니다. |
DevKit 소프트웨어 버전이 중요한 이유는 장치 내 런타임, 펌웨어 및 시스템 패키지가 일련의 세트로 설치되기 때문입니다. 펌웨어 버전 간에 구성 요소를 혼합하면 애플리케이션을 빌드할 때 예상치 못한 동작이 발생할 수 있습니다.
일반적으로 처음 설정할 때는 이러한 명령을 실행하지 않습니다. SDK가 호환되는 Neat Library를 자동으로 설치합니다. 호환되는 Neat SDK 내에서 또는 DevKit에 직접 특정 Neat 라이브러리 버전을 지정해야 할 때만 사용하십시오.
Neat Library 0.4.0의 경우:
sima-cli neat install core@v0.4.0Neat Library 0.1.0 버전:
sima-cli neat install core@v0.1.0Neat 앱
Neat 앱 버전은 Neat Library 버전과 독립적으로 작동합니다. 앱을 설치하면 호환되는 Neat Library 버전이 자동으로 설치됩니다.
| Neat 앱 | 호환 가능: Neat Library |
|---|---|
| 0.4.0 | 0.3.0 |
| 0.5.0 | 0.4.0 |
호환되는 Neat SDK 또는 DevKit에서 Apps 0.5.0을 설치합니다.
sima-cli neat install apps@v0.5.0Model Compiler
Model Compiler는 사용자가 직접 모델을 컴파일하거나 양자화할 때 필요하며, 여기에는 GenAI 모델이 포함됩니다. 미리 컴파일된 모델 패키지만 사용하는 경우에만 선택적으로 사용할 수 있습니다. 필요할 때 이 표를 참조하십시오.
Model Compiler는 다음과 같이 두 가지 방법으로 설치할 수 있습니다.
- 호환되는 Neat SDK 내에서. 이 모드에서는 모든 호스트를 사용할 수 있습니다. 해당 Neat SDK 버전에서 지원하는 운영체제입니다. 이 내용은 Model Compiler 를 설치하세요.에 설명되어 있습니다.
- 지원되는 Ubuntu 호스트 시스템 또는 가상 머신에 직접 설치합니다. 이 모드에서는 호스트 운영체제가 아래에 설명된 Model Compiler 호스트 요구 사항과 일치해야 합니다. 설치 명령은 Model Compiler를 설치하세요.를 참조하십시오.
SDK 설치/설정 과정에서 해당 환경에 사용할 수 있는 Model Compiler 버전이 있으면 자동으로 설치하도록 안내합니다.
| Model Compiler | 호환되는 Neat SDK | 호환되는 호스트 환경 | 참고 사항 |
|---|---|---|---|
| 2.0.0 | 2.0.0 | Ubuntu 22.04 x86_64 | Apple Silicon 또는 aarch64/Linux 지원이 없습니다. |
| 2.1.2 | 2.1.2.3 | Ubuntu 24.04 x86_64 / aarch64 | Apple Silicon은 Neat SDK 내부에 설치하여 지원됩니다. |
| 2.1.3 | 2.1.3.0 | Ubuntu 24.04 x86_64 / aarch64 | Apple Silicon은 Neat SDK 내부에 설치하여 지원됩니다. |
호스트 환경 열은 독립 실행형 Model Compiler 설치에 적용됩니다. 예를 들어, Ubuntu 22.04 호스트를 사용하는 고객은 Neat SDK 2.1.3.0 내부에 설치하여 Model Compiler 2.1.3을 계속 사용할 수 있습니다. 이는 Neat SDK가 호환 되는 Ubuntu 24.04 기반 컨테이너 환경을 제공하기 때문입니다.
설치 단계는 Model Compiler를 설치하세요.를 참조하십시오.
버전 확인
Neat SDK 내부 또는 DevKit에서 다음 명령을 실행합니다.
neat아래 예제는 활성 환경, Neat SDK 버전, 설치된 구성 요소 버전, 그리고 업데이트가 가능한지 여부를 보여줍니다.
Neat Environment
Mode Neat SDK
SDK Version 2.1.3_Palette_SDK_neat_v2.1.3.0
Platform Version 2.1.3
Sysroot /opt/toolchain/aarch64/modalix
Update check online
Components
Neat core 0.4.0 channel=release env=prod latest=0.4.0
PyNeat 0.4.0
neat-runtime 0.4.0
neat-gst-plugins 0.4.0
neat-llima 0.4.0
neat-insight 0.0.6 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가 지원되는 버전 조합인지 확인하십시오.