Home Code A HDC1008 digital humidity sensor Micropython example on an ESP32

A HDC1008 digital humidity sensor Micropython example on an ESP32

by shedboy71

In this example we connect a HDC1008 digital humidity sensor to an ESP32 running Micropython

The HDC1008 is a digital humidity sensor with integrated temperature sensor that provides excellent measurement accuracy at very low power. The device measures humidity based on a novel capacitive sensor. The humidity and temperature sensors are factory calibrated. The innovative WLCSP (Wafer Level Chip Scale Package) simplifies board design with the use of an ultra-compact package. The sensing element of the HDC1008 is placed on the bottom part of the device, which makes the HDC1008 more robust against dirt, dust, and other environmental contaminants. The HDC1008 is functional within the full –40°C to +125°C temperature range.


  • Relative Humidity (RH) Operating Range 0% to
  • 14 Bit Measurement Resolution
  • Relative Humidity Accuracy ±4%
  • Temperature Accuracy ±0.2 °C
  • 200 nA Sleep Mode Current
  • Average Supply Current:
    • 820 nA @ 1sps, 11 bit RH Measurement
    • 1.2 µA @ 1sps, 11 bit RH and Temperature
  • Supply Voltage 3 V to 5 V
  • Tiny 2 mm × 1.6 mm Device Footprint
  • I2C Interface


Parts List


Name Link
ESP32 WEMOS WiFi & Bluetooth Battery ESP32 development tool ESP32 battery esp8266 ESP WROOM 32 ESP32
HDC1008 HDC1008 Digital Temperature and Humidity Sensor Breakout Board Compatible with Arduino
Connecting cables Free shipping Dupont line 120pcs 20cm male to male + male to female and female to female jumper wire



An easy module to connect to an ESP32, SCL is 22 and SDA is 21 on the Wemos board I used, you can see this is the schematic below




You can use any method to upload files or an IDE for development.

The following is based on a github library – https://github.com/kfricke/micropython-hdc1008. The first part of this is the library which I upload to my ESP32

This is the library called hdc1008.py

[codesyntax lang=”python”]

from machine import I2C
from utime import sleep_ms

REG_TEMP = const(0x00)
REG_HUMI = const(0x01)
REG_CFG = const(0x02)
REG_SER_ID1 = const(0xfb)
REG_SER_ID2 = const(0xfc)
REG_SER_ID3 = const(0xfd)

CFG_RST = const(0b10000000)
CFG_HEAT_ON = const(0b100000)
CFG_HEAT_OFF = const(0b0)
CFG_MODE_SINGLE = const(0b0)
CFG_MODE_BOTH = const(0b10000)
CFG_BTST = const(0b1000)
CFG_TEMP_14BIT = const(0b0)
CFG_TEMP_11BIT = const(0b100)
CFG_HUMI_14BIT = const(0b0)
CFG_HUMI_11BIT = const(0b1)
CFG_HUMI_8BIT = const(0b10)

RES_8_BIT  = const(1)
RES_11_BIT = const(2)
RES_14_BIT = const(3)

class HDC1008(object):
    def __init__(self, i2c, addr=0x40, heater=False):
        if i2c == None or i2c.__class__ != I2C:
            raise ValueError('I2C object needed as argument!')
        self._i2c = i2c
        self._addr = addr
        self._heater = heater
        self._tmp = bytearray(4)
        # Read the sensor serial ID
        self.serial = 0
        self._recv(self._tmp, 2)
        self.serial += (self._tmp[0] << 32) + (self._tmp[1] << 24)
        self._recv(self._tmp, 2)
        self.serial += (self._tmp[0] << 16) + (self._tmp[1] << 8)
        self._recv(self._tmp, 2)
        self.serial += self._tmp[0]

    def _send_byte(self, b):
        self._tmp[0] = b
        self._i2c.writeto(self._addr, self._tmp[0:1])

    def _send_bytes(self, b):
        self._i2c.writeto(self._addr, b)
    def _recv(self, buf, c):
        buf[0:c] = self._i2c.readfrom(self._addr, c)

    def _config(self, reg=None):
        if reg is None:
            self._recv(self._tmp, 2)
            return self._tmp[0:2]
            if self._heater:
                reg = reg | CFG_HEAT_ON
            self._tmp[0] = REG_CFG
            self._tmp[1] = reg
            self._tmp[2] = 0 

    def heater(self, s=None):
        if s is not None:
            if s.__class__ != bool:
                raise ValueError('Heater state must be a boolean value or None!')
                self._heater = s
            return self._heater

    def battery_low(self):
        # one read command needed to have the config register defined, where 
        # we can read this flag from
        return (self._config()[0] & CFG_BTST) == CFG_BTST

    def reset(self):
        self._tmp[0] = REG_CFG
        self._tmp[1] = CFG_RST
        self._tmp[2] = 0 

    def _raw_temp(self, acc):
        self._config(CFG_MODE_SINGLE | acc)
        self._recv(self._tmp, 2)
        return self._tmp[1] + (self._tmp[0] << 8)
    def temp(self, acc=CFG_TEMP_14BIT):
        return (self._raw_temp(acc) / 65536) * 165 - 40
    def _raw_humi(self, acc):
        self._config(CFG_MODE_SINGLE | acc)
        self._recv(self._tmp, 2)
        return self._tmp[1] + (self._tmp[0] << 8)
    def humi(self, acc=CFG_HUMI_14BIT):
        return (self._raw_humi(acc) / 65536.0) * 100.0

    def _raw_temp_humi(self, t_acc, h_acc):
        self._config(CFG_MODE_BOTH | t_acc | h_acc)
        self._recv(self._tmp, 4)
        return (self._tmp[1] + (self._tmp[0] << 8), self._tmp[3] + (self._tmp[2] << 8))

    def temp_humi(self, t_acc=CFG_TEMP_14BIT, h_acc=CFG_HUMI_14BIT):
        (raw_temp, raw_humi) = self._raw_temp_humi(t_acc, h_acc)
        return (((raw_temp / 65536) * 165) - 40, (raw_humi / 65536) * 100.0)


I upload this file to my ESP32 and now in main.py I copy the following code in

[codesyntax lang=”python”]

import machine
    import esp
    i2c = machine.I2C(sda=machine.Pin(4), scl=machine.Pin(5))
    import pyb
    i2c = machine.I2C(sda=machine.Pin('X10'), scl=machine.Pin('X9'), freq=400000)
import utime
from hdc1008 import HDC1008

hdc = HDC1008(i2c)
print("Sensor ID: %s" % (hex(hdc.serial)))

def read_sensors():
    print("Temperature (degree celsius): %.2f" % (hdc.temp()))
    print("Relative humidity (percent):  %.2f" % (hdc.humi()))
    print("Both sensors read at once:    %.2f  %.2f" % hdc.temp_humi())
    print("Battery low: %s" % (hdc.battery_low()))

print("Reading sensors 10 times using idle sleeping...")
for i in range(10):




Open up the REPL window. Here is what I saw in uPyCraft

Ready to download this file,please wait!
download ok
Sensor ID: 0x224f67673
Reading sensors 10 times using idle sleeping…
Temperature (degree celsius): 22.99
Relative humidity (percent): 33.60
Both sensors read at once: 23.01 33.60
Battery low: False
Temperature (degree celsius): 23.01
Relative humidity (percent): 33.60
Both sensors read at once: 22.99 33.60
Battery low: False
Temperature (degree celsius): 22.99
Relative humidity (percent): 33.50
Both sensors read at once: 22.99 33.50
Battery low: False
Temperature (degree celsius): 22.99
Relative humidity (percent): 33.50
Both sensors read at once: 22.99 33.50
Battery low: False
Temperature (degree celsius): 22.97
Relative humidity (percent): 33.50
Both sensors read at once: 22.96 33.50
Battery low: False



You may also like

Leave a Comment