Operator Library: Hardware Platform
AppletProperties 運算子沒有輸入和輸出。它可用於控制 Applet 和主機板硬體設定。
此運算子提供了一組用來描述 Applet 的參數。某些值由使用者定義,其他則會自動產生。
此運算子在每個設計中都是強制性的,並由 VisualApplets 自動實例化。該運算子無法被刪除。
| 適用於硬體平台 |
|---|
| imaFlex 2 Dual 100 |
| imaFlex CXP-12 Penta |
| imaFlex CXP-12 Quad |
| mE5 marathon VCLx |
| mE5 marathon VCL |
| mE5 marathon VCX-QP |
| mE5 marathon VF2 |
| LightBridge VCL |
| mE5 ironman VQ8-CXP6D |
| mE5 ironman VQ8-CXP6B |
| mE5 ironman VD8-PoCL |
![]() |
可用參數 |
|---|---|
|
AppletProperties 運算子為每個硬體平臺提供了一組特定的參數。 以下的參數說明指出了哪些硬體平臺支援哪些參數。如果未指定任何限制,則所有平臺都支援該參數。 |
| VisualAppletsVersion (所有平臺) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
所使用的 VisualApplets 版本號碼。 |
|
| ProjectName (所有平臺) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
在 Design 選單的 Properties 選單項目中指定的專案名稱。 |
|
| AppletVersion (所有平臺) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
在 Design 選單的 Properties 選單項目中指定的版本。 |
|
| AppletVendor (所有平臺) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
您可以直接在此運算子的 Module Properties 對話方塊中輸入有關 Applet 供應商的資訊。 |
|
| AppletAuthor (所有平臺) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
您可以直接在此運算子的 Module Properties 對話方塊中輸入有關 Applet 作者的資訊。 |
|
| BuildTime (所有平臺) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
BuildTime 參數是一個自動產生的字串,顯示 Applet 建置的時間(最新網路清單產生的日期和時間)。 此參數值僅在 Framegrabber SDK 中可見。下圖顯示了字串的格式: ![]() |
|
| AppletUid (all platforms) | |
|---|---|
| Type | 靜態讀取參數 |
| Default | 不適用 |
| Range | 不適用 |
|
小程式的唯一 ID。每次進行新組建時都會建立一個新 ID(如果已設定前提條件檢查)。 |
|
| FrontGpiPullControl03 / FrontGpiPullControl47 (imaFlex 2 Dual 100 platform) | ||||
|---|---|---|---|---|
| Type | dynamic, static write parameter | |||
| Default | PullUp | |||
| Range | {PullUp, PullDown} | |||
|
此參數控制前端插槽 GPI 信號的上拉和下拉電阻 (20 kOhm),無論它們被配置為差動還是單端。您可以將 GPI 設定為 PullUp 或 PullDown 狀態。 當 GPI 接腳未由外部驅動,或外部驅動程式的上電時間晚於擷取卡時,上拉電阻會定義 GPI 接腳上的電壓準位。如果連接了外部驅動程式,其驅動能力必須足以覆蓋 20 kOhm 的上拉電阻。 FrontGpiPullControl03 參數控制 GPI 群組通道 A(GPI 接腳 0–3)的行為,而 FrontGpiPullControl47 參數則控制 GPI 群組通道 B(GPI 接腳 4–7)的行為。 為了讓上拉電阻正常運作,外部 GPIO 電源必須連接到適當的連接器接腳(群組通道 A 或通道 B 的 GPI 電壓 IN 與 GPI 接地 IN)。
|
||||
| FrontGpiType03 / FrontGpiType47 (imaFlex 2 Dual 100 platform) | ||||
|---|---|---|---|---|
| Type | dynamic, static write parameter | |||
| Default | SingleEnded | |||
| Range | {SingleEnded, Differential} | |||
|
此參數控制 GPI 接腳是在差動模式還是單端模式下運作。FrontGpiType03 參數管理群組通道 A(GPI 接腳 0–3),而 FrontGpiType47 參數則管理群組通道 B(GPI 接腳 4–7)。 在 SingleEnded 模式下,每個 GPI 接腳都會原封不動地傳遞至 VisualApplets 中,允許群組中的所有四個接腳獨立使用。 在 Differential 模式下,偶數編號的 GPI 接腳和下一個奇數編號的接腳會結合成 VisualApplets 中的差動通道。當差動模式啟用時,偶數接腳會傳輸差動信號,而奇數接腳僅代表負向配對狀態,可以忽略。
|
||||
| FiberPortProtocol0 / FiberPortProtocol1 (imaFlex 2 Dual 100 platform) | ||||
|---|---|---|---|---|
| Type | 靜態寫入參數 | |||
| Default |
QSFP28[0]: CoF QSFP28[1]: DataForwarding |
|||
| Range | {CoF, DataForwarding} | |||
|
此參數定義擷取卡相應 QSFP28 連接埠的光纖協定。連接埠 0 通常用於相機連接 (CoF),而連接埠 1 用於將資料轉發到另一張擷取卡。從屬擷取卡的兩個連接埠通常都設定為 DataForwarding。 CoF 代表 CoaXPress over Fiber (CXP 3.0 標準)。DataForwarding 是 Basler 用於擷取卡與擷取卡之間通訊的協定。這兩種協定每個通道均支援 25 Gbit/s,每個 QSFP28 連接埠總共可達 100 Gbit/s。 在特殊條件下,可以將兩台 100 Gbit/s 相機連接至單張擷取卡。這些設定需要滿足特定的要求。但是,在透過 PCIe 將資料傳輸到主機記憶體或 GPU 之前,擷取卡必須執行預處理並將產生的頻寬減少至少一半。 PCIe 提供約 13 GB/s 的有效頻寬,而單個 QSFP28 連接埠則提供約 12.5 GB/s 的頻寬。兩個 QSFP28 連接埠加起來會產生約 25 GB/s 的內部頻寬,若無預處理和頻寬縮減,此頻寬將無法透過 PCIe 傳輸。此外,主機板的 RAM 系統對可以同時透過 RAM 串流傳輸的資料量施加了進一步的限制。 有關資料轉發功能的更多詳細資訊,請參閱 'Data Forwarding with imaFlex 2 Dual 100 Frame Grabbers'。
|
||||
| DesignClock (所有 imaFlex 平台) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 312.5 | |||
| Range | [312.5; 400.0] | |||
|
此參數表示以百萬赫茲 (MHz) 為單位的設計系統時脈頻率。 您可以在 VisualApplets 中變更設計系統時脈頻率,路徑為選單 Design,選單項目 Change FPGA Clock。使用高於 135 MHz 的頻率設定可能會導致 時序違規。在這種情況下,請降低頻率。
|
||||
| DesignClock (mE5 marathon 與 LightBridge VCL 平台) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 125 | |||
| Range | [125;312.5] | |||
|
此參數表示以百萬赫茲 (MHz) 為單位的設計系統時脈頻率。 您可以在 VisualApplets 中變更設計系統時脈頻率,路徑為選單 Design,選單項目 Change FPGA Clock。使用高於 135 MHz 的頻率設定可能會導致 時序違規。在這種情況下,請降低頻率。
|
||||
| ExtensionGpioType (imaFlex CXP-12 Quad 與 imaFlex CXP-12 Penta 平台) | |||||||
|---|---|---|---|---|---|---|---|
| Type | 動態寫入參數 | ||||||
| Default | OpenDrain | ||||||
| Range | {OpenDrain, PushPull} | ||||||
|
此參數允許使用者為外部擴充 GPIO 連接器選擇電路類型。 在 PushPull 模式下,GPIO 會被 直接驅動。
|
|||||||
| FrontGpioPullControl (imaFlex CXP-12 Penta 平台) | ||||
|---|---|---|---|---|
| Type | 動態寫入參數 | |||
| Default | PullUp | |||
| Range | {PullUp, PullDown} | |||
|
|
||||
| FrontGpioType (imaFlex CXP-12 Penta 平台) | ||||
|---|---|---|---|---|
| Type | 動態寫入參數 | |||
| Default | SingleEnded | |||
| Range | {SingleEnded, Differential} | |||
|
|
||||
| FrontGpioInversion (imaFlex CXP-12 Penta 平台) | ||||
|---|---|---|---|---|
| Type | 動態寫入參數 | |||
| Default | 關閉 | |||
| Range | {On, Off} | |||
|
|
||||
| PcieInterfaceType (ironman 平台) | ||||
|---|---|---|---|---|
| Type | 靜態寫入參數 | |||
| Default | Generation_2 | |||
| Range | {Generation_1, Generation_2} | |||
|
PcieInterfaceType 參數允許您選擇 PCIe 介面類型,進而決定支援的 DMA 頻寬。 Generation_2(預設)代表 PCIe Generation 2 通訊協定,並提供 3,600,000 bytes/s 的頻寬。 Generation_1 代表 PCIe Generation 1 通訊協定,並提供 1,800,000 bytes/s 的頻寬。 Generation_1 設計使用的 FPGA 資源略少。對於 Generation_1 設計而言,Applet 要達到時序收斂會容易得多。Generation_2 則提供最大效能,但要讓 Applet 達到時序收斂更具挑戰性。可能需要進行多次佈局與繞線(Place and Route)合成執行才能滿足時序要求。
|
||||
| PcieInterfaceType (mE5 marathon 與 LightBridge VCL 平台) | ||||
|---|---|---|---|---|
| Type | 靜態寫入參數 | |||
| Default | Generation_2 | |||
| Range | {Generation_1, Generation_2} | |||
|
PcieInterfaceType 參數允許您選擇 PCIe 介面類型,進而決定支援的 DMA 頻寬。 Generation_1: The applet only supports PCIE generation 1. Thus, the maximum DMA transmission bandwidth is ca. 900 MByte/s (1MByte = 1^10Byte). The DmaToPC operator is limited so that LinkParallelism x LinkPixelWidth needs to be <= 64 bit. Generation_2: The applet supports PCIE generation 2. Thus, the maximum DMA transmission bandwidth is ca. 1800 MByte/s (1MByte = 1^10Byte). The DmaToPC operator is limited so that LinkParallelism x LinkPixelWidth needs to be <= 128 bit. Generation_1 的實作消耗的資源少於 Generation_2 的實作。在不需要 Generation_1 高頻寬但資源短缺的設計中,Generation_1 模式非常有用。
|
||||
| GpioType (mE5 marathon 與 ironman 平台) | |||||||
|---|---|---|---|---|---|---|---|
| Type | 動態寫入參數 | ||||||
| Default | OpenDrain | ||||||
| Range | {OpenDrain, PushPull} | ||||||
|
此參數允許使用者選擇外部 GPIO 連接器的電路類型。在 PushPull 模式下,GPIO 會被直接驅動。
|
|||||||
| BuildTimeStamp (所有平台 - 隱藏) | ||||
|---|---|---|---|---|
| Type | 靜態寫入參數 | |||
| Default | 不適用 | |||
| Range | 不適用 | |||
BuildTimeStamp 是一個自動產生的識別號碼。這是一個 32 位元的 Timestamp,可以在執行階段從 Applet 中讀出,以檢查已載入的 Applet 與已載入的 Applet 執行階段環境之間的一致性。 |
||||
| ProjectNameHash (所有平台 - 隱藏) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 不適用 | |||
| Range | 不適用 | |||
針對 ProjectName 中的項目(「設計」功能表、「屬性」功能表項目)進行 32 位元雜湊運算。此值可以在執行階段從 Applet 中讀出,以檢查已載入的 Applet 與已載入的 Applet 執行階段環境之間的一致性。 |
||||
| AppletUidHigh (所有平台 - 隱藏) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 不適用 | |||
| Range | 不適用 | |||
參數 AppletUid 代表一個 128 位元的數字。此數字的高 64 位元會以數字形式輸出在 AppletUidHigh 中。 |
||||
| AppletUidLow (所有平台 - 隱藏) | ||||
|---|---|---|---|---|
| Type | 靜態讀取參數 | |||
| Default | 1 | |||
| Range | {0; 2^32 – 1} | |||
參數 AppletUid 代表一個 128 位元的數字。此數字的低 64 位元會以數字形式輸出在 AppletUidLow 中。 |
||||
以下範例顯示了 operator AppletProperties 的使用方式:
-
Examples - Basic Acquisition
-
Examples - Basic Acquisition
-
Examples - Basic Acquisition
-
Examples - Basic Acquisition

![[備註]](../common/images/admon/note.png)

上一頁

