安裝與環境設定#
關於 pypylon 的背景資訊，請參閱簡介。
安裝 pylon Software Suite#
安裝 Basler pylon Software Suite 以及 pypylon 和所需的補充套件（例如用於 3D 相機）。
資訊
pypylon wheel 套件已經包含 pylon C++ runtimes 和 vTools。這對於使用 pypylon 來說已經足夠，並且適用於不需要任何額外驅動程式的傳輸層 (transport layers)。
如果需要，您可以從 Basler 網站下載 pylon Software Suite 以及任何其他補充套件（例如用於 3D 相機）。
pylon Software Suite 的安裝精靈將引導您完成整個過程，並允許您決定要安裝的元件。建議使用以下元件：
- USB/GigE 驅動程式
- CXP GenTL producer 與驅動程式（如果使用 CXP 相機）
- pylon Viewer
安裝 pypylon#
pypylon 可從 PyPi 取得。若要安裝它，請執行以下命令：
當您在某些系統上執行 pip install 時，您可能會看到類似以下內容：
error: externally-managed-environment × This environment is externally managed To install Python packages system-wide, use your system package manager, for instance on Ubuntu23.04+.
這表示您的作業系統正在管理 Python 安裝。它有助於防止 pip 變更系統套件。
替代方案 1：虛擬環境（建議）#
Python「虛擬環境」允許將 Python 套件安裝在特定應用程式的隔離位置，而不是全域安裝。使用 venv 安裝至資料夾 DIR 您需要執行以下步驟：
python3 -m venv <DIR>
source <DIR>/bin/activate # MacOS/ Linux
<DIR>\Scripts\activate # Windows
pip install pypylon
deactivate
這在 Docker、WSL、Raspberry Pi 和 Conda 設定中的運作方式相同。每個專案都有自己的相依性樹狀結構，且一個專案中的升級絕不會影響另一個專案。
替代方案 2：系統全域安裝#
sudo python3 -m pip install pypylon --break-system-packages
這種方法相當簡單，模組可立即供所有使用者使用。然而，除了需要 root 權限之外，它還有以下缺點。
- 它可能會與 Debian 套件管理產生衝突。
- 未來的 Debian 或 Python 更新可能會損壞系統。
一般而言，在現代 Debian 系統上不建議使用此方法。
驗證安裝#
若要驗證 pypylon 安裝，請執行以下命令：
from pypylon import pylon
factory = pylon.TlFactory.GetInstance()
devices = factory.EnumerateDevices()
print("Detected:", len(devices))
GigE 優化#
如果您計劃使用 GigE 相機，建議進行以下優化：
- 使用專用的網路介面卡 (NIC)
- 啟用巨型訊框 (MTU 9000)
- 停用節能模式
散發 pypylon#
Pypylon 提供了完整的 pylon 執行階段。因此，不需要安裝 pylon Software Suite。
如果您同時需要相機或擷取卡驅動程式，請參閱 pylon Deployment Guide。