I2CDEVICES.md
Tasmota supports several I2C devices. To use them I2C and the device need to be enabled at compile time. I2C and some devices are supported also in the official releases. Devices can be de/-actived on runtime to solve possible address conflicts. (e.g. address 0x27 is used by multiple devices)
Using command I2cDriver individual drivers can be enabled or disabled at runtime allowing duplicate I2C addresses at compile time. Use the Index from the table below to control I2C drivers like I2cDriver10 0 for disabling BMP support.
The following table lists the supported I2C devices
| Index | Define | Driver | Device | Address(es) | Bus2 | Description |
|---|---|---|---|---|---|---|
| 1 | USE_PCA9685 | xdrv_15 | PCA9685 | 0x40 - 0x47 | Yes | 16-channel 12-bit pwm driver |
| 1 | USE_PCA9685_V2 | xdrv_15 | PCA9685 | 0x40 - 0x47 | Yes | 16-channel 12-bit pwm driver |
| 2 | USE_PCF8574 | xdrv_28 | PCF8574 | 0x20 - 0x26 | Yes | 8-bit I/O expander (address range overridable) |
| 2 | USE_PCF8574 | xdrv_28 | PCF8574A | 0x39 - 0x3F | Yes | 8-bit I/O expander (address range overridable) |
| 3 | USE_DISPLAY_LCD | xdsp_01 | 0x27, 0x3F | Yes | LCD display | |
| 4 | REMOVED | USE_DISPLAY_SSD1306 - REMOVED | ||||
| 5 | USE_DISPLAY_MATRIX | xdsp_03 | HT16K33 | 0x70 - 0x77 | 8x8 led matrix | |
| 6 | REMOVED | SH1106 | 0x3C - 0x3D | USE_DISPLAY_SH1106 - REMOVED | ||
| 7 | USE_ADE7953 | xnrg_07 | ADE7953 | 0x38 | Energy monitor | |
| 8 | USE_SHT | xsns_07 | SHT1X | Any | Temperature and Humidity sensor | |
| 9 | USE_HTU | xsns_08 | HTU21 | 0x40 | Yes | Temperature and Humidity sensor |
| 9 | USE_HTU | xsns_08 | SI7013 | 0x40 | Yes | Temperature and Humidity sensor |
| 9 | USE_HTU | xsns_08 | SI7020 | 0x40 | Yes | Temperature and Humidity sensor |
| 9 | USE_HTU | xsns_08 | SI7021 | 0x40 | Yes | Temperature and Humidity sensor |
| 10 | USE_BMP | xsns_09 | BMP085 | 0x76 - 0x77 | Yes | Pressure and temperature sensor |
| 10 | USE_BMP | xsns_09 | BMP180 | 0x76 - 0x77 | Yes | Pressure and temperature sensor |
| 10 | USE_BMP | xsns_09 | BMP280 | 0x76 - 0x77 | Yes | Pressure and temperature sensor |
| 10 | USE_BMP | xsns_09 | BME280 | 0x76 - 0x77 | Yes | Pressure, temperature and humidity sensor |
| 10 | USE_BMP | xsns_09 | BME680 | 0x76 - 0x77 | Yes | Pressure, temperature, humidity and gas sensor |
| 11 | USE_BH1750 | xsns_10 | BH1750 | 0x23, 0x5C | Yes | Ambient light intensity sensor |
| 12 | USE_VEML6070 | xsns_11 | VEML6070 | 0x38 - 0x39 | Ultra violet light intensity sensor | |
| 13 | USE_ADS1115 | xsns_12 | ADS1115 | 0x48 - 0x4B | Yes | 4-channel 16-bit A/D converter |
| 14 | USE_INA219 | xsns_13 | INA219 | 0x40, 0x41, 0x44, 0x45 | Low voltage current sensor | |
| 15 | USE_SHT3X | xsns_14 | SHT3X | 0x44 - 0x45 | Yes | Temperature and Humidity sensor |
| 15 | USE_SHT3X | xsns_14 | SHT4X | 0x44 - 0x46 | Yes | Temperature and Humidity sensor |
| 15 | USE_SHT3X | xsns_14 | SHTCX | 0x70 | Yes | Temperature and Humidity sensor |
| 16 | USE_TSL2561 | xsns_16 | TSL2561 | 0x29, 0x39, 0x49 | Light intensity sensor | |
| 17 | USE_MGS | xsns_19 | Grove | 0x04 | Multichannel gas sensor | |
| 18 | USE_SGP30 | xsns_21 | SGP30 | 0x58 | Yes | Gas (TVOC) and air quality sensor |
| 19 | USE_SI1145 | xsns_24 | SI1145 | 0x60 | Yes | Ultra violet index and light sensor |
| 19 | USE_SI1145 | xsns_24 | SI1146 | 0x60 | Yes | Ultra violet index and light sensor |
| 19 | USE_SI1145 | xsns_24 | SI1147 | 0x60 | Yes | Ultra violet index and light sensor |
| 20 | USE_LM75AD | xsns_26 | LM75AD | 0x48 - 0x4F | Yes | Temperature sensor |
| 21 | USE_APDS9960 | xsns_27 | APDS9960 | 0x39 | Proximity ambient light RGB and gesture sensor | |
| 22 | USE_MCP230xx | xsns_29 | MCP23008 | 0x20 - 0x26 | Yes | 8-bit I/O expander |
| 22 | USE_MCP230xx | xsns_29 | MCP23017 | 0x20 - 0x26 | Yes | 16-bit I/O expander |
| 23 | USE_MPR121 | xsns_30 | MPR121 | 0x5A - 0x5D | Proximity capacitive touch sensor | |
| 24 | USE_CCS811 | xsns_31 | CCS811 | 0x5A | Yes | Gas (TVOC) and air quality sensor |
| 24' | USE_CCS811_V2 | xsns_31 | CCS811 | 0x5A - 0x5B | Gas (TVOC) and air quality sensor | |
| 25 | USE_MPU6050 | xsns_32 | MPU6050 | 0x68 - 0x69 | 3-axis gyroscope and temperature sensor | |
| 26 | USE_DS3231 | xsns_33 | DS1307 | 0x68 | Yes | Real time clock |
| 26 | USE_DS3231 | xsns_33 | DS3231 | 0x68 | Yes | Real time clock |
| 27 | USE_MGC3130 | xsns_36 | MGC3130 | 0x42 | Electric field sensor | |
| 28 | USE_MAX44009 | xsns_41 | MAX44009 | 0x4A - 0x4B | Ambient light intensity sensor | |
| 29 | USE_SCD30 | xsns_42 | SCD30 | 0x61 | Yes | CO2 sensor |
| 30 | USE_SPS30 | xsns_44 | SPS30 | 0x69 | Particle sensor | |
| 31 | USE_VL53L0X | xsns_45 | VL53L0X | 0x29 | Time-of-flight (ToF) distance sensor | |
| 32 | USE_MLX90614 | xsns_46 | MLX90614 | 0x5A | Infra red temperature sensor | |
| 33 | USE_CHIRP | xsns_48 | CHIRP | 0x20 | Soil moisture sensor | |
| 34 | USE_PAJ7620 | xsns_50 | PAJ7620 | 0x73 | Gesture sensor | |
| 35 | USE_INA226 | xsns_54 | INA226 | 0x40, 0x41, 0x44, 0x45 | Low voltage current sensor | |
| 36 | USE_HIH6 | xsns_55 | HIH6130 | 0x27 | Temperature and Humidity sensor | |
| 37 | USE_24C256 | xdrv_10 | 24C256 | 0x50 | Scripter EEPROM storage | |
| 38 | USE_DISPLAY_ILI9488 | xdsp_08 | FT6236 | 0x38 | Touch panel controller | |
| 39 | USE_DISPLAY_RA8876 | xdsp_10 | FT5316 | 0x38 | Touch panel controller | |
| 40 | USE_TSL2591 | xsns_57 | TSL2591 | 0x29 | Light intensity sensor | |
| 41 | USE_DHT12 | xsns_58 | DHT12 | 0x5C | Temperature and humidity sensor | |
| 42 | USE_DS1624 | xsns_59 | DS1621 | 0x48 - 0x4F | Temperature sensor | |
| 42 | USE_DS1624 | xsns_59 | DS1624 | 0x48 - 0x4F | Temperature sensor | |
| 43 | USE_AHT1x | xsns_63 | AHT10/15 | 0x38 - 0x39 | Temperature and humidity sensor | |
| 43 | USE_AHT2x | xsns_63 | AHT20 | 0x38 | Temperature and humidity sensor | |
| 43 | USE_AHT2x | xsns_63 | AM2301B | 0x38 | Temperature and humidity sensor | |
| 44 | USE_WEMOS_MOTOR_V1 | xdrv_34 | 0x2D - 0x30 | WEMOS motor shield v1.0.0 (6612FNG) | ||
| 45 | USE_HDC1080 | xsns_65 | HDC1080 | 0x40 | Temperature and Humidity sensor | |
| 46 | USE_IAQ | xsns_66 | IAQ | 0x5a | Yes | Air quality sensor |
| 47 | USE_DISPLAY_SEVENSEG | xdsp_11 | HT16K33 | 0x70 - 0x77 | Seven segment LED | |
| 48 | USE_AS3935 | xsns_67 | AS3935 | 0x03 | Franklin Lightning Sensor | |
| 49 | USE_VEML6075 | xsns_70 | VEML6075 | 0x10 | UVA/UVB/UVINDEX Sensor | |
| 50 | USE_VEML7700 | xsns_71 | VEML7700 | 0x10 | Ambient light intensity sensor | |
| 51 | USE_MCP9808 | xsns_72 | MCP9808 | 0x18 - 0x1F | Temperature sensor | |
| 52 | USE_HP303B | xsns_73 | HP303B | 0x76 - 0x77 | Pressure and temperature sensor | |
| 53 | USE_MLX90640 | xdrv_43 | MLX90640 | 0x33 | IR array temperature sensor | |
| 54 | USE_VL53L1X | xsns_77 | VL53L1X | 0x29 | Time-of-flight (ToF) distance sensor | |
| 55 | USE_EZOPH | xsns_78 | EZOPH | 0x61 - 0x70 | pH sensor | |
| 55 | USE_EZOORP | xsns_78 | EZOORP | 0x61 - 0x70 | ORP sensor | |
| 55 | USE_EZORTD | xsns_78 | EZORTD | 0x61 - 0x70 | Temperature sensor | |
| 55 | USE_EZOHUM | xsns_78 | EZOHUM | 0x61 - 0x70 | Humidity sensor | |
| 55 | USE_EZOEC | xsns_78 | EZOEC | 0x61 - 0x70 | Electric conductivity sensor | |
| 55 | USE_EZOCO2 | xsns_78 | EZOCO2 | 0x61 - 0x70 | CO2 sensor | |
| 55 | USE_EZOO2 | xsns_78 | EZOO2 | 0x61 - 0x70 | O2 sensor | |
| 55 | USE_EZOPRS | xsns_78 | EZOPRS | 0x61 - 0x70 | Pressure sensor | |
| 55 | USE_EZOFLO | xsns_78 | EZOFLO | 0x61 - 0x70 | Flow meter sensor | |
| 55 | USE_EZODO | xsns_78 | EZODO | 0x61 - 0x70 | Disolved Oxygen sensor | |
| 55 | USE_EZORGB | xsns_78 | EZORGB | 0x61 - 0x70 | Color sensor | |
| 55 | USE_EZOPMP | xsns_78 | EZOPMP | 0x61 - 0x70 | Peristaltic Pump | |
| 56 | USE_SEESAW_SOIL | xsns_81 | SEESOIL | 0x36 - 0x39 | Adafruit Seesaw soil moisture & temp sensor | |
| 56 | USE_SEESAW_ENCODER | xsns_81 | SEEENC | 0x36 - 0x39 | Adafruit Seesaw rotary encoder | |
| 57 | USE_TOF10120 | xsns_84 | TOF10120 | 0x52 | Time-of-flight (ToF) distance sensor | |
| 58 | USE_MPU_ACCEL | xsns_85 | MPU_ACCEL | 0x68 | Yes | MPU6886/MPU9250 6-axis MotionTracking sensor from M5Stack |
| 59 | USE_BM8563 | xdrv_56 | BM8563 | 0x51 | Yes | BM8563 RTC from M5Stack |
| 60 | USE_AM2320 | xsns_88 | AM2320 | 0x5C | Temperature and Humidity sensor | |
| 61 | USE_T67XX | xsns_89 | T67XX | 0x15 | CO2 sensor | |
| 62 | USE_SCD40 | xsns_92 | SCD40 | 0x62 | Yes | CO2 sensor Sensirion SCD4x |
| 63 | USE_HM330X | xsns_93 | HM330X | 0x40 | Particule sensor | |
| 64 | USE_HDC2010 | xsns_94 | HDC2010 | 0x40 | Temperature and Humidity sensor | |
| 65 | USE_ADE7880 | xnrg_23 | ADE7880 | 0x38 | Energy monitor | |
| 66 | USE_PCF85363 | xsns_99 | PCF85363 | 0x51 | Yes | Real time clock |
| 67 | USE_DS3502 | xdrv_61 | DS3502 | 0x28 - 0x2B | Digital potentiometer | |
| 68 | USE_HYT | xsns_97 | HYTxxx | 0x28 | Yes | Temperature and Humidity sensor |
| 69 | USE_SGP40 | xsns_98 | SGP40 | 0x59 | Yes | Gas (TVOC) and air quality |
| 70 | USE_LUXV30B | xsns_99 | LUXV30B | 0x4A | DFRobot SEN0390 V30B lux sensor | |
| 71 | USE_QMC5883L | xsns_33 | QMC5883L | 0x0D | Magnetic Field Sensor | |
| 72 | USE_INA3221 | xsns_100 | INA3221 | 0x40-0x43 | 3-channels Voltage and Current sensor | |
| 73 | USE_HMC5883L | xsns_101 | HMC5883L | 0x1E | 3-channels Magnetic Field Sensor | |
| 74 | USE_DISPLAY_TM1650 | xdsp_20 | TM1650 | 0x24 - 0x27, 0x34 - 0x37 | Four-digit seven-segment LED controller | |
| 75 | USE_PCA9632 | xdrv_64 | PCA9632 | 0x60 | 4-channel 4-bit pwm driver | |
| 76 | USE_SEN5X | xsns_103 | SEN5X | 0x69 | Yes | Gas (VOC/NOx index) and air quality (PPM <1,<2.5,<4,<10) |
| 77 | USE_MCP23XXX_DRV | xdrv_67 | MCP23x17 | 0x20 - 0x26 | Yes | 16-bit I/O expander as virtual button/switch/relay |
| 78 | USE_PMSA003I | xsns_104 | PMSA003I | 0x12 | PM2.5 Air Quality Sensor with I2C Interface | |
| 79 | USE_GDK101 | xsns_106 | GDK101 | 0x18 - 0x1B | Yes | Gamma Radiation Sensor |
| 80 | USE_TC74 | xsns_108 | TC74 | 0x48 - 0x4F | Temperature sensor | |
| 81 | USE_PCA9557 | xdrv_69 | PCA95xx | 0x18 - 0x1F | 8-bit I/O expander as virtual button/switch/relay | |
| 81 | USE_TCA9554 | xdrv_69 | TCA95xx | 0x20 - 0x27 | 8-bit I/O expander as virtual button/switch/relay | |
| 82 | USE_SGP4X | xsns_109 | SGP4X | 0x59 | Gas (TVOC/NOx index) | |
| 83 | USE_MAX17043 | xsns_110 | MAX17043 | 0x36 | Fuel-gauge for 3.7 Volt Lipo battery | |
| 84 | USE_ENS16x | xsns_111 | ENS16x | 0x52 - 0x53 | Gas (TVOC, eCO2) and air quality sensor | |
| 85 | USE_ENS210 | xsns_112 | ENS210 | 0x43 - 0x44 | Temperature and humidity sensor | |
| 86 | USE_AMSX915 | xsns_114 | AMS6915 | 0x28 | Pressure (absolute/differential) and temperature sensor | |
| 87 | USE_SPL06_007 | xsns_25 | SPL06-007 | 0x76 | Pressure and temperature sensor | |
| 88 | USE_QMP6988 | xsns_28 | QMP6988 | 0x56, 0x70 | Yes | Pressure and temperature sensor |
| 89 | USE_HX711_M5SCALES | xsns_34 | M5SCALES | 0x26 | Yes | M5Unit (Mini)Scales(HX711 STM32) U177 |
| 90 | USE_RX8010 | xdrv_56 | RX8010 | 0x32 | Yes | RX8010 RTC from IOTTIMER |
| 90 | USE_RX8030 | xdrv_56 | RX8030 | 0x32 | Yes | RX8030 RTC from #23855 |
| 91 | USE_MS5837 | xsns_116 | MS5837 | 0x76 | Pressure and temperature sensor | |
| 92 | USE_PCF85063 | xdrv_56 | PCF85063 | 0x51 | Yes | PCF85063 Real time clock |
| 93 | USE_AS33772S | xdrv_119 | AS33772S | 0x52 | Yes | AS33772S USB PD Sink Controller |
| 94 | USE_RV3028 | xdrv_56 | RV3028 | 0x52 | Yes | RV-3028-C7 RTC Controller |
| 95 | USE_AGS02MA | xsns_118 | AGS02MA | 0x1A | TVOC Gas sensor | |
| 96 | USE_RX8025 | xdrv_56 | RX8025 | 0x32 | Yes | RX8025 RTC |
| 97 | USE_SEN6X | xsns_119 | SEN6X | 0x6B | Yes | Gas (CO2/VOC/NOx index) and air quality (PPM <1,<2.5,<4,<10) |
| 98 | USE_FM24CXX | xdrv_93 | FM24CXX | 0x50 - 0x57 | Yes | FM24CXX - External FRAM with console / berry R/W operations |
| 99 | USE_STCC4 | xsns_120 | STCC4 | 0x64, 0x65 | Yes | CO2 and optional temperature and humidity sensor |
NOTE: Bus2 is supported on ESP8266, ESP32, ESP32-C6, ESP32-H2, ESP32-P4, ESP32-S2 and ESP32-S3