简介
MR
框架是专为嵌入式系统设计的轻量级框架。充分考虑了嵌入式系统在资源和性能方面的需求。
通过提供标准化的设备管理接口,极大简化了嵌入式应用开发的难度,帮助开发者快速构建嵌入式应用程序。
框架为开发者提供了标准化的开启(open
)、关闭(close
)、控制(ioctl
)、读(read
)、写(write
)等接口。它将应用程序与底层硬件驱动进行解耦。应用程序无需了解驱动的实现细节。
当硬件发生改变时,只需要适配底层驱动,应用程序就可以无缝迁移到新硬件上。这大大提高了软件的可重用性和应对新硬件的可扩展性。
关键特性
- 标准化的设备访问接口
- 应用程序和驱动开发解耦
- 简化底层驱动和应用程序开发
- 轻量易上手,资源占用低
- 模块化设计,各部分解耦合并独立开发,极低的硬件迁移成本
- 支持在裸机环境和操作系统环境下使用
主要组成
- 设备框架:提供设备访问标准接口
- 内存管理:动态内存管理
- 工具:链表、队列、平衡树等常用数据结构
- 各类功能组件
标准化设备接口
设备的所有操作都可通过以下接口实现:
接口 |
描述 |
---|
mr_dev_register |
注册设备 |
mr_dev_open |
打开设备 |
mr_dev_close |
关闭设备 |
mr_dev_ioctl |
控制设备 |
mr_dev_read |
从设备读取数据 |
mr_dev_write |
向设备写入数据 |
示例:
struct mr_spi_dev spi_dev;
int main(void)
{
mr_spi_dev_register(&spi_dev, "spi1/spi10", 0, MR_SPI_CS_ACTIVE_LOW);
int ds = mr_dev_open("spi1/spi10", MR_OFLAG_RDWR);
uint8_t wr_buf[] = {0x01, 0x02, 0x03, 0x04};
mr_dev_write(ds, wr_buf, sizeof(wr_buf));
uint8_t rd_buf[4] = {0};
mr_dev_read(ds, rd_buf, sizeof(rd_buf));
mr_dev_close(ds);
}
配置工具
MR
提供 Kconfig
可视化配置工具,开发者无需深入了解源代码即可进行配置。
Kconfig
会根据配置文件自动生成配置选项界面。开发者可以通过简单的操作来选择需要启用的功能组件和设置相关参数。
通过修改参数,快速裁剪所需功能。配置完成后通过 Python
脚本自动生成配置文件。
目录结构
名称 |
描述 |
---|
bsp |
板级支持包 |
components |
组件 |
device |
设备文件 |
document |
文档 |
driver |
驱动文件 |
include |
库头文件 |
source |
库源文件 |
Kconfig |
配置文件 |
kconfig.py |
自动配置脚本 |
LICENSE |
许可证 |
设备/组件支持一览表
设备/组件 |
计划 |
预览 |
稳定 |
文档 |
---|
ADC |
|
|
[√] |
[√] |
CAN |
|
[√] |
|
|
DAC |
|
|
[√] |
[√] |
I2C |
|
|
[√] |
[√] |
Soft-I2C |
|
|
[√] |
[√] |
Pin |
|
|
[√] |
[√] |
PWM |
[√] |
|
|
|
Serial |
|
|
[√] |
[√] |
SPI |
|
|
[√] |
[√] |
Timer |
|
|
[√] |
[√] |
LCD |
[√] |
|
|
|
Senser |
[√] |
|
|
|
开始使用
验证Python环境
验证系统是否安装Python环境。在命令行中运行 python --version
检查Python版本(MR
脚本工具依赖Python ,若无Python环境请自行安装)。
将项目导入工程
-
从 Gitee
或 Github
仓库下载最新版本源码到本地。
-
将源码复制到您工程所在的目录。以 MDK
工程(CubeMX生成的标准工程)为例:
-
将 bsp
目录中对应芯片的驱动复制到 driver
:
-
移除不需要的文件 bsp
、document
、module
目录(如不需要GIT
也可以移除.git
文件)。完成后,目录结构如下所示:
-
使用自动构建脚本,完成自动构建。在 mr-library
路径下,打开命令行工具,运行:
MDK
:python build.py -mdk
Eclipse
:python build.py -ecl
以MDK
为例:
配置菜单选项
- 在
mr-library
目录下打开命令行工具,运行 python build.py -m
进行菜单配置。
注:当添加对应芯片驱动的后,将显示 Device configure
和 Driver configure
。对应 Driver configure
请参考 bsp
下文档。
- 选中
Device configure
回车进入菜单,按照需要配置功能。
- 配置完成后,按
Q
退出菜单配置界面,按Y
保存配置,脚本将自动生成配置文件。
- 工程中引入
#include "include/mr_lib.h"
并在 main
函数中添加 mr_auto_init();
自动初始化函数,即可开始使用。
注:更多命令可输入:python build.py -h
查看。
先来点个灯吧
#include "include/mr_lib.h"
#define LED_PIN_NUMBER 45
int main(void)
{
mr_auto_init();
int ds = mr_dev_open("pin", MR_OFLAG_RDWR);
mr_dev_ioctl(ds, MR_CTL_PIN_SET_NUMBER, mr_make_local(int, LED_PIN_NUMBER));
mr_dev_ioctl(ds, MR_CTL_PIN_SET_MODE, mr_make_local(int, MR_PIN_MODE_OUTPUT));
while(1)
{
mr_dev_write(ds, mr_make_local(uint8_t, MR_PIN_HIGH_LEVEL), sizeof(uint8_t));
mr_delay_ms(500);
mr_dev_write(ds, mr_make_local(uint8_t, MR_PIN_LOW_LEVEL), sizeof(uint8_t));
mr_delay_ms(500);
}
}
Hello World
#include "include/mr_lib.h"
int main(void)
{
mr_auto_init();
int ds = mr_dev_open("serial1", MR_OFLAG_RDWR);
mr_dev_write(ds, "Hello World\r\n", sizeof("Hello World\r\n"));
while(1);
}
现在您已经完成了入门教程,开始使用MR库吧
来源:https://gitee.com/MacRsh/mr-library