diff --git a/docs/hardware/en/ThermalCam/T256s/FAQ.md b/docs/hardware/en/ThermalCam/T256s/FAQ.md new file mode 100644 index 000000000..81dd91ef7 --- /dev/null +++ b/docs/hardware/en/ThermalCam/T256s/FAQ.md @@ -0,0 +1,84 @@ +# T256s FAQ + +This document summarizes common issues and troubleshooting methods encountered during the use of the T256s, covering power supply, imaging, temperature measurement accuracy, and software updates. + +## Power & Startup + +### Q: The screen keeps rebooting, stays black, or flickers when connected to a phone or PC. + +**A:** This is typically caused by an **insufficient power supply**. + +- When the T256s enables AI Super-Resolution (SR), the internal NPU (Neural Processing Unit) operates at high load, requiring a stable current. +- Some smartphones have limited OTG output, or the use of low-quality cables with high internal resistance can cause instantaneous voltage drops, triggering a device reset. +- **Recommendation:** Use a high-quality standard Type-C data cable. Prioritize connecting to a PC's rear USB 3.0 port or a high-capacity power bank. If using a phone, ensure the battery is sufficiently charged and "Power Saving Mode" is disabled. + +### Q: The device does not respond at all after connecting to a phone. + +**A:** Please follow these troubleshooting steps: + +1. **Enable OTG:** Some brands (e.g., OPPO, vivo, OnePlus) require you to manually enable "OTG Connection" in System Settings; it may automatically turn off after 10 minutes of inactivity. +2. **Permission Authorization:** Upon insertion, the phone should prompt for "Allow the app to access the USB device." Please check "Always allow." +3. **UVC Support:** Ensure your phone runs Android 9.0 or higher and use UVC-compatible software (such as the official Sipeed app). +4. **Cross-Verification:** Test the device on a PC or another smartphone to rule out compatibility issues specific to a single mobile terminal. +## Display & Imaging + +### Q: The image freezes briefly accompanied by a faint mechanical "clicking" sound. + +A: This is the **Non-Uniformity Correction (NUC)** process, also known as "shutter calibration." The thermal module periodically closes an internal shutter to calibrate the sensor and compensate for drift caused by temperature changes. The momentary image freeze is a normal part of the operating mechanism. + +### Q: The app displays "No Signal" or a black screen with no thermal image. + +A: Check the physical connection. If the connection is secure but there is still no image, the module may have failed to initialize or the driver is occupied. Try re-plugging the device. If the following prompt persists, please contact technical support: + +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +### Q: The image has noticeable noise, or the SR detail is not sharp enough. + +A: AI Super-Resolution (ISR) performance is affected by the environment and target characteristics: + +- **Ambient Temperature:** If the ambient temperature is too high (e.g., above 40°C), thermal noise increases significantly, affecting image purity. Recommended usage is between 15°C and 35°C. +- **Warm-up:** Thermal sensitivity reaches its peak only after the device stabilizes. It is recommended to let it run for 2–5 minutes to reach thermal equilibrium. +- **Contrast:** The smaller the temperature difference between the target and the background, the more apparent the noise will be. + +## Super-Resolution (SR) Boundary Conditions + +### Q: Why is the SR effect very obvious in some scenes but barely noticeable in others? + +A: The AI Super-Resolution (ISR) algorithm is based on deep learning to enhance edge details. Its performance depends on scene features: + +- **Ideal Scenarios:** Objects with distinct edges, lines, or complex textures (e.g., PCB traces, electronic component outlines, mechanical parts, or text). In these cases, SR significantly sharpens edges and reduces pixelation. +- **Limited Scenarios:** Large areas of uniform temperature lacking texture (e.g., flat white walls, smooth heat sinks, or the sky). Since there are no features to enhance, the visual improvement is minimal. +- **Recommendation:** To evaluate SR performance, point the device at targets with rich temperature gradients or geometric structures. + +## Temperature Accuracy + +### Q: How do I convert raw Y16 data to Celsius? + +A: The conversion formula is: `$Celsius = (Y16\_Value / 64.0) - 273.15$`. Note that accurate readings require the device to reach thermal equilibrium (approx. 2 minutes after power-on). + +### Q: Why is there a deviation between the measured value and the actual temperature? + +A: Infrared temperature accuracy is subject to interference from several physical factors: +1. **Macro Lens:** Direct impact. The addition of a macro lens introduces variable interference during infrared signal transmission and reception, leading to inherent measurement errors. +2. **Emissivity:** A critical factor. Different materials have varying capacities to radiate infrared energy. Shiny metal surfaces (e.g., aluminum foil, stainless steel) have extremely low emissivity; measuring them directly will result in incorrect "reflected temperatures." It is recommended to apply electrical tape or matte black paint to the target metal surface before measurement. +3. **Measurement Distance:** As distance increases, the physical area covered by a single pixel expands, leading to the **"Size-of-Source Effect" (SSE)**. For precision thermography, a range of 0.2m to 1.0m is recommended. For ultra-close-up shots, a dedicated macro lens must be used. +4. **Environmental Reflection:** If high-temperature objects (e.g., sunlight, soldering irons) are nearby, their radiation may reflect off the target surface into the sensor, causing inflated temperature readings. +5. **Atmospheric Compensation:** For long-distance measurements, water vapor and $CO_2$ in the air absorb infrared energy. While the T256s is primarily designed for near-field analysis (where atmospheric impact is minimal), compensation settings in professional software may be required for specialized use. + +### Q: The software recognizes the device, but the video stream won't open. + +A: 1. Ensure no other programs are occupying the UVC camera; 2. Try manually switching the resolution to 640x480; 3. Check if the system driver identifies it as "T256s" or "USB Camera." + +### Q: How do I update the firmware for better AI capabilities? + +A: T256s supports OTA updates via a PC firmware upgrade tool. Please visit the Sipeed Download Station for the latest firmware packages. Do not disconnect power during the upgrade. If an upgrade failure causes a boot loop (stuck on Logo), refer to the official "Blind Flash" recovery tutorial. + +## Miscellaneous + +### Q: Is it normal for the device to get quite hot? + +A: Yes. The T256s integrates a high-performance AI processing chip which generates heat during operation. The housing is designed to act as a heat sink. Ensure use in a well-ventilated area and avoid prolonged use in enclosed, high-temperature environments. + +### Q: Can I use it with Linux or Raspberry Pi? + +A: Yes. T256s follows the standard UVC protocol and supports Linux (V4L2). On Ubuntu or Raspberry Pi, it can be accessed directly using `cheese`, `guvcview`, or OpenCV. Please run this as the root user. The VID/PID is typically `359f:ffff`. \ No newline at end of file diff --git a/docs/hardware/en/ThermalCam/T256s/Intro.md b/docs/hardware/en/ThermalCam/T256s/Intro.md new file mode 100644 index 000000000..c634bdc8a --- /dev/null +++ b/docs/hardware/en/ThermalCam/T256s/Intro.md @@ -0,0 +1,61 @@ +# T256s Infrared Thermal Imaging: Lightweight, Plug-and-Play, AI Super-Resolution + +The Sipeed T256s is a high-efficiency, portable thermal imaging and temperature measurement terminal designed specifically for developers and field engineers. It integrates a 256×192 resolution Long-Wave Infrared (LWIR) module combined with hardware-level AI Super-Resolution (AI ISR) technology. This allows the device to upscale thermal images locally to a visual clarity equivalent to 640×480. This technology enhances edge details and texture visibility, significantly improving the localization accuracy of tiny hotspots. The device features a unibody CNC aluminum alloy chassis, a 1.69-inch capacitive touchscreen, dual Type-C interfaces, and optional macro lens support. It offers plug-and-play UVC output with both Y16 and MJPEG modes. + +## Product Overview + +The design of the T256s centers on three core pillars: **Portability, Clarity, and Ease of Use**. It is ideal for electronics R&D and repair, industrial maintenance inspections, HVAC diagnostics, and scientific research or education. Key highlights include local AI hardware super-resolution, standard UVC protocol compatibility, independent touch-based operation, flexible dual Type-C power design, precision macro detection, and a high-performance CNC aluminum housing for efficient heat dissipation. + +## Core Features + +1. **On-Device AI Hardware Super-Resolution (ISR):** Equipped with a built-in NPU hardware accelerator, the device enables a 2.5x super-resolution effect by default. Deep learning models enhance thermal clarity in real-time at the edge, effectively suppressing image noise compared to traditional interpolation algorithms. +2. **UVC Plug-and-Play:** Supports standard UVC protocols, providing two output formats: Y16 (14-bit raw temperature data) and MJPEG (pseudo-color images). No proprietary drivers are required, ensuring compatibility with mainstream operating systems and video preview software. +3. **Standalone Touch Terminal:** Featuring a 1.69-inch capacitive touchscreen, the device supports digital zoom, multi-point temperature measurement, pseudo-color switching, photo capture, and gallery browsing. It can function as an independent thermometer with just an external power supply, even when disconnected from a host PC. +4. **Flexible Dual Type-C Connectivity:** Designed with both a Type-C male connector (to connect to hosts/phones) and a Type-C female port (for external power or daisy-chaining devices) to meet diverse application requirements. +5. **Precision Macro Detection:** Supports an external macro lens (approx. 5cm working distance), allowing clear observation of tiny electronic components like 0402 packages on a PCB for rapid troubleshooting of thermal faults. +6. **All-Aluminum CNC Heat-Dissipating Chassis:** The precision CNC machining ensures structural integrity while providing **exceptional passive thermal dissipation**. This prevents thermal drift, ensuring temperature accuracy and system stability during prolonged high-load operation. + +## Technical Specifications + +| Item | Specification | +| --- | --- | +| Native Resolution | 256 × 192 @ 14-bit (Y14) | +| Super-Resolution Output | 640 × 480 (AI hardware-accelerated, 2.5×) | +| Temperature Range | -15°C to 150°C | +| Accuracy | ±2°C or ±2% of reading | +| Thermal Sensitivity (NETD) | < 50 mK @ 25°C | +| Frame Rate | 25 Hz | +| Field of View (FOV) | 56° × 42° | +| Display | 1.69-inch 240×280 capacitive touchscreen | +| Physical Interface | Type-C Male (Device) + Type-C Female (Host/Power) | +| Data Formats | Y16 (14-bit raw data), MJPEG (pseudo-color image) | +| Internal Storage | 32 MB Nand (for temporary snapshot storage) | +| Power Consumption | Standard USB 5V supply, low-power design | +| Housing Material | 6061 Aluminum Alloy, CNC Unibody | + +## Typical Application Scenarios + +- **Electronics R&D and Repair:** Perform high-precision inspections of PCB solder joints and electronic components using the standard-issue macro lens to rapidly locate hardware faults such as short circuits and current leakage. +- **Industrial Maintenance:** Routine inspection of motors, power distribution cabinets, and transformers to identify overheating hazards. +- **HVAC Inspection:** Detect building thermal leaks, underfloor heating pipe layouts, and insulation defects. +- **Scientific Research & Maker Projects:** Utilize raw Y16 data for in-depth thermal analysis or secondary development using open-source tools. + +## Visual Illustrations + + + +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) +*Product Tri-view and Dimensions* + +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) +*AI Super-Resolution Comparison (Left: Native; Right: AI ISR Enhanced)* + +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) +*PCB-level Precision Macro Detection* + +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) +*Industrial Field Inspection Example* + + + + diff --git a/docs/hardware/en/ThermalCam/T256s/QS.md b/docs/hardware/en/ThermalCam/T256s/QS.md new file mode 100644 index 000000000..c529fe027 --- /dev/null +++ b/docs/hardware/en/ThermalCam/T256s/QS.md @@ -0,0 +1,95 @@ +# Quick Start + +*This section guides you through the initial power-on and basic connection of the T256s. For detailed functional descriptions, please refer to the [User Guide (UG)](UG.md).* + +## Power Supply Instructions + +The T256s **does not have a built-in battery**. You can power the device using any of the following methods: +- **Direct Phone Connection:** Plug the device directly into the Type-C port at the bottom of your smartphone (requires OTG power support). +- **External Power:** Connect to a power bank, USB wall adapter, or a PC USB port via the Type-C male or female connectors. + +> [!IMPORTANT] +> **Power Requirements:** A stable 5V power supply is highly recommended. Insufficient power may lead to continuous reboots or screen flickering. + +## Standalone Inspection Mode + +Without connecting to a phone or computer, the T256s can function as an independent, portable thermal imager. Simply connect it to a power source to begin inspection. + +**Startup Workflow:** +1. **Power On:** Connect power via the Type-C female port; the screen will immediately light up and display the boot logo. +2. **System Loading (Approx. 3-5s):** The system automatically initializes and loads the basic UI framework. +3. **Sensor Warm-up & Calibration (Approx. 5-10s):** The **infrared module** completes its initial calibration, and the screen begins displaying real-time thermal distribution images. + +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +## UVC Online Mode + +The T256s complies with the standard **UVC (USB Video Class)** protocol. On major operating systems (Windows, Linux, Android), the device is recognized as a driverless camera, eliminating the need for additional driver installations. + +### Windows Connection +Connect the T256s to your PC via a USB data cable. +- **Device Recognition:** Open "Device Manager." Under the "Cameras" or "Imaging Devices" category, you should see a device named **"USB Camera"** or **"T256s Thermal Camera."** +- **Image Preview:** You can use the built-in Windows "Camera" app or third-party software such as OBS Studio, VLC, or PotPlayer. + +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +### Linux / Raspberry Pi Recognition +In a Linux environment, the T256s is typically mapped to a `/dev/videoX` device. +- **Recommended Tools:** Use `guvcview`, `cheese`, or `ffmpeg` for testing. +- **Log Verification:** After plugging in the device, execute the `dmesg` command in the terminal to view recognition logs. + +**Example Recognition Log (from actual device):** +```text +[102310.868452] usb 1-7.4.2: new high-speed USB device number 35 using xhci_hcd +[102310.966974] usb 1-7.4.2: New USB device found, idVendor=359f, idProduct=ffff, bcdDevice= 4.19 +[102310.966980] usb 1-7.4.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3 +[102310.966982] usb 1-7.4.2: Product: Thermal Camera (UVC) +[102310.966983] usb 1-7.4.2: Manufacturer: Sipeed Ltd. +[102310.966985] usb 1-7.4.2: SerialNumber: 0123456789 +[102310.991815] uvcvideo 1-7.4.2:1.0: Found UVC 1.00 device Thermal Camera (UVC) (359f:ffff) +[102310.998891] usb-storage 1-7.4.2:1.2: USB Mass Storage device detected +[102310.999030] scsi host8: usb-storage 1-7.4.2:1.2 +[102312.036627] scsi 8:0:0:0: Direct-Access Linux File-Stor Gadget 0419 PQ: 0 ANSI: 2 +[102312.036788] sd 8:0:0:0: Attached scsi generic sg1 type 0 +[102312.036980] sd 8:0:0:0: Power-on or device reset occurred +[102312.037313] sd 8:0:0:0: [sdb] 65536 512-byte logical blocks: (33.6 MB/32.0 MiB) +[102312.145478] sd 8:0:0:0: [sdb] Write Protect is off +[102312.145485] sd 8:0:0:0: [sdb] Mode Sense: 0f 00 00 00 +[102312.255625] sd 8:0:0:0: [sdb] Write cache: enabled, read cache: enabled, doesn't support DPO or FUA +[102312.495980] sdb: +[102312.496065] sd 8:0:0:0: [sdb] Attached SCSI removable disk +[102313.464088] usb 1-7.4.2: USB disconnect, device number 35 +[102313.493673] sd 8:0:0:0: [sdb] Synchronizing SCSI cache +[102313.493716] sd 8:0:0:0: [sdb] Synchronize Cache(10) failed: Result: hostbyte=DID_NO_CONNECT driverbyte=DRIVER_OK +[102315.740234] usb 1-7.4.2: new high-speed USB device number 36 using xhci_hcd +[102315.839493] usb 1-7.4.2: New USB device found, idVendor=359f, idProduct=ffff, bcdDevice= 4.19 +[102315.839512] usb 1-7.4.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3 +[102315.839520] usb 1-7.4.2: Product: Thermal Camera (UVC) +[102315.839526] usb 1-7.4.2: Manufacturer: Sipeed Ltd. +[102315.839530] usb 1-7.4.2: SerialNumber: 0123456789 +[102315.864161] uvcvideo 1-7.4.2:1.0: Found UVC 1.00 device Thermal Camera (UVC) (359f:ffff) +[102315.871660] usb-storage 1-7.4.2:1.2: USB Mass Storage device detected +[102315.871856] scsi host8: usb-storage 1-7.4.2:1.2 +[102316.899524] scsi 8:0:0:0: Direct-Access Linux File-Stor Gadget 0419 PQ: 0 ANSI: 2 +[102316.899837] sd 8:0:0:0: Attached scsi generic sg1 type 0 +[102316.899962] sd 8:0:0:0: Power-on or device reset occurred +[102316.900374] sd 8:0:0:0: [sdb] 65536 512-byte logical blocks: (33.6 MB/32.0 MiB) +[102317.010049] sd 8:0:0:0: [sdb] Write Protect is off +[102317.010070] sd 8:0:0:0: [sdb] Mode Sense: 0f 00 00 00 +[102317.120036] sd 8:0:0:0: [sdb] Write cache: enabled, read cache: enabled, doesn't support DPO or FUA +[102317.350047] sdb: +[102317.350175] sd 8:0:0:0: [sdb] Attached SCSI removable disk +``` + +### Android Mobile Usage +- **Connection:** OTG-compatible phones can be directly connected via the bottom interface. +- **Software:** We recommend using apps that support the UVC protocol, such as **"USB Camera."** +- **Operation:** Upon insertion, the phone will typically prompt for permission. Tap "OK" to start the thermal image preview. + +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +## Macro Lens Installation + +To observe PCB components, gently attach the included macro lens to the front of the thermal imaging module. +- **Working Distance:** Approximately 5cm. +- **Effect:** Enables clear visualization of heat distribution on tiny components, such as **0402 surface-mount resistors**. \ No newline at end of file diff --git a/docs/hardware/en/ThermalCam/T256s/UG.md b/docs/hardware/en/ThermalCam/T256s/UG.md new file mode 100644 index 000000000..858e26c5b --- /dev/null +++ b/docs/hardware/en/ThermalCam/T256s/UG.md @@ -0,0 +1,89 @@ +# User Guide (T256s) + +This guide introduces the hardware interfaces, local touch interactions, UVC data formats (MJPEG / Y16), and storage rules for the T256s. It is designed to help you quickly get started with the device for secondary development or thermal data analysis. + +## Hardware Interface Description +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +- **Type-C Male (Device) Port:** Located at the bottom of the unit. Plug this directly into a smartphone for power and data transmission. If the phone does not recognize the device, ensure **OTG Power Supply** is enabled in the system settings. +- **Type-C Female (Host/Power) Port:** Located at the top of the unit. Used for connecting to a PC, power bank, or external power cable. This is ideal for long-term monitoring or communicating with PC-side host software. +- **Touchscreen:** A 1.69-inch capacitive touchscreen (240×280) for local interaction and real-time viewing. It offers responsive control and supports multi-touch (depending on firmware version). +- **Macro Lens (Optional):** Designed for observing small-scale components on PCBs. With a working distance of approximately **5cm**, it provides a clear heat distribution map for tiny components like 0402 packages. + +Note: Avoid exposing the device to high humidity or strong electromagnetic interference. Prolonged operation in high-temperature environments may degrade temperature measurement accuracy. + +## Local Touch Interaction (Standalone Mode) +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +When not connected to a host computer, the T256s functions as a standalone thermal imager. The screen supports the following operations: + +- **Image Zoom:** Tap the center of the screen to toggle quickly between **1x and 2x zoom**. +- **Temperature Annotation:** The system automatically tracks and displays values for the **center point, maximum temperature (Hot Spot), and minimum temperature (Cold Spot)**. The interface defaults to Celsius (°C). A 2-minute warm-up is recommended for optimal accuracy. +- **Pseudo-color (Palette) Switching:** Tap the color block icon in the upper-right corner to cycle through **8 built-in palettes** (e.g., White Hot, Ironbow, Rainbow, etc.). Different palettes suit different scenarios; for instance, "White Hot" is often better for identifying subtle temperature gradients. +- **Quick Capture:** Tap the camera icon on the right-middle of the screen. The current frame will be saved to internal storage. A confirmation prompt will appear upon a successful save. +- **Gallery Preview:** Tap the gallery icon in the lower-right corner. Swipe left or right to browse photos, or use the delete button to manage storage space. + +TODO: Step-by-Step Visual Guide / Illustrations + +## UVC Data Formats & Parsing Theory +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +The T256s is UVC-compliant and supports two primary video stream outputs. Choose the appropriate format based on your development needs. + +### MJPEG Format (Preview & Display) +- **Purpose:** Standard video preview. Compatible with OBS, VLC, or the native Windows Camera app. +- **Features:** The image is processed with **on-device AI Super-Resolution (ISR)** for enhanced detail and has the built-in pseudo-color (CMAP) applied. The output resolution is typically **640×480**, balancing clarity and fluid frame rates. +- **Use Cases:** General inspection, remote monitoring, and real-time hotspot observation. +- **Limitation:** Since the image is converted to a colorized preview, you cannot extract precise temperature values directly from this stream. It is intended for visual representation only. + +### Y16 Format (Measurement & Analysis) +- **Purpose:** Essential for precision thermography or developing custom host software. It contains the **raw 14-bit pixel data** from the sensor. +- **Features:** Outputs a raw grayscale stream representing the infrared energy intensity captured by the detector. Each frame contains complete thermal information. +- **Conversion Logic:** To map raw values to temperature, use the following formula. Ensure the device has reached **thermal equilibrium** (approx. 2 minutes) for accurate readings. + - **Formula:** $Celsius = (raw\_value / 64.0) - 273.15$ + - **Example:** If the raw value is 22700, the temperature is $\approx 22700 / 64.0 - 273.15 = 81.53$ °C. + - **Note:** Pixel values in the MJPEG stream are processed and **cannot** be used with this formula. Use the Y16 raw stream for any quantitative analysis. + + + +## Storage & File Access +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +The T256s features 32 MB of internal storage. When connected to a computer via a USB cable, the device mounts as a standard Mass Storage Class (MSC) device, allowing you to access it just like a typical flash drive. Image files are generally located in the `/DCIM/` or `/Gallery/` directories. If the drive is not recognized, please try using a different data cable or USB port. + +Photo Naming Conventions: +- **Filename Metadata:** Each snapshot includes a temperature summary within its filename, following the format: `P[Index]_T[Center]_L[Min]_H[Max].jpg`. +- **Example:** `P001_T32.5_L28.2_H45.6.jpg`. This indicates that in the first captured image, the center temperature is 32.5°C, the minimum is 28.2°C, and the maximum is 45.6°C. + + +## Macro Lens Usage Tips +![占位图](../../../zh/ThermalCam/T256s/assets/no-image-signal.jpg) + +1. Gently attach the macro lens to the front of the infrared module. The module is high-precision and fragile; **do not apply excessive pressure** or scratch the lens. +2. Maintain a subject distance of approximately **5cm**. Fine-tune the focus by slightly moving the device forward or backward. Note that macro lenses have a very shallow depth of field. +3. At macro scales, local temperature gradients are magnified. Environmental fluctuations (like airflow or hand heat) can interfere with readings. Use in a draft-free indoor environment for best results. + +## Advanced: Y16 Data Parsing Example (Python) +This example demonstrates how to read pixels from a Y16 stream or raw file and convert them to Celsius. + +```python +import numpy as np +# Assume raw_array is the 14-bit raw pixel array (uint16) captured from the sensor. +def raw_to_celsius(raw_array): + # Convert raw 14-bit pixels (uint16) to float and apply formula + celsius = raw_array.astype(np.float32) / 64.0 - 273.15 + return celsius + +# Example: Read a 256x192 raw data frame from a file +raw_data = np.fromfile('frame.raw', dtype=np.uint16).reshape((192, 256)) +temp_map = raw_to_celsius(raw_data) +print(f"Center Point Temperature: {temp_map[96, 128]:.2f} °C") +``` + +Note: Methods for capturing the Y16 stream depend on your platform (e.g., OpenCV, libuvc, or GStreamer).* + +## General Precautions + +- **Warm-up:** Allow the device to reach thermal equilibrium (approx. 2 minutes) to minimize **thermal drift**. +- **Emissivity:** When measuring low-emissivity objects (like shiny metals), apply electrical tape or matte black paint to the surface. This increases the infrared radiation received by the detector, ensuring accurate data. +- **Resource Conflict:** UVC devices generally do not support multiple simultaneous connections. Ensure only one application is accessing the camera at a time. \ No newline at end of file diff --git a/docs/hardware/zh/ThermalCam/T256s/FAQ.md b/docs/hardware/zh/ThermalCam/T256s/FAQ.md index 4fa4a1232..c3ba9e3af 100644 --- a/docs/hardware/zh/ThermalCam/T256s/FAQ.md +++ b/docs/hardware/zh/ThermalCam/T256s/FAQ.md @@ -80,4 +80,4 @@ A: T256s 内部集成了高算力 AI 处理芯片，工作时产生一定热量 ### Q: 可以配合 Linux 或树莓派使用吗？ -A: 可以。T256s 遵循标准 UVC 协议，支持 Linux（V4L2）。在 Ubuntu/树莓派上可直接使用 `cheese`、`guvcview` 或 OpenCV 进行调用。设备 VID/PID 通常为 `359f:ffff`。 +A: 可以。T256s 遵循标准 UVC 协议，支持 Linux（V4L2）。在 Ubuntu/树莓派上可直接使用 `cheese`、`guvcview` 或 OpenCV 进行调用。请使用root用户运行。设备 VID/PID 通常为 `359f:ffff`。