VSF上的USB设备端的声明式开发范式，20行代码实现 -- 已开源

只看该作者 · 2019-12-27 13:59

本帖最后由 vsfopen 于 2019-12-31 15:10 编辑

之前发了第一版USB设备端的简化开发方式，但是。。。代码还是太。。。复杂了，还需要继续简化，第二轮优化大致出来，有望本周更新开源（可能会做一些小调整）先科普一下，声明式的开发范式里，用户需要描述符的只是what，其他的实现细节，自动处理。

还是一样，直接上代码，功能是实现一个USB CDC串口：

复制

#include "vsf.h"



implement_usbd(user_usbd, 0x2348, 0xA7A8, 0x0409, USB_DC_SPEED_HIGH)

    implement_usbd_common_desc(user_usbd, u"VSF-USBD-Simplest", u"SimonQian", u"1.0.0", 64, USB_DESC_CDC_ACM_IAD_LEN, USB_CDC_ACM_IFS_NUM, USB_CONFIG_ATT_WAKEUP, 100)

        implement_cdc_acm_desc(user_usbd, 0, 0, 1, 2, 2, 512, 16)

    implement_usbd_func_desc(user_usbd)

        implement_usbd_func_str_desc(user_usbd, 0, u"VSF-CDC")

    implement_usbd_std_desc_table(user_usbd)

        implement_usbd_func_str_desc_table(user_usbd, 0)

    implement_usbd_device_func(user_usbd)

        implement_cdc_acm_func(user_usbd, 0, 1, 2, 2, NULL, NULL, USB_CDC_ACM_LINECODE(115200, 8, USB_CDC_ACM_PARITY_NONE, USB_CDC_ACM_STOPBIT_1))

    implement_usbd_device_ifs(user_usbd)

        implement_cdc_acm_ifs(user_usbd, 0)

end_implement_usbd(user_usbd, VSF_USB_DC0)



void main(void)

{

    vk_usbd_init(&user_usbd);

    vk_usbd_connect(&user_usbd);

}

第二轮优化后，用户已经不需要在意数据结构了，只需要在意USB设备的参数，以及实现的功能(func)。
用户实现方式，就是填参数，并且根据功能，调用对应的宏然后继续填入参数即可。

只看该作者 · 2019-12-27 14:07

本帖最后由 vsfopen 于 2019-12-27 14:33 编辑

基于1楼demo，做简单的修改，实现2路CDC串口，代码和截图如下（红色的是做的修改或者增加）：

#include "vsf.h"

implement_usbd(user_usbd, 0x2348, 0xA7A8, 0x0409, USB_DC_SPEED_HIGH)
implement_usbd_common_desc(user_usbd, u"VSF-USBD-Simplest", u"SimonQian", u"1.0.0", 64, 2 * USB_DESC_CDC_ACM_IAD_LEN, 2 * USB_CDC_ACM_IFS_NUM, USB_CONFIG_ATT_WAKEUP, 100)
      implement_cdc_acm_desc(user_usbd, 0, 0, 1, 2, 2, 512, 16)
      implement_cdc_acm_desc(user_usbd, 1 * USB_CDC_ACM_IFS_NUM, 1, 3, 4, 4, 512, 16)
implement_usbd_func_desc(user_usbd)
      implement_usbd_func_str_desc(user_usbd, 0, u"VSF-CDC0")
      implement_usbd_func_str_desc(user_usbd, 1, u"VSF-CDC1")
implement_usbd_std_desc_table(user_usbd)
      implement_usbd_func_str_desc_table(user_usbd, 0)
      implement_usbd_func_str_desc_table(user_usbd, 1)
implement_usbd_device_func(user_usbd)
      implement_cdc_acm_func(user_usbd, 0, 1, 2, 2, NULL, NULL, USB_CDC_ACM_LINECODE(115200, 8, USB_CDC_ACM_PARITY_NONE, USB_CDC_ACM_STOPBIT_1))
      implement_cdc_acm_func(user_usbd, 1, 3, 4, 4, NULL, NULL, USB_CDC_ACM_LINECODE(115200, 8, USB_CDC_ACM_PARITY_NONE, USB_CDC_ACM_STOPBIT_1))
implement_usbd_device_ifs(user_usbd)
      implement_cdc_acm_ifs(user_usbd, 0)
      implement_cdc_acm_ifs(user_usbd, 1)
end_implement_usbd(user_usbd, VSF_USB_DC0)

void main(void)
{
vk_usbd_init(&user_usbd);
vk_usbd_connect(&user_usbd);
}

只看该作者 · 2019-12-27 14:15

本帖最后由 vsfopen 于 2019-12-27 14:33 编辑

基于2楼代码，再增加一个MSC试试：

#include "vsf.h"

implement_usbd(user_usbd, 0x2348, 0xA7A8, 0x0409, USB_DC_SPEED_HIGH)
implement_usbd_common_desc(user_usbd, u"VSF-USBD-Simplest", u"SimonQian", u"1.0.0", 64, 2 * USB_DESC_CDC_ACM_IAD_LEN + USB_DESC_MSCBOT_IAD_LEN, 2 * USB_CDC_ACM_IFS_NUM + USB_MSCBOT_IFS_NUM, USB_CONFIG_ATT_WAKEUP, 100)
      implement_cdc_acm_desc(user_usbd, 0, 0, 1, 2, 2, 512, 16)
      implement_cdc_acm_desc(user_usbd, 1 * USB_CDC_ACM_IFS_NUM, 1, 3, 4, 4, 512, 16)
      implement_msc_desc( user_usbd, 2 * USB_CDC_ACM_IFS_NUM, 2, 5, 5, 512)
implement_usbd_func_desc(user_usbd)
      implement_usbd_func_str_desc(user_usbd, 0, u"VSF-CDC0")
      implement_usbd_func_str_desc(user_usbd, 1, u"VSF-CDC1")
      implement_usbd_func_str_desc(user_usbd, 2, u"VSF-MSC0")
implement_usbd_std_desc_table(user_usbd)
      implement_usbd_func_str_desc_table(user_usbd, 0)
      implement_usbd_func_str_desc_table(user_usbd, 1)
      implement_usbd_func_str_desc_table(user_usbd, 2)
implement_usbd_device_func(user_usbd)
      implement_cdc_acm_func(user_usbd, 0, 1, 2, 2, NULL, NULL, USB_CDC_ACM_LINECODE(115200, 8, USB_CDC_ACM_PARITY_NONE, USB_CDC_ACM_STOPBIT_1))
      implement_cdc_acm_func(user_usbd, 1, 3, 4, 4, NULL, NULL, USB_CDC_ACM_LINECODE(115200, 8, USB_CDC_ACM_PARITY_NONE, USB_CDC_ACM_STOPBIT_1))
      implement_msc_func( user_usbd, 2, 5, 5, 0, NULL, NULL)
implement_usbd_device_ifs(user_usbd)
      implement_cdc_acm_ifs(user_usbd, 0)
      implement_cdc_acm_ifs(user_usbd, 1)
      implement_msc_ifs(user_usbd, 2)
end_implement_usbd(user_usbd, VSF_USB_DC0)

void main(void)
{
vk_usbd_init(&user_usbd);
vk_usbd_connect(&user_usbd);
}

这里也都是增量式的开发方式，增加新功能，那就增加新的宏，并且填参数。
这里MSC是跑不起来的，因为MSC不仅仅需要USB，还需要一个SCSI设备（可以用一块内存模拟），目前仅仅有USB部分的代码是没用的

其实，之前的CDC也只是USB部分，并没有实现数据流的代码，这里演示的也只是USB的极简化开发方式

只看该作者 · 2019-12-27 14:31

本帖最后由 vsfopen 于 2019-12-29 17:17 编辑

VSF项目的git仓库：https://github.com/vsfteam/vsf

下载之后，使用IAR打开工程，工程位于：vsf/tree/master/source/example/project/iar_8.4

工程需要选择：usbd_demo_simplest

然后可以直接编译，下载，硬件使用M484，USB设备口接电脑

用户代码只要一个最简配置文件和一个main.c

另外，在上一个echo的demo，红色为改动的地方，这里实现了一个1K的mem_stream流（实际大小可修改，大于一个EP size就行），并且让CDC的收发流都指向这个，就实现了echo功能：
#include "vsf.h"

implement_mem_stream(user_usbd_cdc_acm_stream, 1024)

implement_usbd(user_usbd, 0x2348, 0xA7A8, 0x0409, USB_DC_SPEED_HIGH)
implement_usbd_common_desc(user_usbd, u"VSF-USBD-Simplest", u"SimonQian", u"1.0.0", 64, USB_DESC_CDC_ACM_IAD_LEN, USB_CDC_ACM_IFS_NUM, USB_CONFIG_ATT_WAKEUP, 100)
      implement_cdc_acm_desc(user_usbd, 0, 0, 1, 2, 2, 512, 16)
implement_usbd_func_desc(user_usbd)
      implement_usbd_func_str_desc(user_usbd, 0, u"VSF-CDC")
implement_usbd_std_desc_table(user_usbd)
      implement_usbd_func_str_desc_table(user_usbd, 0)
implement_usbd_device_func(user_usbd)
      implement_cdc_acm_func(user_usbd, 0, 1, 2, 2, &user_usbd_cdc_acm_stream, &user_usbd_cdc_acm_stream, USB_CDC_ACM_LINECODE(115200, 8, USB_CDC_ACM_PARITY_NONE, USB_CDC_ACM_STOPBIT_1))
implement_usbd_device_ifs(user_usbd)
      implement_cdc_acm_ifs(user_usbd, 0)
end_implement_usbd(user_usbd, VSF_USB_DC0)

void main(void)
{
vk_usbd_init(&user_usbd);
vk_usbd_connect(&user_usbd);
}