OneOS简介硬件支持

SOC/MCU 开发板传感器

编译构造工具

工具简介(OneOS-Cube) 系统配置(menuconfig)

menuconfig工作机制 menuconfig使用 Kconfig编写

编译构造(SCons)

SCons简介 SCons基本命令 SCons常用语法 scons脚本编写

生成Keil工程

API参考文档

技术架构及目录结构内核

基础数据类型标准宏定义链表断言硬件操作抽象接口对外公共库任务管理及调度时钟节拍管理定时器管理中断管理任务间同步

信号量互斥锁事件完成量

任务间通信

邮箱消息队列数据队列

内存堆管理内存池管理工作队列日志接口

驱动

设备模型 ADC设备 DAC设备 Pulse Encoder设备 PWM设备 Serial设备 LPM设备 I2C设备 SPI设备 USB设备 Sensor设备 RTC设备 Watchdog设备 Clocksource设备 Clockevent设备 Crypto设备 CAN设备 Touch设备 Audio设备 WLAN设备

组件

SHELL工具日志系统测试框架文件系统 RAMDISK 模组连接套件套接字组件 Paho MQTT接入协议 LibCoAP接入协议 OneNET EDP接入协议 OneNET-MQTT物联网套件 OneNET-NBIoT物联网套件定位

高级语言

MicroPython

简介环境创建快速上手

windows环境 linux环境支持OneOS的开发板

库介绍

micropython标准库 micropython特定库

machine：片上资源硬件控制模块

Pin I2C SPI UART RTC PWM ADC WDT TIMER

device：外设资源硬件控制模块

OLED FontLibrary Battery Bluetooth Finger Flash Motor Humiture Key RFID SE TouchKey Voice

应用开发指南

REPL(交互式解释器) 应用脚本的开发

用户编程手册

内核驱动组件

应用笔记 FAQ

USB设备

应用API 列表

接口	说明
os_device_find()	根据usb设备名称查找设备
os_device_open()	打开usb设备
os_device_read()	读数据
os_device_write()	写数据

os_device_find

该函数根据usb设备名称查找设备，函数原型如下：

os_device_t *os_device_find(const char* name);

参数	说明
name	usb设备名称
返回	说明
设备指针	查找到对应设备将返回相应的设备指针
OS_NULL	没有找到相应的设备对象

os_device_open

该函数用于打开usb设备，函数原型如下：

os_err_t os_device_open(os_device_t *dev, os_uint16_t oflag);

参数	说明
dev	设备指针
oflag	设备模式标志，一般以读写方式打开，即取值：OS_DEVICE_OFLAG_RDWR
返回	说明
OS_EOK	设备打开成功
OS_EBUSY	设备忙
其他错误码	设备打开失败

os_device_read

该函数用于读取接收到的数据，函数原型如下：

os_size_t os_device_read(os_device_t *dev, os_off_t pos, void* buffer, os_size_t size);

参数	说明
dev	设备指针
pos	读取数据偏移量，固定为0
buffer	缓冲区指针，读取的数据将会被保存在缓冲区中
size	读取数据的大小
返回	说明
读到数据的实际大小	返回读取到数据的个数
0	需要读取当前线程的 errno 来判断错误状态

os_device_write

该函数用于写入发送数据，函数原型如下：

os_size_t os_device_write(os_device_t *dev, os_off_t pos, const void *buffer, os_size_t size);

参数	说明
dev	设备指针
pos	写入数据偏移量
buffer	内存缓冲区指针，放置要写入的数据
size	写入数据的大小
返回	说明
写入数据的实际大小	如果是字符设备，返回大小以字节为单位；
0	需要读取当前线程的 errno 来判断错误状态

USBD事件处理函数API列表

接口	说明
os_usbd_reset_handler()	复位事件处理函数
os_usbd_connect_handler()	连接事件处理函数
os_usbd_disconnect_handler()	断开连接事件处理函数

os_usbd_reset_handler

该函数用于驱动程序向usbd协议栈传递 reset 事件，函数原型如下：

os_err_t os_usbd_reset_handler(udcd_t dcd);

参数	说明
dcd	usb设备控制对象
返回	说明
OS_EOK	成功

os_usbd_connect_handler

该函数用于驱动程序向usbd协议栈传递 connect 事件，函数原型如下：

os_err_t os_usbd_connect_handler(udcd_t dcd);

参数	说明
dcd	usb设备控制对象
返回	说明
OS_EOK	成功

os_usbd_disconnect_handler

该函数用于驱动程序向usbd协议栈传递 disconnect 事件，函数原型如下：

os_err_t os_usbd_disconnect_handler(udcd_t dcd);

参数	说明
dcd	usb设备控制对象
返回	说明
OS_EOK	成功

使用示例

本例程为usb模拟鼠标的测试例程：

#include <board.h>
#include <shell.h>
#include <stdint.h>

static int x = 0;
static int y = 0;
static int left = 0;
static int right = 0;
static int scroll = 0;

static void left_callback(void *args)
{
    left = 1;
    os_kprintf("left button click\r\n");
}

static void right_callback(void *args)
{
    right = 1;
    os_kprintf("right button click\r\n");
}

static void update_mouse(os_device_t *device)
{
    uint8_t report[4];

    if ((left | right) != 0)
    {
        report[0] = 0x08 | left | right << 1;
    }
    else
    {
        report[0] = 0;
    }

    report[1] = x;
    report[2] = y;
    report[3] = scroll;

    os_device_write(device, HID_REPORT_ID_MOUSE, report, 4);

    left = 0;
    right = 0;
}

static int usbd_hid_test(int argc, char **argv)
{
    int i, j;
    os_device_t *device = os_device_find("hidd");
    OS_ASSERT(device != OS_NULL);
    os_device_open(device, OS_DEVICE_FLAG_WRONLY);

    /* mouse left button */
    if (key_table_size > 0)
    {
        os_pin_mode(key_table[0].pin, key_table[0].mode);
        os_pin_attach_irq(key_table[0].pin, key_table[0].irq_mode, left_callback, NULL);
        os_pin_irq_enable(key_table[0].pin, PIN_IRQ_ENABLE);
    }

    /* mouse right button */
    if (key_table_size > 1)
    {
        os_pin_mode(key_table[1].pin, key_table[1].mode);
        os_pin_attach_irq(key_table[1].pin, key_table[1].irq_mode, right_callback, NULL);
        os_pin_irq_enable(key_table[1].pin, PIN_IRQ_ENABLE);
    }

    for (j = 0; j < 5; j++)
    {
        os_kprintf("loop %d/5\r\n", j + 1);

        for (i = 0; i < 20; i++)
        {
            x = 10;
            y = 0;
            update_mouse(device);
            os_task_msleep(100);
        }

        for (i = 0; i < 20; i++)
        {
            x = 0;
            y = 10;
            update_mouse(device);
            os_task_msleep(100);
        }

        for (i = 0; i < 20; i++)
        {
            x = -10;
            y = 0;
            update_mouse(device);
            os_task_msleep(100);
        }

        for (i = 0; i < 20; i++)
        {
            x = 0;
            y = -10;
            update_mouse(device);
            os_task_msleep(100);
        }
    }

    return 0;
}

SH_CMD_EXPORT(usbd_hid_test, usbd_hid_test, "usbd_hid_test");

运行结果如下：

sh>usbd_hid_test
loop 1/5
left button click
left button click
loop 2/5
right button click
loop 3/5
loop 4/5
loop 5/5