update chapter 7/8

pull/18/head
liguo 2 years ago
parent 353b3406bb
commit 5274da8002

@ -46,14 +46,13 @@
- [5.5 lab3_challenge1 进程等待和数据段复制(难度:★★☆☆☆](chapter5_process.md#lab3_challenge1_wait)
- [5.6 lab3_challenge2 实现信号量(难度:★★★☆☆](chapter5_process.md#lab3_challenge2_semaphore)
[第六章. PKE实验4文件系统](chapter6_filesystem.md) ----- 课程资源: [PPT](./resources/第六章.实验4文件系统.pptx) [视频讲解](https://www.bilibili.com/video/BV1Us4y1h7tT)
- [6.1 实验4的基础知识](chapter6_filesystem.md#fundamental)
- [6.2 lab4_1 文件操作](chapter6_filesystem.md#lab4_1_file)
- [6.3 lab4_2 目录文件](chapter6_filesystem.md#lab4_2_dir)
- [6.4 lab4_3 硬链接](chapter6_filesystem.md#lab4_3_hardlink)
- [6.5 lab4_challenge1 相对路径(难度:★★★☆☆](chapter6_filesystem.md#lab4_challenge1_pwd)
- [6.6 lab4_challenge2 重载执行(难度:★★★★☆](chapter6_filesystem.md#lab4_challenge2_exec)
[第六章. PKE实验4文件系统](chapter6_filesystem.md)
- [5.1 实验4的基础知识](chapter6_filesystem.md#fundamental)
- [5.2 lab4_1 文件操作](chapter6_filesystem.md#lab4_1_file)
- [5.3 lab4_2 目录文件](chapter6_filesystem.md#lab4_2_dir)
- [5.4 lab4_3 硬链接](chapter6_filesystem.md#lab4_3_hardlink)
- [5.5 lab4_challenge1 多级目录(难度:★☆☆☆☆](chapter6_filesystem.md#lab4_challenge1_treedir)
- [5.6 lab3_challenge2 虚拟文件系统(难度:★★★★☆](chapter6_filesystem.md#lab4_challenge2_vfs)
## 第二部分:系统能力培养实验
@ -64,7 +63,7 @@
- [7.3 fpga实验2以中断方式实现uart通信](chapter7_riscv_on_pynq.md#hardware_lab2)
- [7.4 fpga实验3配置连接到PS端的USB设备](chapter7_riscv_on_pynq.md#hardware_lab3)
[第八章. PKE实验5设备和文件](chapter8_device.md) ----- 课程资源: [PPT](./resources/第八章.实验4设备管理.pptx) [视频讲解](https://www.bilibili.com/video/BV1LB4y157Rb)
[第八章. PKE实验5设备管理](chapter8_device.md) ----- 课程资源: [PPT](./resources/第八章.实验4设备管理.pptx) [视频讲解](https://www.bilibili.com/video/BV1LB4y157Rb)
- [8.1 实验5的基础知识](chapter8_device.md#fundamental)
- [8.2 lab5_1 轮询方式](chapter8_device.md#polling)

File diff suppressed because it is too large Load Diff

@ -1,8 +1,8 @@
# 第八章实验5设备管理基于[RISCV-on-PYNQ](https://gitee.com/hustos/fpga-pynq)
### 目录
### 目录
- [8.1 实验4的基础知识](#fundamental)
- [8.1 实验5的基础知识](#fundamental)
- [8.1.1 pynq开发板介绍](#subsec_pynq)
- [8.1.2 内存映射I/O(MMIO)](#subsec_MMIO)
- [8.1.3 riscv-fesvr原理](#subsec_fesvr)
@ -10,116 +10,128 @@
- [8.1.5 中断驱动I/O控制方式](#subsec_plic)
- [8.1.6 设备文件](#subsec_file)
- [8.2 lab5_1 POLL](#polling)
- [给定应用](#lab4_1_app)
- [实验内容](#lab4_1_content)
- [实验指导](#lab4_1_guide)
- [8.3 lab5_2_PLIC](#PLIC)
- [给定应用](#lab4_2_app)
- [实验内容](#lab4_2_content)
- [实验指导](#lab4_2_guide)
- [8.4 lab5_3_hostdevice](#hostdevice)
- [给定应用](#lab4_3_app)
- [实验内容](#lab4_3_content)
- [实验指导](#lab4_3_guide)
- [给定应用](#lab5_1_app)
- [实验内容](#lab5_1_content)
- [实验指导](#lab5_1_guide)
- [答案解析](#lab5_1_ans)
- [8.3 lab5_2 PLIC](#PLIC)
- [给定应用](#lab5_2_app)
- [实验内容](#lab5_2_content)
- [实验指导](#lab5_2_guide)
- [答案解析](#lab5_2_ans)
- [8.4 lab5_3 hostdevice](#hostdevice)
- [给定应用](#lab5_3_app)
- [实验内容](#lab5_3_content)
- [实验指导](#lab5_3_guide)
- [答案解析](#lab5_3_ans)
<a name="fundamental"></a>
## 7.1 实验5的基础知识
## 8.1 实验5的基础知识
完成前面所有实验后PKE内核的整体功能已经得到完善。在实验四的设备实验中我们将结合fpga-pynq板在rocket chip上增加uart模块和蓝牙模块并搭载PKE内核实现蓝牙通信控制智能小车设计设备管理的相关实验。
完成前面所有实验后PKE内核的整体功能已经得到完善。在实验五的设备实验中我们将结合fpga-pynq板在Rocket chip上增加uart模块和蓝牙模块并搭载PKE内核实现蓝牙通信控制智能小车设计设备管理的相关实验。
<a name="subsec_pynq"></a>
### 7.1.1 pynq开发板介绍
### 8.1.1 pynq开发板介绍
本实验中我们所使用的pynq-z2开发板上搭载两块芯片一块为Arm架构32位芯片称为PS端我们能在上面运行Ubuntu另一块为FPGA可编程芯片称为PL端通过烧录Rocket chip电路使它能够运行Riscv架构的操作系统即riscv-pke。
本实验中我们所使用的pynq-z1开发板上搭载两块芯片一块为ARM架构32位芯片称为PS端我们能在上面运行Ubuntu操作系统另一块为FPGA可编程芯片称为PL端通过烧录Rocket chip电路使它能够运行Riscv架构的操作系统即riscv-pke。
![](pictures/fig6_4.png)
<img title="" src="pictures/fig6_4.png" alt="" data-align="center">
如上图在开发板上运行的时候PKE在PL端运行一方面它可以通过Rocket Chip电路的连线访问PL端的设备device如蓝牙、小车电机等另一方面在PS端运行的riscv-fesvr程序可以和PKE通过HTIF协议通信使得PKE可以读写PS端Linux操作系统下的设备文件host device比如摄像头、声卡等。也就是说PKE除了可以访问本身的设备还可以利用PS端操作系统的功能访问更复杂的设备这就是代理内核的特点。
如上图在开发板上运行的时候PKE在PL端运行一方面它可以通过Rocket Chip电路的连线访问PL端的设备device如蓝牙、小车电机控制器另一方面在PS端运行的riscv-fesvr程序可以和PKE通过HTIF协议通信使得PKE可以读写PS端Linux操作系统下的设备文件host device比如摄像头、声卡等。也就是说PKE除了可以访问本身的设备还可以利用PS端操作系统的功能访问更复杂的设备这就是代理内核的特点。
实验四和前三个实验的关系如下:
实验五和前四个实验的区别如下:
![](pictures/fig6_5.png)
<img title="" src="pictures/fig6_5.png" alt="" data-align="center" width="600">
可见除了部分硬件相关的操作外PKE在Spike和开发板上的运行是完全等价的代理内核一方面让我们可以用最简单的方法访问两端的设备另一方面在不同地方运行基本不用改太多代码非常优越。
可见除了部分硬件相关的操作外PKE在Spike和开发板上的运行是完全等价的代理内核一方面让我们可以用最简单的方法访问PL端与PS端两端的设备,另一方面在不同地方运行基本不用改太多代码,非常优越。
<a name="subsec_MMIO"></a>
### 7.1.2 内存映射I/O(MMIO)
### 8.1.2 内存映射I/O(MMIO)
内存映射(Memory-Mapping I/O)是一种用于设备驱动程序和设备通信的方式它区别于基于I/O端口控制的Port I/O方式。RICSV指令系统的CPU通常只实现一个物理地址空间这种情况下外设I/O端口的物理地址就被映射到CPU中单一的物理地址空间成为内存的一部分CPU可以像访问一个内存单元那样访问外设I/O端口而不需要设立专门的外设I/O指令。
在MMIO中内存和I/O设备共享同一个地址空间。MMIO是应用得最为广泛的一种IO方法它使用相同的地址总线来处理内存和I/O设备I/O设备的内存和寄存器被映射到与之相关联的地址。当CPU访问某个内存地址时它可能是物理内存也可以是某个I/O设备的内存。此时用于访问内存的CPU指令就可以用来访问I/O设备。每个I/O设备监视CPU的地址总线一旦CPU访问分配给它的地址它就做出响应将数据总线连接到需要访问的设备硬件寄存器。为了容纳I/O设备CPU必须预留给I/O一个地址映射区域。
在本章节中修改后的RocketChip将蓝牙控制寄存器和小车电机端接到固定的内存地址,因此可以通过对这些地址进行读写控制蓝牙和小车电机。
在本上一章节中修改后的Rocket Chip将蓝牙控制寄存器和小车电机控制器映射到了固定的内存地址,因此可以通过对这些地址进行读写控制蓝牙和小车电机。
<a name="subsec_fesvr"></a>
### 7.1.3 riscv-fesvr原理
### 8.1.3 riscv-fesvr原理
riscv-fesvr是PKE在PYNQ开发板上使用的重要工具它是ARM端系统上运行的程序控制PKE的启动。除了启动功能riscv-fesvr程序主要分为两个模块系统调用模块块负责接受PKE对ARM端的系统调用请求在ARM端执行这些函数内存模块负责读写RISCV端的内存和PKE交换数据。
riscv-fesvr是PKE在PYNQ开发板上运行的重要工具它是运行在ARM端系统上的程序用于控制PKE的启动。除了启动功能riscv-fesvr程序主要分为两个模块系统调用模块负责接受PKE对ARM端的系统调用请求在ARM端执行这些函数,并返回相应的操作结果;内存模块负责ARM端读写RISCV端的内存和PKE交换数据。
PKE调用宿主机/开发板ARM端的系统调用函数使用的是HTIF协议。协议要求内核保留两个地址作为和riscv-fesvr共享数据的地方。PKE要使用系统调用函数就需要将系统调用函数的编号和参数通过这个地址发送给riscv-fesvr方法是定义一个数组magic_mem该数组存储了调用号和参数再将数组的起始地址按一定的格式填入这个地址中如下图
PKE调用宿主机/开发板ARM端的系统调用函数使用的是HTIF协议。协议要求内核保留两个64位变量tohost和fromhost作为PKE与riscv-fesvr交换数据的地方。当PKE调用宿主机/开发板ARM端系统调用函数时需要将系统调用函数的编号和参数按照固定格式写入tohost变量通过该方式向宿主机/开发板ARM端系统发起系统调用
![](pictures/fig6_7.png)
tohost与fromhost变量的格式如下
打个比方我通过HTIF协议调用ARM端的write函数那么我先定义一个数组magic_memmagic_mem[0]为write的系统调用号magic_mem[1]为文件描述符magic_mem[2]为缓冲区地址magic_mem[3]为写入长度。然后把一个数写入共享地址这个数高8位和中间8位都是0低48位为magic_mem的地址。riscv-fesvr会首先读出magic_mem里的数据然后根据magic_mem[0]决定要调用write函数这时需要注意magic_mem[2]里的缓冲区地址是RISCV端内存的地址所以先把RISCV端内存里的这段数据读到外面内存再以外面内存地址为参数调用write函数。
<img src="pictures/to_from_host.png" title="" alt="" data-align="center" width="500">
riscv-fesvr的内存模块用来读写RISCV端的内存从而可以读取系统调用参数以及读写PKE的缓冲区。Pynq开发板把RISCV端的内存抽象成设备文件/dev/mem所以内存模块可以通过在固定偏移量读写该文件从而实现读写内存。
当通过HTIF进行系统调用时dev与cmd固定为0data部分是一个描述系统调用的数组指针
<img src="pictures/fig6_7.png" title="" alt="" data-align="center">
例如当通过HTIF协议调用ARM端的write函数时需要先定义一个数组magic_memmagic_mem[0]为write的系统调用号magic_mem[1]为文件描述符magic_mem[2]为缓冲区地址magic_mem[3]为写入长度。然后将magic_mem数组的地址写入tohost变量的data部分。随后riscv-fesvr会首先读出magic_mem里的数据然后根据magic_mem[0]决定要调用write函数。另外需要注意magic_mem[2]里的缓冲区地址是RISCV端内存的地址所以需要先把RISCV端内存里的这段数据读到ARM端内存再以ARM端内存地址为参数调用write函数。
PKE在写入tohost变量发起ARM端系统调用后需要接着对fromhost变量进行轮询。当PKE检测到fromhost变量被riscv-fesvr更新为非0值且其dev与cmd部分都为0时从magic_mem数组中读出系统调用返回值。
riscv-fesvr的内存模块用来读写RISCV端的内存从而可以读取系统调用参数以及读写PKE的缓冲区。pynq开发板把RISCV端的内存抽象成设备文件/dev/mem所以内存模块可以通过在固定偏移量读写该文件从而实现读写RISCV端内存。
另外控制摄像头需要用到的ioctl、mmap、munmap三个系统调用函数是原版的riscv-fesvr不支持的所以我们对riscv-fesvr的系统调用模块进行了修改
* ioctl函数比较简单可以直接用PKE传过来的参数调用系统调用函数
* mmap函数比较麻烦因为ARM端通过mmap映射的是ARM端的内存RISCV端无法访问。所以再添加readmmap函数PKE可以通过HTIF调用此函数读取ARM端被映射的内存。将ARM端用mmap映射的所有内存用数组存储映射地址返回给PKE数组索引PKE向readmmap传入索引riscv-fesvr根据索引找到地址读取ARM端的内存数据返回给PKE。
* ioctl系统调用的实现比较简单可以直接用PKE传过来的参数调用ioctl系统调用。
* mmap系统调用的实现比较麻烦因为ARM端通过mmap映射的是ARM端的内存RISCV端无法访问。所以另外添加了readmmap系统调用PKE可以通过HTIF调用此系统调用函数读取ARM端被映射的内存。riscv-fesvr将mmap映射的内存用数组存储映射地址返回给PKE数组索引读取时,PKE向readmmap传入数组索引riscv-fesvr根据索引找到ARM端被映射地址读取ARM端的内存数据返回给PKE。
<a name="subsec_polling"></a>
### 7.1.4 轮询I/O控制方式
### 8.1.4 轮询I/O控制方式
在实验四中,我们设备管理的主要任务是控制设备与内存的数据传递,具体为从蓝牙设备读取到用户输入的指令字符(或传递数据给蓝牙在手机端进行打印),解析为小车前、后、左、右、停止等动作来传输数据给电机实现对小车的控制。在前两个实验中,我们分别需要对轮询控制方式和中断控制方式进行实现。
在实验五中,我们设备管理的主要任务是控制设备与内存间的数据传递。具体来讲,需要将从蓝牙设备读取到的用户输入指令字符,解析为小车前进、后退、左转、右转和停止动作,并传输对应的小车控制指令给电机控制器实现对小车的控制。在前两个实验中,我们分别需要对蓝牙设备的轮询和中断访问方式进行实现。
首先程序直接控制方式又称循环测试方式每次从外部设备读取一个字的数据到存储器对于读入的每个字CPU需要对外设状态进行循环检查直到确定该数据已经传入I/O数据寄存器中
对于轮询方式又称程序直接控制方式CPU需要不断对外设状态进行检查。当外设准备好CPU所需数据后CPU会从外部设备读取一个字的数据到存储器随后再次进行状态检查准备从外设读取下一个字的数据直到数据读取完毕或者程序终止
轮询I/O控制方式流程如图
<img src="pictures/fig6_1_polling.png" alt="fig6_1" style="zoom:100%;" />
<img title="" src="pictures/fig6_1_polling.png" alt="fig6_1" style="zoom:100%;" data-align="center" width="301">
<a name="subsec_plic"></a>
### 7.1.5 中断驱动I/O控制方式
### 8.1.5 中断驱动I/O控制方式
在前一种轮询的控制方式中由于CPU的高速性和I/O设备的低速性导致CPU浪费绝大多数时间处于等待I/O设备完成数据传输的循环测试中会造成大量资源浪费。中断驱动的方式是允许请求I/O的进程在设备工作时进入休眠状态使CPU能够运行别的进程。直到设备工作完成时再由设备发出中断中断处理程序唤醒之前休眠的进程使其能够接受设备返回的数据继续执行。采用中断驱动的控制方式在I/O操作过程中CPU可以执行其他的进程CPU与设备之间达到了部分并行的工作状态从而提升了资源利用率。
在前一种轮询的控制方式中由于CPU的高速性和I/O设备的低速性导致CPU浪费绝大多数时间等待I/O设备完成数据传输的循环测试中会造成大量资源浪费。中断驱动的方式是允许请求I/O的进程在设备工作时进入休眠状态使CPU能够运行别的进程。直到设备工作完成时再由设备发出中断中断处理程序唤醒之前休眠的进程使其能够接受设备返回的数据继续执行。采用中断驱动的控制方式在I/O操作过程中CPU可以执行其他的进程CPU与设备之间达到了部分并行的工作状态从而提升了资源利用率。
Riscv包含三类中断:软中断、时钟中断和外部中断。软中断和时钟中断我们在实验一已经接触过,而设备触发的中断属于外部中断。在实验一中,我们在机器态捕获了时钟中断,然后将其转发成内核态的软中断交由中断处理程序处理本章则直接通过设置MIDELEG寄存器利用RISCV的中断委托机制直接将外部中断交由内核态的中断处理程序处理不用经过机器态的捕获。另外RISCV架构还指定了PLICPriority Level Interrupt Controller模块管理各级中断该设备使用MMIO控制PKE在处理中断之后通过读写指定的内存地址来获取触发中断的设备的编号以及通知PLIC本次中断是否处理成功。
RISCV包含三类中断:软中断、时钟中断和外部中断。软中断和时钟中断我们在实验一已经接触过,而设备触发的中断属于外部中断。在实验一中,我们在机器态捕获了时钟中断,然后将其转发成内核态的软中断交由中断处理程序处理。本章则直接通过设置MIDELEG寄存器利用RISCV的中断委托机制直接将外部中断代理到内核态的中断处理程序处理不用经过机器态的捕获。另外RISCV架构还指定了PLICPriority Level Interrupt Controller模块管理各级中断该设备使用MMIO控制PKE在处理中断之后通过读写指定的内存地址来获取触发中断的设备的编号以及通知PLIC本次中断是否处理成功。
中断驱动I/O方式流程如图
<img src="pictures/fig6_2_plic.png" alt="fig6_2" style="zoom:100%;" />
<img title="" src="pictures/fig6_2_plic.png" alt="fig6_2" style="zoom:100%;" data-align="center" width="319">
<a name="subsec_file"></a>
### 7.1.6 设备文件
### 8.1.6 设备文件
用户程序访问外部设备通常有两种方式:通过特定系统调用访问和通过设备文件访问。前者即操作系统提供专门的函数控制设备,后者是操作系统把设备指定成一个文件,通过通用的文件的读写函数控制设备。设备文件常用的函数除了open、read、write、close还有以下几种
用户程序访问外部设备通常有两种方式:通过特定系统调用访问和通过设备文件访问。前者即操作系统提供专门的函数控制设备,后者是操作系统把设备抽象成一个设备文件,通过通用的文件访问函数控制设备。设备文件常用的函数除了open、read、write、close还有以下几种
* ioctl`int ioctl(int fd, unsigned long request, void *data);`用来设置设备参数。fd是文件描述符request是一个常数表示参数类型不同的类型对应不同的常数data通常是一个指向要设置的参数的值的指针参数的值可以是整数也可以是结构体等返回值为该函数是否执行成功。如摄像头设备我们就可以通过该函数设置摄像头的拍摄分辨率、颜色格式等音频设备我们可以设置采样率、数据格式等。
* mmap`void *mmap(void *addr, size_t length, int prot, int flags, int fd, off_t offset);`该函数原本的作用是将虚拟地址和文件进行映射使得读写文件可以像读写内存一样方便同时也能节省物理内存但对于有些不支持read/write读写的设备就必须使用mmap函数将虚拟地址和设备文件映射才能读写设备的数据。addr参数表示映射的起始虚拟地址通常填NULL表示由操作系统自己指定lengthprot、flags分别表示映射地址空间的长度、权限和其他参数fd为文件描述符offset为文件偏移量返回值为映射的起始虚拟地址。
* ioctl`int ioctl(int fd, unsigned long request, void *data);`用来设置设备参数。fd是文件描述符request是一个常数表示参数类型不同的类型对应不同的常数data通常是一个指向要设置的参数的值的指针参数的值可以是整数也可以是结构体等返回值为该函数是否执行成功。如摄像头设备我们就可以通过该函数设置摄像头的拍摄分辨率、颜色格式等音频设备可以设置采样率、数据格式等。
* mmap`void *mmap(void *addr, size_t length, int prot, int flags, int fd, off_t offset);`该函数原本的作用是将虚拟地址和文件进行映射使得读写文件可以像读写内存一样方便同时也能节省物理内存但对于有些不支持read/write读写的设备就必须使用mmap函数将虚拟地址和设备文件映射才能读写设备的数据。addr参数表示映射的起始虚拟地址通常传递NULL表示由操作系统指定lengthprot、flags分别表示映射地址空间的长度、访问权限和其他参数fd为文件描述符offset为文件偏移量返回值为映射的起始虚拟地址。
在本章节中,将使用PKE通过HTIF协议和PS端的riscv-fesvr进行通信以读写PS端的摄像头设备文件进而控制摄像头设备。
在本章的第三个实验中,我们将使用PKE通过HTIF协议和PS端的riscv-fesvr进行通信以读写PS端的摄像头设备文件进而控制摄像头设备。另外由于我们已经在实验四中为PKE实现了虚拟文件系统因此在本章第三个实验中我们会先将PS端的设备文件挂载到虚拟文件系统中然后通过虚拟文件系统对摄像头外设进行访问控制。相应的文件系统也需要添加上述几个设备文件访问函数的实现。
<a name="polling"></a>
## 7.2 lab4_1 poll
## 8.2 lab5_1 poll
<a name="lab4_1_app"></a>
<a name="lab5_1_app"></a>
#### **给定应用**
- user/app_poll.c
- user/app_polling.c
```c
1 /*
2 * Below is the given application for lab4_1.
2 * Below is the given application for lab5_1.
3 * The goal of this app is to control the car via Bluetooth.
4 */
5
@ -142,50 +154,54 @@ Riscv包含三类中断软中断、时钟中断和外部中断。软中断和
应用通过轮询的方式从蓝牙端获取指令,实现对小车的控制功能。
* 先提交lab3_3的答案然后切换到lab4_1继承lab3_3中所做的修改并make
* 先提交lab4_3的答案然后切换到lab5_1继承lab4_3中所做的修改并make
```bash
//切换到lab4_1
$ git checkout lab4_1_poll
//切换到lab5_1
$ git checkout lab5_1_poll
//继承lab3_3以及之前的答案
$ git merge lab3_3_rrsched -m "continue to work on lab4_1"
//继承lab4_3以及之前的答案
$ git merge lab4_3_hardlink -m "continue to work on lab5_1"
//重新构造
$ make clean; make
```
由于本实验给出的基础代码修改了硬件相关的部分代码所以无法在Spike上运行需在PYNQ开发板上进行验证。读者在进行本实验之前应该已经按照第章中的说明完成了fpga实验1并将rocketchip_wrapper.bit.bin文件烧录到了开发板中。
由于本实验给出的基础代码修改了硬件相关的部分代码所以无法在Spike上运行需在PYNQ开发板上进行验证。读者在进行本实验之前应该已经按照第章中的说明完成了fpga实验1并将rocketchip_wrapper.bit.bin文件烧录到了开发板中。
make完成后需要将obj目录下编译生成的可执行文件传输到开发板中然后在开发板上运行程序。具体的做法如下
1. 首先将make命令编译生成的两个可执行文件obj/app_polling文件与obj/riscv-pke文件通过sftp协议传输到开发板的/home/xilinx目录下。至于如何向开发板中传送文件在第六章中已有详细的介绍读者可以参考之前的描述。
2. 通过ssh协议连接到开发板连接方法在第六章中同样有详细说明并在ssh客户端中输入如下命令执行app_polling
1. 首先将make命令编译生成的两个可执行文件obj/app_polling文件与obj/riscv-pke文件通过sftp协议传输到开发板的/home/xilinx目录下。至于如何向开发板中传送文件在第七章中已有详细的介绍读者可以参考之前的描述。
2. 通过ssh协议连接到开发板连接方法在第七章中同样有详细说明并在ssh客户端中输入如下命令执行app_polling
```bash
$ sudo ./program.sh # 若重启过开发板,则在执行程序前要先执行此脚本进行烧录
$ sudo ./riscv-fesvr riscv-pke app_poll
$ sudo ./riscv-fesvr riscv-pke app_polling
In m_start, hartid:0
(Emulated) memory size: 256 MB
Enter supervisor mode...
PKE kernel start 0x0000000080000000, PKE kernel end: 0x0000000080009000, PKE kernel size: 0x0000000000009000 .
free physical memory address: [0x0000000080009000, 0x00000000800fffff]
PKE kernel start 0x0000000080000000, PKE kernel end: 0x0000000080011000, PKE kernel size: 0x0000000000011000 .
free physical memory address: [0x0000000080011000, 0x00000000800fffff]
kernel memory manager is initializing ...
KERN_BASE 0x0000000080000000
physical address of _etext is: 0x0000000080005000
physical address of _etext is: 0x0000000080009000
kernel page table is on
RAMDISK0: base address of RAMDISK0 is: 0x0000000080072000
RFS: format RAMDISK0 done!
Switch to user mode...
in alloc_proc. user frame 0x00000000800f9000, user stack 0x000000007ffff000, user kstack 0x00000000800f8000
in alloc_proc. user frame 0x0000000080066000, user stack 0x000000007ffff000, user kstack 0x0000000080065000
FS: created a file management struct for a process.
in alloc_proc. build proc_file_management successfully.
User application is loading.
Application: app_polling
CODE_SEGMENT added at mapped info offset:3
Application program entry point (virtual address): 0x0000000000010078
CODE_SEGMENT added at mapped info offset:4
DATA_SEGMENT added at mapped info offset:5
Application program entry point (virtual address): 0x00000000000100b0
going to insert process 0 to ready queue.
going to schedule process 0 to run.
Ticks 0
please input the instruction through bluetooth!
You have to implement sys_user_uart_getchar to get data from UART using uartgetchar in lab4_1 and modify it in lab4_2.
You have to implement sys_user_uart_getchar to get data from UART using uartgetchar in lab5_1 and modify it in lab5_2.
System is shutting down with exit code -1.
```
@ -198,24 +214,29 @@ make完成后需要将obj目录下编译生成的可执行文件传输到开
如输出提示所表示的那样需要找到并完成对uart_getchar的调用重新编译生成app_polling与riscv-pke文件并将这两个文件传输到开发板中在ssh会话中执行以下命令得到预期结果
``` bash
```bash
$ sudo ./program.sh # 若重启过开发板,则在执行程序前要先执行此脚本进行烧录
$ sudo ./riscv-fesvr riscv-pke app_poll
$ sudo ./riscv-fesvr riscv-pke app_polling
In m_start, hartid:0
(Emulated) memory size: 256 MB
Enter supervisor mode...
PKE kernel start 0x0000000080000000, PKE kernel end: 0x0000000080009000, PKE kernel size: 0x0000000000009000 .
free physical memory address: [0x0000000080009000, 0x00000000800fffff]
PKE kernel start 0x0000000080000000, PKE kernel end: 0x0000000080011000, PKE kernel size: 0x0000000000011000 .
free physical memory address: [0x0000000080011000, 0x00000000800fffff]
kernel memory manager is initializing ...
KERN_BASE 0x0000000080000000
physical address of _etext is: 0x0000000080005000
physical address of _etext is: 0x0000000080009000
kernel page table is on
RAMDISK0: base address of RAMDISK0 is: 0x0000000080072000
RFS: format RAMDISK0 done!
Switch to user mode...
in alloc_proc. user frame 0x00000000800f9000, user stack 0x000000007ffff000, user kstack 0x00000000800f8000
in alloc_proc. user frame 0x0000000080066000, user stack 0x000000007ffff000, user kstack 0x0000000080065000
FS: created a file management struct for a process.
in alloc_proc. build proc_file_management successfully.
User application is loading.
Application: app_polling
CODE_SEGMENT added at mapped info offset:3
Application program entry point (virtual address): 0x0000000000010078
CODE_SEGMENT added at mapped info offset:4
DATA_SEGMENT added at mapped info offset:5
Application program entry point (virtual address): 0x00000000000100b0
going to insert process 0 to ready queue.
going to schedule process 0 to run.
please input the instruction through bluetooth!
@ -226,42 +247,43 @@ please input the instruction through bluetooth!
1. 在手机端下载任意一种蓝牙串口通信APP提供一个在安卓12上测试无误的软件下载[蓝牙串口](https://www.coolapk.com/apk/com.orion.bluetoothserialtool)下面的步骤都以此APP为例进行说明其他蓝牙串口通信APP的使用方法与之类似
2. 打开手机蓝牙开关。
3. 点击蓝牙串口通信APP下方的蓝牙设备按钮找到蓝牙模块其名称通常是“BT04-A”点击进行配对。若提示输入PIN码则输入“1234”。
4. 点击蓝牙串口通信APP下方的收发数据按钮进入收发数据界面。在下方的对话框中即可输入控制指令具体命令如下
**注意,若软硬件都正确无误,在发送下方指令后小车会立即开始运动。请务必确保小车的运动在实验人员的控制之内!若小车上有连接用于调试的网线等设备,建议暂时使小车的四个车轮处于悬空状态。当功能全部测试无误后,可以在保持程序运行的情况下直接拔掉网线,并将小车放置在地面上移动**。
| 命令 | 效果 |
| :--: | :---------------------------------------------: |
| 1 | 小车前进 |
| 2 | 小车后退 |
| 3 | 小车左转 |
| 4 | 小车右转 |
| 0 | 小车停止 |
| q | 程序停止在ssh会话中输入ctrl+c也可以停止程序 |
| 命令 | 效果 |
|:---:|:----------------------------:|
| 1 | 小车前进 |
| 2 | 小车后退 |
| 3 | 小车左转 |
| 4 | 小车右转 |
| 0 | 小车停止 |
| q | 程序停止在ssh会话中输入ctrl+c也可以停止程序 |
<a name="lab4_1_guide"></a>
<a name="lab5_1_guide"></a>
#### **实验指导**
基于实验lab1_1你已经了解和掌握操作系统中系统调用机制的实现原理。对于本实验的应用我们发现user/app_poll.c文件中有三个函数调用uart_getcharuart_putchar和uart2_putchar。UART是一种控制设备的端口协议但在本实验中它可以通过MMIO进行控制。对代码进行跟踪我们发现这三个函数都在user/user_lib.c中进行了实现对应于lab1_1的流程我们可以在kernel/syscall.h中查看新增的系统调用以及编号
```c
16 #define SYS_user_uart_putchar (SYS_user_base + 6)
17 #define SYS_user_uart_getchar (SYS_user_base + 7)
18 #define SYS_user_uart2_putchar (SYS_user_base + 8)
34 #define SYS_user_uart_putchar (SYS_user_base + 30)
35 #define SYS_user_uart_getchar (SYS_user_base + 31)
36 #define SYS_user_uart2_putchar (SYS_user_base + 32)
```
继续追踪我们发现在kernel/syscall.c的do_syscall函数中新增了对应系统调用编号的实现函数对于新增系统调用分别有如下函数进行处理
```c
133 case SYS_user_uart_putchar:
134 sys_user_uart_putchar(a1);return 1;
135 case SYS_user_uart_getchar:
136 return sys_user_uart_getchar();
137 case SYS_user_uart2_putchar:
138 sys_user_uart2_putchar(a1);return 1;
297 case SYS_user_uart_putchar:
298 sys_user_uart_putchar(a1);return 1;
299 case SYS_user_uart_getchar:
300 return sys_user_uart_getchar();
301 case SYS_user_uart2_putchar:
302 sys_user_uart2_putchar(a1);return 1;
```
读者的任务即为在kernel/syscall.c中追踪并完善sys_user_uart_getchar。对于uart相关的函数我们给出uart端口的地址映射如图
@ -270,37 +292,59 @@ please input the instruction through bluetooth!
图中的axi_uartlite_0对应于蓝牙设备的uart端口aix_uartlite_1则对应于小车电机驱动板的uart端口。其中蓝牙设备的uart端口的偏移地址为0x60000000对应写地址为0x60000004读地址为0x60000000同时对0x60000008的状态位进行轮询检测到信号时进行读写操作。
在kernel/syscall.c中找到函数实现空缺并根据注释完成sys_user_uart_getchar系统调用由于lab4_2需要对lab4_1完成的代码进行修改所以这里一并给出了lab4_2的提示
在kernel/syscall.c中找到函数实现空缺并根据注释完成sys_user_uart_getchar系统调用由于lab5_2需要对lab5_1完成的代码进行修改所以这里一并给出了lab5_2的提示
```c
95 ssize_t sys_user_uart_getchar() {
96 // TODO (lab4_1 and lab4_2): implment the syscall of sys_user_uart_getchar and modify it in lab4_2.
97 // hint (lab4_1): The functionality of sys_user_uart_getchar is to get data from UART address.
98 // Therefore we should check the data from the address of bluetooth status repeatedly, until the data is ready.
99 // Then read the data from the address of bluetooth reading and return.
100 // hint (lab4_2): the functionality of sys_user_uart_getchar is let process sleep and wait for value. therefore,
101 // we should call do_sleep to let process 0 sleep.
102 // then we should get uartvalue and return.
103 panic( "You have to implement sys_user_uart_getchar to get data from UART using uartgetchar in lab4_1 and modify it in lab4_2.\n" );
104
105 }
227 ssize_t sys_user_uart_getchar() {
228 // TODO (lab5_1 and lab5_2): implment the syscall of sys_user_uart_getchar and modify it in lab5_2.
229 // hint (lab5_1): the functionality of sys_user_uart_getchar is to get data from UART address.
230 // therefore, we should let a pointer point, insert it in
231 // the rear of ready queue, and finally, schedule a READY process to run.
232 // hint (lab5_2): the functionality of sys_user_uart_getchar is let process sleep
233 // and register a callback function to handle system call return value.
234 // therefore, we should call do_sleep to let process 0 sleep.
235 // Note that the do_sleep function will never return, and the function passed to do_sleep
236 // will be called in do_wake.
237 panic( "You have to implement sys_user_uart_getchar to get data from UART using uartgetchar in lab5_1 and modify it in lab5_2.\n" );
238 }
```
**注意编写自己的代码时千万不要修改或删去lab4_2的提示即100行到102行),防止后面实验的合并错误!**
**注意编写自己的代码时千万不要修改或删去lab5_2的提示即232行到236行),防止后面实验的合并错误!**
**实验完毕后,记得提交修改(命令行中-m后的字符串可自行确定以便在后续实验中继承lab4_1中所做的工作**
**实验完毕后,记得提交修改(命令行中-m后的字符串可自行确定以便在后续实验中继承lab5_1中所做的工作**
```
$ git commit -a -m "my work on lab4_1 is done."
$ git commit -a -m "my work on lab5_1 is done."
```
<a name="lab4_1_ans"></a>
#### 答案解析
将kernel/syscall.c文件中的
```c
panic( "You have to implement sys_user_uart_getchar to get data from UART using uartgetchar in lab5_1 and modify it in lab5_2.\n" );
```
替换成:
```c
volatile uint32 *status = (void*)(uintptr_t)0x60000008;
volatile uint32 *rx = (void*)(uintptr_t)0x60000000;
while (!(*status & 0x00000001));
return *rx;
```
替换原因:
地址0x60000008被映射到axi uartlite IP核的状态寄存器而该状态寄存器的最低位被用来描述接收数据FIFO的状态该位为1时表明接收数据FIFO有数据到达。因此在从蓝牙设备读取数据的过程中需要通过轮询的方式不断检查状态寄存器最低位的值直到其值为1表明有数据到达时停止检测并读取接收数据FIFO中的值进行返回接收数据FIFO寄存器的地址被映射为0x60000000
<a name="PLIC"></a>
## 7.3 lab4_2_PLIC
## 7.3 lab5_2 PLIC
<a name="lab4_2_app"></a>
<a name="lab5_2_app"></a>
#### **给定应用**
@ -308,7 +352,7 @@ $ git commit -a -m "my work on lab4_1 is done."
```c
1 /*
2 * Below is the given application for lab4_2.
2 * Below is the given application for lab5_2.
3 * The goal of this app is to control the car via Bluetooth.
4 */
5
@ -352,19 +396,18 @@ $ git commit -a -m "my work on lab4_1 is done."
43
44 return 0;
45 }
```
应用通过中断的方式从蓝牙端获取指令实现对小车的控制功能。在等待蓝牙的进程休眠的时候会执行delay进程可以看到waiting for you提示信息。
* 先提交lab4_1的答案然后切换到lab4_2继承lab4_1中所做的修改并make
* 先提交lab5_1的答案然后切换到lab5_2继承lab5_1中所做的修改并make
```bash
//切换到lab4_2
$ git checkout lab4_2_PLIC
//切换到lab5_2
$ git checkout lab5_2_PLIC
//继承lab4_1以及之前的答案
$ git merge lab4_1_poll -m "continue to work on lab4_2"
//继承lab5_1以及之前的答案
$ git merge lab5_1_poll -m "continue to work on lab5_2"
//重新构造
$ make clean; make
@ -377,70 +420,156 @@ $ sudo ./program.sh # 若重启过开发板,则在执行程序前要先执行
$ sudo ./riscv-fesvr riscv-pke app_PLIC
```
直接编译执行结果和完成后的lab4_1一致一直阻塞在这里等待蓝牙数据。需要修改lab4_1所写的代码并添加中断处理使得等待蓝牙的进程能够自动休眠执行delay进程直到发生外部中断后才继续执行。
直接编译执行结果和完成后的lab5_1一致一直阻塞在这里等待蓝牙数据。需要修改lab5_1所写的代码并添加中断处理使得等待蓝牙的进程能够自动休眠执行delay进程直到发生外部中断后才继续执行。
<a name="lab4_2_content"></a>
<a name="lab5_2_content"></a>
#### **实验内容**
如输出提示所表示的那样需要修改lab4_1所写的代码并添加中断处理。完成后按lab4_1的方法执行程序在等待蓝牙的时候会不断输出waiting for you提示信息在手机上输入控制指令后小车应能根据指令反应。
如输出提示所表示的那样需要修改lab5_1所写的代码并添加中断处理。完成后按lab5_1的方法执行程序在等待蓝牙的时候会不断输出waiting for you提示信息在手机上输入控制指令后小车应能根据指令反应。
<a name="lab4_2_guide"></a>
<a name="lab5_2_guide"></a>
#### **实验指导**
在kernel/syscall.c中找到lab4_1写的代码并根据注释进行修改
在kernel/syscall.c中找到lab5_1写的代码并根据注释进行修改
```c
227 ssize_t sys_user_uart_getchar() {
228 // TODO (lab5_1 and lab5_2): implment the syscall of sys_user_uart_getchar and modify it in lab5_2.
229 // hint (lab5_1): the functionality of sys_user_uart_getchar is to get data from UART address.
230 // therefore, we should let a pointer point, insert it in
231 // the rear of ready queue, and finally, schedule a READY process to run.
232 // hint (lab5_2): the functionality of sys_user_uart_getchar is let process sleep
233 // and register a callback function to handle system call return value.
234 // therefore, we should call do_sleep to let process 0 sleep.
235 // Note that the do_sleep function will never return, and the function passed to do_sleep
236 // will be called in do_wake.
237 panic( "You have to implement sys_user_uart_getchar to get data from UART using uartgetchar in lab5_1 and modify it in lab5_2.\n" );
238 }
```
当应用程序调用uartgetchar获取蓝牙输入指令时会首先让当前进程阻塞并等待蓝牙数据到达。你需要在上述sys_user_uart_getchar函数中实现对当前进程的阻塞。为了完成该工作本实验中添加了一个`do_sleep`函数(`kernel/process.c`
```c
312 void do_sleep(void wake_cb(void*), void* wake_cb_arg){
313 current->status = BLOCKED;
314 set_wake_callback(current->pid, wake_cb, wake_cb_arg);
315 schedule();
316 }
```
`do_sleep`除了将当前进程阻塞外,还将一个调用者提供的回调函数`wake_cb`以及它对应的参数`wake_cb_arg`注册到了当前进程中。
相应的,本实验中还提供了一个`do_wake``kernel/process.c`)函数,用来唤醒指定进程:
```c
95 ssize_t sys_user_uart_getchar() {
96 // TODO (lab4_1 and lab4_2): implment the syscall of sys_user_uart_getchar and modify it in lab4_2.
97 // hint (lab4_1): The functionality of sys_user_uart_getchar is to get data from UART address.
98 // Therefore we should check the data from the address of bluetooth status repeatedly, until the data is ready.
99 // Then read the data from the address of bluetooth reading and return.
100 // hint (lab4_2): the functionality of sys_user_uart_getchar is let process sleep and wait for value. therefore,
101 // we should call do_sleep to let process 0 sleep.
102 // then we should get uartvalue and return.
103 panic( "You have to implement sys_user_uart_getchar to get data from UART using uartgetchar in lab4_1 and modify it in lab4_2.\n" ); // 该行已被你之前写的代码替换
104
105 }
320 void do_wake(uint64 pid){
321 procs[pid].status = READY;
322 current->status = READY;
323 insert_to_ready_queue(&procs[pid]);
324 insert_to_ready_queue( current );
325
326 if (procs[pid].wake_callback)
327 procs[pid].wake_callback(procs[pid].wake_callback_arg);
328
329 schedule();
330 }
```
当蓝牙有数据发送时pke会收到外部中断你需要完成接收到外部中断后的处理。
`do_wake`除了会唤醒指定进程还会使用wake_callback_arg参数调用在`do_sleep`中注册的`wake_callback`函数。
当蓝牙有数据发送时PKE会收到外部中断你需要完成接收到外部中断后的处理。
在kernel/strap.c中找到函数空缺并根据注释完成中断处理函数
```c
103 case CAUSE_MEXTERNEL_S_TRAP:
104 {
105 //reset the PLIC so that we can get the next external interrupt.
106 volatile int irq = *(uint32 *)0xc201004L;
107 *(uint32 *)0xc201004L = irq;
108 volatile int *ctrl_reg = (void *)(uintptr_t)0x6000000c;
109 *ctrl_reg = *ctrl_reg | (1 << 4);
110 // TODO (lab4_2): implment the case of CAUSE_MEXTERNEL_S_TRAP.
111 // hint: the case of CAUSE_MEXTERNEL_S_TRAP is to get data from UART address and wake the process. therefore,
112 // and you need to store the data in struct process.value.
113 panic( "You have to implement CAUSE_MEXTERNEL_S_TRAP to get data from UART and wake the process 0 in lab4_2.\n" );
114
115 break;
116 }
110 case CAUSE_MEXTERNEL_S_TRAP:
111 {
112 //reset the PLIC so that we can get the next external interrupt.
113 volatile int irq = *(uint32 *)0xc201004L;
114 *(uint32 *)0xc201004L = irq;
115 volatile int *ctrl_reg = (void *)(uintptr_t)0x6000000c;
116 *ctrl_reg = *ctrl_reg | (1 << 4);
117 // TODO (lab5_2): implment the case of CAUSE_MEXTERNEL_S_TRAP.
118 // hint: the case of CAUSE_MEXTERNEL_S_TRAP is to get data from UART address and wake
119 // the process. therefore, you need to construct an update_uartvalue_ctx structure
120 // then store the interrupt processing process pid and the uart value in it
121 // and use this structure to update the wake callback context of the process
122 // finally call do_wake to wake up the process.
123 panic( "You have to implement CAUSE_MEXTERNEL_S_TRAP to get data from UART and wake the process 0 in lab5_2.\n" );
124
125 break;
126 }
```
注意由于在do_sleep函数中调用了schedule函数而schedule最终会导致CPU切换到用户态继续执行用户代码因此**do_sleep函数不会返回在它之后的代码也不会被运行即使进程被唤醒**。所以你无法通过在调用do_sleep函数的位置后编写代码来尝试处理uartgetchar系统调用的返回值。正确的做法是通过在do_sleep中注册一个回调函数该函数在基础代码中已经提供位于`kernel/syscall.c`的`update_uartvalue`函数并在获取到蓝牙设备输入后将蓝牙输入注册为该回调函数的调用参数。该回调函数会在进程被唤醒时执行可以在这里处理uartgetchar的返回值然后CPU控制权会回到用户态程序。
**实验完毕后,记得提交修改(命令行中-m后的字符串可自行确定以便在后续实验中继承lab5_2中所做的工作**
```
$ git commit -a -m "my work on lab5_2 is done."
```
<a name="lab5_2_ans"></a>
#### 答案解析
将kernel/strap.c文件中的
```c
panic( "You have to implement CAUSE_MEXTERNEL_S_TRAP to get data from UART and wake the process 0 in lab5_2.\n" );
```
**实验完毕后,记得提交修改(命令行中-m后的字符串可自行确定以便在后续实验中继承lab4_2中所做的工作**
替换为:
```c
volatile uint32 *rx = (void*)(uintptr_t)0x60000000;
uint32 data = *rx;
uint64 handle_intr_pid = 0; // the pid of the process that will handle this interrupt
struct update_uartvalue_ctx *ctx = (struct update_uartvalue_ctx *)alloc_page();
ctx->uartvalue = (char)data;
ctx->pid = handle_intr_pid;
set_wake_callback(handle_intr_pid, NULL, ctx); // add wake callback context
do_wake(handle_intr_pid);
```
$ git commit -a -m "my work on lab4_2 is done."
替换原因:
此处的代码会在产生外部中断时被调用而外部中断的产生则表明蓝牙设备接收到了数据。此时需要从接收数据FIFO中映射地址0x60000000将收到的数据读出并构造一个update_uartvalue_ctx上下文结构体该结构体在kernel/process.h文件中被定义将从蓝牙设备接收到的数据暂存至该上下文中同时存入的还有小车控制进程的id号0最后调用do_wake函数唤醒小车控制进程。在do_wake函数中会调用do_sleep中注册的进程唤醒回调函数update_uartvalue该函数根据上下文信息处理uart_getchar系统调用的返回值
```c
229 void update_uartvalue(void *ctx) {
230 struct update_uartvalue_ctx *uart_ctx = (struct update_uartvalue_ctx *)ctx;
231 char value = uart_ctx->uartvalue;
232 process *proc = &procs[uart_ctx->pid];
233
234 // set system call return value
235 proc->trapframe->regs.a0 = (uint64)value;
236 }
```
再将kernel/syscall.c文件中的sys_user_uart_getchar函数内容替换为
```c
do_sleep(update_uartvalue, NULL);
return 0;
```
替换原因:
当小车控制进程间接调用该函数获取蓝牙设备输入时第一行代码会导致其被阻塞并让出CPU在来自蓝牙设备的中断到达之前小车控制进程会一直处于阻塞状态。当蓝牙设备接收到数据并产生中断时do_wake会调用由do_sleep注册的回调函数update_uartvalue处理系统调用返回值。最后小车控制进程会被上文中添加的do_wake函数所唤醒。注意位于do_sleep后面的语句永远不会被执行包括return 0因此我们需要通过注册回调函数的方式来正确处理uart_getchar系统调用的返回值。
<a name="hostdevice"></a>
## 7.4 lab4_3_hostdevice
## 7.4 lab5_3 hostdevice
<a name="lab4_3_app"></a>
<a name="lab5_3_app"></a>
#### **给定应用**
- user/app_host_device.c
```c
@ -531,16 +660,16 @@ $ git commit -a -m "my work on lab4_2 is done."
85 }
```
该用户程序包含两个进程,其中主进程和实验4_2类似负责接收蓝牙发送过来的数据根据数据控制小车行动前进、后退、左转、右转、停止子进程则负责拍摄和分析首先初始化摄像头设备然后是个死循环判断摄像头拍摄的图像数据如果当前小车处于前进状态则拍摄然后检查数据如果判断前面有障碍物则控制车轮停转刹车否则如果主进程退出了则自己进行释放文件、内存、关闭设备等操作再退出。在用户程序操控摄像头的过程中使用了ioctl、mmap、munmap等系统调用你需完善其中的open和ioctl两个系统调用,对其进行完善从而实现小车的障碍识别和停止功能。
该用户程序包含两个进程,其中主进程和实验5_2类似负责接收蓝牙发送过来的数据根据数据控制小车行动前进、后退、左转、右转、停止子进程则负责拍摄和分析首先初始化摄像头设备然后是个死循环判断摄像头拍摄的图像数据如果当前小车处于前进状态则拍摄然后检查数据如果判断前面有障碍物则控制车轮停转刹车否则如果主进程退出了则自己进行释放文件、内存、关闭设备等操作再退出。在用户程序操控摄像头的过程中使用了ioctl、mmap、munmap等系统调用你需完善其中的ioctl系统调用对其进行完善从而实现小车的障碍识别和停止功能。
* 先提交lab4_2的答案然后切换到lab4_3继承lab4_2中所做的修改并make
* 先提交lab5_2的答案然后切换到lab5_3继承lab5_2中所做的修改并make
```bash
//切换到lab4_3
$ git checkout lab4_3_hostdevice
//切换到lab5_3
$ git checkout lab5_3_hostdevice
//继承lab4_2以及之前的答案
$ git merge lab4_2_PLIC -m "continue to work on lab4_3"
//继承lab5_2以及之前的答案
$ git merge lab5_2_PLIC -m "continue to work on lab5_3"
//重新构造
$ make clean; make
@ -555,41 +684,54 @@ $ sudo ./riscv-fesvr riscv-pke app_host_device
<a name="lab4_3_content"></a>
#### 实验内容
#### 实验内容
如应用提示所表示的那样读者需要找到并完成对ioctl的调用使得用户能够设置设备参数从而控制摄像头实现拍照等功能获取图片后检查数据从而判断前方是否出现障碍物。
如应用提示所表示的那样读者需要找到并完成对open和ioctl的调用使得用户能够设置设备参数从而控制摄像头实现拍照等功能获取图片后检查数据从而判断前方是否出现障碍物。
在之前的文件系统实验中我们已经为PKE实现了虚拟文件系统并为host端的文件设计了一个hostfs从而为PKE提供通过虚拟文件系统直接访问host端文件的能力。同样的在本次实验中摄像头在ARM端系统中也是作为设备文件进行管理的它对应`/dev`目录下的`/dev/hostfs`文件。通过直接操作该设备文件的方式便可以通过文件系统接口来控制摄像头设备
跟踪相关系统调用在kernel/file.c里可以看到需要补充的函数
为了在PKE中操作摄像头设备本实验修改了PKE文件系统的默认挂载方式首先仍然将ARM端的hostfs_root目录作为虚拟文件系统根目录进行挂载其次将ARM端的`/dev`目录挂载到PKE的`/dev`目录这样便可以像访问本地设备一样访问ARM端设备文件另外本实验并不涉及到RFS。与上述变更相关的代码可以在`kernel/proc_file.c`中的`fs_init`函数内找到
```c
25 int do_open(char *pathname, int flags) {
26 // TODO (lab4_3): call host open through spike_file_open and then bind fd to spike_file
27 // hint: spike_file_dup function can bind spike_file_t to an int fd.
28 panic( "You need to finish open function in lab4_3.\n" );
29 }
30 int do_write(int fd, char *buf, uint64 count) {
31 spike_file_t *f = spike_file_get(fd);
32 return spike_file_write(f, buf, count);
33 }
34 int do_close(int fd) {
35 spike_file_t *f = spike_file_get(fd);
36 return spike_file_close(f);
37 }
38
39 int do_ioctl(int fd, uint64 request, char *data) {
40 // TODO (lab4_3): call host ioctl through frontend_sycall
41 // hint: fronted_syscall ioctl argument:
42 // 1.call number
43 // 2.fd
44 // 3.the order to device
45 // 4.data address
46 panic( "You need to call host's ioctl by frontend_syscall in lab4_3.\n" );
47 }
21 void fs_init(void) {
22 // initialize the vfs
23 vfs_init();
24
25 // register hostfs-file and mount it as the root
26 if( register_hostfs() < 0 ) panic( "fs_init: cannot register hostfs.\n" );
27 struct device *hostdev = init_host_device("HOSTDEV", "./hostfs_root");
28 vfs_mount("HOSTDEV", MOUNT_AS_ROOT);
29
30 // register hostfs-dev and mount it as /dev
31 struct device *hostdev_dev = init_host_device("dev", "/dev");
32 vfs_mount("dev", MOUNT_DEFAULT);
33
34 // register and mount rfs
35 if( register_rfs() < 0 ) panic( "fs_init: cannot register rfs.\n" );
36 struct device *ramdisk0 = init_rfs_device("RAMDISK0");
37 rfs_format_dev(ramdisk0);
38 vfs_mount("RAMDISK0", MOUNT_DEFAULT);
39 }
```
另外为了让hostfs支持对给定的不同路径`hostfs_root`、`/dev`实例化出多个hostfs设备并挂载到不同的虚拟文件系统目录`/`、`/dev`基础代码对hostfs也进行了一些改造。这部分相关代码可以在`kernel/hostfs.c`中找到,读者可以自行阅读,这里不再赘述。
为了通过ioctl操作设备文件基础代码中还为VFS添加了文件ioctl操作的相关支持。读者在完成文件系统相关实验后应该对文件系统相关函数的实验方式有了一定的了解与对文件的read/write等操作的实现方式一样ioctl同样是作为vinode的一个操作函数实现的。对ioctl实现的跟踪方式也与之前在文件系统中对文件操作函数的跟踪方式类似通过对相关调用的跟踪在`kernel/hostfs.c`里可以看到需要补充的函数:
```c
215 int hostfs_ioctl(struct vinode *f_inode, uint64 request, char *data) {
216 spike_file_t *pf = (spike_file_t *)f_inode->i_fs_info;
217 if (pf < 0) {
218 sprint("hostfs_write: invalid file handle!\n");
219 return -1;
220 }
221 panic( "You need to call host's ioctl by frontend_syscall in lab5_3.\n" );
222 }
```
实验预期结果小车在前进过程中能够正常识别障碍物后并自动停车。测试时别忘记把摄像头接到USB接口否则系统会找不到设备文件。
<a name="lab4_3_guide"></a>
<a name="lab5_3_guide"></a>
#### 实验指导
@ -610,10 +752,31 @@ USB摄像头最基础的控制方法是使用读写设备文件的方式。拍
应用第21行可以看到我们从摄像头获取的数据是YUYV格式读者可进行查阅它用灰度、蓝色色度、红色色度三个属性表示颜色每个像素点都有灰度属性。由于我们分析障碍物只需要灰度图所以取每个像素点的灰度属性即可。因此对于获取过来的数据删去奇数索引的数据就可以得到灰度图。
注意:对于灰度阈值的设定可根据环境亮度进行一定的调整,可以先根据摄像头返回的图像进行分析,计算出对应障碍物的灰度值;灰度阈值越精确,小车对于障碍物的识别将越灵敏,并能在合理的距离内识别到障碍物并停车。
**虽然如此,该算法仍不是非常精确。所以,这里给出的障碍物判断算法仅供参考,我们鼓励大家编写更高级的算法,实现更强大的功能。**
**虽然如此,但该算法仍不是非常精确。所以,这里给出的障碍物判断算法仅供参考,我们鼓励大家编写更高级的算法,实现更强大的功能。**
**实验完毕后,记得提交修改(命令行中-m后的字符串可自行确定以便在后续实验中继承lab4_3中所做的工作**
```
$ git commit -a -m "my work on lab4_3 is done."
$ git commit -a -m "my work on lab5_3 is done."
```
<a name="lab5_3_ans"></a>
#### 答案解析
将`kernel/hostfs.c`文件中的:
```c
panic( "You need to call host's ioctl by frontend_syscall in lab5_3.\n" );
```
替换成:
```c
return frontend_syscall(HTIFSYS_ioctl, pf->kfd, request, (uint64)data, 0, 0, 0, 0);
```
替换原因:
frontend_syscall函数在spike_interface/spike_utils.c中定义该函数会将其所有参数通过HTIF协议传给riscv-fesvr在PS端进行系统调用。注意fd参数是PKE内部的文件描述符不是该文件在PS端操作系统里对应的文件描述符所以需要先将fd通过spike_file_get转成spike_file_t对象然后获取该对象的kfd属性这个属性存储的值才是该文件在PS端操作系统里对应的文件描述符。

Loading…
Cancel
Save