14-bit RAW 熱成像相機模組：MD 對比 InfiRay Mini2 640
CAMCUDA / 工程案例筆記
一個已解決的 MD 整合問題——以及釐清 RAW 影像工作流程的檢查項目。
驗證路徑。
640×512 LWIR · USB UVC Y16
FlexMini 640 產品參考，4.9 mm 組件。非客戶的裝置。
選擇 16-bit RAW 熱成像相機模組應從擷取格式著手，而非僅看螢幕上的影像。OEM 整合同樣需要明確定義的格式、清晰的影像來源，以及主機可用的緩衝區，以避免將顯示處理與原始數據混淆。
該 CAMCUDA FlexMini 640 16-bit RAW LWIR 熱成像相機模組 為相應配置提供 USB UVC Y16 路徑。當中的關鍵區別非常簡單： 封裝於 16-bit Y16 容器中的 Y14 灰階數據。以下是一則簡短的客戶案例，隨後提供檢查該路徑的指引。
整合案例：韌體升級解決問題
一名德國客戶的 MD 16-bit RAW 整合問題在升級韌體後得以解決。該結果說明了在規劃評估時，韌體相容性應與硬件及主機需求一併納入考慮。
以下工程工作流程參考現有 MD 指南及整合資源編寫。此內容並非客戶測試過程的重現，亦不保證相同的升級能解決所有擷取問題。
Y16 容器中的 Y14 代表甚麼
Y16 僅告知主機灰階採樣的儲存方式：每像素兩個位元組。它並未告知主機這些採樣包含 16 個有效感測器位元，或每個數值皆代表溫度。儲存寬度與影像涵義需要分別釐清。
MD 指南將 RAW 來源描述為封裝在 16-bit 容器中的 Y14 灰階。 Linux V4L2 亮度格式規範 亦指出 Y16 採樣精度可能低於 16 位元。對於此 MD 配置，輸出為 非測溫圖像數據，而非每個像素的已校準溫度值。
在實作解碼器前，請先確認所選來源的位元對齊方式與縮放比例。現有資料並未定義通用的低 14 位元佈局、固定移位或採樣範圍。其他熱成像相機的轉換公式無法替代這些具體資訊。
FlexMini 640 VS INFIRAY MINI2 640
16-bit RAW 熱成像相機模組比較：FlexMini 640 vs InfiRay Mini2 640
兩款模組均採用非致冷 VOx 640×512 探測器、12 μm 像元間距以及 8–14 μm LWIR 波段。建議先比較基礎成像規格，再評估 RAW 數據存取與主機端處理選項。
| 規格 / 輸出 | CAMCUDA FlexMini 640 14-bit RAW · Y16 | InfiRay Mini2 640 |
|---|---|---|
| 探測器 / 解像度 | 非製冷 VOx / 640×512 | 非製冷 VOx / 640×512 |
| 像元間距 | 12 μm | 12 μm |
| LWIR 波段 | 8–14 μm | 8–14 μm |
| 標稱幀率 | 50 Hz 硬件規格；Y16 擷取模式取決於韌體及主機支援。 | 30 / 60 Hz 探測器幀率。 |
| 公布的 NETD | ≤30 mK | ≤40 mK 於 25°C、F/1.0、25 Hz |
| 16-bit RAW 輸出 | 是 — 16-bit Y16 容器中的 Y14 灰階。 USB UVC RAW 擷取。 | 否 — 僅限已處理視訊。 無 16-bit RAW 幀輸出。 |
| 主機端可用數據 | 原始灰階幀緩衝區，儲存為 little-endian uint16。請將其與可選的 8-bit 視覺預覽分開。 | 經顯示處理的視訊幀，而非原始 RAW 灰階緩衝區。 |
| RAW 來源選擇 | RAW (0)、pre-AGC (3) 及 post-AGC (4)，視乎韌體功能而定。在執行所需的 Y16 重啟後，請驗證使用中的來源。 | 已處理視訊輸出中未提供 16-bit RAW 來源。 |
| 主機端影像處理 | 保留原始灰階取樣，以供自訂正規化及影像分析流程使用。 | 使用所提供的已處理視訊；不提供原始 RAW 取樣。 |
熱成像視訊流與 RAW 圖像緩衝區滿足不同的整合需求。 CAMCUDA FlexMini 640 透過 USB UVC 提供封裝於 16-bit Y16 容器中的 Y14 灰階數據。 InfiRay Mini2 640 僅輸出經處理的視訊，不具備 16-bit RAW 輸出。
當您的項目需要 RAW 數據而非單純的熱成像畫面時，請選擇 FlexMini 640。 直接存取原始灰階緩衝區，可讓您的主機應用程式自主控制顯示歸一化與圖像分析，而無需完全依賴經處理的視訊。
FlexMini 640 RAW 路徑為非測溫模式。 Y16 說明了儲存格式；此處的有效負載為 Y14 灰階，而非校準後的溫度數據。標稱幀率並不保證為主機擷取幀率，所列出的 NETD 數值亦非相同條件下的基準比對。Mini2 基本規格： Mini2 系列規格書第 2 頁.
選擇受支援的來源，然後驗證使用中的來源
請先從已安裝韌體實際公開的內容著手。 公開指南第 4 頁 介紹了這些來源選擇器；當前的 MD 資源進一步闡明了其功能檢查。功能遮罩決定了哪些選擇器可用於相符的模組。
| 選擇器 | 數據路徑 |
|---|---|
| 0 · RAW | ISP 早期階段探測器輸出；16-bit 容器內的 Y14 灰階 |
| 3 · Pre-AGC | AGC / 動態範圍壓縮前 |
| 4 · Post-AGC | AGC 處理後，據描述保留 14-bit 域 |
獨立的 NUC (1) 與 SFFC (2) 選擇器已被移除。指南說明表中的相應項目不應視為可選項目。
- 讀取
caps_mask以及目前來源狀態。 - 請求可用來源並檢查
selected_source及pending. - 若變更處於擱置狀態，請重新啟動 Y16 串流。
- 讀取
active_source以驗證已生效的選擇。
已請求並不等同於處於作用中狀態。 請以讀回值作為完成檢查，而不僅僅依賴成功的 SET 回應。來源選擇僅於執行階段生效，不會寫入 Flash；請勿假設存在預設來源或在重新通電後仍能保留設定。
從相應升級到 Linux 影格擷取
1. 確認升級套件
升級前，請先與 CAMCUDA 確認模組和電路板版本、介面、主機及相容韌體。公開指南展示了一個 Windows 升級公用程式，並要求若裝置在完成後未重啟，請重新通電。單憑較新的檔案名稱並不能作為相容性檢查依據。
2. 列舉實際視訊裝置
指南使用以下指令列出可用格式。 /dev/video0 為範例路徑；請在您的主機上識別正確的裝置。
v4l2-ctl -d /dev/video0 --list-formats-ext尋找 Y16 並檢查其宣告的尺寸與間隔。指南展示了 50 fps 下的 640×512；持續接收效能仍需在交付的模組與主機上確認。Linux API 將 格式列舉 與 格式協商分開處理。請檢查驅動程式傳回的格式，而非假設其未經變更地接受請求。
請使用三項獨立的檢查： 宣告格式, 作用中影像來源 及 已接收幀。在清單中看到 Y16 可解答第一個問題。讀取來源狀態可解答第二個問題。在目標主機上擷取影像可解答第三個問題。將這些檢查分開進行，比起單純回報影像看起來有問題，能讓技術支援請求更具實用價值。
3. 使用相應的擷取範例
Linux 範例以 make進行建置。指南隨後展示了此擷取呼叫：
./raw_y16_grab /dev/video0 frame_y16.raw 640 512 5 frame_y16.pgm 10這是指南的呼叫範例。請參閱相應的 README 取得引數定義，並根據您的主機調整裝置路徑；請勿根據位置推斷每個數值的用途。在將幀輸入演算法之前，請先確認作用中來源並保留原始緩衝區。
保留 RAW 緩衝區並在正確層級進行疑難排解
隨附的擷取範例會儲存連續的 Little-Endian uint16 沒有每幀標頭的幀。就其 640×512 雙位元組儲存佈局而言，一幀包含 655,360 位元組。該檔案大小既不是傳輸吞吐量的測量值，也不是通用的驅動程式步進 (stride) 規則。
可選的 PGM 是 8-bit、按百分位數拉伸的預覽：有助於觀察場景，但與原始分析緩衝區不同。請將 RAW 檔案與訊號源狀態及協商格式一併保留。否則，顯示轉換可能會被誤認為採集數據發生了變化。
如需進行比較工作，請保留未經處理的採集檔案，並記錄每個處理階段所消耗的輸出。顯示預覽與 RAW 幀不應作為相同的數據表示進行比較。這種簡單的區隔有助於整合團隊和 CAMCUDA 討論數據路徑，而無需猜測螢幕截圖包含的內容。
| 觀察結果 | 下一步檢查 |
|---|---|
| 未列出 Y16 | 確認裝置路徑、電路板、已安裝韌體及相應的升級支援。 |
| 來源請求成功，影像看似未有變化 | 檢查待處理狀態，必要時重新啟動 Y16，然後讀取 active_source。 |
| 預覽數值與 RAW 檔案不符 | 檢查所比對的輸出是否已轉換為 8-bit 預覽。 |
| 擷取未能達到預期速率 | 檢查協商模式、主機頻寬及接收幀數；標稱設定並不等同實測傳輸效能。 |
| 像素解碼不明確 | 請索取特定來源的對齊與縮放參數，切勿臆測遮罩或位移。 |
圍繞交付配置商定驗收檢查：訊號源切換行為、快門行為以及在目標主機上的接收幀效能。簡要記錄模組和電路板版本、韌體、選定及作用中訊號源、模式和輸出檔案。這些是實用的評估檢查，不能替代對計劃部署配置的實際測量。
CAMCUDA FlexMini 640 概覽
使用此摘要來構建評估框架，然後查看當前產品頁面以獲取配置、光學元件和訂購選項。硬件規格和依賴韌體的採集路徑均分開列出。
| 產品 | CAMCUDA FlexMini 640 16-bit RAW LWIR 熱成像相機模組 |
|---|---|
| 硬件型號 / SKU | FlexMini 640 14-bit RAW · Y16 |
| 探測器 / 解像度 | 非製冷 VOx / 640×512 |
| 像素間距 / 波段 | 12 μm / 8–14 μm |
| 採集路徑 | USB UVC Y16；16-bit Y16 容器內的 Y14 灰階 |
| 影像用途 | 非輻射測溫灰階擷取 |
| 鏡頭選項 | 4.1、4.9、9.1、13、19 及 35 mm；供貨情況與配置依報價而定 |
指南、SDK 資源與兼容性
這份四頁的英文和德文指南將升級程序、Linux 格式檢查、捕獲示例和信號源選擇器參考整合到一處。
SDK 兼容性： 審查的控制 SDK v1.11.0 主標頭引用了 ir_ctrl_temperature.h，但該套件中並無此檔案。在編譯整合之前，請獲取更正的相符套件，並確認標頭、程式庫和硬件相容性。它不是一個完整、可直接編譯的 SDK 版本。獨立的 Linux V4L2 擷取範例不受此打包限制影響。
這些是當前的整合資源，而非客戶歷史版本的記錄。由於共用資料夾內容可能會發生變化，請確認獲得批准的套件。如果指南和封存資料夾標籤不同，請使用檔案基本名稱 (basename) 來識別相關工具。
正在計劃評估？請通過 MD 產品頁面分享您的主機平台、鏡頭、接口、所需信號源和數量。CAMCUDA 可以在您投入集成之前審核所需的配置。
常見問題
16-bit RAW 熱成像相機模組是否提供已校準的溫度數據？
僅憑容器無法確定這一點。此 MD 配置在 Y16 儲存中攜帶 Y14 灰階，且不具備輻射測溫功能：影像計數並非校準溫度。在構建分析管線之前，請將原始緩衝區與顯示正規化分開，並確認特定訊號源的解讀方式。
若我的 Linux 主機無法使用 Y16，應該檢查甚麼？
檢查實際設備路徑和枚舉格式，然後確認模組、 介面 電路板和已安裝的韌體。請 CAMCUDA 審查該配置的升級相容性。一旦 Y16 可用，請將驗證協商模式與作用中訊號源作為獨立步驟進行。切勿將韌體更新視為通用的擷取修復方案。
如何確認 pre-AGC 輸出已啟用？
在請求訊號源 3 之前，請檢查功能遮罩 (capability mask)。檢查 selected_source 和 pending；需要時重啟 Y16 串流，然後讀取 active_source。有效訊號源才是有價值的驗證結果——而不僅僅是成功的設定請求。
