Usbd on CLing

GD32 — USBD

Tue, 08 Sep 2026 14:52:21 +0800

GD32 — USBD

固件库: GD32F30x_Firmware_Library V3.0.3
示例数: 11

示例列表

USB 音频 — audio
USB CDC ACM 虚拟串口 — cdc_acm
复合设备: 双 CDC — composite_dev_dual_cdc
复合设备: HID + 打印机 — composite_dev_hid_printer
自定义 HID — custom_hid
设备固件升级 (DFU) — dev_firmware_update
IAP HID — in_application_program_hid
USB CD-ROM — msc_cdrom
USB U 盘 — msc_udisk
标准 HID 键盘 — standard_hid_keyboard
USB 打印机 — usb_printer

GD32 USBD — IAP HID

Tue, 08 Sep 2026 14:52:21 +0800

USBD — IAP HID

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/in_application_program_hid/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "usb_iap_core.h"
#include "usbd_hw.h"
#define SRAM_BASE_ADDR      SRAM_BASE
#define SRAM_END_ADDR       (SRAM_BASE + GET_BITS(REG32(0x1FFFF7E0U), 16U, 31U) * 1024U)

int main(void)
{
    uint32_t app_address;
    app_func application;
    uint32_t sram_sect = REG32(APP_LOADED_ADDR);

    /* configure Tamper key to run firmware */
    gd_eval_key_init(KEY_TAMPER, KEY_MODE_GPIO);

    /* tamper key must be pressed on board when power on */
    if(0U !=gd_eval_key_state_get(KEY_TAMPER)) {
        /* test if user code is programmed starting from address 0x8008000 */
        if((sram_sect >= SRAM_BASE_ADDR) && (sram_sect < SRAM_END_ADDR)){
            app_address = *(__IO uint32_t*) (APP_LOADED_ADDR + 4U);
            application = (app_func) app_address;

            /* initialize user application's stack pointer */
            __set_MSP(*(__IO uint32_t*) APP_LOADED_ADDR);

            /* jump to user application */
            application();
        }
    }

    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usbd_iap, &iap_desc, &iap_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    usbd_connect(&usbd_iap);

    while(1) {
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — USB CD-ROM

Tue, 08 Sep 2026 14:52:21 +0800

USBD — USB CD-ROM

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/msc_cdrom/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "usbd_msc_core.h"
#include "usbd_hw.h"

int main(void)
{
    __IO uint8_t flag = 0U;

    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usb_msc, &msc_desc, &msc_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    gpio_bit_set(USB_PULLUP, USB_PULLUP_PIN);

    usbd_connect(&usb_msc);

    flag = Flash_Data[0];

    while(USBD_CONFIGURED != usb_msc.cur_status){
    }

    while(1) {
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — USB CDC ACM 虚拟串口

Tue, 08 Sep 2026 14:52:21 +0800

USBD — USB CDC ACM 虚拟串口

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/cdc_acm/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "cdc_acm_core.h"
#include "usbd_hw.h"

int main(void)
{
    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usbd_cdc, &cdc_desc, &cdc_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    usbd_connect(&usbd_cdc);

    while(USBD_CONFIGURED != usbd_cdc.cur_status) {
        /* wait for standard USB enumeration is finished */
    }

    while(1) {
        if(0U == cdc_acm_check_ready(&usbd_cdc)) {
            cdc_acm_data_receive(&usbd_cdc);
        } else {
            cdc_acm_data_send(&usbd_cdc);
        }
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — USB U 盘

Tue, 08 Sep 2026 14:52:21 +0800

USBD — USB U 盘

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/msc_udisk/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "usbd_msc_core.h"
#include "usbd_hw.h"

int main(void)
{
    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usb_msc, &msc_desc, &msc_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    usbd_connect(&usb_msc);

    while(USBD_CONFIGURED != usb_msc.cur_status) {
    }

    while(1) {
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — USB 打印机

Tue, 08 Sep 2026 14:52:21 +0800

USBD — USB 打印机

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/usb_printer/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "printer_core.h"
#include "usbd_hw.h"

int main(void)
{
    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usbd_printer, &printer_desc, &printer_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    usbd_connect(&usbd_printer);

    while(USBD_CONFIGURED != usbd_printer.cur_status) {
        /* wait for standard USB enumeration is finished */
    }

    while(1) {
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — USB 音频

Tue, 08 Sep 2026 14:52:21 +0800

USBD — USB 音频

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/audio/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "audio_core.h"
#include "usbd_hw.h"

int main(void)
{
    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usbd_audio, &audio_desc, &audio_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    usbd_connect(&usbd_audio);

    while(1) {
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — 标准 HID 键盘

Tue, 08 Sep 2026 14:52:21 +0800

USBD — 标准 HID 键盘

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/standard_hid_keyboard/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "standard_hid_core.h"
#include "usbd_hw.h"

int main(void)
{
    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    hid_itfop_register(&usb_hid, &fop_handler);

    /* USB device configuration */
    usbd_init(&usb_hid, &hid_desc, &hid_class);

    /* NVIC configuration */
    nvic_config();

    usbd_connect(&usb_hid);

    while(USBD_CONFIGURED != usb_hid.cur_status) {
    }

    while(1) {
        fop_handler.hid_itf_data_process(&usb_hid);
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — 复合设备: HID + 打印机

Tue, 08 Sep 2026 14:52:21 +0800

USBD — 复合设备: HID + 打印机

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/composite_dev_hid_printer/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "hid_printer_wrapper.h"
#include "usbd_hw.h"

void key_config(void);
void led_config(void);

/*!
    \brief      main routine
    \param[in]  none
    \param[out] none
    \retval     none
*/
int main(void)
{
    /* led configuration */
    led_config();

    /* key configuration */
    key_config();

    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usbd_hid_printer, &hid_printer_desc, &hid_printer_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    usbd_connect(&usbd_hid_printer);

    while(USBD_CONFIGURED != usbd_hid_printer.cur_status) {
        /* wait for standard USB enumeration is finished */
    }

    while(1) {
    }
}

void key_config(void)
{
    /* keys configuration */
    gd_eval_key_init(KEY_USER1, KEY_MODE_EXTI);
    gd_eval_key_init(KEY_WAKEUP, KEY_MODE_EXTI);
}

void led_config(void)
{
    /* initialize LEDs */
    gd_eval_led_init(LED2);
    gd_eval_led_init(LED3);
    gd_eval_led_init(LED4);
    gd_eval_led_init(LED5);
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — 复合设备: 双 CDC

Tue, 08 Sep 2026 14:52:21 +0800

USBD — 复合设备: 双 CDC

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/composite_dev_dual_cdc/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "dual_cdc_acm_core.h"
#include "usbd_hw.h"

int main(void)
{
    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usbd_dual_cdc, &dual_cdc_desc, &dual_cdc_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    usbd_connect(&usbd_dual_cdc);

    while(USBD_CONFIGURED != usbd_dual_cdc.cur_status) {
        /* wait for standard USB enumeration is finished */
    }

    while(1) {
        if(0U == cdc_check_ready0(&usbd_dual_cdc)) {
            cdc_data_receive0(&usbd_dual_cdc);
        } else {
            cdc_acm_data_send0(&usbd_dual_cdc);
        }

        if(0U == cdc_check_ready1(&usbd_dual_cdc)) {
            cdc_data_receive1(&usbd_dual_cdc);
        } else {
            cdc_acm_data_send1(&usbd_dual_cdc);
        }
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — 设备固件升级 (DFU)

Tue, 08 Sep 2026 14:52:21 +0800

USBD — 设备固件升级 (DFU)

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/dev_firmware_update/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "dfu_core.h"
#include "usbd_hw.h"
#define SRAM_BASE_ADDR      SRAM_BASE
#define SRAM_END_ADDR       (SRAM_BASE + GET_BITS(REG32(0x1FFFF7E0U), 16U, 31U) * 1024U)

int main(void)
{
    uint32_t app_addr;
    app_func application;
    uint32_t sram_sect = REG32(APP_LOADED_ADDR);

    /* configure tamper key to run firmware */
    gd_eval_key_init(KEY_TAMPER, KEY_MODE_GPIO);

    /* tamper key must be pressed on GD32-EVAL when power on */
    if(0U != gd_eval_key_state_get(KEY_TAMPER)){
        /* test if user code is programmed starting from address 0x08008000 */
        if((sram_sect >= SRAM_BASE_ADDR) && (sram_sect < SRAM_END_ADDR)){
            app_addr = *(__IO uint32_t*) (APP_LOADED_ADDR + 4U);
            application = (app_func) app_addr;

            /* initialize user application's stack pointer */
            __set_MSP(*(__IO uint32_t*) APP_LOADED_ADDR);

            /* jump to user application */
            application();
        }
    }

    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    /* USB device configuration */
    usbd_init(&usb_dfu, &dfu_desc, &dfu_class);

    /* NVIC configuration */
    nvic_config();

    usbd_connect(&usb_dfu);

    while(1) {
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 USBD — 自定义 HID

Tue, 08 Sep 2026 14:52:21 +0800

USBD — 自定义 HID

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/USBD/custom_hid/src/main.c

功能简介

本示例演示 USBD 的基本用法。

完整代码

#include "custom_hid_core.h"
#include "usbd_hw.h"

int main(void)
{
    /* system clocks configuration */
    rcu_config();

    /* GPIO configuration */
    gpio_config();

    custom_hid_itfop_register(&usbd_custom_hid, &fop_handler);

    /* USB device configuration */
    usbd_init(&usbd_custom_hid, &custom_hid_desc, &custom_hid_class);

    /* NVIC configuration */
    nvic_config();

    /* enabled USB pull-up */
    usbd_connect(&usbd_custom_hid);

    while(USBD_CONFIGURED != usbd_custom_hid.cur_status) {
        /* wait for standard USB enumeration is finished */
    }

    while(1) {
    }
}

代码讲解

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。