# 开源小满EasyXMen代码仓库

**Repository Path**: easyxmen/XMen

## Basic Information

- **Project Name**: 开源小满EasyXMen代码仓库
- **Description**: 开源小满EasyXMen代码仓库。本仓为镜像仓，主仓地址：https://atomgit.com/easyxmen/XMen。
- **Primary Language**: Unknown
- **License**: LGPL-2.1
- **Default Branch**: master
- **Homepage**: https://atomgit.com/easyxmen/XMen
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 4
- **Created**: 2025-04-24
- **Last Updated**: 2025-09-30

## Categories & Tags

**Categories**: os

**Tags**: None

## README

# 项目名称（Project Name）

开源安全车控操作系统小满EasyXMen（简称“开源小满”）是面向嵌入式电子控制单元场景的实时安全操作系统，具有安全性、可靠性、实时性和可移植性等特点。  
Open Source Safety Vehicle Control Operating System EasyXMen ("EasyXMen") is a real-time safety operating system designed for embedded electronic control unit scenarios, featuring security, reliability, real-time performance, and portability.

# 项目特点（Project Features）

- 具有广泛的可扩展性，完善的系统服务和调度机制，可快速适应在多种硬件平台上部署运行  
Highly scalable with comprehensive system services and scheduling mechanisms, enabling rapid adaptation for deployment and operation across multiple hardware platforms

- 支持CAN/CANFD、LIN、Ethernet多种总线通信，适用不同通信需求和场景  
Support CAN/CANFD, LIN, and Ethernet bus communication protocols, suitable for various communication requirements and scenarios

- 提供功能安全机制检测和阻止软件故障，实现系统的功能安全保护  
Provide functional safety mechanisms to detect and prevent software failures, ensuring functional safety protection for the system

- 采用架构模块化设计思路，便于软件的升级和维护  
Adopt a modular architectural design approach, facilitating software upgrades and maintenance

# 代码地址（Code Address）

https://atomgit.com/easyxmen/XMen

# 文档地址（Document Address）

仓库地址（Warehouse address）：https://atomgit.com/easyxmen/docs  

网页浏览地址（Web address）：https://easyxmen.atomgit.net/docs/

# 目录结构（Directory Structure）

```
├── BSWCode                 # 模块静态代码 # Module static code
│   ├── CommonInclude       # 共用的头文件 # Common header files
│   ├── Communication       # 通信模块代码 # Communication module code
│   ├── Crypto              # 加密模块代码 # Encryption module code
│   ├── Libraries           # Lib库代码 # Lib library code
│   ├── Memory              # 存储模块代码 # Memory module code
│   └── SystemServices      # 系统服务模块代码 # System services module code
├── Drivers                 # 板级外设芯片代码 # Board-level peripheral chip code
├── Examples                # 示例工程 # Example projects
├── RTOS                    # OS 代码 # OS code
│   ├── Extend              # OS 扩展代码 # OS extension code
│   ├── Kernel              # OS 内核代码 # OS kernel code
│   └── Portable            # OS移植代码 # OS porting code
│       ├── Mcu             # MCU相关的移植代码 # MCU related porting code
│       └── Processor       # 处理器架构相关移植代码 # Processor architecture related porting code
└── Test                    # bsw模块测试代码 # bsw module test code
    └── UT                  # 单元测试代码 # Unit test code
```

**补充说明 （Supplementary Note）**

- Portable/Mcu 下一个芯片一个目录，比如TC397,S32K148  
One directory for each chip under Portable/Mcu, e.g. TC397, S32K148.

- Portable/Processor 一种芯片架构一个目录，比如arm,RISC-V  
One directory for each chip architecture under Portable/Processor, e.g. arm, RISC-V

- Test/UT 下一个Bsw模块一个目录  
One directory for each Bsw module under Test/UT

- Drivers 下放置板级外设芯片实现代码，例如 TJA1101  
Save board-level peripheral chip implementation code under Drivers , e.g. TJA1101.

- Examples 下以一个硬件板型+具体功能组合成目录名，例如S32K148EVB_Q147_Demo  
One directory with combined name of a hardware board model+ specific function, e.g. S32K148EVB_Q147_Demo


  - 工程对仓库中已有的实现代码进行引用  
    Project references to existing implementation code in the repository

  - 工程应实现自动化编译  
    Automatic compilation shall be implemented for engineering

  - 工程的内部目录供参考  
    Internal directory of the project for reference

  ```log
   ├── MCAL                    # MCAL 静态代码 # MCAL static code
   ├── Asw                     # 应用代码 # Application code
   |   ├── src                 # 应用源码 # Application source code
   |   └── gen                 # 应用配置生成 # Application configuration generation
   ├── PaltformFils            # 编译器等平台相关 # Compiler and other platform related
   └── ConfigProj              # 配置工程  # Configuration project
       ├── BswCfgProj          # bsw 配置工程 # bsw configuration project
       ├── SwcCfgProj          # swc 配置工程 # swc configuration project
       └── McalCfgProj         # MCAL 配置工程 # MCAL configuration project
  ```

# 运行条件（Operational Conditions）

协议栈静态代码需要结合开发工具进行使用，可通过[官方入口](https://register.easyxmen.com/welcome.html?channel=3)进行开发工具链免费申请。 各模块配置、工具使用方法，可参考模块用户手册（详见工具链界面-Help-Open Reference Manual Folder）； 基于特定芯片平台Demo工程，可通过配置工具获取使用。  
The static code of protocol stack needs to be used in combination with the development tools, which can be applied for the development toolchains for free through the [Official Portal](https://register.easyxmen.com/welcome.html?channel=3). For the configuration of each module and how to use the tools, refer to the module user manual (see Toolchains Interface-Help-Open Reference Manual Folder for details). Based on a specific chip platform Demo project, it can be obtained through configuration tools.

## 项目状态(Project Status)

EasyXMen目前支持NXP S32K148,英飞凌TC397，瑞萨RH850 U2A16这三个平台  
EasyXMen now supports three platforms, i.e. NXP S32K148, Infineon TC397, Renesas RH850 U2A16.


# 开发贡献与指导（Development Contributions and Guidance）

## commit

[commit规范（commit Specification）](https://atomgit.com/easyxmen/XMen/wiki/Commit规范)

## issue

- 在提交 Issue 之前，请先使用开源EasyXmen项目的搜索功能，查看是否已经有其他人提交了类似的问题。如果已经存在相关的 Issue，可以在该 Issue 下留言  
Before submitting an issue, please use the search function of the open source EasyXmen project to check whether someone else has already submitted a similar issue. If there is already a related issue, you can leave a comment under that issue.

- 提交 issue 时选择合适的模板  
Select the appropriate template when submitting an issue

- 提交 Issue 后，可以关注 Issue 的回复状态，了解问题的处理进度  
After submitting an issue, you can follow the response status of the issue to understand the progress of the issue handling

- 在 Issue 交流过程中，若议题已经得到解决，或 Issue 并非项目相关问题，请及时关闭  
During the issue communication process, if the issue has been resolved or the issue is not related to the project, please close it in a timely manner

## Pull Request

[PR提交指南（PR Submission Guidelines）](https://atomgit.com/easyxmen/XMen/wiki/PR提交指南)

# 开源许可（Open Source License）

- EasyXMen项目整体基于LGPL V2.1开源，详见[LICENSE.txt](./LICENSE.txt)，并附有例外，例外详见[EXCEPTION.md](./EXCEPTION.md)   
The EasyXMen project is open-source based on LGPL V2.1, see [LICENSE.txt](./LICENSE.txt) for details, with exceptions outlined in [EXCEPTION.md](./EXCEPTION.md).

# 贡献者（Contributors）

| 用户名（User Name）               | 邮箱 （E-mail）                        | 贡献的描述（Description of Contributors）               |
| -------------------- | ---------------------------- | ------------------------ |
| *示例：hongkunzhang* | *hongkunzhang@i-soft.com.cn* | *同步代码，仓库规则制定* |
| *Example: hongkunzhang* | *hongkunzhang@i-soft.com.cn* | *Synchronization code, repository rules formulation* |
|                      |                              |                          |
|                      |                              |                          |