Crate topdon_thermal_rs 

A Rust library to interface with the TOPDON TC001 thermal camera.

This library provides a high-level interface to find the camera by its USB ID, configure it for raw data streaming, and read frames. It offers simple methods to process the raw data into displayable BGR (visual) and colormapped (thermal) images.

Prerequisites

• A Linux-based operating system (the device discovery relies on the /sys filesystem).
• The TOPDON TC001 camera (or similar) connected.
• Required system libraries for opencv (e.g., libopencv-dev).

Example

Here is a complete example of how to use the library to open the camera and display both video streams.

// main.rs
use opencv::core::{min_max_loc, no_array};
use anyhow::Result;
use opencv::{highgui, prelude::*};
use topdon_thermal_rs::{Colormap, ThermalCamera};
use std::str::FromStr;

fn main() -> Result<()> {


// Final target resolution for the processed thermal image
    const THERMAL_WIDTH: i32 = 512;
    const THERMAL_HEIGHT: i32 = 384;

    // USB ID for the camera
    const VENDOR_ID: u16 = 0x0bda;
    const PRODUCT_ID: u16 = 0x5830;

    const TEMP_SCALE_FACTOR: f64 = 60.0;
    const COLORMAP: &str = "JET";
    const BLUR_RADIUS: u32 = 10;
    const CONTRAST: f64 = 1.0;

    // Initialize the camera using the library
    let mut camera = ThermalCamera::new(VENDOR_ID, PRODUCT_ID)?;

    highgui::named_window("Visual", highgui::WINDOW_AUTOSIZE)?;
    highgui::named_window("Thermal", highgui::WINDOW_AUTOSIZE)?;

    println!("📷 Camera initialized. Press 'q' or ESC in a camera window to exit.");

    loop {
        // 1. Read the raw frame data
        match camera.read_frame() {
            Ok(frame_data) => {
                // 2. Get the processed BGR visual image from the frame
                if let Ok(visual) = frame_data.visual_bgr() {
                    highgui::imshow("Visual", &visual)?;
                }

                // 3. Get the processed colormapped thermal image from the frame
                let colormap = Colormap::from_str(COLORMAP)?;
                if let Ok(thermal) = frame_data.thermal_colormapped(THERMAL_WIDTH, THERMAL_HEIGHT, Some(colormap), BLUR_RADIUS, CONTRAST) {
                    highgui::imshow("Thermal", &thermal)?;
                }
                // 4. Get the absolute temperature data
                if let Ok(temps) = frame_data.temperatures(THERMAL_WIDTH, THERMAL_HEIGHT, TEMP_SCALE_FACTOR) {
                    let mut min_temp = 0.0;
                    let mut max_temp = 0.0;
                    min_max_loc(&temps, Some(&mut min_temp), Some(&mut max_temp), None, None, &no_array())?;

                    if let Ok(avg_temp) = frame_data.average_temperature(TEMP_SCALE_FACTOR) {
                        print!("\rAvg: {:.2}°C, Min: {:.2}°C, Max: {:.2}°C   ", avg_temp, min_temp, max_temp);
                    }
                }
            }
            Err(e) => {
                eprintln!("Error reading frame: {}. Exiting.", e);
                break;
            }
        }

        // Wait for a key press
        let key = highgui::wait_key(10)?;
        if key == 'q' as i32 || key == 27 {
            break;
        }
    }

    Ok(())
}

Structs

RoiAnalysis

Holds the temperature analysis results for a specific Region of Interest (ROI).

ThermalCamera

Represents the thermal camera device.

ThermalCameraBuilder

ThermalFrame

Represents a single frame captured from the camera, containing raw visual and thermal data.

Enums

Colormap

Represents the available OpenCV colormaps for thermal imaging.