# Phytium-FreeBSD-SDK

**Repository Path**: phytium_embedded/phytium-freebsd-sdk

## Basic Information

- **Project Name**: Phytium-FreeBSD-SDK
- **Description**: 本项目发布了 Phytium 系列 CPU 的 FreeBSD 系统补丁、构建工具和使用文档，支持在 Ubuntu/Debian 环境下交叉构建 FreeBSD 的完整系统，包括内核、rootfs 和基本应用程序
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 2
- **Created**: 2025-05-13
- **Last Updated**: 2025-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Phytium-FreeBSD-SDK

v1.0.0 [ReleaseNote](./docs/Changelog.md)

- 如需 Phytium 全系 CPU 的软件适配支持，请联系 linan1284@phytium.com.cn

## 1. 介绍

- FreeBSD 是一种高性能、可靠且安全的开源类 Unix 操作系统，广泛应用于高性能服务器、高端嵌入式平台和工作站桌面系统。FreeBSD 提供了完整系统，包括内核、构建工具和用户态应用，并且使用更宽松的开源协议，主要是允许用户修改后进行闭源发布，因此，许多商用操作系统采用 FreeBSD 作为基线或移植其组件。本项目发布了 Phytium 系列 CPU 的 FreeBSD 系统和构建工具，以及参考例程和使用说明。

- FreeBSD 的内核源码允许闭源商用，实时系统 RTEMS 已经移植了其中的一部分驱动，如 SDMMC, USB 和 PCIe，具体参考 [Phytium RTEMS SDK](https://gitee.com/phytium_embedded/phytium-rtems-sdk) 、 [RTEMS LibBSD](https://gitee.com/phytium_embedded/rtems-libbsd) 以及下面的外设支持列表

![fastfetch](docs/figs/fastfetch.png)

- 目前支持的 FreeBSD 版本包括，

| **芯片**      | **FreeBSB 版本**  | **支持情况** | 
| :-------------| :----------: | :-----------------: |
| E2000D(AARCH64 模式)        |     14.2     | 支持  |
| E2000Q(AARCH64 模式)        |     14.2     | 支持  |
| PhytiumPI(AARCH64 模式)     |     14.2     | 支持  |

- 目前支持的外设包括，

| 外设  | 支持平台 | 支持情况 | 移植到 RTEMS |
| ------ | ------- |---------|---------|
| UART(PL011) | `E2000 `<br> `PhytiumPI` |         支持            |  否 |
| SDMMC | `E2000 `<br> `PhytiumPI` |         支持            | 是  |
| PCIe | `E2000 `<br> `PhytiumPI` |         支持            | 是  |
| SATA | `E2000 `<br> |         支持            | 否  |
| SATA(PCIe) | `E2000 `<br> |         支持            | 否  |
| USB-XHCI | `E2000 `<br> `PhytiumPI` |         支持            | 是  |
| USB-XHCI(PCIe) | `E2000 `<br>  |         支持            | 是  |
| NVMe(PCIe) | `E2000 `<br> `PhytiumPI` |         支持            | 是  |
| Network(E1000 PCIe) | `E2000 `<br> |         支持            | 否  |
| WLAN(RTL8188EU USB) | `E2000 `<br> `PhytiumPI` |         支持            | 是  |
| WLAN(RTL8852BE PCIe) | `E2000 `<br> |         支持（使用 UEFI 固件）            | 否  |

## 2. 快速入门

- 目前 SDK 支持在 Ubuntu 20.04 (x64)、WSL 1/2 Ubuntu/Debain 通过[交叉编译构建 FreeBSD 镜像](./docs/get-start/ubuntu_x64_setup.md)
- 使用[预先构建生成的 FreeBSD 镜像](https://pan.baidu.com/s/1dFHqyZxfNqVheL72LrGWVg?pwd=phyt)，提取码 `phyt`，将镜像烧录到硬盘中直接启动，完成启动后，可以在[本地构建 FreeBSD 内核、以及安装或源码构建应用程序](./docs/get-start/freebsd_setup.md)
- 在[飞腾派使用 FreeBSD](./docs/get-start/phytiumpi_setup.md)

## 3. 使用方法

- 参考[交叉编译构建 FreeBSD 镜像](./docs/get-start/ubuntu_x64_setup.md)构建 FreeBSD 镜像，生成设备树、内核和内核模块，进入系统后，
- 参考[FreeBSD 内核调试](./docs/usage/kernel_debug.md) 调试内核问题
- 参考[FreeBSD Kuya 自动化测试](./docs/usage/system_test.md) 进行其系统和内核功能的测试
- 参考[Network](./docs/usage/network.md) 配置和使用网络
- 参考[UART](./docs/usage/uart.md) 配置和使用串口
- 参考[SD/MMC](./docs/usage/mmc.md) 配置和使用 SD 卡、eMMC 文件系统
- 参考[SATA](./docs/usage/sata.md) 配置和使用 AHCI SATA 盘上的文件系统
- 参考[NVMe](./docs/usage/nvme.md) 配置和使用 NVMe SSD 盘上的文件系统
- 参考[USB](./docs/usage/usb.md) 配置和使用 USB 设备
- 参考[PCI](./docs/usage/pci.md) 配置和使用 PCI 设备
- 参考[WLAN](./docs/usage/wlan.md) 配置和使用无线网卡

## 4. 应用例程

- 参考[Linux Jail](./docs/applications/linux_jail.md) 使用 Linux 模拟器运行 Ubuntu 兼容层
- 参考[FIO](./docs/applications/fio.md) 进行块设备的读写性能评估测试

## 5. 参考资料

- [The FreeBSD Project](https://www.freebsd.org/)
- [FreeBSD Manual Pages](https://man.freebsd.org/cgi/man.cgi)
- [FreeBSD Fresh Ports](https://www.freshports.org/categories.php)
- [FreeBSD ARM64](https://wiki.freebsd.org/arm64)
- [FreeBSD 中文社区](https://book.bsdcn.org)
- [CheriBSD](https://www.cheribsd.org/)
- [CheriBSD Github](https://github.com/CTSRD-CHERI/cheribsd)
- [CheriBuild Github](https://github.com/CTSRD-CHERI/cheribuild)

## 6. 贡献方法

请联系飞腾嵌入式软件部

opensource_embedded@phytium.com.cn

## 7. 许可协议

BSD-2