Merge pull request #175 from matt-sorenson/lolin-c3-mini

Add support for lolin c3 mini on a airgradient-pro

Author: MallocArray

configuration.md

@@ -64,6 +64,17 @@ MQTT support has been mentioned in the AirGradient forums several times.  ESPHom
 
 After extensive discussion on the [AirGradient forum](https://forum.airgradient.com/t/concern-about-hijackable-wifi-connection/3845), it may be a good idea to remove the Captive Portal package after initial configuration, as leaving it in will default to enabling the Access Point Mode if WiFi is not available, potentially allowing an external source to reconfigure the device to a new network or upload another firmware file.  Can also add a password to the ap if this functionality is desired, but want to secure it.
 
+### Using a lolin-d3-mini in an AG Pro board
+
+The lolin-d3-mini has a similar enough pin configuration that we're able to replace the stock D1 mini
+and make some minor config changes and get the benefits of an ESP32-c3 based device without buying a
+whole new motherboard.
+
+1. Start with the airgradient-pro.yaml file
+2. Under packages, replace 'airgradient_d1_mini_board.yaml' with 'airgradient_lolin-c3-mini_board.yaml'
+3. change the `!extend config_button` section to use pin number `4` instead of `D7`
+
+
 # Home Assistant Automation
 
 Pairing ESPHome with Home Assistant opens a multitude of opportunities to create custom actions tailored to your liking.

packages.md

@@ -32,6 +32,12 @@ Board configuration for devices based on the D1 Mini chip (AG Basic and AG Pro),
 
 Board configuration for devices based on the ESP32-C3 chip (AG ONE and OpenAir) using the original Arduino framework
 
+## airgradient_lolin-c3-mini_board.yaml
+
+Board configuration for the AG Pro that has been user upgraded to use a lolin-c3-mini
+
+The board is close enough pin configuration that you can directly replace the d1 mini and replace the `board` package in airgradient-pro.yaml, and replace the `D7` under the `!extend config_button` with `4`.
+
 ## button_factory_reset.yaml
 
 Enables a button to reset device to factory resets, which erases all nvram and erases all stored preferences.
@@ -53,6 +59,8 @@ binary_sensor:
       number: D7
 ```
 
+If using an AG Pro v4.2 with a user lolin-d3-mini upgrade use pin 4 instead of D7
+
 * Short press - Toggle temperature display between C and F
 * Press and hold up to 5 seconds - Initiate Senseair S8 CO2 manual calibration.  Ensure device is already outdoors or near an open window for 5+ minutes before initiating
 

packages/airgradient_lolin-c3-mini_board.yaml

@@ -0,0 +1,48 @@
+# This is for use with the AirGradient Pro replacing the default
+# D1 Mini esp8266 board with a Lolin C3 Mini esp32 board
+
+substitutions:
+  config_version: 5.3.2
+
+esphome:
+  name: "${name}"
+  friendly_name: "${friendly_name}"
+  name_add_mac_suffix: ${name_add_mac_suffix}  # Set to false if you don't want part of the MAC address in the name
+  platform: ESP32
+
+  project:
+    name: mallocarray.airgradient
+    version: "$config_version"
+  min_version: 2025.5.0
+
+esp32:
+  board: lolin_c3_mini
+  variant: esp32c3
+  framework:
+    type: esp-idf
+
+# Enable logging
+# https://esphome.io/components/logger.html
+logger:
+
+uart:
+  - rx_pin: 1
+    tx_pin: 0
+    baud_rate: 9600
+    id: pms5003_uart
+
+  - rx_pin: 6
+    tx_pin: 7
+    baud_rate: 9600
+    id: senseair_co2_uart
+
+i2c:
+  # https://esphome.io/components/i2c.html
+  sda:
+    number: 8
+    # Acknowledging that this is a strapping pin and should not have external pullup/down resistors
+    # https://esphome.io/guides/faq.html#why-am-i-getting-a-warning-about-strapping-pins
+    ignore_strapping_warning: true
+  scl: 10
+  # 400kHz eliminates warnings about components taking a long time other than SGP40 component: https://github.com/esphome/issues/issues/4717
+  frequency: 400kHz