融合终端交流采集板SPI接口使用说明及Demo.docxVIP

交采板SPI接口使用说明 密级： 文件标识 项目名称 文件名称 交采底板SPI接口使用说明 编 制 任振东 审 核 批 准 文件版本号 V1.1 修改历史 版本 日期 说明 负责人 V1.0 2020.02.11 初始版本 任振东 V1.1 2020.02.27 更新了libsg.h、libsg.so、工程实例appjcDemo2.3.rar 增加了校表相关的协议帧说明及校表流程 任振东 V1.1 2020.03.10 更新了spi_rd_real()，spi_rd_real2()，spi_rd_event() 任振东  引言 融合终端的交流采集板是由单片机STM32和计量芯片ATT7022E构成的计量子系统，能测量3个电压、4个电流、4路开入.交采底板和主控板的通信方式为SPI总线，主控板是SPI主机、交采板是SPI从机。通信协议为智芯公司自定义，通信交互方式是问答模式，即主控板发起询问、交采板应答。协议帧格式是用C语言struct来定义。可结合附件的C语言工程样例 REF _Re\r \h 10来阅读。 数据结构 spidev_t ：描述了SPI设备的相关信息，打开SPI设备时用到它。 frm_rd_03_t ：主控板向交采板请求实时数据、请求校表参数时，发送此结构体格式的帧到交采板，由帧头、帧尾、命令码、数据标识、linux系统时间等组成。 frm_rd_real_response_t ： 是交采板对frm_rd_03_t的应答帧，包含有交采实时数据1。 frm_rd_event_t ：向交采板请求开入事件信息时，发送此结构体的帧，由帧头、帧尾、开入防抖时间等组成。 frm_rd_event_response_t ： 是交采板对frm_rd_event_t的应答帧，包含有开入事件信息。 frm_start_adj_t：启动校表时，主控板发送此帧给交采板，应合理配置其rate。 frm_start_adj_response_t：是交采板对frm_start_adj_t的应帧。 frm_rd_coeff_respose_t：是交采板对读系数帧frm_rd_03_t的应答帧。 交采板能提供数据 实时数据1，ac_real_t ：是交采板提供的第1组实时数据，主要包含电压、电流、谐波、电能量脉冲个数等。 实时数据2，ac_real2_t ：是交采板提供的第2组实时数据，主要包括视在电能量脉冲个数、4象限无功电能量脉冲个数等。 开入事件，di_event_send_t ：交采板提供的开入事件用此结构体承载。 交采板不能提供失压、断相类数据。 SPI操作 如何打开SPI设备：初始化一个spidev_t设备，用spi_dev_open()函数打开它。 如何发送一帧：用函数fc_send(),输入参数有发送缓冲区、长度等，它封装了ioctl()。 如何接收一帧：用函数fc_recv()，输入参数有接收缓冲区、长度等, 它封装了ioctl()。 读交交采实时数据 用spi_rd_real()，构造发送帧frm_rd_03_t，设置输入参数：SPI设备、发送帧、返回数据缓冲区等。 读开入量变位事件 用spi_rd_event()，构造发送帧frm_rd_event_t，设置输入参数：SPI设备、发送帧、返回数据缓冲区等。 时间同步原理 在召测交采板实时数据的SPI协议发送帧中的ac_time3_t，用主控板的系统时间来填充，交采板会根据此时间来设置其时间 校正流程 校正点1对应：220V 5A 1.0; 校正点2对应：220V 5A 0.5L; 校正点3对应：220V 0.25A 0.5L; 从开始校正点1开始，依次校正。 校正第1点的过程： 配置功率源到校正点1。下发启动帧frm_start_adj_response_t，检查响应帧frm_start_adj_response_t，如果正确响应，且响应帧的sta为0，就循环查询校表状态：循环发送此帧frm_rd_coeff7022，并检查应帧frm_rd_coeff_respose_t，直到frm_rd_coeff_respose_t的sta有值表示校表结束，根据sta值判断校表成功与否，如果成功，就切换到校正点2，用时大致15秒。 如何设置交采板的防抖时间 在召测交采板开入量变位事件的SPI协议发送帧中有di_lowtm和di_hightm，分别是高电平去抖动时间和低电平去抖动时间，设置为相同值即可，用防抖时间赋值，单位是毫秒。 Linux工程实例 用智芯公司提供编译环境；解压到某个目录，进入main.c文件目录，make clean;make即可。