본문으로 건너뛰기

PCIe 호스트를 설치합니다.

이 페이지를 사용하여 Linux 시스템에 Neat PCIe 호스트 패키지를 설치하고, Modalix PCIe 카드에 연결합니다.

Neat PCIe 호스트 패키지는 호스트 시스템에서 연결된 Modalix PCIe 카드로 입력을 보내고 추론 결과를 수신하기 위한 공동 처리 API를 제공합니다.

PCIe 호스트 장치에 설치합니다.

이 설치 프로그램을 Modalix PCIe 카드에 연결된 PCIe 호스트 시스템에서 실행합니다. Neat SDK 컨테이너 내부, DevKit 또는 Modalix PCIe 카드에서 실행하지 마십시오.

지원되는 호스트 운영체제​

Neat PCIe 호스트 패키지는 다음으로 검증된 호스트 플랫폼을 지원합니다.

운영 체제아키텍처지원
우분투 22.04x86_64지원됨
우분투 24.04x86_64지원됨

Arm64 호스트 빌드는 아직 검증되지 않았습니다. Windows 11은 지원되지 않습니다.

필수 조건​

패키지를 설치하기 전에:

  • PCIe 호스트에 sima-cli를 설치합니다. 다음을 사용하십시오. sima-cli installation guide.
  • 다음 단계를 따라 PCIe 호스트 드라이버를 설치하고 확인하십시오. PCIe Driver Installation guide.
  • Modalix PCIe 카드를 연결하고 구성하여 관리 인터페이스를 사용할 수 있도록 합니다. 호스트에서 접근할 수 있습니다. 카드 0의 기본 주소는 10.0.0.2입니다.
  • 카드에 호환되는 Neat Library 버전을 설치합니다. 호스트와 카드 패키지는 호환되는 버전에서 제공되어야 합니다.

PCIe 호스트를 인증하여 SiMa.ai 아티팩트를 다운로드할 수 있도록 합니다.

sima-cli login

PCIe 호스트 패키지를 설치합니다.​

PCIe 호스트에서 작업 디렉터리를 선택한 다음, 설치된 Ubuntu 버전에 맞는 명령을 실행합니다.

x86_64 아키텍처의 Ubuntu 22.04:

sima-cli neat install core/pciehost/ubuntu22/amd64@v0.4.0

x86_64 아키텍처 기반의 Ubuntu 24.04:

sima-cli neat install core/pciehost/ubuntu24/amd64@v0.4.0

설치 프로그램은 C++ API와 ~/pyneatpcie에 있는 Python 환경을 포함하여 Neat PCIe 호스트 애플리케이션을 개발하고 실행하는 데 필요한 모든 것을 추가합니다.

또한 sima-neat/core 저장소에서 Codex 및 Claude용 코딩 에이전트 기술인 neat-pcie-application-builder를 설치합니다. 기술 설치는 최선을 다하는 방식으로 진행되므로 임시 GitHub 또는 코딩 에이전트 구성 문제로 인해 PCIe 호스트 패키지가 차단되지 않습니다. 경고가 표시되면 다음을 사용하여 다시 시도하십시오.

sima-cli playbooks install gh:sima-neat/core/pcie_host/skills/neat-pcie-application-builder

처음 설치하는 동안 SSH 프로비저닝은 카드에 대한 sima 계정의 비밀번호를 요청할 수 있습니다. 그런 다음 ~/.ssh/sima_neat_pcie_ed25519를 생성하거나 재사용하고 해당 공개 키를 카드에 설치합니다. 이후 일반적인 PCIe 작동은 카드 측 모델 설정을 위해 비밀번호 없는 SSH를 사용합니다.

설치가 완료되었는지 확인하세요.​

Python API와 PCIe 호스트 플러그인이 설치되어 있는지 확인합니다.

source ~/pyneatpcie/bin/activatepython3 -c "import pyneatpcie; print('pyneatpcie ready')"gst-inspect-1.0 neatpciehost

문제 해결​

SSH 프로비저닝으로 카드를 자동으로 검색할 수 없는 경우, 먼저 호스트가 관리 주소에 접속할 수 있는지 확인하십시오.

ping -c 1 10.0.0.2

그런 다음 설치된 설정 유틸리티를 실행하고 주소를 명시적으로 지정합니다.

pcie-setup.sh --hosts "10.0.0.2"

패키지 설치 또는 런타임 시작에 실패하는 경우, PCIe 호스트 패키지와 카드에 설치된 Neat Library가 호환되는 버전인지 확인하십시오.

다음 단계​

PCIe 공동 처리을 계속 진행하여 호스트에서 카드까지의 전체 개발 경로를 확인합니다.