cvi語言編碼規(guī)范

1、精品文檔你我共享 目的：規(guī)范上位機CVI軟件代碼的編寫，提高上位機程序的可讀性和可維護性。 適用范圍：適用于本公司基于 CVI的所有上位機程序。 說明：CVI語言的核心是標準 C;因此本規(guī)范是在 C語言編碼規(guī)范的基礎上，對變量命名，函數(shù)名，函數(shù) 調(diào)用等具體細節(jié)進行了詳細的規(guī)范；其余內(nèi)容基本參照原C語言編碼規(guī)范的規(guī)定。 1、 DLL文件命名 12 13 14 24 34 AAAAAA 通信類 DLL文件的命名，用產(chǎn)品名稱+后綴.DLL的方式命名；女0 AN9651H.DLL AN9632X.DLL;作為 公司代碼前綴的 AN用大寫字母，作為產(chǎn)品系列的后綴H,X,U,P等用大寫字母；對于某一系列產(chǎn)

2、品通 用的DLL文件，產(chǎn)品名稱中相應的位用小寫字母x代替，如 AN97xxx.DLL; AN969xx.DLL等； 2、 C語言的源文件，頭文件，工程文件等的命名，遵照 DLL文件命名的原則。 函數(shù)命名 對查詢類函數(shù)，動詞為 對設置類函數(shù)，動詞為 3、 對控制類函數(shù)，動詞為 對組合類命令，動詞為 函數(shù)返回值 Control ； Comp lex; 如 ControlStart; ControlStop 等等 如 ComplexSetStartReadVoltage 等等; 對通信類DLL函數(shù)，返回值為int 意，不是下位機通信返回的錯誤代碼） CodeError Message -1 型，=0

3、，表示函數(shù)執(zhí)行成功，=負值表示相應的通信錯誤代碼 （注 ，錯誤代碼如下表， Unknown system error. Inv alid port nu mber. Port is not open. Unknown I/O error. 通信類DLL文件中，函數(shù)的命名原則為：DLL文件名（沒有后綴）+下劃線 _+函數(shù)功能名 其中函數(shù)功能名為動賓詞組，每個單詞的首字母大寫，其它字母小寫; Read;如 ReadVoltage， ReadCurrent， Read Power 等等 Set ;女0 SetOutVoltage ； SetOutFrequency 等等 Unexp ected in

4、 ternal error. No serial port found. Cannot open p ort. 11 A NULL poin ter was p assed whe n a non-NULL poin ter was exp ected. Out of memory. Un able to allocate system resources. Inv alid p arameter. Inv alid baud rate. Inv alid p arity. Inv alid nu mber of data bits. 精品文檔你我共享 AAAAAA 44 90 91 Inv

5、alid nu mber of stop bits. Bad file han dle. File I/O error. 94 97 99 104 114 124 151 152 180 257 258 259 -260 261 262 263 264 265 269 300 301 302 303 304 -305 402 Inv alid count; must be greater tha n or equal to 0. Inv alid interrupt level. I/O op erati on timed out. Break time must be a p ositive

6、 value. Requested input queue size must be 0 or greater. Requested out put queue size must be 0 or greater. Gen eral I/O error. Buffer p arameter is NULL. Supp orted library could not be loaded. P acket was sent, but no ack no wledgme nt was received. Packet was not sent withi n retry limit. Packet

7、was not received within retry limit. End of tran smissi on character encoun tered whe n start of data character exp ected. Un able to read p acket nu mber. Incon siste nt p acket nu mber. Un able to read p acket data. Un able to read checksum. Checksum received did not match compu ted checksum. P ac

8、ket size exceeds input queue size. Error opening file. Error readi ng file. Did not receive in itial n egative ack no wledgme nt character. Did not receive ack no wledgme nt after end of tran smissi on character was sent. Error writi ng to file. Did not receive either a start of data or end of tran

9、smissi on character whe n exp ected. Tran sfer was can celed because CAN ASCII character was received. 503 504 505 506 507 508 Inv alid start delay. Inv alid maximum nu mber of retries. Inv alid wait p eriod. Inv alid p acket size. Un able to read Cyclical Redu ndancy Check. Cyclical Redundancy Chec

10、k error. -9 =正值表示相應的下位機上傳的錯誤代碼或上位機對通信數(shù)據(jù)解包處理后產(chǎn)生的錯誤代碼，錯誤代碼定 義如下 #defi ne AINUO_COMERR_TIMEOUT / 下位機上傳的錯誤類型 #defi ne AINUO_COMERR_CHECKSUM 0 x01 / 校驗和錯誤 #defi ne AINUO_COMERR_CMDT YP 0 x02 / 命令類型錯誤 #defi ne AINUO_COMERR_CMD 0 x03 / 命令字錯誤 #defi ne AINUO_COMERR_STAT 0 x04 / 狀態(tài)不符 #defi ne AINUO_COMERR_ PA

11、RA 0 x05 / 參數(shù)錯誤 / 上位機接收到的數(shù)據(jù)出錯錯誤類型 #defi ne AINUO_ PCCOMERR_CHECKSUM 0 x11 / 校驗和錯誤 #defi ne AINUO_ PCCOMERR_CMDT YP 0 x12 / 命令類型錯誤 #defi ne AINUO_ PCCOMERR_CMD 0 x13 / 命令字錯誤 #defi ne AINUO_ PCCOMERR_ PACKHEAD 0 x16 / 數(shù)據(jù)頭錯誤 #defi ne AINUO_ PCCOMERR_ PACKTAIL 0 x17 / 數(shù)據(jù)尾錯誤 #defineAINUO PCCOMERR PACKLEN 0 x18 / 數(shù)據(jù)包長度錯誤 4、函數(shù)參數(shù) 示例如下: 輸入?yún)?shù) int32 portNo ；通信端口號 int32 addr ；下位機地址 這兩個參數(shù)一般是必需的; ;設置參數(shù) 輸出參數(shù) double64 *voltage double64 *curre