1# V0.1.0 2 3:::{note} 4本文作者：龙进 <longjin@RinGoTek.cn> 5 62022年11月6日 7::: 8 9## 前言 10 11  DragonOS从2022年1月15日开始开发，到如今已经经历了将近300天。在这么多个日夜里，已经数不清到底花了多少时间在DragonOS的开发之中， 12我基本上把所有的空闲时间都给了DragonOS，保守估计总工时已经在1000小时以上。能够发布第一个版本，我感到十分有成就感。 13 14  在2022年7月以来，陆陆续续的，有来自6所高校或企业的小伙伴/大佬加入了DragonOS的开发。我当时非常的欣喜，我想，也许在大家的一同努力下，我们能创造出 15一个真正具有实用性的操作系统呢！我们累计召开了14次交流讨论会。我相信，在大家的共同努力下，将来，我们一定能创造出真正独立自主的、开放的、面向服务器领域应用的开源操作系统，并在生产环境中得到应用。 16 17  尽管DragonOS目前只是一个玩具水平的操作系统，只是“比本科生毕业设计难度略高的”操作系统。但是，请不要小看它，它的内在的架构设计，瞄准了Linux5.18及以后的发行版， 18虽尚未能达到Linux的水平，但我们正努力追赶。得益于Linux的相关资料，DragonOS在架构设计之时，学习了Linux的很多设计思想，相关组件都尽量考虑了可扩展性与可移植性。 19 20  千里之行，始于足下。DragonOS V0.1.0版本的发布，是一个全新的开始。**希望在未来的十年里，我们能与众多伙伴们一同努力，在2032年，将DragonOS建设成为具有实用意义的，能够在服务器领域取得 21广泛应用的开源操作系统！** 22 23 24## 特别鸣谢 25 26  在DragonOS V0.1.0版本的发布之际，我想对我的老师、前辈以及学校表示衷心的感谢！ 27 28- **佛山市南海区大沥镇中心小学 姚志城老师**： 您是带领我接触计算机，学会编程的领路人。十年前，与您交谈时，您说过：“我们国家目前还没有自主的、成熟的操作系统”。这句话，为我的梦想埋下了种子。您培养了我对计算机的热爱，因此我选择了软件工程这个专业。感谢当年您的教导，师恩难忘！ 29 30- **佛山市南海区石门实验学校**： 在石实就读的三年里，非常感谢石实的“扬长教育”理念，在老师们的培养下，让我充分发挥了自己的个性和特长，也取得了不错的成绩。在石实的三年里，我学会了C++、Java以及简单的算法，也自己开发了几个安卓app，积累了将近6千行的代码量。 31 32- **佛山市南海区石门中学**：“任重道远，毋忘奋斗”是石中的校训，我想，这句校训，也应当成为我们每个新时代青年人的座右铭。在石门中学的三年，家国情怀教育对我产生了很大的影响。我想，我们作为新时代的青年，更应当肩负起时代的重任，奋勇拼搏，为祖国的发展，为民族的自强，为人类的未来，努力奋斗！ 33 34- **华南理工大学**：“博学慎思，明辨笃行”，在华工，我得到了进一步的学习与发展。开拓了自己的视野，学会了跟很多人打交道。并且，在软件学院，我遇到了一群认真负责的老师。非常感谢学院对我的支持，支持我们成立项目组。我相信，在学院的支持下，能让DragonOS取得更好的发展，走的更远！ 35 36- **华南理工大学软件学院 王国华老师**：王老师是我《操作系统》课程的老师，在她的指导下，我对操作系统的原理有了更深的理解，并参加了“泛珠三角+大学生计算机作品赛“，在2022年6月的广东省选拔赛中，DragonOS取得了一等奖、最佳创新奖的好成绩。 37 38- **华南理工大学软件学院 汤峰老师**： 汤老师是我们在校内的项目组的指导老师。在她的悉心指导下，我们将不断前行，保持我们前进的方向，持续构建开源社区。我由衷地感谢汤老师的指导！ 39 40- **[Yaotian Feng](https://github.com/Codetector1374)**： 在Bilibili上认识了这位非常厉害的老哥，解答了我的很多问题，很多次在我毫无头绪的debug了几天之后，几句话点醒了我，让我找到解决问题的路径。并且，他也跟我分享了容易踩坑的地方，让我在将要踩坑的时候能够有个心理预期，不至于那么难受哈哈哈哈。 41 42## 贡献者名单 43 44DragonOS V0.1.0版本的发布，离不开以下小伙伴们的共同努力： 45 46- 龙进 <longjin@RinGoTek.cn> 47- zzy666-hw <zzy666@mail.ustc.edu.cn> 48- 关锦权 <guanjinquan@DragonOS.org> 49- 周于喆 <zhouyuzhe@DragonOS.org> 50- kkkkkong <kongweichao@DragonOS.org> 51- houmkh <jiaying.hou@qq.com> 52- wang904 <1234366@qq.com> 53- Liric Mechan <i@liric.cn> 54- Mustang <handsomepd@qq.com> 55- Eugene <caima12138@foxmail.com> 56- kun <1582068144@qq.com> 57- zhujikuan <1335289286@qq.com> 58- Alloc Alice <1548742234@qq.com> 59 60## 赞助者名单 61 62感谢以下同学的赞赏，我们将不断努力！ 63 64- TerryLeeSCUT 65- 悟 66- slientbard 67 68## 内核 69 70### 遵循的一些标准规范 71 72- 启动引导：Multiboot2 73- 系统接口：posix 2008 74 75### 硬件架构 76 77- 目前支持在x86-64架构的处理器上运行 78### Bootloader 79 80- 使用Grub 2.06作为bootloader 81 82### 内存管理 83 84- 实现了基于bitmap的页分配器 85- 实现了slab分配器，用来分配小块的、具有对齐要求的内存 86- 抽象出VMA（虚拟内存区域） 87- 实现VMA反向映射机制 88- 实现MMIO地址空间自动映射机制 89 90### 多核 91 92- 支持多核引导。也就是说，在DragonOS启动后，将会启动AP处理器。但是，为了简化其他内核模块的实现，目前AP处理器上，暂时没有任务在运行。 93- 粗略实现了IPI（处理器核间通信）框架 94 95### 进程管理 96 97- 支持进程的创建、回收 98- 内核线程 99- kthread机制 100- 用户态、内核态进程/线程的fork/vfork（注意，用户态的fork和内核态的有一定的区别，内核态的fork更复杂） 101- exec 让进程去执行一个新的可执行文件 102- 进程的定时睡眠（sleep)（支持spin/rdtsc高精度睡眠、支持上下文切换方式的睡眠） 103 104### 同步原语 105 106- spinlock 自旋锁 107- mutex 互斥量 108- atomic 原子变量 109- wait_queue 等待队列 110- semaphore 信号量 111 112### 调度相关 113 114- CFS调度器 115- 单核调度（暂时不支持多核负载均衡） 116- completion “完成”机制，让一个进程能等待某个任务的完成。 117 118### IPC进程间通信 119 120- 匿名管道 121 122### 文件系统 123 124- VFS虚拟文件系统的基本功能 125- FAT32文件系统（尚不支持删除文件夹） 126- devfs设备文件系统。目前只将键盘文件注册到其中。 127- rootfs根文件系统，在真实的磁盘文件系统被挂载前，为其他的伪文件系统提供支持。 128- 挂载点抽象。目前实现了文件系统的挂载，使用类似于栈的方式管理所有的挂载点。（将来需要优化这部分） 129 130### 异常及中断处理 131 132- 处理器异常的捕获 133- 对APIC的支持 134- softirq软中断机制 135- 能够对内核栈进行traceback 136 137### 内核数据结构 138 139- 普通的二叉树 140- kfifo先进先出缓冲区 141- 循环链表 142- IDR 映射数据结构 143- IDA ID分配数据组件 144 145### 屏幕显示 146 147- VESA VBE显示芯片驱动 148- 实现了屏幕管理器，支持多个显示框架注册到屏幕管理器中。 149- 实现了TextUI文本界面框架，能够渲染文本到屏幕上。并且预留了上下滚动翻页、多显示窗口的支持。 150- printk 151 152### 内核实用库 153 154- 字符串操作库 155- ELF可执行文件支持组件 156- 基础数学库 157- CRC函数库 158 159### 软件移植 160 161- 移植了LZ4压缩库（V1.9.3），为将来实现页面压缩机制打下基础。 162 163### 内核测试 164 165- ktest单元测试框架 166- 支持使用串口（COM1）输出屏幕内容到文件之中。 167 168### 驱动程序支持 169 170- IDE硬盘 171- AHCI硬盘（SATA Native) 172- ACPI 高级电源配置模块 173- PCI总线驱动 174- XHCI主机控制器驱动（usb3.0) 175- ps/2键盘 176- ps/2鼠标 177- HPET高精度定时器 178- RTC时钟 179- local APIC定时器 180- UART串口（支持RS-232) 181- VBE显示 182- 虚拟tty设备 183 184### 系统调用 185 186DragonOS目前一共有22个有效的系统调用。 187 188- SYS_PUT_STRING 往屏幕上打印字符 189- SYS_OPEN 打开文件 190- SYS_CLOSE 关闭文件 191- SYS_READ 读取文件 192- SYS_WRITE 写入文件 193- SYS_LSEEK 调整文件指针 194- SYS_FORK fork系统调用 195- SYS_VFORK vfork系统调用 196- SYS_BRK 调整堆大小为指定值 197- SYS_SBRK 调整堆大小为相对值 198- SYS_REBOOT 重启 （将来sysfs完善后，将删除这个系统调用，请勿过度依赖这个系统调用） 199- SYS_CHDIR 切换进程的工作目录 200- SYS_GET_DENTS 获取目录中的目录项的元数据 201- SYS_EXECVE 让当前进程执行新的程序文件 202- SYS_WAIT4 等待进程退出 203- SYS_EXIT 退出当前进程 204- SYS_MKDIR 创建文件夹 205- SYS_NANOSLEEP 纳秒级睡眠（最长1秒）在小于500ns时，能够进行高精度睡眠 206- SYS_CLOCK 获取当前cpu时间 207- SYS_PIPE 创建管道 208- SYS_MSTAT 获取系统当前的内存状态信息 209- SYS_UNLINK_AT 删除文件夹或删除文件链接 210 211## 用户环境 212 213### LibC 214 215  LibC是应用程序与操作系统交互的纽带。DragonOS的LibC实现了一些简单的功能。 216 217- malloc堆内存分配器 218- 基础数学库 219- 简单的几个与文件相关的函数 220- pipe 221- fork/vfork 222- clock 223- sleep 224- printf 225 226### Shell命令行程序 227 228- 基于简单的字符串匹配的解析（不是通过编译课程学的的那一套东西做的，因此比较简单，粗暴） 229- 支持的命令：ls,cd,mkdir,exec,about,rmdir,rm,cat,touch,reboot 230 231### 用户态驱动程序 232 233- 用户态键盘驱动程序 234 235 236## 源码、发布版镜像下载 237 238  您可以通过以下方式获得源代码: 239 240### 通过Git获取 241 242- 您可以访问[https://github.com/fslongjin/DragonOS/releases](https://github.com/fslongjin/DragonOS/releases)下载发布版的代码，以及编译好的，可运行的磁盘镜像。 243- 我们在gitee上也有镜像仓库可供下载：[https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS) 244 245### 通过DragonOS软件镜像站获取 246 247  为解决国内访问GitHub慢、不稳定的问题，同时为了方便开发者们下载DragonOS的每个版本的代码，我们特意搭建了镜像站，您可以通过以下地址访问镜像站： 248 249  您可以通过镜像站获取到DragonOS的代码压缩包，以及编译好的可运行的磁盘镜像。 250 251- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org) 252- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn) 253 254 255## 开放源代码声明 256 257 258:::{note} 259为促进DragonOS项目的健康发展，DragonOS以GPLv2开源协议进行发布。所有能获得到DragonOS源代码以及相应的软件制品（包括但不限于二进制副本、文档）的人，都能享有我们通过GPLv2协议授予您的权利，同时您也需要遵守协议中规定的义务。 260 261这是一个相当严格的，保护开源软件健康发展，不被侵占的协议。 262 263对于大部分的善意的人们而言，您不会违反我们的开源协议。 264 265我们鼓励DragonOS的自由传播、推广，但是请确保所有行为没有侵犯他人的合法权益，也没有违反GPLv2协议。 266 267请特别注意，对于违反开源协议的，尤其是**商业闭源使用以及任何剽窃、学术不端行为将会受到严肃的追责**。（这是最容易违反我们的开源协议的场景）。 268 269并且，请注意，按照GPLv2协议的要求，基于DragonOS修改或二次开发的软件，必须同样采用GPLv2协议开源，并标明其基于DragonOS进行了修改。亦需保证这些修改版本的用户能方便的获取到DragonOS的原始版本。 270 271您必须使得DragonOS的开发者们，能够以同样的方式，从公开渠道获取到您二次开发的版本的源代码，否则您将违反GPLv2协议。 272 273关于协议详细内容，还敬请您请阅读项目根目录下的**LICENSE**文件。请注意，按照GPLv2协议的要求，**只有英文原版才具有法律效力**。任何翻译版本都仅供参考。 274::: 275 276### 开源软件使用情况 277 278  DragonOS在开发的过程中，参考了一些开源项目的设计，或者引入了他们的部分代码，亦或是受到了他们的启发。现将他们列在下面。我们对这些开源项目的贡献者们致以最衷心的感谢！ 279 280格式：<项目名> - <链接> - <开源协议> 281 282- Linux - https://git.kernel.org/ - GPLv2 283- skiftOS - https://github.com/skiftOS/skift - MIT 284- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt) 285- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License 286- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license 287- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license 288- MINE - 《一个64位操作系统的设计与实现》田宇; 人民邮电出版社 289- chcore - 《现代操作系统：设计与实现》陈海波，夏虞斌; 机械工业出版社 290- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT 291