Raspberry Pi & HDC2010: A Complete I2C Temperature & Humidity Sensor Setup Guide

Raspberry Pi & HDC2010: A Complete I2C Temperature & Humidity Sensor Setup Guide

This guide covers how to integrate the Texas Instruments HDC2010 high‑precision temperature and humidity sensor with any Raspberry Pi model, from Pi 4 to Pi Zero W. The instructions are based on a Debian‑based OS and Python 2.7, but they work unchanged on newer Python 3 installations.

About the HDC2010

The HDC2010 is a digital sensor that delivers:

• Relative humidity range: 0 % – 100 %
• Humidity accuracy: ± 2 % (factory calibrated)
• Temperature range: – 40 °C to + 125 °C (functional) and – 40 °C to + 80 °C (operational)
• Temperature accuracy: ± 0.2 °C (factory calibrated)
• Built‑in heating element to evaporate condensation

For full technical details, see the datasheet.

s‑Sense HDC2010 Sensor Breakout by itbrainpower.net

Part number: SS‑HDC2010#I2C SKU: ITBP‑6005

Optional Combo: HDC2010 + CCS811

Part number: SS‑HDC2010+CCS811#I2C SKU: ITBP‑6006

Both breakout boards use the same I²C interface and can be wired identically. This guide focuses on the single‑sensor board; the combo board follows the same steps.

Prerequisites – Raspberry Pi Setup

1. Enable the I²C bus
   1. Run sudo raspi-config.
   2. Navigate to Interface Options → I2C, enable it, and reboot.
2. Verify the driver

   After reboot, ls /dev/*i2c* should list /dev/i2c‑1.

3. Confirm sensor presence

   Connect the breakout and run i2cdetect -y 1. The sensor should appear at address 0x40.

4. Install Python dependencies
   1. sudo apt-get install python-setuptools
   2. Download smbus2‑0.3.0.
   3. tar -xf smbus2-0.3.0.tar.gz
   4. cd smbus2-0.3.0
   5. sudo python setup.py install

Hardware Wiring

All Raspberry Pi models share the same I²C pins, but we’ll list the pin numbers for clarity. Use the GPIO.setmode(GPIO.BOARD) convention.

All Pi models support the same wiring, so you can use the same schematic for Pi 4, 3B+, 3B, 3A+, 2B, B, Zero, and Zero W.

Software – Reading the Sensor

1. Download the HDC2010 Raspberry Pi Python library.
2. Extract the archive and navigate to the newly created folder.
3. Copy the hdc2010_simple.py script into the library directory.
4. Open hdc2010_param.py to confirm the default I²C address (0x40) matches your hardware.
5. Run the sample with python hdc2010_simple.py and observe temperature and humidity readings.

For advanced usage, consult the library’s documentation or modify the script to log data or integrate with MQTT.

Source: Basic IoT – Raspberry Pi HDC2010 how to