CherryUSB的bootuf2配置

发布于 2024-12-15 18:59:48 浏览：31 订阅该版

[tocm]

# 前言
uf2是一种微软推出的利用usb msc模拟u盘刷机的固件格式（参考链接：https://github.com/microsoft/uf2) uf2文件按512字节一块组织待刷机固件文件，而一块又分为36字节的块头部和476字节的数据载体，比如原始的bin固件1024字节，那么组织成uf2文件最少需要3个uf2文件块，而一般为了底层处理方便，只会利用476字节中的256字节存储固件数据，那么1024字节就需要1024/256=4个uf2文件块。

# 一、配置和构建bootuf2
cherryusb的keil工程创建参考（https://club.rt-thread.org/ask/article/2e12c73fd42b27c6.html ）上一篇文章，这里直接在上一篇基础上添加修改文件。
1、添加uf2源代码文件到keil
![00.png](https://oss-club.rt-thread.org/uploads/20241215/b8118e7764ed67bcacb21c80ef013326.png)
![01.png](https://oss-club.rt-thread.org/uploads/20241215/ee275ae99e753d23b4f0e418ccb3afb3.png)

2、在main函数中添加bootuf2初始化函数
![02.png](https://oss-club.rt-thread.org/uploads/20241215/d2ff792b136b890b7e62c6f005f9b0e5.png.webp)

3、根据需要配置bootuf2_config.h文件
![03.png](https://oss-club.rt-thread.org/uploads/20241215/9978b2683cb2d59873db00c09a75b73d.png.webp)

4、运行效果
![04.png](https://oss-club.rt-thread.org/uploads/20241215/10e53d7d3f6e828e1490a60292ab756d.png)

# 二、其它
1、uf2整个项目只需要用户自己实现“bootuf2_flash_write”这个底层函数函数
```c
int bootuf2_flash_write(uint32_t address, const uint8_t *data, size_t size)
{
    USB_LOG_INFO("address:%08x, size:%d\n", address, size);
    USB_LOG_INFO("erase 32kblack\n");
    USB_LOG_INFO("write 32kblack\n");

return 0;
}
```

2、固件打包工具路径“CherryUSB\tools\uf2”
这里主要注意固件基地址和FAMILYID，比如我的板子固件基地址是0x70000000,FAMILYID在bootuf2_config.h默认是0xffffffff,可以根据自己需要配置修改。