1# LiteOS-M内核<a name="ZH-CN_TOPIC_0000001096757661"></a> 2 3- [简介](#section11660541593) 4- [目录](#section161941989596) 5- [约束](#section119744591305) 6- [使用说明](#section3732185231214) 7- [贡献](#section1371123476307) 8- [相关仓](#section1371113476307) 9 10## 简介<a name="section11660541593"></a> 11 12OpenHarmony LiteOS-M内核是面向IoT领域构建的轻量级物联网操作系统内核，具有小体积、低功耗、高性能的特点，其代码结构简单，主要包括内核最小功能集、内核抽象层、可选组件以及工程目录等，分为硬件相关层以及硬件无关层，硬件相关层提供统一的HAL（Hardware Abstraction Layer）接口，提升硬件易适配性，不同编译工具链和芯片架构的组合分类，满足AIoT类型丰富的硬件和编译工具链的拓展。其架构图如图1所示： 13 14**图 1** OpenHarmony LiteOS-M核内核架构图<a name="fig0865152210223"></a> 15 16 17## 目录<a name="section161941989596"></a> 18 19目录结构如下，详细目录请参考[arch_spec_zh.md](arch_spec_zh.md)。 20 21``` 22/kernel/liteos_m 23├── arch # 内核指令架构层目录 24│ ├── arm # arm 架构代码 25│ │ ├── arm9 # arm9 架构代码 26│ │ ├── cortex-m3 # cortex-m3架构代码 27│ │ ├── cortex-m33 # cortex-m33架构代码 28│ │ ├── cortex-m4 # cortex-m4架构代码 29│ │ ├── cortex-m55 # cortex-m55架构代码 30│ │ ├── cortex-m7 # cortex-m7架构代码 31│ │ └── include # arm架构公共头文件目录 32│ ├── csky # csky架构代码 33│ │ └── v2 # csky v2架构代码 34│ ├── include # 架构层对外接口存放目录 35│ ├── risc-v # risc-v 架构 36│ │ ├── nuclei # 芯来科技risc-v架构代码 37│ │ └── riscv32 # risc-v官方通用架构代码 38│ └── xtensa # xtensa 架构代码 39│ └── lx6 # xtensa lx6架构代码 40├── components # 可选组件 41│ ├── backtrace # 栈回溯功能 42│ ├── cppsupport # C++支持 43│ ├── cpup # CPUP功能 44│ ├── dynlink # 动态加载与链接 45│ ├── exchook # 异常钩子 46│ ├── fs # 文件系统 47│ ├── lmk # Low memory killer 机制 48│ ├── lms # Lite memory sanitizer 机制 49│ ├── net # Network功能 50│ ├── power # 低功耗管理 51│ ├── shell # shell功能 52│ └── trace # trace 工具 53├── drivers # 驱动框架Kconfig 54├── kal # 内核抽象层 55│ ├── cmsis # cmsis标准接口支持 56│ └── posix # posix标准接口支持 57├── kernel # 内核最小功能集支持 58│ ├── include # 对外接口存放目录 59│ └── src # 内核最小功能集源码 60├── testsuites # 内核测试用例 61├── tools # 内核工具 62├── utils # 通用公共目录 63``` 64 65## 约束<a name="section119744591305"></a> 66 67开发语言：C/C++； 68 69适用架构：详见目录结构arch层。 70 71动态加载模块：待加载的共享库需要验签或者限制来源，确保安全性。 72 73## 使用说明<a name="section3732185231214"></a> 74 75OpenHarmony 76LiteOS-M内核的编译构建系统是一个基于gn和ninja的组件化构建系统，支持按组件配置、裁剪和拼装，按需构建出定制化的产品。本文主要介绍如何基于gn和ninja编译LiteOS-M工程，GCC+gn、IAR、Keil MDK等编译方式可以参考社区爱好者贡献的站点。 77 78### 搭建系统基础环境 79 80在搭建各个开发板环境前，需要完成OpenHarmony系统基础环境搭建。系统基础环境主要是指OpenHarmony的编译环境和开发环境，详细介绍请参考官方站点[开发环境准备](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/Readme-CN.md)。开发者需要根据环境搭建文档完成环境搭建。 81 82### 获取OpenHarmony源码 83 84详细的源码获取方式，请见[源码获取](https://gitee.com/openharmony/docs/blob/HEAD/zh-cn/device-dev/get-code/sourcecode-acquire.md)。获取OpenHarmony完整仓代码后，假设克隆目录为`~/openHarmony`。 85 86### 已支持的示例工程 87 88Qemu模拟器: `arm_mps2_an386、esp32、riscv32_virt、SmartL_E802`, 编译运行详见: [Qemu指导](https://gitee.com/openharmony/device_qemu) 89 90恒玄科技: `bes2600`, 编译运行详见: [恒玄开发指导](https://gitee.com/openharmony/device_soc_bestechnic) 91 92### 社区移植工程链接 93 94LiteOS-M内核移植的具体开发板的工程由社区开发者提供，可以访问社区开发者代码仓获取。如果您移植支持了更多开发板，可以提供链接给我们进行社区分享。 95 96- cortex-m3： 97 98 - STM32F103 https://gitee.com/rtos_lover/stm32f103_simulator_keil 99 100 该仓包含OpenHarmony LiteOS-M内核基于STM32F103芯片架构构建的Keil工程，支持Keil MDK方式进行编译。 101 102- cortex-m4： 103 104 - 野火挑战者STM32F429IGTb https://gitee.com/harylee/stm32f429ig_firechallenger 105 106 该仓包含OpenHarmony LiteOS-M内核移植支持`野火挑战者STM32F429IGTb`开发板的工程代码，支持Ninja、GCC、IAR等方式进行编译。 107 108## 贡献<a name="section1371123476307"></a> 109 110[如何贡献](https://gitee.com/openharmony/docs/blob/HEAD/zh-cn/contribute/%E5%8F%82%E4%B8%8E%E8%B4%A1%E7%8C%AE.md) 111 112[Commit message规范](https://gitee.com/openharmony/kernel_liteos_m/wikis/Commit%20message%E8%A7%84%E8%8C%83) 113 114[Liteos-M 内核编码规范](https://gitee.com/openharmony/kernel_liteos_m/wikis/OpenHarmony%E8%BD%BB%E5%86%85%E6%A0%B8%E7%BC%96%E7%A0%81%E8%A7%84%E8%8C%83) 115 116如何基于Liteos-M内核贡献一款芯片: 117 118[轻量系统芯片移植指导](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/porting/Readme-CN.md) 119 120## 相关仓<a name="section1371113476307"></a> 121 122[内核子系统](https://gitee.com/openharmony/docs/blob/HEAD/zh-cn/readme/%E5%86%85%E6%A0%B8%E5%AD%90%E7%B3%BB%E7%BB%9F.md) 123 124[kernel\_liteos\_m](https://gitee.com/openharmony/kernel_liteos_m/blob/master/README_zh.md) 125 126