Can the SD library support Chinese paths or file names?

[zhushengji]

Related area

SD

Hardware specification

ESP32

Is your feature request related to a problem?

It is common for file names to contain Chinese, so if UTF-8 can be supported, it will be very convenient for development.

Describe the solution you'd like

SD library support for UTF-8

Describe alternatives you've considered

No response

Additional context

No response

I have checked existing list of Feature requests and the Contribution Guide

• I confirm I have checked existing list of Feature requests and Contribution Guide.

[VojtechBartoska]

what do you think @P-R-O-C-H-Y?

[OceanZhouX]

Any updates on this?

[justdomyself]

now Can it support chinese filename ?

[P-R-O-C-H-Y]

Hi @zhushengji @OceanZhouX @justdomyself,
where is the issue for you guys? I posted a simple working sketch where Chinese file names and dirs work perfectly (its simplified SD example). Can you retest it and post your debug output from Serial Monitor? Thanks

Tested on ESP32 Wrover kit + Arduino IDE 1.8.19

Sketch:

#include "SD.h"

//SD Pins definiton for ESP32-wroker kit
#define SD_SCK  14
#define SD_MISO  2
#define SD_MOSI  15
#define SD_CS  13


void listDir(fs::FS &fs, const char * dirname, uint8_t levels){
    Serial.printf("Listing directory: %s\n", dirname);

    File root = fs.open(dirname);
    if(!root){
        Serial.println("Failed to open directory");
        return;
    }
    if(!root.isDirectory()){
        Serial.println("Not a directory");
        return;
    }

    File file = root.openNextFile();
    while(file){
        if(file.isDirectory()){
            Serial.print("  DIR : ");
            Serial.println(file.name());
            if(levels){
                listDir(fs, file.path(), levels -1);
            }
        } else {
            Serial.print("  FILE: ");
            Serial.print(file.name());
            Serial.print("  SIZE: ");
            Serial.println(file.size());
        }
        file = root.openNextFile();
    }
}

void setup() {

    Serial.begin(115200);
    delay(200);

    SPI.begin(SD_SCK, SD_MISO, SD_MOSI, SD_CS);
    if(!SD.begin(SD_CS,SPI,40000000)){
        Serial.println("Card Mount Failed");
        return;
    }

    //Open file if exists or create new file and create subdir if not exist (chineese symbols are random)
    File file = SD.open("/获取磁盘文件列表/数量.txt", "a", true);
    if (file) {
      Serial.printf("File openned - %s \n", file.name());
      file.println("foo");
      file.close();
    }
    else Serial.println("File not found or cant be created");

    listDir(SD,"/获取磁盘文件列表",1);
  
    SD.end();
}

void loop() {
  // put your main code here, to run repeatedly:
     delay(100);
}

Debug output:

rst:0x1 (POWERON_RESET),boot:0x1e (SPI_FAST_FLASH_BOOT)
configsip: 0, SPIWP:0xee
clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
mode:DIO, clock div:1
load:0x3fff0030,len:1344
load:0x40078000,len:13864
load:0x40080400,len:3608
entry 0x400805f0
File opened - 数量.txt 
Listing directory: /获取磁盘文件列表
  FILE: 数量.txt  SIZE: 5