# baremetal

**Repository Path**: embed-systems/baremetal

## Basic Information

- **Project Name**: baremetal
- **Description**: A lightweight armv8 OS-less SMP execution environment
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2025-08-17
- **Last Updated**: 2025-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Baremetal: A lightweight armv8 OS-less SMP execution environment
Baremetal project是一个轻量级的SMP多核裸驱动程序，为IP及小系统验证开发量身定制，有如下特性：

- 标准GLIBC库支持，开发界面友好
- 支持SMP多核，中断处理
- 多平台支持。ARMv8-A及ARMv8-R处理器
- 支持[测试框架](tests/)，方便测例快速集成与执行, 并可以批量自动化执行单元测试
---

## 0. 安装toolchain
a) Armv8-A 64处理器(如Cortex-A78) 使用 **aarch64-none-elf-** toolchain.

b) Armv8-R 32位处理器(如Cortex-R52) 使用 **arm-none-eabi-** toolchain.

请于官网[Arm GNU Toolchain][arm-toolchains] 下载, 本人使用的是10.3-2021.07

设置环境变量**CROSS_COMPILE**  
```
export CROSS_COMPILE=/path/to/toolchain/install/dir/bin/your-toolchain-prefix-
```

## 1. 快速上手
### 1.1 下载代码
```
git clone https://gitee.com/claud_ling/baremetal.git
cd baremetal
```
### 1.2 编译
选择你要运行的目标平台，设置**PLATFORM**, 见<1.3 当前支持的平台>

以ARMv8 qemu平台为例:
```
export PLATFORM=qemu
make
```
或者这样
```
make PLATFORM=qemu
```

### 1.3 当前支持的平台
| | [PLATFORM](src/platform) | [ARCH](src/arch/)
|--|--|--|
|QEMU aarch64 virt|qemu|aarch64
|Arm FVP BaseR AEMv8-R AArch32|fvp_armv8r|aarch32


# 2. 在emulator platform上运行测例
* [QEMU aarch64 virt](src/platform/qemu/README.md)
* [Arm FVP BaseR AEMv8-R AArch32](src/platform/fvp_armv8r/README.md)

<!-- Links -->

[arm-toolchains]: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-a/downloads