Skip to content

README.md

Latest commit

 

History

History
62 lines (47 loc) · 2.15 KB

README.md

File metadata and controls

62 lines (47 loc) · 2.15 KB

OpenP3 - Unofficial Thermal Master P3 Linux Driver

OpenP3 is a reverse-engineered, open-source driver and viewer for the Thermal Master P3 thermal camera (Android USB-C version).

The P3 camera uses a proprietary USB handshake that prevents it from working with standard UVC drivers. This project implements the specific handshake sequence to unlock the device and visualize the thermal stream on Linux.

image

Features

  • 🔓 Unlocks the P3: Performs the 8-step initialization handshake.
  • 🌡️ Live Viewer: Real-time thermal view with customizable color palettes.
  • 🎯 Measurement: Automatic Min/Max temperature tracking and mouse-over temperature spot check.
  • 🐍 Pure Python: No kernel compilation required, runs in user space.

Requirements

  • Linux (tested on Ubuntu/Arch)
  • Python 3.x
  • libusb

Installation

  1. Clone the repository:

    git clone [https://github.com/YOUR_USERNAME/OpenP3.git](https://github.com/YOUR_USERNAME/OpenP3.git)
cd OpenP3

  2. Install dependencies:

    pip install -r requirements.txt

  3. Setup Permissions (udev rules): To access the USB device without root privileges (highly recommended):

    sudo cp 99-thermal-p3.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger

    Note: Unplug and replug the camera after this step.

Usage

Simply run the main script:

python p3_app.py

Controls

  • [q]: Quit application
  • [c]: Cycle color palettes (Inferno, Jet, Hot, Bone)
  • Mouse Hover: Shows the temperature at the cursor location.

Technical Details

  • Vendor ID: 0x3474
  • Product ID: 0x45a2
  • Protocol: The camera requires a sequence of 8 control transfers (Request 32) to Interface 0, followed by a specific Start Command (Request 238) to Interface 1.

Disclaimer

This project is not affiliated with Thermal Master. It is a reverse-engineering effort created for interoperability purposes. Use at your own risk.

License

MIT License