mirror of
https://github.com/sipeed/sipeed_wiki.git
synced 2026-09-11 00:22:49 -05:00
文档同步
This commit is contained in:
compile-js
84
docs/hardware/en/ThermalCam/T256s/FAQ.md
Normal file
84
docs/hardware/en/ThermalCam/T256s/FAQ.md
Normal file
@@ -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:
|
||||
|
||||
|
||||
|
||||
### 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`.
|
||||
61
docs/hardware/en/ThermalCam/T256s/Intro.md
Normal file
61
docs/hardware/en/ThermalCam/T256s/Intro.md
Normal file
@@ -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
|
||||
|
||||
|
||||
|
||||
|
||||
*Product Tri-view and Dimensions*
|
||||
|
||||
|
||||
*AI Super-Resolution Comparison (Left: Native; Right: AI ISR Enhanced)*
|
||||
|
||||
|
||||
*PCB-level Precision Macro Detection*
|
||||
|
||||
|
||||
*Industrial Field Inspection Example*
|
||||
|
||||
|
||||
|
||||
|
||||
95
docs/hardware/en/ThermalCam/T256s/QS.md
Normal file
95
docs/hardware/en/ThermalCam/T256s/QS.md
Normal file
@@ -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.
|
||||
|
||||
|
||||
|
||||
## 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.
|
||||
|
||||
|
||||
|
||||
### 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.
|
||||
|
||||
|
||||
|
||||
## 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**.
|
||||
89
docs/hardware/en/ThermalCam/T256s/UG.md
Normal file
89
docs/hardware/en/ThermalCam/T256s/UG.md
Normal file
@@ -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
|
||||
|
||||
|
||||
- **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)
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
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.
|
||||
@@ -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`。
|
||||
|
||||
Reference in New Issue
Block a user