跳至主要内容

安裝 PCIe 主機

請使用此頁面，在已連接至 Modalix PCIe 卡的 Linux 主機上安裝 Neat PCIe 主機套件。

Neat PCIe 主機套件提供協同處理 API，用於將來自主機的輸入傳送到已連接的 Modalix PCIe 卡，並接收推論結果。

安裝於 PCIe 主機上。

請在連接到 Modalix PCIe 卡的 PCIe 主機上執行此安裝。請勿在 Neat SDK 容器、DevKit 或 Modalix PCIe 卡上執行。

支援的主機作業系統​

Neat PCIe 主機封裝支援以下經過驗證的主機平台：

作業系統架構支援
Ubuntu 22.04x86_64支援
Ubuntu 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

Ubuntu 24.04 於 x86_64 平台上：

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

安裝程式會新增所有必要的元件，以便開發和執行 Neat PCIe 主機應用程式，包括 C++ API 和位於 ~/pyneatpcie 的 Python 環境。

它還會安裝來自 sima-neat/core 儲存庫的 neat-pcie-application-builder 編碼代理技能，適用於 Codex 和 Claude。技能安裝採用盡力而為的方式，因此暫時性的 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 協同處理，以驗證主機與卡之間的完整開發路徑。