14-bitowy moduł kamery termowizyjnej RAW: FlexMini 640 vs InfiRay Mini2 640
CAMCUDA / NOTATKI INŻYNIERYJNE
Rozwiązany problem z integracją MD — oraz procedury sprawdzające, które zapewniają przejrzysty przepływ pracy z obrazem RAW.
Zweryfikuj ścieżkę.
640×512 LWIR · USB UVC Y16
Egzemplarz referencyjny produktu FlexMini 640, zespół 4,9 mm. Nie jest to moduł klienta.
Wybór 16-bitowego modułu kamery termowizyjnej RAW zaczyna się od formatu akwizycji, a nie tylko od obrazu na ekranie. Integracja OEM wymaga również zdefiniowanego formatu, jednoznacznego źródła obrazu oraz bufora, którego host może używać bez mylenia przetwarzania na potrzeby wyświetlania z danymi pierwotnymi.
Archiwum Moduł kamery termowizyjnej CAMCUDA FlexMini 640 16-bit RAW LWIR oferuje ścieżkę USB UVC Y16 dla dopasowanych konfiguracji. Kluczowe rozróżnienie jest proste: dane w skali szarości Y14 w 16-bitowym kontenerze Y16. Poniżej znajduje się krótkie studium przypadku klienta oraz przewodnik sprawdzania tej ścieżki.
Przypadek integracji: aktualizacja oprogramowania układowego rozwiązała problem
Problem niemieckiego klienta z integracją 16-bitowego RAW w MD został rozwiązany po aktualizacji oprogramowania układowego. Wynik ten pokazuje, dlaczego kompatybilność oprogramowania układowego należy uwzględniać na równi z wymaganiami sprzętowymi i hosta podczas planowania ewaluacji.
Poniższy schemat procedury inżynieryjnej bazuje na aktualnych przewodnikach i zasobach integracyjnych MD. Nie stanowi on rekonstrukcji sesji testowej klienta ani gwarancji, że ta sama aktualizacja rozwiąże każdy problem z akwizycją.
Co oznacza Y14 w kontenerze Y16
Format Y16 informuje hosta o sposobie przechowywania próbek w skali szarości: dwa bajty na piksel. Nie oznacza to jednak, że próbki te zawierają 16 efektywnych bitów sensora ani że każda wartość reprezentuje temperaturę. Szerokość zapisu i interpretacja obrazu wymagają oddzielnego rozpatrzenia.
Przewodnik po MD opisuje źródło RAW jako dane w skali szarości Y14 w 16-bitowym kontenerze. Specyfikacja formatu luma Linux V4L2 również zwraca uwagę, że precyzja próbkowania Y16 może być niższa niż 16 bitów. W tej konfiguracji MD strumień wyjściowy to nieradiometryczne dane obrazu, a nie skalibrowane wartości temperatury dla każdego piksela.
Przed wdrożeniem dekodera należy zweryfikować wyrównanie bitów i skalowanie wybranego źródła. Dostępne materiały nie definiują uniwersalnego układu 14 najmniej znaczących bitów, stałego przesunięcia ani zakresu próbek. Formuła konwersji z innej kamery termowizyjnej nie zastąpi tych informacji.

FlexMini 640 VS INFIRAY MINI2 640
Porównanie 16-bitowych modułów kamer termowizyjnych RAW: FlexMini 640 vs InfiRay Mini2 640
Oba moduły wykorzystują niechłodzony detektor VOx 640×512, piksele 12 μm oraz pasmo LWIR 8–14 μm. Najpierw porównaj podstawowe parametry obrazowania, a następnie dostęp do danych RAW i opcje przetwarzania po stronie hosta.
| Specyfikacja / wyjście | CAMCUDA FlexMini 640 14-bit RAW · Y16 | InfiRay Mini2 640 |
|---|---|---|
| Detektor / rozdzielczość | Niechłodzony VOx / 640×512 | Niechłodzony VOx / 640×512 |
| Rozmiar piksela | 12 μm | 12 μm |
| Pasmo LWIR | 8–14 μm | 8–14 μm |
| Nominalna częstotliwość klatek | Specyfikacja sprzętowa 50 Hz; tryb przechwytywania Y16 zależy od oprogramowania układowego i obsługi przez hosta. | Częstotliwości odświeżania detektora 30 / 60 Hz. |
| Publikowana NETD | ≤30 mK | ≤40 mK przy 25°C, F/1.0, 25 Hz |
| 16-bitowe wyjście RAW | Tak — skala szarości Y14 w 16-bitowym kontenerze Y16. Akwizycja RAW przez USB UVC. | Nie — wyłącznie przetworzone wideo. Brak wyjścia 16-bitowych klatek RAW. |
| Dane dostępne dla hosta | Oryginalny bufor klatek w skali szarości, zapisany jako little-endian uint16. Należy go odseparować od opcjonalnego 8-bitowego podglądu wizualnego. | Klatki wideo przetworzone do wyświetlania, zamiast oryginalnego bufora RAW w skali szarości. |
| Wybór źródła RAW | RAW (0), pre-AGC (3) i post-AGC (4), zależnie od możliwości oprogramowania układowego. Po wymaganym restarcie Y16 należy zweryfikować aktywne źródło. | Brak 16-bitowego źródła RAW udostępnionego na wyjściu przetworzonego wideo. |
| Przetwarzanie obrazu po stronie hosta | Zachowaj oryginalne próbki w skali szarości do własnego potoku normalizacji i analizy obrazu. | Pracuj na dostarczonym, przetworzonym wideo; oryginalne próbki RAW nie są dostępne. |
Termowizyjny strumień wideo i bufor obrazu RAW odpowiadają na zupełnie inne potrzeby integracyjne. CAMCUDA FlexMini 640 zapewnia dane w skali szarości Y14 w 16-bitowym kontenerze Y16 przez USB UVC. InfiRay Mini2 640 przesyła wyłącznie przetworzone wideo, bez 16-bitowego wyjścia RAW.
Wybierz FlexMini 640, gdy Twój projekt wymaga danych RAW, a nie tylko obrazu termowizyjnego. Dostęp do pierwotnego bufora w skali szarości pozwala aplikacji hosta sterować normalizacją wyświetlania i analizą obrazu, zamiast polegać wyłącznie na przetworzonym wideo.
Ścieżka RAW w MD jest nieradiometryczna. Y16 opisuje format zapisu; przesyłanymi danymi są w tym przypadku wartości w skali szarości Y14, a nie skalibrowane dane temperaturowe. Nominalne prędkości klatkowe nie gwarantują rzeczywistej szybkości rejestracji przez hosta, a podane wartości NETD nie stanowią benchmarku w porównywalnych warunkach. Podstawowa specyfikacja Mini2: Karta katalogowa serii Mini2, strona 2.
Wybierz obsługiwane źródło, a następnie zweryfikuj aktywne źródło
Zacznij od tego, co faktycznie udostępnia zainstalowane oprogramowanie układowe. Strona 4 publicznego przewodnika wprowadza te selektory źródeł; aktualne zasoby MD precyzują weryfikację ich możliwości. Maska możliwości określa, które z nich mogą być użyte w dopasowanym module.
| Selektor | Ścieżka danych |
|---|---|
| 0 · RAW | Sygnał wyjściowy detektora z wczesnego etapu ISP; skala szarości Y14 w 16-bitowym kontenerze |
| 3 · Pre-AGC | Przed AGC / kompresją zakresu dynamicznego |
| 4 · Post-AGC | Po AGC, opisywany jako zachowujący domenę 14-bitową |
Oddzielne selektory NUC (1) i SFFC (2) zostały usunięte. Ich pozycji w tabeli objaśniającej w przewodniku nie należy traktować jako opcji do wyboru.
- Odczytaj
caps_maski aktualny stan źródła. - Zażądaj dostępnego źródła i sprawdź
selected_sourceorazpending. - Jeśli zmiana oczekuje na zastosowanie, zrestartuj strumień Y16.
- Odczytaj
active_sourceaby zweryfikować aktywny wybór.
Stan żądany to nie to samo co stan aktywny. Odczyt zwrotny należy traktować jako weryfikację zakończenia operacji, a nie tylko samą pomyślną odpowiedź SET. Wybór źródła działa wyłącznie w czasie pracy i nie jest zapisywany w pamięci Flash; nie należy zakładać domyślnego źródła ani zachowania ustawień po cyklu zasilania.
Od dopasowanej aktualizacji do przechwytywania klatek w systemie Linux
1. Potwierdź pakiet aktualizacji
Przed aktualizacją uzgodnij z CAMCUDA wersję modułu i płytki, interfejs, host oraz kompatybilne oprogramowanie układowe. Publiczny przewodnik przedstawia narzędzie do aktualizacji dla systemu Windows i zaleca wykonanie cyklu zasilania, jeśli urządzenie nie uruchomiło się ponownie po zakończeniu procedury. Sama nowsza nazwa pliku nie stanowi weryfikacji kompatybilności.
2. Wylistuj rzeczywiste urządzenie wideo
W przewodniku użyto następującego polecenia do wyświetlenia listy dostępnych formatów. /dev/video0 to przykładowa ścieżka; zidentyfikuj właściwe urządzenie w systemie hosta.
v4l2-ctl -d /dev/video0 --list-formats-ext
Wyszukaj format Y16 i sprawdź zgłaszane rozmiary oraz interwały. Przewodnik przedstawia 640×512 przy 50 fps; stabilna wydajność odbioru nadal wymaga potwierdzenia na dostarczonym module i hoście. Interfejs API systemu Linux rozróżnia wyliczanie formatów od negocjacji formatu. Sprawdź format zwrócony przez sterownik, zamiast zakładać, że żądanie zostało zaakceptowane bez zmian.
Zastosuj trzy odrębne weryfikacje: zgłaszany format, aktywne źródło obrazu oraz odebrane klatki. Obecność Y16 na liście odpowiada na pierwsze pytanie. Odczytanie stanu źródła odpowiada na drugie. Przechwytywanie na docelowym hoście odpowiada na trzecie. Rozdzielenie tych weryfikacji sprawia, że zgłoszenie do wsparcia technicznego jest znacznie bardziej przydatne niż samo zgłoszenie, że obraz wygląda nieprawidłowo.
3. Użyj pasującego przykładu przechwytywania
Przykład dla systemu Linux kompiluje się za pomocą make. Następnie przewodnik przedstawia to wywołanie przechwytywania:
./raw_y16_grab /dev/video0 frame_y16.raw 640 512 5 frame_y16.pgm 10
Jest to przykładowe wywołanie z przewodnika. Skorzystaj z odpowiedniego pliku README w celu uzyskania definicji argumentów i dostosuj ścieżkę urządzenia do swojego hosta; nie należy wnioskować o przeznaczeniu poszczególnych liczb na podstawie ich pozycji. Przed przekazaniem klatek do algorytmu potwierdź aktywne źródło i zachowaj oryginalny bufor.
Zachowaj bufor RAW i diagnozuj właściwą warstwę
Dostarczony przykład przechwytywania zapisuje kolejne dane little-endian uint16 klatek bez nagłówków dla poszczególnych klatek. Dla dwubajtowego formatu zapisu 640×512 jedna klatka zawiera 655 360 bajtów. Ten rozmiar pliku nie jest pomiarem przepustowości przesyłu ani uniwersalną regułą kroku sterownika (stride).
Opcjonalny plik PGM to 8-bitowy podgląd z rozciągnięciem percentylowym: przydatny do podglądu sceny, lecz różniący się od pierwotnego bufora analitycznego. Należy zachować plik RAW wraz ze statusem źródła i wynegocjowanym formatem. W przeciwnym razie transformacja wyświetlania może zostać błędnie uznana za zmianę w pozyskanych danych.
W celach porównawczych należy zachować nienaruszony plik z akwizycji i rejestrować, które dane wyjściowe przetwarza każdy etap. Podgląd wyświetlania i klatka RAW nie powinny być porównywane tak, jakby były tą samą reprezentacją. To proste rozróżnienie pomaga zarówno zespołowi integracyjnemu, jak i CAMCUDA w analizie ścieżki danych bez konieczności domyślania się, co zawiera zrzut ekranu.
| Obserwacja | Kolejna weryfikacja |
|---|---|
| Format Y16 nie jest wymieniony | Potwierdź ścieżkę urządzenia, płytkę, zainstalowane oprogramowanie układowe oraz zgodną obsługę aktualizacji. |
| Żądanie źródła powiodło się, obraz pozostaje bez zmian | Sprawdź stan oczekiwania, zrestartuj Y16, gdy jest to wymagane, a następnie odczytaj active_source. |
| Wartości podglądu różnią się od pliku RAW | Sprawdź, czy porównywany sygnał wyjściowy został przekonwertowany do 8-bitowego podglądu. |
| Przechwytywanie nie osiąga zamierzonej szybkości | Sprawdź wynegocjowany tryb, przepustowość hosta i odebrane klatki; ustawienia nominalne nie odzwierciedlają zmierzonego transferu. |
| Dekodowanie pikseli jest niepewne | Zażądaj specyficznego dla źródła wyrównania i skalowania, zamiast szacować maskę lub przesunięcie. |
Uzgodnij testy odbiorcze dla dostarczonej konfiguracji: zachowanie przełączania źródła, działanie migawki oraz wydajność odbieranych klatek na docelowym hoście. Prowadź zwięzłą dokumentację rewizji modułu i płytki, oprogramowania układowego, wybranego oraz aktywnego źródła, trybu i plików wyjściowych. Są to praktyczne testy ewaluacyjne, a nie zamiennik pomiarów konfiguracji planowanej do wdrożenia.
CAMCUDA FlexMini 640 w skrócie
Wykorzystaj to podsumowanie do zaplanowania ewaluacji, a następnie sprawdź aktualną stronę produktu pod kątem konfiguracji, optyki i opcji zamawiania. Specyfikacje sprzętowe oraz ścieżka akwizycji zależna od oprogramowania układowego są wyszczególnione osobno.
| Produkt | Moduł kamery termowizyjnej CAMCUDA FlexMini 640 16-bit RAW LWIR |
|---|---|
| Model sprzętowy / SKU | FlexMini 640 14-bit RAW · Y16 |
| Detektor / rozdzielczość | Niechłodzony VOx / 640×512 |
| Rozmiar piksela / pasmo | 12 μm / 8–14 μm |
| Ścieżka akwizycji | USB UVC Y16; skala szarości Y14 w 16-bitowym kontenerze Y16 |
| Przeznaczenie obrazu | Nieradiometryczna akwizycja skali szarości |
| Opcje obiektywów | 4.1, 4.9, 9.1, 13, 19 i 35 mm; dostępność i konfiguracja na zapytanie |
Przewodniki, zasoby SDK i kompatybilność
Czterostronicowe przewodniki w języku angielskim i niemieckim gromadzą w jednym miejscu procedurę aktualizacji, sprawdzanie formatu w systemie Linux, przykład przechwytywania oraz opis selektora źródeł.
- Przewodnik po aktualizacji oprogramowania układowego i RAW/Y16 w języku angielskim · PDF
- Deutsche Anleitung: Firmware-Upgrade und RAW/Y16 · PDF
- MD SDK i zasoby integracyjne · Google Drive
Kompatybilność SDK: główny plik nagłówkowy recenzowanego pakietu control SDK v1.11.0 odwołuje się do ir_ctrl_temperature.h, którego brakuje w tym pakiecie. Uzyskaj poprawiony, pasujący pakiet i potwierdź kompatybilność nagłówków, bibliotek oraz sprzętu przed integracją kompilacji. Nie jest to kompletne, gotowe do kompilacji wydanie SDK. Niezależny przykład przechwytywania Linux V4L2 jest odrębny od tego ograniczenia pakietu.
Są to aktualne zasoby integracyjne, a nie rejestr historycznych wersji klienta. Potwierdź zatwierdzony pakiet, ponieważ zawartość folderu współdzielonego może ulec zmianie. W przypadku rozbieżności między oznaczeniami przewodnika a folderów archiwum, użyj podstawowych nazw plików (basenames) do zidentyfikowania właściwych narzędzi.

Planujesz ewaluację? Podaj swoją platformę hosta, obiektyw, interfejs, wymagane źródło i ilość za pośrednictwem strony produktu MD. CAMCUDA może przeanalizować wymaganą konfigurację przed przystąpieniem do integracji.
Często zadawane pytania
Czy 16-bitowy moduł kamery termowizyjnej RAW dostarcza skalibrowane dane temperaturowe?
Sam kontener nie pozwala tego ustalić. Ta konfiguracja MD przesyła skalę szarości Y14 w formacie zapisu Y16 i jest nieradiometryczna: wartości zliczeń obrazu nie są skalibrowanymi temperaturami. Zachowaj oryginalny bufor oddzielnie od normalizacji wyświetlania i potwierdź interpretację specyficzną dla źródła przed budową potoku analitycznego.
Co należy sprawdzić, jeśli Y16 nie jest dostępne na moim hoście Linux?
Sprawdź rzeczywistą ścieżkę urządzenia i wyliczone formaty, a następnie potwierdź moduł, interfejs płytkę oraz zainstalowane oprogramowanie układowe. Zwróć się do CAMCUDA o weryfikację zgodności aktualizacji dla tej konfiguracji. Gdy format Y16 będzie dostępny, zweryfikuj wynegocjowany tryb oraz aktywne źródło w oddzielnych krokach. Unikaj traktowania aktualizacji oprogramowania układowego jako uniwersalnego rozwiązania problemów z przechwytywaniem.
Jak mogę potwierdzić, że wyjście pre-AGC jest aktywne?
Sprawdź maskę możliwości przed zażądaniem źródła 3. Skontroluj parametry selected_source oraz pending; w razie potrzeby zrestartuj strumień Y16, a następnie odczytaj active_source. To efektywne źródło jest miarodajnym wynikiem weryfikacji — a nie samo pomyślne żądanie ustawienia.
Źródła
- Zasoby produktowe i integracyjne CAMCUDA FlexMini 640
- Ogólnodostępny przewodnik w języku angielskim oraz Przewodnik w języku niemieckim, strony 1–4
- Karta katalogowa serii Mini2 — podstawowa specyfikacja obrazowania, strona 2
- Linux V4L2: formaty wyłącznie luma i precyzja Y16
- Linux V4L2: VIDIOC_ENUM_FMT
- Linux V4L2: negocjacja formatu