Klipper seria.c 文件代码分析

chatgpt/2023/9/26 12:43:36

一. 前言

        Klipper 底层硬件的串口模块程序写的是否正确是决定下位机与上位机能否正常通信的前提，如果这个文件的驱动没写好，那上位机控制下位机就无从谈起，更无法通过上位机去验证下位机程序的正确性。

        本篇博文将详细解析 Klipper src 文件夹下的 lpc176x 单片机的 serial.c，来分析其中的 API 函数的功能和作用，以此为新的平台的串口驱动的移植提供参考。

二. serial_init 函数

        serial_init 函数主要是：

        1. 对串口的根时钟进行初始化；

        2. 设置通信配置：

  • 波特率：通过设置分频系数（DLL 和 DLM）进行设置，前提是设置 LCR 的 bit7 为 1，即使能开启对除数锁存器的访问 ）；
  • 字长（设置 LCR 的 [1:0] ，默认 8 个字节）
  • 停止位（设置 LCR 的 bit2，默认 1 个停止位）
  • 奇偶校验（设置 LCR 的 bit3 进行使能，默认不进行奇偶校验；[5:4] 选择发送数据的奇偶校验值，这里不深入研究）

        代码及注释如下： 

void
serial_init(void)
{// Setup baudenable_pclock(PCLK_UARTx); //使能 UART 时钟LPC_UARTx->LCR = (1<<7); // set DLAB bit 开启对除数锁存器的访问uint32_t pclk = get_pclock_frequency(PCLK_UARTx); //得到时钟频率uint32_t div = pclk / (CONFIG_SERIAL_BAUD * 16); //的分频系数LPC_UARTx->DLL = div & 0xff;  //设置分频系数低 8 位LPC_UARTx->DLM = (div >> 8) & 0xff;  //设置分频系数高 8 位LPC_UARTx->FDR = 0x10;   //取消预分频LPC_UARTx->LCR = 3; // 8N1 ; clear DLAB bit，设置停止位、奇偶校验、极性// Enable fifoLPC_UARTx->FCR = 0x01;  //使能 FIFO// Setup pinsgpio_peripheral(GPIO_Rx, GPIO_FUNCTION_UARTx, 0);gpio_peripheral(GPIO_Tx, GPIO_FUNCTION_UARTx, 0);// Enable receive irqarmcm_enable_irq(UARTx_IRQHandler, UARTx_IRQn, 0);LPC_UARTx->IER = 0x01;   //使能接收中断
}

三. 使能发送中断

        程序使用 serial_enable_tx_irq API 函数来进行发送中断的使能：

  1. 先要通过判断 LSR 寄存器的 bit5 位为 1 即发送 FIFO 里面没有数据，串口可以发送新的数据；
  2. 之后在此函数中调用 kick_tx 函数来实现发送中断的使能。
void
serial_enable_tx_irq(void)
{if (LPC_UARTx->LSR & (1<<5)) {    //上一字节发送完成irqstatus_t flag = irq_save();kick_tx();  //发送一个字节后使能发送中断irq_restore(flag);}
}

        对于  kick_tx 函数，其中的逻辑是：

  1. 先向 THR 中写数据，然后判断到 THR 不为空之后，使能发送中断；
  2. 数据由 serial_get_tx_byte 函数得到，此函数将遍历函数内部数组的数据，将其赋值给 data，然后向 THR 赋值，将 data 通过中断的方式发送出去；
  3. 若数组遍历到尽头之后，变量 ret 将被赋值0为 -1，在 if(ret) 条件判断中，函数将通过设置 IER 寄存器，关闭发送中断，只使能接收中断。
// Write tx bytes to the serial port
static void kick_tx(void)
{for (;;) {if (!(LPC_UARTx->LSR & (1<<5))) {// Output fifo full - enable tx irq，有数据需要发送，使能发送中断LPC_UARTx->IER = 0x03;break;}uint8_t data;int ret = serial_get_tx_byte(&data);if (ret) {// No more data to send - disable tx irqLPC_UARTx->IER = 0x01;break;}LPC_UARTx->THR = data;}
}

       从 IER 寄存器可以看到 0x01 对应的是 Enable 接收数据中断，0x03 则同时 Enable 了接收和发送中断。

四. 中断服务函数 

        中断服务函数将通过 IIR 寄存器判断是否达到了中断条件，若产生了 THRE 中断，即获取到 status 为 0x02，即数据发送寄存器 THR 为空，程序将产生串口中断，在程序使能发送中断时，在 kick_tx 中发出一个 FIFO 的数据，THR 将为空，程序将发生中断发送下一个 FIFO 的数据，直到 Disable 掉串口发送中断。

void UARTx_IRQHandler(void)
{uint32_t iir = LPC_UARTx->IIR, status = iir & 0x0f; //获取中断状态if (status == 0x04) //接收中断serial_rx_byte(LPC_UARTx->RBR);else if (status == 0x02)  //发送中断kick_tx();
}

         从 IIR 寄存器可以看到 0x02 对应的是发生了接收数据中断，0x04 是出现了发送中断。 

五. 总结

        程序只有安照正确的逻辑编写 API 函数，Klipper 下位机驱动才可以适配上层的应用层代码，对于 serial.c 程序，核心是理解中断发送和接收的条件，在应用代码的基础上编写发送和接收函数。

        完整代码如下：

// lpc176x serial port
//
// Copyright (C) 2018-2021  Kevin O'Connor <kevin@koconnor.net>
//
// This file may be distributed under the terms of the GNU GPLv3 license.#include "board/armcm_boot.h" // armcm_enable_irq
#include "autoconf.h" // CONFIG_SERIAL_BAUD
#include "board/irq.h" // irq_save
#include "board/serial_irq.h" // serial_rx_data
#include "command.h" // DECL_CONSTANT_STR
#include "internal.h" // gpio_peripheral
#include "sched.h" // DECL_INIT#if CONFIG_LPC_SERIAL_UART0_P03_P02DECL_CONSTANT_STR("RESERVE_PINS_serial", "P0.3,P0.2");#define GPIO_Rx GPIO(0, 3)#define GPIO_Tx GPIO(0, 2)#define GPIO_FUNCTION_UARTx 1#define LPC_UARTx LPC_UART0#define UARTx_IRQn UART0_IRQn#define PCLK_UARTx PCLK_UART0
#elif CONFIG_LPC_SERIAL_UART3_P429_P428DECL_CONSTANT_STR("RESERVE_PINS_serial", "P4.29,P4.28");#define GPIO_Rx GPIO(4, 29)#define GPIO_Tx GPIO(4, 28)#define GPIO_FUNCTION_UARTx 3#define LPC_UARTx LPC_UART3#define UARTx_IRQn UART3_IRQn#define PCLK_UARTx PCLK_UART3
#endif// Write tx bytes to the serial port
static void
kick_tx(void)
{for (;;) {if (!(LPC_UARTx->LSR & (1<<5))) {// Output fifo full - enable tx irq，有数据需要发送，使能发送中断LPC_UARTx->IER = 0x03;break;}uint8_t data;int ret = serial_get_tx_byte(&data);if (ret) {// No more data to send - disable tx irqLPC_UARTx->IER = 0x01;break;}LPC_UARTx->THR = data;}
}void
UARTx_IRQHandler(void)
{uint32_t iir = LPC_UARTx->IIR, status = iir & 0x0f; //获取中断状态if (status == 0x04) //接收中断serial_rx_byte(LPC_UARTx->RBR);else if (status == 0x02)  //发送中断kick_tx();
}void
serial_enable_tx_irq(void)
{if (LPC_UARTx->LSR & (1<<5)) {    //上一字节发送完成irqstatus_t flag = irq_save();kick_tx();  //发送一个字节后使能发送中断irq_restore(flag);}
}void
serial_init(void)
{// Setup baudenable_pclock(PCLK_UARTx); //使能 UART 时钟LPC_UARTx->LCR = (1<<7); // set DLAB bit 开启对除数锁存器的访问uint32_t pclk = get_pclock_frequency(PCLK_UARTx); //得到时钟频率uint32_t div = pclk / (CONFIG_SERIAL_BAUD * 16); //的分频系数LPC_UARTx->DLL = div & 0xff;  //设置分频系数低 8 位LPC_UARTx->DLM = (div >> 8) & 0xff;  //设置分频系数高 8 位LPC_UARTx->FDR = 0x10;   //取消预分频LPC_UARTx->LCR = 3; // 8N1 ; clear DLAB bit，设置停止位、奇偶校验、极性// Enable fifoLPC_UARTx->FCR = 0x01;  //使能 FIFO// Setup pinsgpio_peripheral(GPIO_Rx, GPIO_FUNCTION_UARTx, 0);gpio_peripheral(GPIO_Tx, GPIO_FUNCTION_UARTx, 0);// Enable receive irqarmcm_enable_irq(UARTx_IRQHandler, UARTx_IRQn, 0);LPC_UARTx->IER = 0x01;   //使能接收中断
}
DECL_INIT(serial_init);

六. 参考文献

1. 来源：NXP 官网，UM10360

https://cache.nxp.com.cn/secured/assets/documents/en/user-guide/UM10360.pdf?__gda__=1690807854_806c303fe28ea3f108ebbd4977345cb6&fileExt=.pdf

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.exyb.cn/news/show-5313431.html

如若内容造成侵权/违法违规/事实不符，请联系郑州代理记账网进行投诉反馈，一经查实，立即删除！

相关文章

Vue实现柱状图横向自动滚动

Vue实现柱状图横向自动滚动

Vue实现柱状图横向自动滚动 1. 前言2. 代码3、实现效果图 1. 前言 原理&#xff1a;通过定时器修改Echarts的配置&#xff08;options&#xff09;达到我们想要的效果。 此外&#xff0c;我们还需要了解Echarts中dataZoom这个组件&#xff0c;这个组件用于&#xff1a;用于区域…
阅读更多...
Apache Storm入门介绍之三分钟看懂Apache Storm

Apache Storm入门介绍之三分钟看懂Apache Storm

文章目录 0.前言1. 什么是 Apache Storm&#xff1f;1.1. Nimbus1.2. Zookeeper1.3. Supervisor1.4. Worker1.5 集群模式下各组件职责 2. 核心概念2.1基本架构和任务模型2.2 工作流程 3. 源码地址3.1. 代码结构3.1. 核心模块介绍 4. Storm入门实例0.创建java工程并引入依赖1. 创…
阅读更多...
add-apt-repository ppa:graphics-drivers/ppa 报错 AttributeError 解决方法

add-apt-repository ppa:graphics-drivers/ppa 报错 AttributeError 解决方法

add-apt-repository ppa:graphics-drivers/ppa 报错 AttributeError: ‘NoneType’ object has no attribute ‘people’ 解决方法 当我在尝试在 Debian 12 系统上安装Nvidia 驱动的时候遇到了问题&#xff0c;有说要增加一下驱动源的&#xff0c;但是我运行标题的命令总是报错…
阅读更多...
颠倒二进制位，颠倒给定的 32 位无符号整数的二进制位。

颠倒二进制位，颠倒给定的 32 位无符号整数的二进制位。

题记&#xff1a; 颠倒给定的 32 位无符号整数的二进制位。 提示&#xff1a; 请注意&#xff0c;在某些语言&#xff08;如 Java&#xff09;中&#xff0c;没有无符号整数类型。在这种情况下&#xff0c;输入和输出都将被指定为有符号整数类型&#xff0c;并且不应影响您的…
阅读更多...
算法——十大排序 （部分未完结）

算法——十大排序 （部分未完结）

总结 为什么需要稳定排序&#xff1f; ▪ 让第⼀个关键字的排序结果服务于第⼆个关键字排序中数值相同的那些数 ▪ 主要是为了第⼀次考试分数相同时候&#xff0c;可以按照第⼆次分数的⾼低进行排序 一、冒泡排序 从最简单的冒泡排序开始 思想&#xff1a;交换相邻的元素&am…
阅读更多...
Ubuntu安装harbor（http模式）并随便上传一个

Ubuntu安装harbor（http模式）并随便上传一个

Ubuntu安装harbor&#xff08;http模式&#xff09; docker和harbor的介绍就免了&#xff0c;都不知道啥东西&#xff0c;还安装搞毛 先安装docker环境 不要问&#xff0c;软件源之类的配置&#xff0c;挨个梭就行 sudo apt update sudo apt install apt-transport-https ca…
阅读更多...
高速过孔同进同出？到底是什么一种设计体验

高速过孔同进同出？到底是什么一种设计体验

高速先生成员--黄刚 每当来一个比较新的概念时&#xff0c;高速先生总是非常的喜欢&#xff0c;随之而来的求知欲也会爆发个小宇宙。其实问题的来源是我们公司的北京分部的资深设计工程师&#xff0c;北京分部本身也是我司全国20多个分部里设计能力最强的分部之一了&#xff0c…
阅读更多...
JAVASE---类和对象

JAVASE---类和对象

1. 面向对象的初步认知 1.1 什么是面向对象 Java是一门纯面向对象的语言(Object Oriented Program&#xff0c;简称OOP)&#xff0c;在面向对象的世界里&#xff0c;一切皆为对象。面向对象是解决问题的一种思想&#xff0c;主要依靠对象之间的交互完成一件事情。用面向对象的…
阅读更多...
推荐文章

Copyright @ 2022~2023