1. Introducció
This manual provides detailed instructions for the setup, operation, and maintenance of the Waveshare MLX90640 IR Array Thermal Imaging Camera Module. This module features a 32×24 pixel far-infrared thermal sensor array and communicates via an I2C interface, making it suitable for integration with various microcontrollers such as Raspberry Pi, Arduino (ESP32), and STM32.
Si us plau, llegiu aquest manual detingudament abans d'utilitzar el producte per garantir-ne el funcionament correcte i evitar danys.
2. Producte acabatview i Característiques
The MLX90640 Thermal Camera Module is designed for thermal imaging applications, offering a compact and efficient solution for temperature detection and visualization.

Figura 2.1: Davant view of the MLX90640 Thermal Camera Module, showing the infrared lens and connector.
Característiques principals:
- Sensor Array: Adopts MLX90640 far-infrared thermal sensor array with 32×24 pixels.
- Camp de View: camp de 55° view for comprehensive thermal detection.
- Interfície: Communicates via I2C interface, configurable to fast mode (up to 1MHz data rate).
- Sensibilitat a la temperatura: Noise Equivalent Temperature Difference (NETD) of 0.1K RMS @1Hz refresh rate.
- Voltage Compatibilitat: Vol a bordtage traductor, compatible amb volums operatius de 3.3V / 5Vtage.
- Compatibilitat: Designed for use with Raspberry Pi, Arduino (ESP32), and STM32 platforms.

Figura 2.2: A baix view of the MLX90640 Thermal Camera Module, showing the Waveshare branding and model information.
3. Informació de seguretat
- Descàrrega electrostàtica (ESD): Handle the module with care to prevent damage from electrostatic discharge. Use anti-static precautions.
- Font d'alimentació: Assegureu-vos que la font d'alimentació voltage is within the specified range (3.3V/5V). Incorrect voltagPots danyar el mòdul.
- Connexions: Always double-check wiring connections before applying power to avoid short circuits or incorrect operation.
- Entorn de funcionament: Avoid exposing the module to extreme temperatures, humidity, or corrosive environments.
- Cura de les lents: Do not touch the infrared lens directly. Clean only with a soft, lint-free cloth if necessary.
4. Guia de configuració
4.1. Descripció del pinout
The MLX90640 module uses an I2C interface for communication. The typical pin connections are as follows:
- VCC: Power supply input (3.3V or 5V).
- GND: Connexió a terra.
- SDA: I2C Serial Data Line.
- SCL: I2C Serial Clock Line.

Figura 4.1: MLX90640 module with typical jumper wire connections for integration.
4.2. Connecting to a Microcontroller (e.g., Raspberry Pi)
- Connexió d'alimentació: Connect the VCC pin of the MLX90640 module to the 3.3V or 5V power output of your microcontroller. Connect the GND pin to the microcontroller's ground.
- Connexió I2C: Connect the SDA pin of the MLX90640 module to the SDA pin of your microcontroller. Connect the SCL pin of the MLX90640 module to the SCL pin of your microcontroller. Refer to your specific microcontroller's documentation for I2C pin assignments.
- Configuració del programari: Install necessary libraries and drivers for the MLX90640 sensor on your chosen platform (Raspberry Pi, Arduino, STM32). Waveshare provides development resources and example code for these platforms.
For detailed software setup and programming examples, please refer to the official Waveshare documentation and development resources provided with the module.
5. Instruccions de funcionament
5.1. Adquisició de dades
Once the module is correctly connected and the software environment is set up, you can begin acquiring thermal data. The MLX90640 sensor provides a 32×24 array of temperature readings, which can be processed to generate a thermal image.
- Comunicació I2C: The module communicates via I2C. Ensure your microcontroller's I2C bus is configured correctly and operating at the desired speed (up to 1MHz for fast mode).
- Velocitat de fotogrames: The sensor can provide data at various refresh rates. The Noise Equivalent Temperature Difference (NETD) of 0.1K RMS is specified at a 1Hz refresh rate. Higher refresh rates may affect NETD.
- Dades de calibratge: The MLX90640 sensor requires internal calibration data to be read and applied for accurate temperature measurements. This is typically handled by the provided software libraries.
5.2. Thermal Imaging Example
The module can be used to visualize temperature distributions, as shown in the example below with a Raspberry Pi.

Figura 5.1: Un example setup demonstrating the MLX90640 module capturing a thermal image of a Raspberry Pi, displaying temperature variations.
The software will typically convert the raw sensor data into a temperature matrix, which can then be rendered as a color-coded thermal image, where different colors represent different temperature ranges.
6. Manteniment
- Neteja: Keep the module clean and free from dust. Use a soft, dry, lint-free cloth to gently wipe the module. Avoid using liquids or abrasive cleaners.
- Neteja de lents: The infrared lens is sensitive. If cleaning is absolutely necessary, use a lens cleaning cloth or a soft brush designed for optical components. Do not apply pressure.
- Emmagatzematge: When not in use, store the module in an anti-static bag in a dry, cool environment, away from direct sunlight and extreme temperatures.
- Actualitzacions de firmware: Consulteu periòdicament el lloc web oficial de Waveshare website or development resources for any firmware updates or software library improvements.
7. Solució De Problemes
- Problem: Module not detected by microcontroller.
- Solució:
- Verify all wiring connections (VCC, GND, SDA, SCL) are correct and secure.
- Assegureu-vos que la font d'alimentació voltage is within the 3.3V/5V range.
- Check if the I2C bus is enabled and configured correctly on your microcontroller.
- Confirm the I2C address of the MLX90640 module (usually fixed, but check documentation).
- Problem: Incorrect or noisy temperature readings.
- Solució:
- Ensure the lens is clean and unobstructed.
- Verify that the correct calibration data is being applied by your software.
- Check for electromagnetic interference in the operating environment.
- Confirm the refresh rate setting; higher rates might introduce more noise if not handled correctly.
- Problem: Software examples fail to compile or run.
- Solució:
- Ensure all required libraries are installed and correctly linked in your development environment.
- Verify that your microcontroller's operating system or firmware is compatible with the provided examples.
- Check for any specific hardware configurations or jumpers required by the examples.
8. Especificacions
| Característica | Detall |
|---|---|
| Matriu de sensors | MLX90640 Far-Infrared Thermal Sensor |
| Resolució | 32 × 24 píxels |
| Camp de View (FoV) | 55° |
| Interfície | I2C (up to 1MHz Fast Mode) |
| Diferència de temperatura equivalent al soroll (NETD) | 0.1K RMS @1Hz refresh rate |
| Vol. Operatiutage | 3.3V / 5V (compatible) |
| Dispositius compatibles | Raspberry Pi, Arduino (ESP32), STM32 |
| Dimensions del producte | 1.1 x 0.63 x 1.1 polzades (aprox. 28 x 16 x 28 mm) |
| Pes de l'article | 0.317 unces |

Figura 8.1: Dimensional drawing of the MLX90640 Thermal Camera Module (dimensions in millimeters).
9. Garantia i Suport
This Waveshare product is covered by standard manufacturer warranty. For specific warranty terms and conditions, please refer to the official Waveshare weblloc o poseu-vos en contacte amb el seu servei d'atenció al client.
Suport tècnic: Waveshare provides comprehensive development resources and manuals, including examples for Raspberry Pi, Arduino (ESP32), and STM32. These resources are essential for successful integration and operation of the module.
For further assistance, please visit the official Waveshare support page or contact their technical support team directly.





