# zephyr_rtos

**Repository Path**: hichard/zephyr_rtos

## Basic Information

- **Project Name**: zephyr_rtos
- **Description**: 这是一个完整的zephyr rtos的仓库，包括zephyr内核、mcuboot以及modules，拉下来就是一个完整的系统，可以基于它开发应用。考虑到python3的更新，不同用户可能用不同的python3版本，所以python3的venv环境用户自己建立，不包含在本仓库中。其它情况请参考Readme.txt

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-11
- **Last Updated**: 2026-01-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zephyr_rtos

这是一个完整的 Zephyr RTOS 仓库，包括 Zephyr 内核、MCUboot 和modules，拉下来就是一个完整的系统，可以直接用于项目开发。考虑到python3的更新，不同用户可能用不同的python3版本，所以python3的venv环境用户自己建立，不包含在本仓库中。


## 环境搭建（基于 Ubuntu 22.04 及以上）

### 安装基础工具
执行以下命令安装必要的工具和依赖：

```bash
sudo apt install --no-install-recommends git cmake ninja-build gperf \
  ccache dfu-util device-tree-compiler wget \
  python3-dev python3-pip python3-setuptools python3-tk python3-wheel xz-utils file \
  make gcc gcc-multilib g++-multilib libsdl2-dev libmagic1 python3-venv
```

### 确认版本
验证以下工具是否安装成功：

```bash
cmake --version
python3 --version
dtc --version
```

## Python 虚拟环境与 west 工具安装

建议将 Python 虚拟环境建立在 `/opt/zephyrproject` 目录下，以便多人协作使用。

### 创建虚拟环境
```bash
sudo mkdir -p /opt/zephyrproject/
sudo python3 -m venv /opt/zephyrproject/.venv
sudo chmod 777 -R /opt/zephyrproject/.venv
```

### 激活虚拟环境并安装 west
```bash
source /opt/zephyrproject/.venv/bin/activate
pip install west -i https://pypi.tuna.tsinghua.edu.cn/simple/
```

## 代码下载与依赖安装

### 下载代码
```bash
git clone https://gitee.com/hichard/zephyr_rtos.git
cd zephyr_rtos
```

### 安装额外的 Python 依赖包
```bash
west packages pip --install -- -i https://pypi.tuna.tsinghua.edu.cn/simple/
```

### 设置虚拟环境权限保护
安装完成后，建议锁定虚拟环境权限以防止误操作：
```bash
sudo chmod 555 -R /opt/zephyrproject/.venv
```

## 开发流程

本仓库支持基于稳定发布分支的开发流程，用户可随时与官方仓库合并更新。

## 工具链安装

工具链需用户自行安装。若使用 ARM 架构，推荐使用 GNU ARM 工具链，下载地址：[ARM GNU Toolchain](https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads)

## 文档与版本

当前 Zephyr 版本为 **v4.3.0**，详细文档请参考：[Zephyr 文档中心](https://docs.zephyrproject.org/latest/introduction/index.html)

## 注意事项

- 本仓库结构完整，可直接用于开发。
- 虚拟环境建议统一管理，以避免版本冲突。
- west 工具使用国内镜像加速安装。
- 开发过程中建议参考 Zephyr 官方文档进行配置和调试。

如需进一步帮助，请参考 Zephyr 官方文档或联系项目维护者。