合宙Air105|SFUD库|FS|SPI FLASH|W25QXX |LuatOS-SOC接口|官方demo|学习（15-4）：SFUD库操作-外置flash

已于 2023-02-11 11:39:26 修改
阅读量278 收藏 2
点赞数
分类专栏： LuatOS-SOC接口学习 文章标签： 国产mcu lua sfud w25qxx SPI-FLASH
于 2023-02-10 23:43:29 首次发布
本文为博主原创文章，未经博主允许不得转载！
本文链接：https://blog.csdn.net/Medlar_CN/article/details/128978904
版权

基础资料

基于Air105开发板：Air105 - LuatOS 文档

上手：开发上手 - LuatOS 文档

探讨重点

官方SFUD库操作-外置flash demo相关内容的学习及探讨。

扩展：

合宙Air103|SDIO (扩展) |LuatOS-SOC接口|官方demo|学习（15-3）：SDIO - 文件读写操作_打酱油的工程师的博客-CSDN博客

合宙Air105|fs| io操作(扩展)|io.SEEK_END|io.SEEK_SET|io.SEEK_CUR|LuatOS-SOC接口|官方demo|学习（15-2）：fs - 文件系统额外操作_打酱油的工程师的博客-CSDN博客

合宙Air105|fatfs| io操作(扩展)|SPI|可调功放|I2C|SPI|toHex()|os.remove|LuatOS-SOC接口|官方demo|学习（15-1）：fatfs文件系统_打酱油的工程师的博客-CSDN博客

​ 参考博文

https://blog.csdn.net/Medlar_CN/article/details/128181736

 软件版本

AIR105：LuatOS@AIR105 base 22.12 bsp V0014 32bit

硬件准备

  • air105开发板
  • SPI FLASH 这里选择W25Q128

软件使用

接口文档可参考：https://wiki.luatos.com/api/sfud.html

​接线方式：

--  接线AIR105--------W25QXX

--[[SPI2_CSN/GPIO19 -- CS

SPI2_MISO/GPIO21 ----- DO

SPI2_MOSI/GPIO20 ----- DI

SPI2_CLK/GPIO18 ----- CLK

           +3.3V ----- VCC

            GND ----- GND]]

demo代码及解析：

    local spi_flash = spi.deviceSetup(2,pin.PB03,0,0,8,10*1000*1000,spi.MSB,1,0)--PB03

    --[[sfud.init(spi_id, spi_cs, spi_bandrate)/sfud.init(spi_device)

    初始化sfud

    参数

    传入值类型   解释

    int spi_id SPI的ID/userdata spi_device

    int spi_cs SPI的片选

    int spi_bandrate SPI的频率

    返回值

    返回值类型   解释

    bool    成功返回true,否则返回false

    ]]

    local ret = sfud.init(spi_flash)

    if ret then

        log.info("sfud.init ok")

    else

        log.info("sfud.init Error")

        return

    end

    --eraseWrite

    --sfud.getDeviceNum() 返回值： int  返回设备总数

    log.info("sfud.getDeviceNum",sfud.getDeviceNum())

    --返回值类型 userdata    成功返回一个数据结构,该结构（flash结构体）无法直接显示,专用于后续的sfud操作。不成功则返回nil

    --userdata可看做为sfud各类操作的基本模板。

    local sfud_device = sfud.getDeviceTable()

    --[[

        sfud.eraseWrite(flash, addr,data)

        先擦除再往 Flash 写数据

        参数

        传入值类型   解释

        userdata    flash Flash 设备对象 sfud.get_device_table()返回的数据结构

        int addr 起始地址

        string  data 待写入的数据

        返回值

        返回值类型   解释

        int 成功返回0

    ]]

    local str="sfud is a little filesystem(lfs)"

    log.info("sfud.eraseWrite",sfud.eraseWrite(sfud_device,1024,str))

    log.info("sfud.read",sfud.read(sfud_device,1024,string.len(str)))

    --[[sfud.mount(flash, mount_point, offset, maxsize)

        挂载sfud lfs文件系统

        参数

        传入值类型   解释

        userdata    flash Flash 设备对象 sfud.get_device_table()返回的数据结构

        string  mount_point 挂载目录名

        int 起始偏移量,默认0

        int 总大小, 默认是整个flash

        返回值

        返回值类型   解释

        bool    成功返回true

    ]]

    log.info("sfud.mount",sfud.mount(sfud_device,"/sfud"))

    --获取文件系统信息,传入值类型string,路径,默认”/”,可选,

    --返回值：boolean获取成功返回true,否则返回false，int，总的block数量；int，已使用的block数量；int，block的大小,单位字节；string，文件系统类型,例如lfs代表littlefs

    -- 打印根分区的信息

    log.info("fsstat", fs.fsstat("/"))  -- I/user.fsstat    true    128 4   4096    lfs

    -- 打印挂载的sfud分区的信息

    log.info("fsstat", fs.fsstat("/sfud")) -- I/user.fsstat true    2048    2   4096    lfs

LOG:

[2023-02-10 23:17:00.867] __y__Z_Remote_Upgrade 441:no ota info

[2023-02-10 23:17:00.867] no bl encrypt

[2023-02-10 23:17:00.867] main 672:bootloader build release Feb  1 2023 20:19:29!

[2023-02-10 23:17:00.867] Jump_AppRun 76:jump to 0x01010400 !



[2023-02-10 23:17:00.876] main 188:APP Build release Feb  9 2023 22:01:02!

[2023-02-10 23:17:00.876] I/main LuatOS@AIR105 base 22.12 bsp V0014 32bit

[2023-02-10 23:17:00.876] I/main ROM Build: Feb 10 2023 20:58:08

[2023-02-10 23:17:00.876] D/main loadlibs luavm 204792 15376 15376

[2023-02-10 23:17:00.876] D/main loadlibs sys   406456 51032 51616

[2023-02-10 23:17:00.876] I/user.main  sfuddemo        1.0.0

[2023-02-10 23:17:00.876] I/sfud Find a Winbond flash chip. Size is 8388608 bytes.

[2023-02-10 23:17:00.876] I/sfud LuatOS-sfud flash device is initialize success.

[2023-02-10 23:17:00.876] I/user.sfud.init ok

[2023-02-10 23:17:00.876] I/user.sfud.getDeviceNum 1

[2023-02-10 23:17:00.944] I/user.sfud.eraseWrite 0

[2023-02-10 23:17:00.944] I/user.sfud.read  sfud is a little filesystem(lfs)

[2023-02-10 23:17:00.944] D/sfud lfs_mount 0

[2023-02-10 23:17:00.944] D/sfud vfs mount /sfud ret 0

[2023-02-10 23:17:00.944] I/user.sfud.mount       true

[2023-02-10 23:17:00.944] I/user.fsstat true 128  4       4096         lfs

[2023-02-10 23:17:00.944] I/user.fsstat true 2048         2       4096         lfs

PS: SFUD (Serial Flash Universal Driver) 串行 Flash 通用驱动库

项目地址: https://github.com/armink/SFUD

SFUD 是一款开源的串行 SPI Flash 通用驱动库。由于现有市面的串行 Flash 种类居多，各个 Flash 的规格及命令存在差异， SFUD 就是为了解决这些 Flash 的差异现状而设计，让我们的产品能够支持不同品牌及规格的 Flash，提高了涉及到 Flash 功能的软件的可重用性及可扩展性，同时也可以规避 Flash 缺货或停产给产品所带来的风险。

  • 主要特点：支持 SPI/QSPI 接口、面向对象（同时支持多个 Flash 对象）、可灵活裁剪、扩展性强、支持 4 字节地址
  • 资源占用
    • 标准占用：RAM:0.2KB ROM:5.5KB
    • 最小占用：RAM:0.1KB ROM:3.6KB
  • 设计思路：
    • 什么是 SFDP ：它是 JEDEC （固态技术协会）制定的串行 Flash 功能的参数表标准，最新版 V1.6B （点击这里查看）。该标准规定了，每个 Flash 中会存在一个参数表，该表中会存放 Flash 容量、写粒度、擦除命令、地址模式等 Flash 规格参数。目前，除了部分厂家旧款 Flash 型号会不支持该标准，其他绝大多数新出厂的 Flash 均已支持 SFDP 标准。所以该库在初始化时会优先读取 SFDP 表参数。
    • 不支持 SFDP 怎么办 ：如果该 Flash 不支持 SFDP 标准，SFUD 会查询配置文件 ( /sfud/inc/sfud_flash_def.h ) 中提供的 Flash 参数信息表 中是否支持该款 Flash。如果不支持，则可以在配置文件中添加该款 Flash 的参数信息（添加方法详细见 2.5 添加库目前不支持的 Flash）。获取到了 Flash 的规格参数后，就可以实现对 Flash 的全部操作。

sfud - SPI FLASH sfud软件包

已适配 Air101/Air103 Air105 ESP32C3 Air780

备注

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

小技巧

本库有专属demo，点此链接查看sfud的demo例子

sfud.init(spi_id, spi_cs, spi_bandrate)/sfud.init(spi_device)

初始化sfud

参数

传入值类型

解释

int

spi_id SPI的ID/userdata spi_device

int

spi_cs SPI的片选

int

spi_bandrate SPI的频率

返回值

返回值类型

解释

bool

成功返回true,否则返回false

例子

--spi

log.info("sfud.init",sfud.init(0,20,20 * 1000 * 1000))

--spi_device

local spi_device = spi.deviceSetup(0,17,0,0,8,2000000,spi.MSB,1,0)

log.info("sfud.init",sfud.init(spi_device))

sfud.getDeviceNum()

获取flash设备信息表中的设备总数

参数

无

返回值

返回值类型

解释

int

返回设备总数

例子

log.info("sfud.getDeviceNum",sfud.getDeviceNum())

sfud.getDevice(index)

通过flash信息表中的索引获取flash设备

参数

传入值类型

解释

int

index flash信息表中的索引

返回值

返回值类型

解释

userdata

成功返回一个数据结构,否则返回nil

例子

local sfud_device = sfud.getDevice(1)

sfud.getDeviceTable()

获取flash设备信息表

参数

无

返回值

返回值类型

解释

userdata

成功返回一个数据结构,否则返回nil

例子

local sfud_device = sfud.getDeviceTable()

sfud.chipErase(flash)

擦除 Flash 全部数据

参数

传入值类型

解释

userdata

flash Flash 设备对象 sfud.get_device_table()返回的数据结构

返回值

返回值类型

解释

int

成功返回0

例子

sfud.chipErase(flash)

sfud.erase(flash,add,size)

擦除 Flash 指定地址指定大小

参数

传入值类型

解释

userdata

flash Flash 设备对象 sfud.get_device_table()返回的数据结构

number

add 擦除地址

number

size 擦除大小

返回值

返回值类型

解释

int

成功返回0

例子

sfud.erase(flash,add,size)

sfud.read(flash, addr, size)

读取 Flash 数据

参数

传入值类型

解释

userdata

flash Flash 设备对象 sfud.get_device_table()返回的数据结构

int

addr 起始地址

int

size 从起始地址开始读取数据的总大小

返回值

返回值类型

解释

string

data 读取到的数据

例子

log.info("sfud.read",sfud.read(sfud_device,1024,4))

sfud.write(flash, addr,data)

向 Flash 写数据

参数

传入值类型

解释

userdata

flash Flash 设备对象 sfud.get_device_table()返回的数据结构

int

addr 起始地址

string

data 待写入的数据

返回值

返回值类型

解释

int

成功返回0

例子

log.info("sfud.write",sfud.write(sfud_device,1024,"sfud"))

sfud.eraseWrite(flash, addr,data)

先擦除再往 Flash 写数据

参数

传入值类型

解释

userdata

flash Flash 设备对象 sfud.get_device_table()返回的数据结构

int

addr 起始地址

string

data 待写入的数据

返回值

返回值类型

解释

int

成功返回0

例子

log.info("sfud.eraseWrite",sfud.eraseWrite(sfud_device,1024,"sfud"))

sfud.mount(flash, mount_point, offset, maxsize)

挂载sfud lfs文件系统

参数

传入值类型

解释

userdata

flash Flash 设备对象 sfud.get_device_table()返回的数据结构

string

mount_point 挂载目录名

int

起始偏移量,默认0

int

总大小, 默认是整个flash

返回值

返回值类型

解释

bool

成功返回true

例子

log.info("sfud.mount",sfud.mount(sfud_device,"/sfud"))

log.info("fsstat", fs.fsstat("/"))

log.info("fsstat", fs.fsstat("/sfud"))

打酱油的工程师
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
spiflash驱动w25qxx.zip
04-20
本资源为w25qxx系列flash的spi驱动代码 包含spi.h和spi.c和w25qxx.h和w25qxx.c四个驱动文件和头文件
SPI Flash 通用驱动程序（SFUD）
07-29
SFUD 是一款开源的串行 SPI Flash 通用驱动库。由于现有市面的串行 Flash 种类居多，各个 Flash 的规格及命令存在差异， SFUD 就是为了解决这些 Flash 的差异现状而设计，让我们的产品能够支持不同品牌及规格的 Flash，提高了涉及到 Flash 功能的软件的可重用性及可扩展性，同时也可以规避 Flash 缺货或停产给产品所带来的风险。最新版本见：https://github.com/armink/SFUD
STM32H750VBT6-SPI-FLASH-W25QXX.rar
11-04
STM32 HAL库SPI接口访问W25Q系列FLASH的范例代码，采用STM32CUBEIDE开发平台，也适用于其它型号SPI接口FLASH的访问。具体介绍见CSDN博文《STM32存储左右互搏 SPI总线读写FLASH W25QXX》： https://pegasus.blog.csdn.net/article/details/130246345 。
W25QXX_spiflash_w25q128_w25qxx_
10-01
通过stm32单片机的spi实现flash的读写
STM32H750VBT6-SPI-FLASH-FATS-W25QXX.rar
11-20
STM32 HAL库SPI接口文件系统FATS访问W25Q系列FLASH的范例代码，采用STM32CUBEIDE开发平台，也适用于其它型号SPI接口FLASH的访问。具体介绍见CSDN博文《STM32存储左右互搏 SPI总线FATS文件读写FLASH W25QXX》： https://pegasus.blog.csdn.net/article/details/130249055 。
合宙Air780E|FTP|内网穿透|命令测试|LuatOS-SOC接口|官方demo|学习（18）：FTP命令及应用
Medlar_CN的博客
02-23 1109
合宙Air780E|FTP|内网穿透|命令测试|LuatOS-SOC接口|官方demo|学习（18）：FTP命令及应用
Air780E开发板开发环境搭建
weixin_42854045的博客
01-18 720
Air780E开发板开发环境搭建
串行 Flash 通用驱动库——SFUD
Walker_s_的博客
05-25 2398
SFUD (Serial Flash Universal Driver) 串行 Flash 通用驱动库 0、SFUD 是什么 SFUD 是一款开源的串行 SPI Flash 通用驱动库。由于现有市面的串行 Flash 种类居多，各个 Flash 的规格及命令存在差异， SFUD 就是为了解决这些 Flash 的差异现状而设计，让我们的产品能够支持不同品牌及规格的 Flash，提高了涉及到 Fla...
LuatOS-SOC接口文档(air780E)-- fs - 文件系统额外操作
l531798151的博客
10-07 99
文件系统类型,例如lfs代表littlefs。获取成功返回true,否则返回false。-- 打印main.luac的大小。文件大小,若获取失败会返回0。block的大小,单位字节。路径,默认”/”,可选。已使用的block数量。-- 打印根分区的信息。
LuatOS 开发指南
jeek_we的博客
09-01 1420
Luat 的 NDK 开发
基于RTT移植LittleFs并挂载到外部W25Q64的SPI_Flash上的总结.pdf
05-30
LittleFS 并挂在到W25Q64的SPI Flash上
W25Qxx_NORFLASH_SPI_cn.rar_SPI norFlash_W25QXX__norflash中文_spi f
07-14
W25Qxx系列Flash（NORFLASH），提供SPI接口，中文手册
15 SPI_W25Qxx.7z15 SPI_W25Qxx.7z
02-11
15 SPI_W25Qxx.7z
STM32H750VBT6-QSPI-FLASH-W25QXX.rar
最新发布
02-01
STM32 HAL库QSPI接口访问FLASH W25Q系列的范例代码，采用STM32CUBEIDE开发平台。具体介绍见CSDN博文《STM32存储左右互搏 QSPI总线读写FLASH W25QXX》： https://pegasus.blog.csdn.net/article/details/130258229 。
【LuatOS-esp32】4.1 文件系统——luatools下载文件读写
qq_38091632的博客
02-09 1462
读取txt数据
Air724UG开发环境
weixin_39147232的博客
12-09 1049
合宙的LTE-CAT1模块（型号Air724UG）的应用方法，对开发环境进行总结梳理，主要涉及下载工具的搜集、烧录/调试步骤的整理。
LuatOS-SOC接口文档(air780E)--lora2 - lora2驱动模块(支持多挂)
l531798151的博客
10-26 763
模式 正常模式:lora.STANDBY 休眠模式:lora.SLEEP 默认为正常模式。cb lora回调,参数包括lora_device, event, data, size。rx_done -- 接收完成。tx_timeout -- 发送超时。rx_timeout -- 接收超时。lora发送配置参数,与具体设备有关。lora接收配置参数,与具体设备有关。lora配置参数,与具体设备有关。设置进入模式(休眠，正常等)lora配置发送参数。lora配置接收参数。
合宙Air780E|iot|update|FOTA|LuatOS-Air开发|LuatOS-SOC接口|官方demo|学习（17）：FOTA（远程升级）
Medlar_CN的博客
02-17 2243
合宙Air780E|iot|update|FOTA|LuatOS-Air开发|LuatOS-SOC接口|官方demo|学习（17）：FOTA（远程升级）
正点原子 spi-w25qxx
09-04
正点原子 SPI-W25Qxx是一款基于SPI总线的Flash存储器模块。它使用了W25Q系列的Flash芯片，并且具有快速的数据读写速度和较大的存储容量。 SPI-W25Qxx模块的主要特点包括以下几个方面： 1. 灵活的接口：SPI-W25Qxx模块可以通过SPI总线与微控制器或其他设备进行通信。SPI总线是一种四线串行总线，具有高速数据传输和简化的通信协议。 2. 大容量存储：SPI-W25Qxx模块采用了W25Q系列的Flash芯片，具有较大的存储容量。W25Q系列的Flash芯片可提供从512KB到128MB不等的存储容量，可以满足各种存储需求。 3. 快速的数据读写：SPI-W25Qxx模块的Flash芯片具有快速的数据读写速度。读操作可以在几微秒的时间内完成，写操作也只需要几毫秒的时间。 4. 低功耗设计：SPI-W25Qxx模块采用了低功耗设计，运行时的功耗较低。这对于一些对功耗要求较高的应用场景十分重要。 5. 可编程的功能：SPI-W25Qxx模块的Flash芯片支持多种可编程功能，例如写保护设置、擦除操作和扇区大小选择等。这些功能可以根据具体需求进行配置。 总之，正点原子SPI-W25Qxx是一款高性能、灵活可靠的Flash存储器模块。它适用于各种嵌入式系统和应用场景，如数据存储、固件更新和数据备份等。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

打酱油的工程师

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值