FAQ：FAT文件系统下如何获取函数文件名(短文件名 / 长文件名)

### 一、简介
    在FAT文件系统下，可以使用vfs_file_name()函数获取文件名，通过修改配置分为获取文件短名和文件长名；
    获取短名时，文件名限制为总共 8 + 3 个字符，其中 3 为文件后缀名，超出部分会变成 "~ + 数字"；
    获取长名时，文件名长度最大为260个字符，但是相应的会消耗更多的资源空间。

下面介绍在FAT文件系统下如何获取文件短名和长名。

### 二、补丁链接
    链接：https://pan.baidu.com/s/1DYOR0TrQAkSANBjHAqrU8A 
    提取码：ehdj
### 三、示例SDK环境
    - AD1x-457_AC104-release_v1.8.0 的 mbox_mg工程

### 四、获取文件短名
    公版SDK默认支持的是文件短名，获取到的短名编码格式是内码(GB18030)。
    示例：mbox_mg工程上电后会检测SD卡的上线，如果SD卡上线了就会挂载FAT文件系统，并播放SD卡里的歌曲，把其相关信息打印出来：
![SD卡](https://foruda.gitee.com/images/1696987910324865983/61508f73_10929185.png "屏幕截图")
![输入图片说明](https://foruda.gitee.com/images/1696987846942338399/f868be01_10929185.png "屏幕截图")
![输入图片说明](https://foruda.gitee.com/images/1696988021831378721/02640f16_10929185.png "屏幕截图")

### 五、获取文件长名
    1.在公版SDK的基础上，替换fs_lib.a库（见补丁链接）。
    2.修改宏FOPEN_LONG 和 宏FS_FOPEN_LONG（见下）
    3.修改获取文件名的长度（获取文件名长名时，该长度需大于16，小于等于16时会默认变为获取文件短名，见下）

![输入图片说明](https://foruda.gitee.com/images/1696988196805029335/171e10a5_10929185.png "屏幕截图")
![输入图片说明](https://foruda.gitee.com/images/1696988265397897873/cd78b072_10929185.png "屏幕截图")
![输入图片说明](https://foruda.gitee.com/images/1696988434370567603/0d954574_10929185.png "屏幕截图")

4.注意：使用vfs_file_name获取到文件长名时，其格式为unicode码，需要转换成utf8才能打印（见下）
      注意：若文件是中文字符，某些串口工具可能不支持中文字符导致显示错误，用户可以先尝试文件名字为数字或英文来确认长名功能是否正常。
![输入图片说明](https://foruda.gitee.com/images/1696989240957907720/f9bfe984_10929185.png "屏幕截图")
![输入图片说明](https://foruda.gitee.com/images/1696989686773190097/0eae0304_10929185.png "屏幕截图")

珠海杰理科技/fw-AD15N

内容风险标识

评论 (3)

珠海杰理科技/fw-AD15N .gitee-modal { width: 500px !important; }

内容风险标识