運算子 AppletProperties

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 運算子為每個硬體平臺提供了一組特定的參數。

以下的參數說明指出了哪些硬體平臺支援哪些參數。如果未指定任何限制,則所有平臺都支援該參數。

I/O Properties

Property Value
Operator Type 無(因為沒有輸入或輸出)

支援的 Link 格式

無

參數

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)。

[備註] 可用性

imaFlex 2 Dual 100

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 中的差動通道。當差動模式啟用時,偶數接腳會傳輸差動信號,而奇數接腳僅代表負向配對狀態,可以忽略。

[備註] 可用性

imaFlex 2 Dual 100

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'。

[備註] 可用性

imaFlex 2 Dual 100

DesignClock (所有 imaFlex 平台)
Type 靜態讀取參數
Default 312.5
Range [312.5; 400.0]

此參數表示以百萬赫茲 (MHz) 為單位的設計系統時脈頻率。 您可以在 VisualApplets 中變更設計系統時脈頻率,路徑為選單 Design,選單項目 Change FPGA Clock。使用高於 135 MHz 的頻率設定可能會導致 時序違規。在這種情況下,請降低頻率。

[備註] 可用性

imaFlex 2 Dual 100, imaFlex CXP-12 Quad, imaFlex CXP-12 Penta

DesignClock (mE5 marathon 與 LightBridge VCL 平台)
Type 靜態讀取參數
Default 125
Range [125;312.5]

此參數表示以百萬赫茲 (MHz) 為單位的設計系統時脈頻率。 您可以在 VisualApplets 中變更設計系統時脈頻率,路徑為選單 Design,選單項目 Change FPGA Clock。使用高於 135 MHz 的頻率設定可能會導致 時序違規。在這種情況下,請降低頻率。

[備註] 可用性

mE5 marathon VCLx, mE5 marathon VCL, mE5 marathon VCX-QP, mE5 marathon VF2, LightBridge VCL

ExtensionGpioType (imaFlex CXP-12 Quad 與 imaFlex CXP-12 Penta 平台)
Type 動態寫入參數
Default OpenDrain
Range {OpenDrain, PushPull}

此參數允許使用者為外部擴充 GPIO 連接器選擇電路類型。 在 PushPull 模式下,GPIO 會被 直接驅動。

[備註] 參數僅影響 GPIO 連接器

此參數對 Front GPIO 連接器沒有影響。只有 GPIO 連接器會受此參數影響。

[備註] 可用性

imaFlex CXP-12 Quad, imaFlex CXP-12 Penta

FrontGpioPullControl (imaFlex CXP-12 Penta 平台)
Type 動態寫入參數
Default PullUp
Range {PullUp, PullDown}

  • PullUp:在所有 Front GPIO 輸入上,提升電阻已啟用 至 SLTRG_VIN(外部 5–24 V 輸入參考電壓)。

  • PullDown:在所有 front GPIO 輸入上,下拉電阻已 啟用至 SLTRG_GND(隔離式 GND)。

[備註] 可用性

imaFlex CXP-12 Penta

FrontGpioType (imaFlex CXP-12 Penta 平台)
Type 動態寫入參數
Default SingleEnded
Range {SingleEnded, Differential}

  • Differential:所有 Front GPIO 輸入均為差動式。

  • SingleEnded:所有 Front GPIO 輸入均為單端式(以 SLTRG_GND 為參考)。

[備註] 可用性

imaFlex CXP-12 Penta

FrontGpioInversion (imaFlex CXP-12 Penta 平台)
Type 動態寫入參數
Default 關閉
Range {On, Off}

  • On:與 FPGA 輸出相比,所有 Front GPIO 輸出的極性均 為相反。

  • Off:與 FPGA 輸出相比,所有 Front GPIO 輸出的極性均 相同。

[備註] 可用性

imaFlex CXP-12 Penta

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)合成執行才能滿足時序要求。

[備註] 可用性

mE5 ironman VD8-PoCL、mE5 ironman VQ8-CXP6D 與 mE5 ironman VQ8-CXP6B

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 模式非常有用。

[備註] 可用性

mE5 marathon VCLx、mE5 marathon VCL、mE5 marathon VCX-QP、mE5 marathon VF2 與 LightBridge VCL。

GpioType (mE5 marathon 與 ironman 平台)
Type 動態寫入參數
Default OpenDrain
Range {OpenDrain, PushPull}

此參數允許使用者選擇外部 GPIO 連接器的電路類型。在 PushPull 模式下,GPIO 會被直接驅動。

[備註] 參數僅影響 GPIO 連接器

此參數對 Front GPIO 連接器沒有影響。只有 GPIO 連接器會受此參數影響。

[備註] 可用性

mE5 marathon VCLx、mE5 marathon VCL、mE5 marathon VCX-QP、mE5 marathon VF2、mE5 ironman VD8-PoCL、mE5 ironman VQ8-CXP6D 與 mE5 ironman VQ8-CXP6B

BuildTimeStamp (所有平台 - 隱藏)
Type 靜態寫入參數
Default 不適用
Range 不適用
[備註] Visibility

此參數不會顯示在操作員的參數清單中。

不過,此參數在執行階段環境中是可见的。

BuildTimeStamp 是一個自動產生的識別號碼。這是一個 32 位元的 Timestamp,可以在執行階段從 Applet 中讀出,以檢查已載入的 Applet 與已載入的 Applet 執行階段環境之間的一致性。

ProjectNameHash (所有平台 - 隱藏)
Type 靜態讀取參數
Default 不適用
Range 不適用
[備註] Visibility

此參數不會顯示在操作員的參數清單中。

不過,此參數在執行階段環境中是可见的。

針對 ProjectName 中的項目(「設計」功能表、「屬性」功能表項目)進行 32 位元雜湊運算。此值可以在執行階段從 Applet 中讀出,以檢查已載入的 Applet 與已載入的 Applet 執行階段環境之間的一致性。

AppletUidHigh (所有平台 - 隱藏)
Type 靜態讀取參數
Default 不適用
Range 不適用
[備註] Visibility

此參數不會顯示在操作員的參數清單中。

不過,此參數在執行階段環境中是可见的。

參數 AppletUid 代表一個 128 位元的數字。此數字的高 64 位元會以數字形式輸出在 AppletUidHigh 中。

AppletUidLow (所有平台 - 隱藏)
Type 靜態讀取參數
Default 1
Range {0; 2^32 – 1}
[備註] Visibility

此參數不會顯示在操作員的參數清單中。

不過,此參數在執行階段環境中是可见的。

參數 AppletUid 代表一個 128 位元的數字。此數字的低 64 位元會以數字形式輸出在 AppletUidLow 中。

使用範例

以下範例顯示了 operator AppletProperties 的使用方式: