# DongShanPi-Lab

**Repository Path**: dongshan-community/dong-shan-pi-lab

## Basic Information

- **Project Name**: DongShanPi-Lab
- **Description**: DongShanPi-Lab 是由山东大学“东山社区”发起并维护的开源教学项目。它是一套专为“东山派”RISC-V开发套件量身打造的系统化实验课程。
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 20
- **Forks**: 20
- **Created**: 2025-09-12
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DongShanPi-Lab

## 项目简介

DongShanPi-Lab 是由山东大学“东山社区”发起并维护的开源教学项目。它是一套专为“东山派”RISC-V开发套件量身打造的系统化实验课程。

本项目旨在通过开放协作的方式，让学生、教师、开发者和爱好者共同建设一个可扩展、可复现、可验证的实验环境。

## 项目内容

DongShanPi-Lab 规划了完整的实验课程体系，涵盖编程语言（C、C++、Python等）和常见专业课（数据结构、操作系统等）。

本仓库包含以下主要内容：

| 模块              | 说明                |
| --------------    | -----------------   |
| `docs/`           | 教程、贡献指南        |
| `C/`              | C语言编程实验         |
| `CPP/`            | C++语言编程实验       |
| `Python/`         | Python语言编程实验    |
| `DataStructure/`  | 数据结构与算法实验    |
| ...               | 待补充    |

每个实验科目下包含若干子目录，每个子目录为一个实验题目。命名规则：**<难度>\_<题目名>\_<作者>**。例如： **1_LEDFlash_DSPi**。

对于**编程类科目**（各种编程语言、数据结构、程序设计基础等），难度参考表如下：

| 难度 | 说明 | 实例
| --- | --- | --- |
| 1 | 仅涉及基础的编程语法和语句结构，面向编程初学者 | 打印乘法表，翻转字符串 |
| 2 | 涉及数组、链表、结构体等组织数据操作 | 成绩管理系统，表达式求值 |
| 3 | 涉及模块划分、文件IO、树型数据结构、算法实现 | 任务调度模拟、哈希表实现 |
| 4 | 涉及系统调用、并发、线程、复杂数据结构 | 多线程计算、同步与归约 |
| 5 | 开放性题目、系统级设计、框架搭建、多种技术整合 | 脚本语言解释器、可视化设计 |

对于**系统与应用类科目**（操作系统、计算机组成、嵌入式系统、网络、体系结构等），难度参考表如下：

**TODO：欢迎贡献**

## 如何参与

DongShanPi-Lab 项目所有内容开源，任何学习者均可免费下载并按照实验内容学习和使用东山派。

你可以通过以下两种方式贡献你的想法和代码：

### 贡献实验题目

1. 选择一个科目，在科目对应目录中创建一个新的子目录作为新的实验题目。子目录命名规则：**<难度>\_<题目名>\_<作者>**。

2. 在新目录内提供：

    - `README.md`：题目描述与背景、题目详细内容、题目测试方法
    - `solution/`：**（可选）** 参考实现代码
    - `test/`：**（可选）** 自动化测试脚本或测试数据
    - 其他为了描述题目内容需要的文件或数据

3. 提交Pull Request，等待审核与合并。

### 贡献解答

如果你想为他人编写的实验题目提供参考答案：

1. 选择一个科目和题目，如 C/1_LEDFlash_DSPi，在其中新建一个目录：**solution\_<作者>**。

2. 在新目录内提供：

    - `README.md`：解法说明
    - 源代码

3. 提交Pull Request，等待审核与合并。

## 开发环境建议

- 目标平台：东山派实验套件（基于RISC-V架构），或QEMU-RISCV64

- 推荐工具链：

    - [riscv-gnu-toolchain](https://github.com/riscv-collab/riscv-gnu-toolchain)
    - [QEMU](https://www.qemu.org/download/)

## 东山计划（Dongshan Project）

**本项目是“东山计划（Dongshan Project）”的开源组成部分之一。**

除了本仓库的开源实验资源，东山计划还包含：

- 全套教学课程体系，涵盖从编程语言到计算机系统的完整教学路径。

- 面向教师的课程支持与实验指导方案。

- 面向学生的全流程教学平台，整合 Gitee 社区资源、在线评测、实验提交与学习记录系统。

👉 更多信息请关注**东山计划官方网站**或本仓库的更新日志。

## 🤝 加入我们

## 📄 许可证

本项目采用 [BSD License](./LICENSE) 开源许可证。

---

<div align="center">
**⭐ 如果您对这个项目感兴趣，请给我们一个Star关注进展！⭐**
</div>