OneOS简介硬件支持

SOC/MCU 开发板传感器温湿度计万耦开发板

快速开发指南

开发环境搭建

开发环境介绍 OneOS-Cube环境搭建 MDK环境搭建

源码获取示例工程体验

Keil模拟器万耦开发板开发手册

从零开始构建代码工程

编译构造工具

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

menuconfig工作机制 menuconfig使用 Kconfig编写

编译构造(SCons)

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

生成Keil工程使用GDB调试工程

API参考文档

技术架构及目录结构内核

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

信号量互斥锁事件完成量

任务间通信

邮箱消息队列数据队列

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

驱动

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

组件

SHELL工具日志系统测试框架文件系统 RAMDISK OTA NetTools Molink Socket MQTT CoAP HTTP WebSocket OneNET-EDP OneNET-MQTT OneNET-NBIoT Aliyun 定位

高级语言

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 SESecure TouchKey Voice

应用开发指南

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

用户编程手册

内核驱动

ADC设备 DAC设备 Pulse Encoder设备 PWM设备 Serial设备 LPM设备 I2C设备 SPI设备 USB设备 Sensor设备 RTC设备 Watchdog设备 Clocksource设备 Clockevent设备 Crypto设备 CAN设备 Touch设备 Audio设备 WLAN设备温湿度计低功耗

组件

远程升级套件网络调试套件模组连接套件 Socket套件 MQTT接入套件 CoAP接入套件 HTTP接入套件 WebSocket接入套件 OneNET EDP物联网套件 OneNET MQTT物联网套件 OneNET NBIoT物联网套件 Aliyun物联网套件

OnePos定位

总体介绍云对云端对云终端配置

应用笔记 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