English

• MR 框かまち架か
• 简介
• 关键特性とくせい
• 主要しゅよう组成
• 标准化か设备接せっ口こう
• 配置はいち工具こうぐ
• 目め录结构
• 设备/组件支持しじ一いち览表
• 开始使用しよう
  • 验证Python环境
  • 将はた项目导入工程こうてい
  • 配置はいち菜さい单选项
• 先さき来らい点てん个灯吧
• Hello World
• 现在您已经完成かんせい了りょう入にゅう门教程ほど，开始使用しようMR库吧

MR 框かまち架か是ぜ专为嵌入かんにゅう式しき系けい统设计的轻量级框架か。充分じゅうぶん考こう虑了嵌入かんにゅう式しき系けい统在资源和わ性能せいのう方面ほうめん的てき需求。 通つう过提供ていきょう标准化か的てき设备管理かんり接せっ口こう，极大简化了りょう嵌入かんにゅう式しき应用开发的てき难度，帮助开发者しゃ快速かいそく构建嵌入かんにゅう式しき应用程ほど序じょ。

框かまち架か为开发者提供ていきょう了りょう标准化か的てき开启(open)、关闭(close)、控ひかえ制せい(ioctl)、读(read)、写うつし(write) 等とう接せっ口こう。它将应用程ほど序じょ与あずか底そこ层硬件けん驱动进行解かい耦。应用程ほど序じょ无需了解りょうかい驱动的てき实现细节。 当とう硬かた件けん发生改あらため变时,只ただ需要じゅよう适配底そこ层驱动,应用程ほど序じょ就可以无缝迁移うつり到いた新しん硬かた件けん上じょう。这大大だい提ひさげ高だか了りょう软件的てき可か重用じゅうよう性せい和わ应对新しん硬かた件けん的てき可か扩展性せい。

• 标准化か的てき设备访问接せっ口こう
• 应用程ほど序じょ和わ驱动开发解かい耦
• 简化底そこ层驱动和应用程ほど序じょ开发
• 轻量易やす上手じょうず，资源占うらない用よう低ひく
• 模かたぎ块化设计，各部かくぶ分解ぶんかい耦合并独立どくりつ开发，极低的てき硬かた件けん迁移成本なりもと
• 支持しじ在ざい裸はだか机つくえ环境和わ操作そうさ系けい统环境さかい下か使用しよう

• 设备框かまち架か：提供ていきょう设备访问标准接せっ口こう
• 内うち存そん管理かんり：动态内ない存そん管理かんり
• 工具こうぐ：链表、队列、平衡へいこう树等常用じょうよう数すう据すえ结构
• 各かく类功能のう组件

设备的てき所有しょゆう操作そうさ都と可か通どおり过以下か接せっ口こう实现：

示しめせ例れい：

int main(void)
{
    /* 打だ开SPI1总线下か的てきSPI10设备 */
    int ds = mr_dev_open("spi1/spi10", MR_O_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);
}

得とく益えき于标准じゅん化か设备接せっ口こう，所有しょゆう设备自じ动支持しじ msh 设备命令めいれい，通つう过命令れい行ぎょう可か完成かんせい所有しょゆう设备操作そうさ。

MR 提供ていきょう Kconfig 可か视化配置はいち工具こうぐ，开发者しゃ无需深入ふかいり了解りょうかい源げん代だい码即可か进行配置はいち。

Kconfig 会かい根ね据すえ配置はいち文ぶん件けん自じ动生成せいせい配置はいち选项界面かいめん。开发者しゃ可か以通过简单的操作そうさ来らい选择需要じゅよう启用的てき功こう能のう组件和わ设置相しょう关参数すう。

通つう过修改あらため参さん数すう，快速かいそく裁さい剪所需功能のう。配置はいち完成かんせい后きさき通どおり过 Python 脚本きゃくほん自じ动生成せいせい配置はいち文ぶん件けん。

验证系けい统是否いや安あん装そうPython环境。在ざい命令めいれい行ぎょう中ちゅう运行 python --version 检查Python版本はんぽん（MR 脚本きゃくほん工具こうぐ依よ赖Python ，若わか无Python环境请自行ぎょう安あん装そう，暂不支持しじ3.11.7以上いじょう的てき版本はんぽん）。

1. 从 Gitee 或ある Github 仓库下か载最新版しんぱん本源ほんげん码到本地ほんじ。

2. 将はた源みなもと码复制せい到いた您工程ほど所在しょざい的てき目め录。以 MDK 工程こうてい（CubeMX生成せいせい的てき标准工程こうてい）为例：

   

3. 将はた bsp 目め录中对应芯しん片へん的てき驱动复制到いた driver（请仔细阅读bsp中なか的てき文ぶん档）：

   

4. 移うつり除じょ不ふ需要じゅよう的てき文ぶん件けん bsp、document目め录（如不需要じゅようGIT也可以移除じょ.git文ぶん件けん）。完成かんせい后きさき，目もく录结构如下か所しょ示しめせ：

   

5. 使用しよう自じ动构建けん脚本きゃくほん，完成かんせい自じ动构建けん。在ざい mr-library 路みち径みち下か，打だ开命令れい行ぎょう工具こうぐ，运行 python tool.py -b

   以MDK为例：

   

   注ちゅう：

   • 支持しじMDK5、Eclipse。
   • MDK未み先さき编译或ある版本はんぽん过低可能かのう导致GNU配置はいち失しつ败。

1. 在ざい mr-library 目め录下打だ开命令れい行ぎょう工具こうぐ，运行 python tool.py -m 进行菜さい单配置はいち。

   

   运行失しつ败：

   • 检查Python版本はんぽん（暂不支持しじ3.11.7以上いじょう的てき版本はんぽん，重じゅう新しん安あん装そう并删除じょ已やめ安あん装そう的てき模も块）。
   • 命令めいれい行ぎょう工具こうぐ不ふ支持しじ，推荐使用しようpowershell(win10及以上じょう)、git bash(较新版本はんぽん)等ひとし。

2. 选中 Device configure 回かい车进入にゅう菜さい单，配置はいち功こう能のう。

   

3. 配置はいち完成かんせい后きさき，按 Q 退出たいしゅつ菜さい单配置はいち界面かいめん，按Y 保存ほぞん配置はいち，脚本きゃくほん将はた自じ动生成せいせい配置はいち文ぶん件けん。

   

4. 工程こうてい中ちゅう引入 #include "include/mr_lib.h" 并在 main 函数かんすう中ちゅう添加てんか mr_auto_init(); 自じ动初始はじめ化か函数かんすう，即そく可か开始使用しよう。

注ちゅう：更さら多た命令めいれい可か输入：python tool.py -h 查看。

#include "include/mr_lib.h"

/* 定てい义LED引脚（PC13）*/
#define LED_PIN_NUMBER                  45

int main(void)
{
    /* 自じ动初始はじめ化か */
    mr_auto_init();

    /* 打だ开PIN设备 */
    int ds = mr_dev_open("pin", MR_O_WRONLY);
    /* 设置到いたLED引脚 */
    mr_dev_ioctl(ds, MR_IOC_PIN_SET_NUMBER, MR_MAKE_LOCAL(int, LED_PIN_NUMBER));
    /* 设置LED引脚为推挽すいばん输出模も式しき */
    mr_dev_ioctl(ds, MR_IOC_PIN_SET_MODE, MR_MAKE_LOCAL(int, MR_PIN_MODE_OUTPUT));

    while(1)
    {
        /* 点てん亮あきらLED */
        mr_dev_write(ds, MR_MAKE_LOCAL(uint8_t, 1), sizeof(uint8_t));
        mr_delay_ms(500);
        mr_dev_write(ds, MR_MAKE_LOCAL(uint8_t, 0), sizeof(uint8_t));
        mr_delay_ms(500);
    }
}

#include "include/mr_lib.h"

int main(void)
{
    /* 自じ动初始はじめ化か */
    mr_auto_init();

    /* 打だ开Serial-1设备 */
    int ds = mr_dev_open("serial1", MR_O_RDWR);
    /* 输出Hello World */
    mr_dev_write(ds, "Hello World\r\n", sizeof("Hello World\r\n"));
    
    while(1);
}

1. 参考さんこう更さら多た教程きょうてい。
2. 尝试基もと于某款芯片へん开发驱动，练习设备驱动编程。
3. 尝试编写更さら多た设备模も板ばん和わ开发更さら多功たこう能のう。
4. 欢迎您提出ていしゅつ意い见和建けん议。如果您对开发有ゆう兴趣，诚邀您参与さんよ到いた MR 项目的もくてき开发中ちゅう来き，项目交流こうりゅう群ぐん：199915649（QQ）。