融合終端交流采集板SPI接口使用說明及Demo

交采板SPI接口使用說明密級：文件標識項目名稱文件名稱交采底板SPI接口使用說明編制任振東審核批準文件版本號V1.1修改歷史版本日期說明負責(zé)人V1.02020.02.11初始版本任振東V1.12020.02.27更新了libsg.h、libsg.so、工程實例appjcDemo2.3.rar增加了校表相關(guān)的協(xié)議幀說明及校表流程任振東V1.12020.03.10更新了spi_rd_real()，spi_rd_real2()，spi_rd_event()任振東

引言融合終端的交流采集板是由單片機STM32和計量芯片ATT7022E構(gòu)成的計量子系統(tǒng)，能測量3個電壓、4個電流、4路開入.交采底板和主控板的通信方式為SPI總線，主控板是SPI主機、交采板是SPI從機。通信協(xié)議為智芯公司自定義，通信交互方式是問答模式，即主控板發(fā)起詢問、交采板應(yīng)答。協(xié)議幀格式是用C語言struct來定義。可結(jié)合附件的C語言工程樣例REF_Ref33694307\r\h10來閱讀。數(shù)據(jù)結(jié)構(gòu)spidev_t：描述了SPI設(shè)備的相關(guān)信息，打開SPI設(shè)備時用到它。frm_rd_03_t：主控板向交采板請求實時數(shù)據(jù)、請求校表參數(shù)時，發(fā)送此結(jié)構(gòu)體格式的幀到交采板，由幀頭、幀尾、命令碼、數(shù)據(jù)標識、linux系統(tǒng)時間等組成。frm_rd_real_response_t：是交采板對frm_rd_03_t的應(yīng)答幀，包含有交采實時數(shù)據(jù)1。frm_rd_event_t：向交采板請求開入事件信息時，發(fā)送此結(jié)構(gòu)體的幀，由幀頭、幀尾、開入防抖時間等組成。frm_rd_event_response_t：是交采板對frm_rd_event_t的應(yīng)答幀，包含有開入事件信息。frm_start_adj_t：啟動校表時，主控板發(fā)送此幀給交采板，應(yīng)合理配置其rate。frm_start_adj_response_t：是交采板對frm_start_adj_t的應(yīng)幀。frm_rd_coeff_respose_t：是交采板對讀系數(shù)幀frm_rd_03_t的應(yīng)答幀。交采板能提供數(shù)據(jù)實時數(shù)據(jù)1，ac_real_t：是交采板提供的第1組實時數(shù)據(jù)，主要包含電壓、電流、諧波、電能量脈沖個數(shù)等。實時數(shù)據(jù)2，ac_real2_t：是交采板提供的第2組實時數(shù)據(jù)，主要包括視在電能量脈沖個數(shù)、4象限無功電能量脈沖個數(shù)等。開入事件，di_event_send_t：交采板提供的開入事件用此結(jié)構(gòu)體承載。交采板不能提供失壓、斷相類數(shù)據(jù)。SPI操作如何打開SPI設(shè)備：初始化一個spidev_t設(shè)備，用spi_dev_open()函數(shù)打開它。如何發(fā)送一幀：用函數(shù)fc_send(),輸入?yún)?shù)有發(fā)送緩沖區(qū)、長度等，它封裝了ioctl()。如何接收一幀：用函數(shù)fc_recv()，輸入?yún)?shù)有接收緩沖區(qū)、長度等,它封裝了ioctl()。讀交交采實時數(shù)據(jù)用spi_rd_real()，構(gòu)造發(fā)送幀frm_rd_03_t，設(shè)置輸入?yún)?shù)：SPI設(shè)備、發(fā)送幀、返回數(shù)據(jù)緩沖區(qū)等。讀開入量變位事件用spi_rd_event()，構(gòu)造發(fā)送幀frm_rd_event_t，設(shè)置輸入?yún)?shù)：SPI設(shè)備、發(fā)送幀、返回數(shù)據(jù)緩沖區(qū)等。時間同步原理在召測交采板實時數(shù)據(jù)的SPI協(xié)議發(fā)送幀中的ac_time3_t，用主控板的系統(tǒng)時間來填充，交采板會根據(jù)此時間來設(shè)置其時間校正流程校正點1對應(yīng)：220V5A1.0;校正點2對應(yīng)：220V5A0.5L;校正點3對應(yīng)：220V0.25A0.5L;從開始校正點1開始，依次校正。校正第1點的過程：配置功率源到校正點1。下發(fā)啟動幀frm_start_adj_response_t，檢查響應(yīng)幀frm_start_adj_response_t，如果正確響應(yīng)，且響應(yīng)幀的sta為0，就循環(huán)查詢校表狀態(tài)：循環(huán)發(fā)送此幀frm_rd_coeff7022，并檢查應(yīng)幀frm_rd_coeff_respose_t，直到frm_rd_coeff_respose_t的sta有值表示校表結(jié)束，根據(jù)sta值判斷校表成功與否，如果成功，就切換到校正點2，用時大致15秒。如何設(shè)置交采板的防抖時間在召測交采板開入量變位事件的SPI協(xié)議發(fā)送幀中有di_lowtm和di_hightm，分別是高電平去抖動