fatfs - 读写fatfs格式#

已适配 Air105 Air780

备注

本页文档由这个文件自动生成。如有错误,请提交issue或帮忙修改后pr,谢谢!

小技巧

本库有专属demo,点此链接查看fatfs的demo例子

示例

-- 通常只使用fatfs.mount挂载tf/sd卡,其他操作走io库就可以了

fatfs.mount(mount_point, spiid_or_spidevice, spi_cs, spi_speed)#

挂载fatfs

参数

传入值类型

解释

string

fatfs挂载点, 通常填””或者”SD”, 底层会映射到vfs的 /sd 路径

int

传入spi device指针,或者spi的id

int

片选脚的GPIO 号, 若前一个参数传的是spi device,这个参数就不需要传

int

SPI最高速度,默认10M, 若前2个参数传的是spi device,这个参数就不需要传

返回值

返回值类型

解释

bool

成功返回true, 否则返回nil或者false

string

失败的原因

例子

-- 方法1, 使用SPI模式
    local spiId = 2
    local result = spi.setup(
        spiId,--串口id
        255, -- 不使用默认CS脚
        0,--CPHA
        0,--CPOL
        8,--数据宽度
        400*1000  -- 初始化时使用较低的频率
    )
    local TF_CS = pin.PB3
    gpio.setup(TF_CS, 1)
    --fatfs.debug(1) -- 若挂载失败,可以尝试打开调试信息,查找原因
	-- 提醒, 若TF/SD模块带电平转换, 通常不支持10M以上的波特率!!
    fatfs.mount("SD", spiId, TF_CS, 24000000)
    local data, err = fatfs.getfree("SD")
    if data then
        log.info("fatfs", "getfree", json.encode(data))
    else
        log.info("fatfs", "err", err)
    end
	-- 往下的操作, 使用 io.open("/sd/xxx", "w+") 等io库的API就可以了

fatfs.getfree(mount_point)#

获取可用空间信息

参数

传入值类型

解释

string

挂载点, 需要跟fatfs.mount传入的值一致

返回值

返回值类型

解释

table

若成功会返回table,否则返回nil

int

导致失败的底层返回值

例子

-- table包含的内容有
-- total_sectors 总扇区数量
-- free_sectors 空闲扇区数量
-- total_kb 总字节数,单位kb
-- free_kb 空闲字节数, 单位kb
-- 注意,当前扇区大小固定在512字节

    local data, err = fatfs.getfree("SD")
    if data then
        log.info("fatfs", "getfree", json.encode(data))
    else
        log.info("fatfs", "err", err)
    end