鸿蒙移植i.mx6ull(九) 串口移植(基于IMX6ULL)

Ps:这个鸿蒙系列是韦东山老师录制的视频和开发手册为基础，请大家支持韦老师。 这个专栏是：
1.学习的笔记记录。
2.整理和知识点汇总。
3.个人做的项目经验汇总。

1. Liteos-a中串口的使用

1.1 内核里打印

内核打印函数是PRINT_RELEASE，它的内部调用关系如下：

PRINT_RELEASE
    LOS_LkPrint
    	g_osLkHook
    		OsLkDefaultFunc
    			OsVprintf
    				UartPuts
    					UartPutsReg
    						UartPutStr
    							UartPutcReg

我们要实现UartPutcReg，用来输出单个字符。

1.2 APP控制台

我们编写的应用程序，调用printf时，那些信息从哪里打印出来？从控制台。 在串口上运行程序，控制台就是串口。
远程登录板子后运行程序，控制台就是远程登录终端。

控制台的实现分为4层：

1.2.1 /dev/console

init进程打开的就是/dev/console，它会打开shell。
我们在shell里执行各种APP时，这些APP会继承父进程的3个设备：标准输入、标准输出、标准错误，都对应/dev/console。
我们编写的APP，一般不需要自己去打开/dev/console，它已经继承得到了。
在串口上运行程序，/dev/console就是串口。 远程登录板子后运行程序，/dev/console就是远程登录终端。
所以/dev/console表示的是当前终端，它可能对应不同的设备，比如/dev/serial或/dev/telnet。

1.2.2 /dev/serial

在Liteos-a中，/dev/serial被称为virtual serial，虚拟串口。它只是起一个中转的作用，无论是APP还是内核，使用/dev/serial时，都是再次跳转去执行具体串口设备驱动程序的函数。比如：

那么，/dev/serial这个虚拟串口，怎么跟具体串口挂钩？也就是上图中，GetFileOps函数为何能得到具体串口的驱动程序？
方法如下图所示：

virtual_serial_init函数会找到/dev/uartdev-0的驱动程序(即它对应的struct inode，里面含有file_operations_vfs)。

1.2.3 /dev/uartddev-0

1. 总体介绍

这是真正操作硬件的驱动程序，它分为两部分：device_t、driver_t。

• 在device_t中设置资源，比如寄存器物理基地址、中断号等
• 在driver_t中提供函数，比如device_probe、device_attach函数
• 当内核发现有名字系统的device_t、driver_t时
• 就会调用driver_t中的device_probe、device_attach函数
• 在里面根据device_t得到资源、注册驱动register_driver

这种写驱动程序的方法，被称为分离：操作函数、资源分离。
以后想换一个硬件，只需要修改device_t就可以，driver_t保存不变。

2. device_t

示例代码：

3. drvier_t

先注册一个drvier_t结构体，它里面带有各类device_method_t：

当内核发现有同名的device_t和driver_t时，就会调用driver_t里面提供的device_probe、device_attach函数。

4. uartdev_fops

在device_attach函数里从device_t里获取硬件资源、注册驱动：

/dev/uartdev-0对应的驱动程序时uartdev_fops，它通过uart_ops来操作硬件。

1.2.4 uart_ops

在UART驱动程序里，我们只需要提供硬件操作部分：

uart_ops里有4个函数：

• config：配置串口，比如波特率等
• startup：启动串口，比如注册中断处理函数、启动串口
• start_tx：发送字符串
• shutdown：关闭串口

串口就两大功能：发送数据、接收数据。
在Liteos-a中，发送数据比较简单：没有使用中断，而是使用查询方式逐个发送，核心是UartPutcReg。
接收数据时使用中断，所以需要注册串口接收中断处理函数，它要做的事情是：

• 发生中断时，读取硬件获得字符，可能有多个字符
• 处理特殊字符：比如不`\r`换为`\n`
• 通知上层代码：udd->recv(udd, buf, count);

2. 串口移植

我们的目标是：让最小系统启动。 那么对于串口，不需要考虑得很全面：

• 不需要初始化串口：u-boot已经初始化串口了
• 不需要动态配置串口：固定使用某个波特率等配置就可以(在u-boot里设置过了)

移植工作只需要实现这几点：

• 串口发送单个字符

• 注册串口接收中断函数：确定中断号、使能中断、在中断函数中读取数据

2.1 最终结果

本章节做的修改会制作为补丁文件：

• 03_openharmony_uart_imx6ull.patch

假设目录openharmony中是未修改的代码，从没打过补丁；
假设补丁文件放在openharmony的同级目录； 打补丁方法如下：

$ cd openharmony
$ patch -p1 < ../openharmony_100ask_v1.2.patch
$ patch -p1 < ../01_openharmony_add_demo_board.patch
$ patch -p1 < ../02_openharmony_memmap_imx6ull.patch 
$ patch -p1 < ../03_openharmony_uart_imx6ull.patch

打上补丁后，可以如此编译：

$ cd kernel/liteos_a
$ cp tools/build/config/debug/demochip_clang.config .config
$ make clean
$ make

2.2 串口发送单个字符

2.3 在device_t中指定资源

需要确定2个资源：寄存器地址、中断号

2.4 实现uart_ops

在UART驱动程序里，uart_ops结构体封装了UART的硬件操作：

uart_ops里有4个函数：

• config：配置串口，比如波特率等
• startup：启动串口，比如注册中断处理函数、启动串口
• start_tx：发送字符串
• shutdown：关闭串口

我们只需要实现startup、start_tx，其他函数可以设为空：

• startup：确定中断号、request_irq、使能中断、提供中断处理函数
• start_tx：发送字符串

2.5 GIC

在kernel\liteos_a\platform\main.c中，调用OsSystemInfo打印系统信息时，代码如下：

    PRINT_RELEASE("\n******************Welcome******************\n\n"
            "Processor   : %s"
#if (LOSCFG_KERNEL_SMP == YES)
            " * %d\n"
            "Run Mode    : SMP\n"
#else
            "\n"
            "Run Mode    : UP\n"
#endif
            "GIC Rev     : %s\n"
            "build time  : %s %s\n"
            "Kernel      : %s %d.%d.%d.%d/%s\n"
            "\n*******************************************\n",
            LOS_CpuInfo(),
#if (LOSCFG_KERNEL_SMP == YES)
            LOSCFG_KERNEL_SMP_CORE_NUM,
#endif
            HalIrqVersion(), __DATE__, __TIME__,\
            KERNEL_NAME, KERNEL_MAJOR, KERNEL_MINOR, KERNEL_PATCH, KERNEL_ITRE, buildType);

里面的HalIrqVersion函数用到的GIC的虚拟地址，要正确设置，否则没有打印信息。
IMX6ULL的内存映射代码里，设备空间从GIC开始映射，所以GIC的虚拟地址就是PERIPH_DEVICE_BASE：

// kernel/liteos_a/kernel/base/include/los_vm_zone.h
#define GIC_VIRT_BASE    PERIPH_DEVICE_BASE

// vendor/democom/demochip/board/include/asm/platform.h
#define GIC_BASE_ADDR             (GIC_VIRT_BASE)