Is SGP30 TVOC & eCO2 Air Quality Sensor Compatible with Home Assistant (MicroPython)?

Verdict Badge

VERDICT: [ COMPATIBLE (MANUAL CONFIG REQUIRED) ]

Protocol: I2C Bus / 3.3V

Bridge Needed: NO

Hardware Safety & Electrical Verification

Electrical parameters & logic voltage safety limits before powering ICs

🟢 3.3V Native Direct Hookup 🧪 Verified in Lab

Power Input 5V DC via USB-C / VBUS

GPIO Logic Voltage 3.3V Logic Level — Level Shifter Required for 5V peripherals

Current Profile Peak Tx Current: ~180mA to ~250mA @ 3.3V

Ingress Protection None (Exposed Board — Enclosure Required)

## Compatibility Overview

Multi-pixel gas sensor measuring total volatile organic compounds (TVOC) and equivalent CO2 for indoor air purification.

Interactive Pinout & Wiring Diagram

Hover over any pin to view voltage limits and pull-up specifications

VCC

3.3V Power

GND

Ground Common

SDA / TX

Data Line (GPIO 21)

SCL / RX

Clock Line (GPIO 22)

CS / INT

Chip Select (GPIO 19)

## Technical Specification Matrix

Feature / Attribute	Specification / Status
Hardware Protocol	I2C Bus / 3.3V
Bridge Required	NO
Border Router Needed	None
Hardware Capabilities & Peripherals	TVOC (ppb) eCO2 (ppm) Air Quality Index Note: Exposing entities to Home Assistant requires corresponding YAML component config.
Pairing Complexity	Intermediate
Factory Reset Instruction	Hold BOOTSEL button while inserting USB power.

## Step-by-Step Pairing Guide

Factory Reset Device

Hold BOOTSEL button while inserting USB power.

Initialize Pairing Mode on Home Assistant (MicroPython)

Open Home Assistant (MicroPython) administration console, navigate to Integrations / Add Device, and start pairing scanner.

Confirm Entity Binding & State Verification

Verify that primary entities (TVOC (ppb), eCO2 (ppm), Air Quality Index) report live state changes inside Home Assistant (MicroPython).

Production Code Generator & Preset Toolkit

Pre-configured pinouts & drivers for SGP30 TVOC & eCO2 Air Quality Sensor

SDA Pin: SCL Pin:

Test in Wokwi Simulator ↗ | Real-time pin binding active

👥 Community Verified Database Continuous hardware testing updates

Report a Pinout Error or Submit Tested Code Snippets

Found a pin mapping quirk or built a custom ESPHome YAML driver for SGP30 TVOC & eCO2 Air Quality Sensor? Help us keep this matrix 100% accurate.

## Frequently Asked Questions

Does this device operate in Offline Mode?

100% local I2C sensor telemetry over Wi-Fi.

What is the expected Battery Life & Power specification?

3.3V VCC I2C0 (SDA=GPIO4 SCL=GPIO5).

How does Signal Mesh & Range Extension function?

Wi-Fi 802.11n.

Related Compatibility Matrix Guides

I2C Bus / 3.3V