mr-library简介
一起学嵌入式 2023-09-18


mr-library简介

mr-library 是一个面向嵌入式系统的轻量级框架,提供统一的底层驱动设备模型以及基础服务功能,具有模块化设计、可配置性和扩展性的特点, 可帮助开发者快速构建嵌入式应用程序。

mr-library 框架支持互斥锁、对象管理等基础内核功能。集成异步事件驱动框架(event)、多时基软件定时器(soft-timer) 等服务。提供串口、SPI、I2C、ADC/DAC等常见外设的驱动设备模型,通过统一的驱动接口(open、close、ioctl、read、write)访问底层硬件设备,解耦底层驱动和应用。

应用场景

  • MCU开发的低层驱动程序。
  • RTOS实时操作系统的外挂框架(作为驱动设备框架使用)。
  • 各类IoT和智能硬件产品的快速开发。

驱动设备框架

开发者能以面向对象的方式访问外设,简化驱动逻辑的开发流程。框架实现了常用外设的通用驱动模板,开发者可以快速移植到不同的硬件平台。

驱动设备框架支持普通设备的通用接口、总线设备自动总线控制、多种设备的中断接管。

驱动设备接口

设备驱动框架提供统一的操作接口,设备的所有操作都需要通过以下接口实现:

接口 描述
mr_device_add 添加设备
mr_device_find 查找设备
mr_device_open 打开设备
mr_device_close 关闭设备
mr_device_ioctl 控制设备
mr_device_read 从设备读取数据
mr_device_write 向设备写入数据

SPI设备使用示例:

/* 定义SPI设备 */ #define SPI_DEVICE0_CS_PIN              10 #define SPI_DEVICE1_CS_PIN              20 struct mr_spi_device spi_device0, spi_device1; /* 添加SPI设备 */ mr_spi_device_add(&spi_device0, "spi10", SPI_DEVICE0_CS_PIN);
mr_spi_device_add(&spi_device1, "spi11", SPI_DEVICE1_CS_PIN); /* 查找SPI设备 */ mr_device_t spi0_device = mr_device_find("spi10"); mr_device_t spi1_device = mr_device_find("spi11"); /* 挂载总线 */ mr_device_ioctl(spi0_device, MR_CTRL_ATTACH, "spi1");
mr_device_ioctl(spi1_device, MR_CTRL_ATTACH, "spi1"); /* 以可读可写的方式打开SPI设备 */ mr_device_open(spi0_device, MR_OPEN_RDWR);
mr_device_open(spi1_device, MR_OPEN_RDWR); /* 发送数据 */ char buffer0[] = "hello"; char buffer1[] = "world";
mr_device_write(spi0_device, 0, buffer0, sizeof(buffer0) - 1);
mr_device_write(spi1_device, 0, buffer1, sizeof(buffer1) - 1); /* 读取数据 */ mr_device_read(spi0_device, 0, buffer0, sizeof(buffer0) - 1);
mr_device_read(spi1_device, 0, buffer1, sizeof(buffer1) - 1); /* 关闭设备 */ mr_device_close(spi0_device);
mr_device_close(spi1_device);

服务框架

mr-library 框架集成了轻量级的服务框架,用于构建嵌入式开发中的应用服务,支持异步事件监听,多时基软件定时器等。通过服务框架完成对应用层不同应用间的解耦,实现应用程序的模块化,可裁剪,业务逻辑清晰,开发快速,代码高度复用。

事件服务

事件服务是一种异步事件处理机制,它通过事件分发和回调的方式,可以有效地提高系统的异步处理能力、解耦性和可扩展性。

事件服务包含两个部分:事件服务器和事件。

  • 事件服务器用于接收和分发事件,其内部维护一个事件队列用于存储待处理事件和一个事件列表用于存储已创建事件。
  • 事件需要创建到事件服务器并提供一个回调函数。

当事件发生时,事件服务器会将事件插入到事件队列中进行缓存。事件服务器会周期性地从事件队列中取出事件进行分发,找到对应的事件回调进行事件处理。

事件服务操作接口

接口 描述
mr_event_server_find 查找事件服务器
mr_event_server_add 添加事件服务器
mr_event_server_remove 移除事件服务器
mr_event_server_handle 事件服务器处理
mr_event_create 创建事件
mr_event_delete 移除事件
mr_event_notify 通知事件发生
mr_event_trigger 触发事件

事件服务使用示例:

/* 定义事件 */ #define EVENT1                          1 #define EVENT2                          2 #define EVENT3                          3 /* 定义事件服务器 */ struct mr_event_server event_server; mr_err_t event1_cb(mr_event_server_t server, void *args) { printf("event1_cb\r\n"); /* 通知事件服务器事件2发生 */ mr_event_notify(EVENT2, server); return MR_ERR_OK;
} mr_err_t event2_cb(mr_event_server_t server, void *args) { printf("event2_cb\r\n"); /* 通知事件服务器事件3发生 */ mr_event_notify(EVENT3, server) return MR_ERR_OK;
} mr_err_t event3_cb(mr_event_server_t server, void *args) { printf("event3_cb\r\n"); return MR_ERR_OK;
} int main(void) { /* 添加事件服务器到内核容器 */ mr_event_server_add(&event_server, "server", 4); /* 创建事件到服务器 */ mr_event_create(EVENT1, event1_cb, MR_NULL, &event_server);
    mr_event_create(EVENT2, event2_cb, MR_NULL, &event_server);
    mr_event_create(EVENT3, event3_cb, MR_NULL, &event_server); /* 通知事件服务器事件1发生 */ mr_event_notify(EVENT1, &event_server); while (1)
    { /* 事件服务器处理 */ mr_event_server_handle(&event_server);
    }
}

现象:

event1_cb
event2_cb
event3_cb

软件定时器服务

软件定时器是一种在软件层面实现计时功能的机制,通过软件定时器,可以在特定时间点或时间间隔触发特定的事件。软件定时器常用于实现周期性任务、超时处理、定时器中断等功能。

软件定时器包含两个主要组件:定时服务器和定时器。

  • 定时服务器用于时间管理和定时器处理。
  • 定时器用于处理特定的超时处理,它需要注册到定时服务器并提供一个回调函数。

软件定时器服务操作接口

接口 描述
mr_soft_timer_server_find 查找定时服务器
mr_soft_timer_server_add 添加定时服务器
mr_soft_timer_server_remove 移除定时服务器
mr_soft_timer_server_update 定时服务器时基信号更新
mr_soft_timer_server_handle 定时服务器处理
mr_soft_timer_add 添加定时器
mr_soft_timer_remove 移除定时器
mr_soft_timer_start 启动定时器
mr_soft_timer_stop 暂停定时器
mr_soft_timer_add_then_start 添加定时器并启动

软件定时器服务使用示例:

/* 定义定时服务器和定时器 */ struct mr_soft_timer_server server; struct mr_soft_timer timer1, timer2, timer3; mr_err_t timer1_callback(mr_soft_timer timer, void *args) { printf("timer1_callback\r\n"); return MR_ERR_OK;
} mr_err_t timer2_callback(mr_soft_timer timer, void *args) { printf("timer2_callback\r\n"); return MR_ERR_OK;
} mr_err_t timer3_callback(mr_soft_timer timer, void *args) { printf("timer3_callback\r\n");
    mr_soft_timer_stop(timer); return MR_ERR_OK;
} int main(void) { /* 添加定时服务器 */ mr_soft_timer_server_add(&server, "soft-timer"); /* 添加定时器并启动 */ mr_soft_timer_add_then_start(&timer1, 5, timer1_callback, MR_NULL, &server);
    mr_soft_timer_add_then_start(&timer2, 10, timer2_callback, MR_NULL, &server);
    mr_soft_timer_add_then_start(&timer3, 15, timer3_callback, MR_NULL, &server); while (1)
    { /* 更新定时服务器时钟 */ mr_soft_timer_server_update(&server, 1); /* 定时服务器处理(放在哪里,回调就将在哪里被调用) */ mr_soft_timer_server_handle(&server);
    }
}

代码目录

mr-library 的代码目录结构如下表所示:

名称 描述
bsp 板级支持包
device 设备文件
document 文档
driver 驱动文件
include 库头文件
module 组件
package 软件包
src 库源文件
  • 内核层: mr-library 的核心部分,实现对象管理,设备控制,服务接口等。
  • 设备层: 提供统一的设备接口,将设备接入到内核中。
  • 驱动层: 为设备提供底层硬件驱动,当硬件更换时仅需修改驱动层。
  • 组件层: 通过框架提供的API实现不同的功能。包括但不限于虚拟文件系统、通用传感器模块、网络框架等。
  • 软件包: 可独立使用,无依赖的软件包。


声明: 本文转载自其它媒体或授权刊载,目的在于信息传递,并不代表本站赞同其观点和对其真实性负责,如有新闻稿件和图片作品的内容、版权以及其它问题的,请联系我们及时删除。(联系我们,邮箱:evan.li@aspencore.com )
0
评论
  • 【7.24 深圳】2025国际AI+IoT生态发展大会/2025全球 MCU及嵌入式技术论坛


  • 相关技术文库
  • C语言
  • 编程
  • 软件开发
  • 程序
  • 51单片机数码管显示跑马灯程序源代码讲解

    基于51单片机学习板。用S1键作为控制跑马灯的方向按键,S5键作为控制跑马灯方向的加速度按键,S9键作为控制跑马灯方向的减速度按键,S13键作为控制跑马灯方向的启动或者暂停按键。记得把输出线P0.4一直输出低电平,...

    昨天
  • 基于ARM的智能家居控制通信控制站的设计与实现

    0 引言 物体信息化是现代社会信息化建设的“催化剂”和“增倍器”。只有走集成整合信息技术以及信息数据之路,企业的信息化建设才能真正发挥作用,才能进一步推动信息建设上水平。现代物体信息化的发展,直接刺激了新生...

    前天
  • ARM中打印函数print 的几种实现方法

    1利用C库函数printf。 步骤: 1)首先需要包含头文件stdio.h。 2)然后定义文件句柄。实际上就是一个int型变量封装在结构体中。 struct__FILE{inthandle;}; 3)定义FILE__stdout;FILE即为__FILE,通过stdio.h宏定义。...

    前天
  • 高效的C编程之:C编译器及其优化(上)

    本章将帮助读者在ARM处理器上编写高效的C代码。本章涉及的一些技术不仅适用于ARM处理器,也适用于其他RISC处理器。本章首先从ARM编译器及其优化入手,讲解C编译器在优化代码时所碰到的一些问题。理解这些问题,将有...

    07-08
  • 有关C51的编程规范

    简介:编程首要是要考虑程序的可行性,然后是可读性、可移植性、健壮性以及可测试性。这是总则。但是很多人忽略了可读性、可移植性和健壮性(可调试的方法可能歌不相同),这是不对的。 下面就来说说有关C51的编程规...

    07-08
  • 光立方程序编写步骤

    基于51单片机的4*4*4光立方程序实现原理及程序代码。LED光立方的复位电路、时钟电路、每层LED灯电路控制逻辑,系统总原理图,工作流程及相关C语言源码实现。希望能够对你学习了解LED光立方程序编写及LED立方实体制...

    07-04
  • 封装继承多态

    封装: 封装是实现面向对象程序设计的第一步,封装就是将数据或函数等集合在一个个的单元中(我们称之为类)。被封装的对象通常被称为抽象数据类型。 封装的意义: 封装的意义在于保护或者防止代码(数据)被我们无意中...

    07-04
  • 封装是什么意思?

    即隐藏对象的属性和实现细节,仅对外公开接口,控制在程序中属性的读和修改的访问级别;将抽象得到的数据和行为(或功能)相结合,形成一个有机的整体,也就是将数据与操作数据的源代码进行有机的结合,形成“类”,其中...

    07-04
  • 超声波模块测距51程序_单片机超声波测距c语言

    超声波检测原理 超声波测距的程序流程图 程序如下: //超声波模块程序 //超声波模块程序 //Trig = P2^0 //Echo = P3^2 #include #define uchar unsigned char #define uint unsigned int // void delay(uint z) {...

    07-01
  • 大佬带你看嵌入式系统,嵌入式系统该学习什么?

    嵌入式系统是当今的热门系统之一,在诸多领域,嵌入式系统都有所应用。为增进大家对嵌入式系统的认识,小编将为大家介绍嵌入式系统是一个什么样的专业,以及学习嵌入式系统该学习哪些内容。如果你对嵌入式系统具有...

    06-27
  • c51单片机编程要点总结

    c51单片机编程要点总结 1、头文件:#include (我用的是 STC 89C54RD+) 2、预定义:sbit LED = P1^0// 定义 P1 口的 0 位为 LED 注:“P1^0”这个写法,与 A51 不同(A51 是 P1.0),P1 是一组端口,端口号范围 0~7 注2...

    06-25
下载排行榜
更多
评测报告
更多
广告