如何使用TSMaster調(diào)用外部DLL/LIB程序

調(diào)用外部DLL/LIB程序

在用戶自定義開發(fā)過程中，常常會(huì)遇到需要調(diào)用外部 DLL/LIB 程序文件的需求，這些文件可能是用戶自己編寫的，也可能是其它供應(yīng)商提供的。TSMaster 支持調(diào)用外部二進(jìn)制程序庫，但必須通過一定的方法進(jìn)行封裝。本節(jié)內(nèi)容以調(diào)用 NI 公司的 TDMS 文件記錄程序?yàn)槔菔痉庋b DLL 庫的方法，而 LIB 庫的使用與 DLL 類似，用戶可以在 visual studio工程中執(zhí)行類似操作實(shí)現(xiàn)。

一 獲取外部程序庫

NI 公司的 TDMS 庫可以通過此鏈接下載，對(duì)于外部庫的使用，請(qǐng)注意以下限制：

1. 在下載外部程序庫的過程中，請(qǐng)注意發(fā)布程序庫的使用協(xié)議，同星公司僅提供外部程序庫的使用環(huán)境，不為違反外部庫使用協(xié)議的行為負(fù)責(zé)；

2. 外部庫被 TSMaster 載入后，即成為了主程序的一部分，如果外部庫發(fā)生了崩潰/內(nèi)存溢出等行為，會(huì)導(dǎo)致 TSMaster 程序不穩(wěn)定或崩潰，此時(shí)需要重新打開軟件并卸載有問題的外部庫；

3. TSMaster 僅支持 32bit-msvc 版本的外部庫，請(qǐng)使用合適版本的 DLL/LIB 文件，否則會(huì)導(dǎo)致編譯過程出錯(cuò)。

（在附件的“tdms_example\TDM C DLL”目錄下，可以找到解壓后的 TDMS 外部庫相關(guān)文件。）

二 準(zhǔn)備外部庫調(diào)用模板

該模板可以從 TSMaster 程序中拷貝，通過 幫助->api 例程-> Mini Program SDK 目錄下名為 VC++的工程，將該工程復(fù)制到其它用戶自定義的位置備用即可。

在附件“tdms_example\tdms_sdk”可以看到為 TDMS 功能準(zhǔn)備的工程。

三 編輯模板并生成DLL

無論外部庫是 DLL 還是 LIB，或者兩者均有，都可以在模板工程中被調(diào)用。需要注意的是，為了能夠使得 TSMaster 能夠正常識(shí)別，用戶在準(zhǔn)備模板工程過程中，除了實(shí)現(xiàn)自己的邏輯外，還需要提供函數(shù)的注釋，參數(shù)說明等信息。具體方法可以打開默認(rèn)模板文件，在全局搜索 fun1 關(guān)鍵字，該函數(shù)為一個(gè)示例函數(shù)，它出現(xiàn)的地方，也就是用戶需要添加自定義內(nèi)容的地方。

如上圖所示，可以看到在 MPLibCode.cpp 文件中，實(shí)現(xiàn)了 fun1 函數(shù)的聲明和實(shí)現(xiàn)，在 MPLibCodeExtern.cpp 文 件 中 ， 向 dll 管 理 模 板 注 冊(cè) 了 函 數(shù) fun1 的 存 在 ， 在 TSMasterBaseSource.cpp 文件中，向 dll 管理模板注冊(cè)了 fun1 函數(shù)的相關(guān)參數(shù)信息。

在集成 TDMS 功能過程中，首先需要將編譯過程需要的 h 文件和 lib 文件拷貝到工程目錄下，并在工程鏈接器中將 LIB 文件作為輸入。對(duì)于外部函數(shù)，例如 TDMS 庫自帶的DDC_CreateFile 函數(shù)，在模板中使用一個(gè)新的函數(shù)進(jìn)行封裝，將其命名為 tdms_CreateFile。盡管 LIB 文件的函數(shù)可以直接導(dǎo)出，但通常建議新建一個(gè)函數(shù)對(duì)它進(jìn)行封裝，一是可以統(tǒng)一函數(shù)的名稱，便于用戶區(qū)分，而是所有 API 的函數(shù)返回值必須為 int 類型，如果原生外部庫不是該返回類型，則必須通過傳遞指針等方式獲取返回值，此時(shí)必須通過封裝的形式使用。

TDMS 其它的函數(shù)封裝過程請(qǐng)參考示例工程，請(qǐng)務(wù)必注意封裝函數(shù)代碼和函數(shù)注冊(cè)代碼需要匹配，才能正確工作?；谠撃０?，在 Debug/Release-x86 模式下，可以生成所需的“tdms_sdk.dll”。

四 在TSMaster中調(diào)用模板DLL

為了在 TSMaster 中調(diào)用“tdms_sdk.dll”，可以將該 dll 直接拖入，或者通過仿真->小程序庫->加載的方式載入，如下圖所示，直接加載會(huì)失敗，這是由于模板 dll 依賴了 TDMS運(yùn)行時(shí) DLL 文件，依賴文件在“tdms_example\TDM C DLL\dev\bin\32-bit”目錄下，由 NI公司提供，將所有文件拷貝到 TSMaster 工程\Plugins\Dependencies 目錄下（這個(gè)目錄需要手動(dòng)創(chuàng)建，默認(rèn) TSMaster 不會(huì)創(chuàng)建），再載入模板 dll，即可正確載入。

打開示例工程“tdms_example\tdms_example”，在測(cè)試系統(tǒng)的第一條用例，為 TDMS文件生成測(cè)試代碼。用戶也可以新建小程序來調(diào)用，兩者在操作上沒有區(qū)別，都需先在屬性窗口中，勾選所需外部庫，然后在腳本程序中調(diào)用所需函數(shù)。如下圖所示，腳本運(yùn)行后會(huì)在 D 盤根目錄下創(chuàng)建一個(gè)示例 TDMS 文件。

直接運(yùn)行該腳本，可以發(fā)現(xiàn)程序能夠運(yùn)行但并未按需創(chuàng)建 TDMS 文件，通過運(yùn)行記錄文件查看錯(cuò)誤消息，可以看到提示未能打開存儲(chǔ)設(shè)備。這個(gè)問題是 TDMS 庫所特有的，因?yàn)樗囊蕾囄募?，除?dll 外，還包含一個(gè)名為 DataModels 的文件夾，TSMaster 在使用“tdms_example\Plugins\Dependencies”目錄下的依賴文件時(shí)，不會(huì)對(duì)文件夾進(jìn)行關(guān)聯(lián)，因此需要手動(dòng)把該文件夾復(fù)制到 TSMaster 安裝程序目錄，例如“C:\ProgramFiles(x86)\TOSUN\TSMaster\bin”。有些外部庫只有 dll 依賴，則不需要手動(dòng)復(fù)制操作。

解決依賴的文件夾后，即可正確生成 TDMS 文件。用戶可以參考以上過程，實(shí)現(xiàn)自己的邏輯。整個(gè)過程需要對(duì) visual stuido 環(huán)境具備一定了解，如有不清楚的地方，請(qǐng)參考示例工程。

五 在TSMaster中調(diào)試模板DLL

在使用模板 dll 過程中，不可避免存在調(diào)試過程。用戶可以修改模板 visual stuido 中項(xiàng)目屬性->常規(guī)->輸出目錄，將 dll 的目錄輸出到調(diào)試使用的工程中“MPLibrary”目錄下。例如將“tdms_example”示例中 dll 生成到“tdms_example\tdms_example\MPLibrary”下，然后先運(yùn)行 TSMaster 工程，再啟動(dòng) visual stuido 調(diào)試功能。調(diào)試過程與小程序調(diào)試方法一致，可以參考小程序的調(diào)試過程。