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

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

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