sd_card for esp32s3box3

SD MMC cards components for esphome.

Config

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
  power_ctrl_pin: GPIO43  # Optionnel : GPIO pour contrôler l'alimentation de la carte SD

• mode_1bit (Optional, bool): spécifie si le mode 1 bit ou 4 bits est utilisé
• clk_pin : (Required, GPIO): broche d'horloge
• cmd_pin : (Required, GPIO): broche de commande
• data0_pin: (Required, GPIO): broche de données 0
• data1_pin: (Optional, GPIO): broche de données 1, utilisée uniquement en mode 4 bits
• data2_pin: (Optional, GPIO): broche de données 2, utilisée uniquement en mode 4 bits
• data3_pin: (Optional, GPIO): broche de données 3, utilisée uniquement en mode 4 bits
• power_ctrl_pin: (Optional, GPIO): broche pour contrôler l'alimentation de la carte SD (par exemple, GPIO43 pour l'ESP32-S3-Box-3)

Contrôle d'alimentation (PWR_CTRL)

Pour les appareils comme l'ESP32-S3-Box-3, vous pouvez utiliser la broche power_ctrl_pin pour activer ou désactiver l'alimentation de la carte SD. Par exemple, sur l'ESP32-S3-Box-3, la broche GPIO43 est souvent utilisée pour contrôler l'alimentation du lecteur de carte SD.

Exemple de configuration pour l'ESP32-S3-Box-3 :

esp32:
  board: esp32s3box
  flash_size: 16MB
  framework:
    type: esp-idf
    version: recommended
    sdkconfig_options:
      CONFIG_ESP32S3_DEFAULT_CPU_FREQ_240: "y"
      CONFIG_ESP32S3_DATA_CACHE_64KB: "y"
      CONFIG_ESP32S3_DATA_CACHE_LINE_64B: "y"
      CONFIG_FATFS_LFN_STACK: "y"



sd_mmc_card:
  id: box3_sd
  clk_pin: GPIO11
  cmd_pin: GPIO14
  data0_pin: GPIO9
  data1_pin: GPIO13
  data2_pin: GPIO42
  data3_pin: GPIO12
  mode_1bit: false
  power_ctrl_pin: GPIO43  # Active l'alimentation du lecteur de carte SD

Notes

Arduino Framework

Ce composant utilise la bibliothèque SD_MMC et partage ses limitations. Pour plus de détails, voir : SD_MMC

Le mode 4 bits ne fonctionne pas avec les versions d'Arduino Framework antérieures à 2.0.7 en raison d'un problème dans la fonction setPins de SD_MMC. Ce problème a été corrigé par la pull request espressif/arduino-esp32/#7646

La version recommandée par esphome est 2.0.5.

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

ESP-IDF Framework

Par défaut, les noms de fichiers longs ne sont pas activés. Pour changer ce comportement, CONFIG_FATFS_LFN_STACK ou CONFIG_FATFS_LFN_HEAP doit être défini dans la configuration du framework. Voir la documentation Espressif pour plus de détails.

esp32:
  board: esp32dev
  framework:
    type: esp-idf
    sdkconfig_options:
      CONFIG_FATFS_LFN_STACK: "y"

Sensors

Used space

sensor:
  - platform: sd_mmc_card
    type: used_space
    name: "SD card used space"

Espace utilisé sur la carte SD en octets.

• Toutes les options sensor sont disponibles

Total space

sensor:
  - platform: sd_mmc_card
    type: total_space
    name: "SD card total space"

Capacité totale de la carte SD.

• Toutes les options sensor sont disponibles

Free space

sensor:
  - platform: sd_mmc_card
    type: free_space
    name: "SD card free space"

Espace libre sur la carte SD.

• Toutes les options sensor sont disponibles

File size

sensor:
  - platform: sd_mmc_card
    type: file_size
    path: "/test.txt"

Retourne la taille du fichier spécifié.

• path (Required, string): chemin du fichier
• Toutes les options sensor sont disponibles

Text Sensor

text_sensor:
  - platform: sd_mmc_card
    sd_card_type:
      name: "SD card type"

Type de carte SD (MMC, SDSC, ...)

• Toutes les options text sensor sont disponibles