prefixkit Ask an engineerAsk Support RU

ESPHome devices

M5Stack AirQ: ESPHome

M5Stack AirQ (sensors, ESP8266): GPIO pinout and a starter ESPHome config with relays, buttons, LED. Local Home Assistant control with no cloud.

Type
Sensors
Chip
ESP8266
Region standard
GLOBAL

Pinout

PinFunction
GPIO1Ink Screen Busy
GPIO2Ink Screen RST
GPIO3Ink Screen D/C
GPIO4Ink Screen CS
GPIO5Ink Screen SCK
GPIO6Ink Screen MOSI
GPIO8Button B
GPIO9beep
GPIO10SEN55 Power Switch
GPIO11SEN55 SDA
GPIO12SEN55 SCL
GPIO26Speaker Pin 2
GPIO15GROVE A SCL
GPIO13GROVE A SDA

Find it in shops: AliExpress

Links open a search in the shop; some are affiliate links: buying through them costs you nothing extra and supports this site. We do not sell devices or get them from manufacturers.

Starter ESPHome config

Built from the pinout above. Keys and the Wi-Fi password come from secrets.yaml in ESPHome. Check the pins against your hardware revision before flashing: one model can ship with different boards.

substitutions:
  name: m5stack-airq

esphome:
  name: ${name}
  friendly_name: "M5Stack AirQ"

esp8266:
  board: esp01_1m  # most plugs and relays have 1 MB flash; check yours

logger:
api:
  encryption:
    key: !secret api_key
ota:
  - platform: esphome
    password: !secret ota_password
wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  ap: {}
captive_portal:

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO8
      mode: INPUT_PULLUP
      inverted: true
    name: "Button"  # Button B

# Other pins from the pinout:
#   GPIO1: Ink Screen Busy
#   GPIO2: Ink Screen RST
#   GPIO3: Ink Screen D/C
#   GPIO4: Ink Screen CS
#   GPIO5: Ink Screen SCK
#   GPIO6: Ink Screen MOSI
#   GPIO9: beep
#   GPIO10: SEN55 Power Switch
#   GPIO11: SEN55 SDA
#   GPIO12: SEN55 SCL
#   GPIO26: Speaker Pin 2
#   GPIO15: GROVE A SCL
#   GPIO13: GROVE A SDA

How to flash

  • Most devices are flashed over UART: a 3.3 V USB-TTL adapter to RX, TX, GND and 3V3, holding GPIO0 to ground at power-on (ESP8266/ESP32). Mains power disconnected.
  • Beken (BK72xx) and Realtek chips are flashed with ltchiptool, or with cloudcutter without opening the case if the firmware allows it.
  • Details and board photos: the device page in the ESPHome database.

A config from scratch: ESPHome generator. Which pins are safe: pinout.

Similar devices

Idea?