Skip to content

Latest commit

 

History

History
145 lines (96 loc) · 3.81 KB

README.md

File metadata and controls

145 lines (96 loc) · 3.81 KB

串口下位机程序说明

简体中文 | English

相关文件

本下位机程序仅包含单个文件debug.c，位于仓库lower/serial目录下，也可以下载发行版中的下位机程序压缩包后在serial文件夹中找到

配置项

  • **#define DEBUG_SEND(buf,len)：需配置为所用平台的串口发送语句，将buf所指向的len个字节通过串口发出

  • #define DEBUG_RESET()：需配置为所用平台的复位语句，上位机中点击复位并运行时会调用该语句

  • #define DEBUG_READ_ADDR_RANGE(addr)：读地址限制条件，若请求的地址addr不符合条件则返回0x00

  • #define DEBUG_WRITE_ADDR_RANGE(addr)：写地址限制条件，若请求的地址addr不符合条件则不会写入

  • #define DEBUG_ADDR_OFFSET：读写偏移地址，下位机会将收到的指令加上该偏移量后再进行读写操作

注：带**的项为必需配置，其余项若不需要对应功能可不定义

函数接口

  • void Debug_SerialRecv(uint8_t *buf,uint16_t len);：外部程序需要在收到串口数据时调用该函数进行解析，buf为数据首地址，len为字节数

    注：程序使用循环队列作为接收数据缓存，自动处理分包和粘包，因此无需保证一次性传入完整数据帧，但应保证一个数据帧接收结束时及时调用该函数

移植说明

  1. 开启一个串口，将下位机程序添加到项目工程中

  2. 修改配置项

  3. 在收到串口数据时调用Debug_SerialRecv函数

问题处理

上位机点击连接后显示读取超时，下位机还在正常运行

  • 检查串口连接是否正常，包括串口参数配置（波特率等）、硬件接线、下位机相关程序等，确保下位机能收到串口数据并返回结果

上位机点击连接后显示读取超时，下位机出现运行异常（进入硬件错误或发生复位现象等）

  • 这是读写地址越界导致的现象，请参照芯片手册将允许读写的地址上下限写到配置项DEBUG_READ_ADDR_RANGE和DEBUG_WRITE_ADDR_RANGE中

上位机正常连接，但显示的数值不正确

  • 可能是由于下位机的实际地址与上位机符号文件间存在偏移导致的，需要测量出该偏移并写到配置项DEBUG_ADDR_OFFSET中

  • 偏移测量方法：

    • 选取任意一个变量（假设为var）

    • 在上位机中查看变量&var的值（即为符号文件中的地址）

    • 在下位机程序中打印出&var的值（即为下位机中的实际地址）

    • 将两个值相减即可得到偏移（实际地址-符号文件地址）

移植示例

STM32 & HAL & 中断收发

/****Debug.c****/
//...
//串口发送指令（使用串口1）
#define DEBUG_SEND(buf,len) HAL_UART_Transmit_IT(&huart1,(buf),(len))
//复位指令
#define DEBUG_RESET() { \
	__set_FAULTMASK(1); \
	NVIC_SystemReset(); \
}
//...

/****main.c****/
//...
int main(void)
{
	//...(需先进行串口初始化)
	__HAL_UART_ENABLE_IT(&huart1,UART_IT_RXNE); //使能串口RXNE中断
	//...
	while(1)
	{
		//...
	}
}
//...

/****stm32f1xx_it.c****/
//...
void USART1_IRQHandler(void) //串口中断服务函数
{
	if(__HAL_UART_GET_FLAG(&huart1,UART_FLAG_RXNE)!=RESET) //判定为RXNE中断
	{
		uint8_t ch=huart1.Instance->DR; //读出收到的字节
		Debug_SerialRecv(&ch,1); //进行解析
	}
}
//...

Arduino 串口轮询方式

/****main.ino****/

//...
#define DEBUG_SEND(buf,len) Serial.write((buf),(len))
//...(下位机程序其他部分)

void setup()
{
	//...
	Serial.begin(115200); //初始化串口波特率为115200
	//...
}

void loop()
{
	while(Serial.available())
	{
		uint8_t ch=Serial.read(); //读出串口数据
		Debug_SerialRecv(&ch,1); //进行解析
	}
	//...其余代码不能有阻塞情况，需尽快执行完毕
}