Edit online

配置 USB 设备功能

Read time: 3 minute(s)

配置 USB Device Controller

配置 USB 设备功能和进行其他开发工作之前，需按照下列流程配置 USB Device Controller：

进入 SDK 根目录，执行下列命令，进入 menuconfig 的功能配置界面：
```
scons menuconfig
```
在 menuconfig 中的功能界面，使能 USB 端口并配置当前 USB 端口为 Device 模式。
```
Board options
   [*] Using Usb0
       Select Usb0 mode (Device)  --->
```
使能 CherryUSB 驱动，并使能 Device 模式。
```
Local packages options
   > Third-party packages options
       [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
           [*]   Enable usb device mode  --->
```
完成上述配置后，USB Device Controller 即可作为 USB 设备进行工作。根据需要，可以继续完成其他功能配置或进行调试和开发。

配置基本显示功能

如需实现 USB Display 的基本显示功能，必须配置 LCD 参数，确保 LCD 能正常显示。关于详细配置描述，可查看 Display 配置和屏适配指南。

除了 LCD 基础功能参数外，USB 端还可对显示功能进行额外控制，详细参数配置描述如下：

进入 SDK 根目录，执行下列命令，进入 menuconfig 的功能配置界面。
```
scons menuconfig
```

在 menuconfig 中的功能界面，使能 CherryUSB 和 USB Device Mode。

> Local packages options
   > Third-party packages options
       [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
           [*]   Enable usb device mode  --->

此时，可配置下列相关功能参数：

注： USB Display 会通过系统 API 自动读取当前屏幕的分辨率，无需额外配置。

[*]   Use display template
        select USB coding format (AUTO)  --->
(0)     scale down for X two sides
(0)     scale down for Y two sides
[ ]     Using switch LCD on/off gpio (NEW)
[ ]     Print FPS in-live

表 1. USB Display 功能的详细参数配置
参数	描述
`Use display template`	使能显示实例模板，必须使能。
`select USB coding format (AUTO)`	图像编码格式，当前主要支持 JPEG 和 H264 编码格式。如不确定编码格式对应的性能，建议使用默认 AUTO 选项。 (X) AUTO ( ) H264 ( ) JPEG
`Using switch LCD on/off gpio (NEW)`	使用物理开关控制屏幕开关。
`GPIO name(NEW)`	开关对应的 GPIO 管脚以及控制的正负极性参数如下： (PD.6) GPIO name (NEW) Select GPIO polarity (0 = On, 1 = Off) --->
`Select switch mode`	选择开关模式 `Select switch mode (Backlight Switch)`：屏幕背光开关模式。使能后，表示使用物理开关来开关屏幕背光。 `Select switch mode (USB Display Switch)`：USB Display 开关模式。使能后，表示使用物理开关切换 USB Display 模式和 LVGL 本地模式。
`Default usb display disable (NEW)`	是否默认 Disable USB Display。该功能通过调用下列函数实现。进行二次开发时，用户可直接调用下列函数： void usb_display_enable(void); void usb_display_disable(void);
`Print FPS in-live`	串口 FPS 实时打印开关的默认值。使能后，系统默认会在调试串口中打印 USB Display 的实时 FPS，示例如下： Current FPS: 60.0 Current FPS: 59.0 在系统运行过程中，可以使用 usb_fps on/off 串口调试命令来动态的打开/ 关闭 FPS 打印。