usbapp - USB功能操作#

已适配 Air105

备注

本页文档由这个文件自动生成。如有错误，请提交issue或帮忙修改后pr，谢谢！

小技巧

常量#

常量	类型	解释
usbapp.NO_READY	number	NO_READY事件
usbapp.READY	number	READY事件
usbapp.SEND_OK	number	SEND_OK事件
usbapp.NEW_DATA	number	NEW_DATA事件

usbapp.set_id(id, vid, pid)#

USB 设置VID和PID

参数

传入值类型	解释
int	设备id,默认为0
int	vid 小端格式
int	pid 小端格式

返回值

无

例子

usbapp.set_id(0, 0x1234, 0x5678)

usbapp.hid_mode(id, mode, buff_size)#

USB HID设备模式

参数

传入值类型	解释
int	设备id,默认为0
int	mode，目前0是键盘，1是自定义
int	buff_size，只能是8,16,32,64，如果是键盘模式或者填了其他值，自动为8

返回值

无

例子

usbapp.hid_mode(0, 0) -- usb hid键盘模式
usbapp.hid_mode(0, 1) -- usb hid自定义模式，用于免驱USB交互

usbapp.start(id)#

启动USB设备

参数

传入值类型	解释
int	设备id,默认为0

返回值

返回值类型	解释
bool	成功返回true,否则返回false

例子

-- 启动USB
usbapp.start(0)

usbapp.stop(id)#

关闭USB设备

参数

传入值类型	解释
int	设备id,默认为0

返回值

返回值类型	解释
bool	成功返回true,否则返回false

例子

-- 关闭USB
usbapp.stop(0)

usbapp.vhid_upload(id, data)#

USB HID设备上传数据

参数

传入值类型	解释
int	设备id,默认为0
string	数据. 注意, HID的可用字符是有限制的, 基本上只有可见字符是支持的, 不支持的字符会替换为空格.

返回值

返回值类型	解释
bool	成功返回true,否则返回false

例子

-- HID上传数据
usbapp.vhid_upload(0, "1234") -- usb hid会模拟敲出1234

usbapp.hid_tx(id, data, start, len)#

USB HID设备上传用户自定义数据

参数

传入值类型	解释
int	设备id,默认为0
string	or zbuff 注意数据量不足时会自动填充0
int	可选，data为zbuff才有效，要发送的数据起始位置，默认为0
int	可选，data为zbuff才有效，要发送的数据长度，默认为zbuff内有效数据，最大值不超过zbuff的最大空间

返回值

返回值类型	解释
bool	成功返回true,否则返回false

例子

-- HID上传数据
usbapp.hid_tx(0, "1234") -- usb hid上传0x31 0x32 0x33 0x34  + N个0

usbapp.hid_rx(id, buff)#

buff形式读接收到的数据，一次读出全部数据存入buff中，如果buff空间不够会自动扩展，目前只有air105支持这个操作

参数

传入值类型	解释
int	设备id,默认为0
zbuff	zbuff对象

返回值

返回值类型	解释
int	返回读到的长度，并把zbuff指针后移

例子

usbapp.hid_rx(0, buff)

usbapp.vhid_cancel_upload(id)#

USB HID设备取消上传数据

参数

传入值类型	解释
int	设备id,默认为0

返回值

返回值类型	解释
nil	无返回值

例子

-- 取消上传数据,通常不需要
usbapp.vhid_cancel_upload(0)

usbapp.udisk_attach_sdhc(id)#

USB U盘设备挂载SDHC，TF卡

参数

传入值类型	解释
int	设备id,默认为0

返回值

返回值类型	解释
nil	无返回值

例子

usbapp.udisk_attach_sdhc(0)

usbapp.udisk_detach_sdhc(id)#

USB U盘设备去除挂载SDHC，TF卡

参数

传入值类型	解释
int	设备id,默认为0

返回值

返回值类型	解释
nil	无返回值

例子

usbapp.udisk_detach_sdhc(0)