summaryrefslogtreecommitdiff
path: root/docs/zh/demo/usbd_msc.rst
blob: 1b09a7d2450af545f6ea560042f40e60c74e8e46 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
MSC Device
=================

本节主要演示 USB 模拟 U 盘功能。默认使用RAM 作为存储介质模拟 U 盘。

- 实现 U 盘的读写和获取容量接口,注意,容量 block_num 为虚拟的,实际没有这么多 block,读写的数据超过 BLOCK_COUNT 会丢弃。

block_size 一般为 512/2048/4096。

.. code-block:: C

    void usbd_msc_get_cap(uint8_t busid, uint8_t lun, uint32_t *block_num, uint32_t *block_size)
    {
        *block_num = 1000; //Pretend having so many buffer,not has actually.
        *block_size = BLOCK_SIZE;
    }
    int usbd_msc_sector_read(uint8_t busid, uint8_t lun, uint32_t sector, uint8_t *buffer, uint32_t length)
    {
        if (sector < BLOCK_COUNT)
            memcpy(buffer, mass_block[sector].BlockSpace, length);
        return 0;
    }

    int usbd_msc_sector_write(uint8_t busid, uint8_t lun, uint32_t sector, uint8_t *buffer, uint32_t length)
    {
        if (sector < BLOCK_COUNT)
            memcpy(mass_block[sector].BlockSpace, buffer, length);
        return 0;
    }

- 默认上述 API 在中断中执行,如果需要在非中断中执行,可以选择如下:

1,裸机下开启 `CONFIG_USBDEV_MSC_POLLING` 并在 while1 中调用 `usbd_msc_polling`,则读写函数在 while1 中执行。

2, OS 下开启 `CONFIG_USBDEV_MSC_THREAD`,则读写函数在线程中执行。

- 修改  `CONFIG_USBDEV_MSC_BUFSIZE` 会影响 U 盘的读写速度,必须是 block_size 的整数倍,当然,也会增加 RAM 的占用。

- 如果 RAM 例程可以用,但是介质更换成 SD 或者 FLASH 后不可用,则一定是介质驱动问题。