esphome_sd_card

A collection of ESPHome components focus on operating a SD card.

To use any of these components in your ESPHome device, check out the documentation for adding external components.

Components

sd_mmc_card

The main component, allow reading and writing to the SD card. It also provide some sensors and other utilities to manipulate the card.

basic configuration:

sd_mmc_card:
  id: sd_mmc_card
  mode_1bit: false
  clk_pin: GPIO14
  cmd_pin: GPIO15
  data0_pin: GPIO2
  data1_pin: GPIO4
  data2_pin: GPIO12
  data3_pin: GPIO13

sd_file_server

A simple web page to navigate the card content and upload/download/delete files.

basic configuration:

sd_file_server:
  id: file_server
  url_prefix: file
  root_path: "/"
  enable_deletion: true
  enable_download: true
  enable_upload: true

Notes

sd_mmc_card does not work entierly with arduino framework version prior to 2.0.7. The issue as been fix by the pull request espressif/arduino-esp32/#7646

The recommended version by esphome is 2.0.5

esp32:
  board: esp32dev
  framework:
    type: arduino
    version: latest