介紹RPC模塊前,我們先淺聊一下RPC的相關(guān)說明,以及在什么樣的情況下需要了解本文。
1.
RPC 說明
遠程過程調(diào)用(RPC, Remote Procedure Call)是一種網(wǎng)絡(luò)通信協(xié)議,使得程序可以調(diào)用另一臺計算機上的程序或服務(wù),就像調(diào)用本地的程序一樣。RPC 的主要目的是簡化分布式計算,使得開發(fā)者無需關(guān)注底層的網(wǎng)絡(luò)通信細節(jié)。
2.
什么情況下需要了解此文章?
用戶基于 TSMaster 開發(fā)了對應(yīng)的應(yīng)用工程,想在外部程序中自動化控制TSMaster,可以查閱此文章。(備注:除了 RPC,TSMaster還提供了基于COM的接口,有需求可另行查閱相關(guān)文章。)
本文適用程控模式:TSMaster1 控制 TSMaster2,或者其他進程控制 TSMaster 進程(使用 TSMaster.dll)適用于語言:C++ 、Python、 C#等語言。
1
RPC的基本概念
客戶端和服務(wù)器:
客戶端:發(fā)起 RPC 請求的程序。
服務(wù)器:接收 RPC 請求并執(zhí)行相應(yīng)過程的程序。
代理:
客戶端代理:封裝請求并將其發(fā)送到服務(wù)器。
服務(wù)器代理:接收請求,解包并調(diào)用本地過程,之后將結(jié)果返回給客戶端代理。
通信機制:
傳輸協(xié)議:底層使用的協(xié)議,比如 TCP、UDP。
數(shù)據(jù)序列化:將數(shù)據(jù)結(jié)構(gòu)或?qū)ο筠D(zhuǎn)換成可以傳輸?shù)母袷剑热?JSON、XML、ProtocolBuffers。
RPC 工作流程:
● 客戶端調(diào)用本地代理方法:客戶端調(diào)用一個看似本地的方法,但實際上這個方法由客戶端代理負責處理;
●客戶端代理序列化請求:將方法名、參數(shù)等信息打包成消息;
●消息傳輸:客戶端代理將消息通過網(wǎng)絡(luò)傳輸?shù)椒?wù)器;
●服務(wù)器代理解包請求:接收到消息后,服務(wù)器代理解包消息并調(diào)用實際的本地方法;
●執(zhí)行方法并生成響應(yīng):本地方法執(zhí)行完畢后,生成響應(yīng)結(jié)果;
●服務(wù)器代理打包響應(yīng):服務(wù)器代理將結(jié)果打包成消息并通過網(wǎng)絡(luò)發(fā)送回客戶端;
●客戶端代理解包響應(yīng):客戶端代理接收到響應(yīng)消息后,解包并將結(jié)果返回給客戶端。
2
TSMaster RPC 應(yīng)用
1.
RPC 功能
基于 TSMaster 的 RPC 機制,用戶可以在 TSMaster 上位機環(huán)境中搭建完整的工程,涵蓋從測試用例開發(fā)到程控設(shè)備管理、總線通訊配置以及控制板卡操作等一系列流程。通過這一機制,用戶能夠高效地在客戶端遠程控制 TSMaster 服務(wù)器,實現(xiàn)對系統(tǒng)變量、CAN 信號、LIN 信號、FlexRay 信號以及以太網(wǎng)(ETH)信號等的讀寫操作。此外,用戶還可以調(diào)用 TSMaster 服務(wù)器上定義的各種函數(shù),進一步擴展和定制系統(tǒng)功能。
這種集成化的解決方案使得工程管理和自動化測試更加便捷和高效。用戶無需在多個平臺之間切換,即可完成包括硬件配置、信號監(jiān)控、數(shù)據(jù)采集和測試執(zhí)行等復雜任務(wù)。通過TSMaster 的 RPC 機制,用戶在客戶端即可實現(xiàn)對服務(wù)器的遠程程控,簡化了操作流程,提高了測試和開發(fā)效率,確保了系統(tǒng)的穩(wěn)定性和可靠性。
TSMaster 提供了強大的接口和豐富的功能模塊,用戶可以根據(jù)需求靈活組合使用,實現(xiàn)對各種信號和設(shè)備的精細控制和管理。這種架構(gòu)不僅適用于研發(fā)測試階段,也適用于生產(chǎn)環(huán)境中的實時監(jiān)控和故障診斷,極大提升了工程項目的整體質(zhì)量和效率。
不僅如此,TSMaster 的 RPC 機制支持多種拓撲結(jié)構(gòu),不僅可以實現(xiàn)客戶端與服務(wù)器之間的一對一通信,還能夠?qū)崿F(xiàn)以下復雜的通信拓撲:
1:一對多 (One-to-Many):單個客戶端可以同時控制多個 TSMaster 服務(wù)器,適用于需要同時管理多個測試環(huán)境或設(shè)備的情況。
2:多對一 (Many-to-One):多個客戶端可以同時連接到一個 TSMaster 服務(wù)器,這樣不同的用戶或測試系統(tǒng)可以共享同一個服務(wù)器資源,實現(xiàn)協(xié)同工作和資源共享。
3:多對多 (Many-to-Many):多個客戶端和多個服務(wù)器之間可以進行靈活的通信和控制,構(gòu)建復雜的分布式測試和控制系統(tǒng),適用于大型工程項目和分布式測試環(huán)境。
這種靈活的拓撲結(jié)構(gòu)使得 TSMaster 能夠適應(yīng)各種復雜的工程需求,無論是在單一項目中還是在跨項目、跨地域的分布式測試中,都能提供高效、可靠的解決方案。通過這種多樣化的通信模式,用戶可以最大限度地利用硬件和軟件資源,提高系統(tǒng)的擴展性和靈活性,滿足不同規(guī)模和復雜度的工程項目需求。
3
TSMaster RPC 使用說明
基于RPC本身機制,TSMaster提供了相應(yīng)接口,在需要被程控的工程中,激活RPC server端,為程控腳本提供相應(yīng)資源。
1.
激活 server
開啟server端操作如下:
新建一個C腳本,在啟動事件中輸入下面代碼,即表示激活了當前工程的rpc server rpc_tsmaster_activate_server(true);
實際上,在 TSMaster v2024.06.05.1124 版本之后,所有TSMaster工程已經(jīng)默認激活了RPC功能。
2.
激活 client
native_int h; //client 句柄
//參數(shù) 1 為提供 rpc 服務(wù)的 TSMaster 應(yīng)用程序名
com.rpc_tsmaster_create_client(“TSMaster”,&h);
//激活 client 端
Com.rpc_tsmaster_activate_client(h,true);
3.
修改 server 端數(shù)據(jù)
3.1 啟動停止 server 工程
啟動工程:
TSMaster 小程序:
com.rpc_tsmaster_cmd_start_simulation(h);
API(C\C++\C#\Python):
rpc_tsmaster_cmd_start_simulation(h);
3.2 讀寫系統(tǒng)變量
設(shè)置系統(tǒng)變量:
TSMaster 小程序:
com.rpc_tsmaster_cmd_write_system_var(h, "Var1", "1.2345");
API(C\C++\C#\Python):
rpc_tsmaster_cmd_write_system_var(h,"Var1","1.2345");
獲取系統(tǒng)變量:
TSMaster 小程序:
com.rpc_tsmaster_cmd_read_system_var(h, "Var1", "1.2345");
API(C\C++\C#\Python):
rpc_tsmaster_cmd_read_system_var(h,"Var1","1.2345");
3.3 讀寫 CAN 信號
設(shè)置 CAN 信號:
TSMaster 小程序:
com.rpc_tsmaster_cmd_set_can_signal(h,"chnidx/net/node/msg/signal", 1234)
API(C\C++\C#\Python):
rpc_tsmaster_cmd_set_can_signal(h,"chnidx/net/node/msg/signal", 1234)
獲取 CAN 信號:
double d = 0;
TSMaster 小程序:
com.rpc_tsmaster_cmd_get_can_signal(h,"chnidx/net/node/msg/signal", %d)
API(C\C++\C#\Python):
rpc_tsmaster_cmd_get_can_signal(h,"chnidx/net/node/msg/signal", %d)
3.4 讀寫 LIN 信號
設(shè)置 LIN 信號:
TSMaster 小程序:
com.rpc_tsmaster_cmd_set_lin_signal(h,"chnidx/net/node/msg/signal", 1234);
API(C\C++\C#\Python):
rpc_tsmaster_cmd_set_lin_signal(h,"chnidx/net/node/msg/signal", 1234);
獲取 LIN 信號:
double d = 0;
TSMaster 小程序:
com.rpc_tsmaster_cmd_get_lin_signal(h,"chnidx/net/node/msg/signal", %d);
API(C\C++\C#\Python):
rpc_tsmaster_cmd_get_lin_signal(h,"chnidx/net/node/msg/signal", %d);
3.5 讀寫 FlexRay 信號
設(shè)置 FR 信號:
TSMaster 小程序:
com.rpc_tsmaster_cmd_set_flexray_signal(h,"chnidx/net/node/msg/signal", 1234);
API(C\C++\C#\Python):
rpc_tsmaster_cmd_set_flexray_signal(h,"chnidx/net/node/msg/signal", 1234);
獲取 FR 信號:
double d = 0;
TSMaster 小程序:
com.rpc_tsmaster_cmd_get_can_signal(h,"chnidx/net/node/msg/signal", %d);
API(C\C++\C#\Python):
rpc_tsmaster_cmd_get_can_signal(h,"chnidx/net/node/msg/signal", %d)
3.6 RPC使用 TSMaster 系統(tǒng)函數(shù)
// 第一步:準備調(diào)用函數(shù)的輸入?yún)?shù)
#define STR_BUFFER_SIZE 1024
char args[4][STR_BUFFER_SIZE];
char* pArgs[4] = {&args[0][0], &args[1][0], &args[2][0], &args[3][0]};
sprintf_s(pArgs[0], STR_BUFFER_SIZE, "%s", "var1");
sprintf_s(pArgs[1], STR_BUFFER_SIZE, "%d", svtString);
sprintf_s(pArgs[2], STR_BUFFER_SIZE, "%s", "string default value");
sprintf_s(pArgs[3], STR_BUFFER_SIZE, "%s", "this is a comment");
// 步驟 2:調(diào)用任意 API
s32 ret;
ret = com.rpc_tsmaster_call_system_api(h, "app.create_system_var", 4, STR_BUFFER_SIZE,
&pArgs[0]);
// 步驟 3:處理參數(shù)中的返回值(如果可用)
s32 i;
log("API call result = %d", ret);
for (i=0; i<4; i++){
log("Argument %d: %s", i+1, pArgs[i]);
}
上述代碼等價與在 TSMaster 進程中使用 app.create_system_var 來創(chuàng)建系統(tǒng)變量,即:app.create_system_var(var1,svtString,”string default value”,”this is a comment”);
需要注意的是,使用該方式調(diào)用 TSMaster 內(nèi)的系統(tǒng)函數(shù),無法使用參數(shù)為指針類型(報文類型除外)的函數(shù)。
3.7 RPC使用小程序庫函數(shù)
// 第一步:準備調(diào)用函數(shù)的輸入?yún)?shù)
#define STR_BUFFER_SIZE 1024
char args[4][STR_BUFFER_SIZE];
char* pArgs[4] = {&args[0][0], &args[1][0], &args[2][0], &args[3][0]};
sprintf_s(pArgs[0], STR_BUFFER_SIZE, "%s", "var1");
sprintf_s(pArgs[1], STR_BUFFER_SIZE, "%d", svtString);
sprintf_s(pArgs[2], STR_BUFFER_SIZE, "%s", "string default value");
sprintf_s(pArgs[3], STR_BUFFER_SIZE, "%s", "this is a comment");
//步驟 2:調(diào)用任意 API
s32 ret;TSMaster RPC 編程指導
ret = com.rpc_tsmaster_call_library_api(h, "mylib.create_system_var", 4, STR_BUFFER_SIZE,
&pArgs[0]);
// 步驟 3:處理參數(shù)中的返回值(如果可用)
s32 i;
log("API call result = %d", ret);
for (i=0; i<4; i++){
log("Argument %d: %s", i+1, pArgs[i]);
}
4
TSMaster RPC 函數(shù)說明
1.
rpc_tsmaster_create_client
函數(shù)名稱 | UInt32 rpc_tsmaster_create_client(const char*ATSMasterAppName,const psize_t AHandle) |
功能介紹 | 創(chuàng)建一個 TSMaster Rpc 客戶端 |
調(diào)用位置 | 初始化 tsmaster lib 庫之后 |
輸入?yún)?shù) | ATSMasterAppName: TSMaster server 端的應(yīng)用程序名稱; AHandle : TSMaster Rpc 客戶端句柄 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | s32 h; rpc_tsmaster_create_client("TSMaster1", &h) |
2.
rpc_tsmaster_activate_client
函數(shù)名稱 | UInt32 rpc_tsmaster_activate_client(const size_t AHandle,constbool AActivate) |
功能介紹 | 激活或者停用一個 TSMaster Rpc 客戶端 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 AActivate: true=激活,false=停用 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | rpc_tsmaster_activate_client(h, true) |
3.
rpc_tsmaster_is_simulation_running
函數(shù)名稱 | UInt32 rpc_tsmaster_is_simulation_running(const size_tAHandle,const pbool AIsRunning) |
功能介紹 | 獲取遠程 TSMaster 仿真運行的狀態(tài) |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 AIsRunning:遠程 TSMaster 仿真運行的狀態(tài)的數(shù)據(jù)指針 True=正在運行,false=未運行 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | bool b; if (0 == com.rpc_tsmaster_is_simulation_running(h, &b)){ if (b){ // current simulation is running } } |
4.
rpc_tsmaster_cmd_set_mode_realtime
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_set_mode_realtime(const size_t AHandle) |
功能介紹 | 將 TSMaster Rpc server 配置為實時模式 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后,仿真運行之前 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | rpc_tsmaster_cmd_set_mode_realtime(h) |
5.
rpc_tsmaster_cmd_set_mode_sim
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_set_mode_sim(const size_t AHandle) |
功能介紹 | 將 TSMaster Rpc server 配置為仿真模式 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后,仿真運行之前 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | rpc_tsmaster_cmd_set_mode_sim(h) |
6.
rpc_tsmaster_cmd_start_simulation
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_start_simulation(const size_t AHandle) |
功能介紹 | 啟動 TSMaster Rpc server 仿真 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | rpc_tsmaster_cmd_start_simulation(h) |
7.
rpc_tsmaster_cmd_set_can_signal
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_set_can_signal(const size_t AHandle,const char* ASgnAddress,const double AValue) |
功能介紹 | 在遠程 TSMaster 上修改數(shù)據(jù)庫中的 CAN 信號值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號的路徑 AValue: 信號值 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | if(0==rpc_tsmaster_cmd_set_can_signal(h, "0/CAN_FD_Powertrain/Engine/EngineData/EngSpeed", 1234)){ // signal written } |
8.
rpc_tsmaster_cmd_get_can_signal
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_get_can_signal(const size_t AHandle,const char* ASgnAddress,const pdouble AValue) |
功能介紹 | 在遠程 TSMaster 上獲取數(shù)據(jù)庫中的 CAN 信號值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號的路徑 AValue: 信號值指針 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | double d; if(0==rpc_tsmaster_cmd_get_can_signal(h, "0/CAN_FD_Powertrain/Engine/EngineData/EngSpeed", &d)){ // signal is retrieved } |
9.
rpc_tsmaster_cmd_set_lin_signal
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_set_lin_signal(const size_t AHandle,const char* ASgnAddress,const double AValue) |
功能介紹 | 在遠程 TSMaster 上修改數(shù)據(jù)庫中的 LIN 信號值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號的路徑 AValue: 信號值 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | if(0==rpc_tsmaster_cmd_set_lin_signal(h, "chnidx/net/node/msg/signal", 1234)){ // signal written } |
10.
rpc_tsmaster_cmd_get_lin_signal
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_get_lin_signal(const size_t AHandle,const char* ASgnAddress,const pdouble AValue) |
功能介紹 | 在遠程 TSMaster 上獲取數(shù)據(jù)庫中的 LIN 信號值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號的路徑 AValue: 信號值指針 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | double d; if(0==rpc_tsmaster_cmd_get_lin_signal(h, "chnidx/net/node/msg/signal", &d)){ // signal is retrieved } |
11.
rpc_tsmaster_cmd_set_flexray_signal
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_set_flexray_signal(const size_t AHandle,const char* ASgnAddress,const double AValue) |
功能介紹 | 在遠程 TSMaster 上修改數(shù)據(jù)庫中的 flexray 信號值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號的路徑 AValue: 信號值 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | if(0==rpc_tsmaster_cmd_set_flexray_signal(h, "chnidx/net/node/msg/signal", 1234)){ // signal written } |
12.
rpc_tsmaster_cmd_get_flexray_signal
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_get_flexray_signal(const size_tAHandle,const char* ASgnAddress,const pdouble AValue) |
功能介紹 | 在遠程 TSMaster 上獲取數(shù)據(jù)庫中的 flexray 信號值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號的路徑 AValue: 信號值指針 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | double d; if(0==rpc_tsmaster_cmd_get_flexray_signal(h, "chnidx/net/node/msg/signal", &d)){ // signal is retrieved } |
13.
rpc_tsmaster_cmd_write_system_var
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_write_system_var(const size_tAHandle,const char* ACompleteName,const char* AValue) |
功能介紹 | 從遠程 TSMaster 按名稱寫入系統(tǒng)變量 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ACompleteName:系統(tǒng)變量名稱 AValue: 數(shù)據(jù)值 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | rpc_tsmaster_cmd_write_system_var(h, "v1", "1.2345") |
14.
rpc_tsmaster_cmd_read_system_var
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_read_system_var(const size_tAHandle,const char* ASysVarName,const pdouble AValue) |
功能介紹 | 從遠程 TSMaster 按名稱讀取系統(tǒng)變量 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASysVarName:系統(tǒng)變量名稱 AValue: 數(shù)據(jù)值指針 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | double d; if (0 == rpc_tsmaster_cmd_read_system_var(h, "v1", &d)){ log("value = %f", d); } |
15.
rpc_tsmaster_cmd_write_signal
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_write_signal(const size_t AHandle,constTLIBApplicationChannelType ABusType,const char* AAddr,const double AValue) |
功能介紹 | 從遠程 TSMaster 按名稱寫入信號值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ABusType:總線類型 AAddr:數(shù)據(jù)庫中信號的路徑 AValue: 數(shù)據(jù)值 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | if(0==rpc_tsmaster_cmd_write_signal(h,APP_CAN, "0/Powertrain/Engine/EngSpeed", 1234)){ // value written } |
16.
rpc_tsmaster_cmd_read_signal
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_read_signal(const size_t AHandle,constTLIBApplicationChannelType ABusType,const char* AAddr,const pdouble AValue) |
功能介紹 | 從遠程 TSMaster 按名稱讀取信號 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ABusType:總線類型 AAddr:數(shù)據(jù)庫中信號的路徑 AValue: 數(shù)據(jù)值指針 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | double d; if(0==rpc_tsmaster_cmd_read_signal(h,APP_CAN, "0/Powertrain/Engine/EngSpeed", &d)){ log("signal value = %f", d); } |
17.
rpc_tsmaster_delete_client
函數(shù)名稱 | UInt32 rpc_tsmaster_delete_client(const size_t AHandle) |
功能介紹 | 刪除 rpc client |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | rpc_tsmaster_delete_client(h) |
18.
rpc_tsmaster_cmd_stop_simulation
函數(shù)名稱 | UInt32 rpc_tsmaster_cmd_stop_simulation(const size_t AHandle) |
功能介紹 | 停止遠程 TSMaster 仿真 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | rpc_tsmaster_cmd_stop_simulation(h) |
19.
rpc_tsmaster_call_system_api
函數(shù)名稱 | UInt32 rpc_tsmaster_call_system_api(const size_t AHandle,constchar* AAPIName,const s32 AArgCount,const s32 AArgCapacity,const char** AArgs) |
功能介紹 | Client 調(diào)用 server 端使用系統(tǒng)函數(shù) |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 AAPIName:系統(tǒng)函數(shù)名稱,”app.create_system_var” AArgCount: 函數(shù)參數(shù)數(shù)量 AArgCapacity:參數(shù)字符串長度 AArgs:參數(shù)字符串數(shù)組 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | // 第一步:準備調(diào)用函數(shù)的輸入?yún)?shù) #define STR_BUFFER_SIZE 1024 char args[4][STR_BUFFER_SIZE]; char* pArgs[4] = {&args[0][0], &args[1][0], &args[2][0], &args[3][0]}; sprintf_s(pArgs[0], STR_BUFFER_SIZE, "%s", "var1"); sprintf_s(pArgs[1], STR_BUFFER_SIZE, "%d", svtString); sprintf_s(pArgs[2], STR_BUFFER_SIZE, "%s", "string default value"); sprintf_s(pArgs[3], STR_BUFFER_SIZE, "%s", "this is a comment"); // 步驟 2:調(diào)用任意 API s32 ret; ret = com.rpc_tsmaster_call_system_api(h, "app.create_system_var", 4, STR_BUFFER_SIZE, &pArgs[0]); // 步驟 3:處理參數(shù)中的返回值(如果可用) s32 i; log("API call result = %d", ret); for (i=0; i<4; i++){ log("Argument %d: %s", i+1, pArgs[i]); } |
20.
rpc_tsmaster_call_library_api
函數(shù)名稱 | UInt32 rpc_tsmaster_call_library_api(const size_t AHandle,constchar* AAPIName,const s32 AArgCount,const s32 AArgCapacity,const char** AArgs) |
功能介紹 | Client 調(diào)用 server 端使用系統(tǒng)函數(shù) |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 AAPIName:小程序庫函數(shù)名稱,”mylib.create_system_var” AArgCount: 函數(shù)參數(shù)數(shù)量 AArgCapacity:參數(shù)字符串長度 AArgs:參數(shù)字符串數(shù)組 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | // 第一步:準備調(diào)用函數(shù)的輸入?yún)?shù) #define STR_BUFFER_SIZE 1024 char args[4][STR_BUFFER_SIZE]; char* pArgs[4] = {&args[0][0], &args[1][0], &args[2][0], &args[3][0]}; sprintf_s(pArgs[0], STR_BUFFER_SIZE, "%s", "var1"); sprintf_s(pArgs[1], STR_BUFFER_SIZE, "%d", svtString); sprintf_s(pArgs[2], STR_BUFFER_SIZE, "%s", "string default value"); sprintf_s(pArgs[3], STR_BUFFER_SIZE, "%s", "this is a comment"); //步驟 2:調(diào)用任意 API s32 ret; ret = com.rpc_tsmaster_call_library_api(h, "mylib.create_system_var", 4, STR_BUFFER_SIZE, &pArgs[0]); // 步驟 3:處理參數(shù)中的返回值(如果可用) s32 i; log("API call result = %d", ret); for (i=0; i<4; i++){ log("Argument %d: %s", i+1, pArgs[i]); } |
-
編程
+關(guān)注
關(guān)注
88文章
3615瀏覽量
93731 -
RPC
+關(guān)注
關(guān)注
0文章
111瀏覽量
11534 -
網(wǎng)絡(luò)通信
+關(guān)注
關(guān)注
4文章
800瀏覽量
29812
發(fā)布評論請先 登錄
相關(guān)推薦
可編程控制器(PLC)實驗指導書三
根據(jù)實際應(yīng)用編寫MPLAB-IDE入門指導 mini-PRO ICD2系列使用說明
TKScope仿真器編程ATmega8使用說明
![TKScope仿真器<b class='flag-5'>編程</b>ATmega8<b class='flag-5'>使用說明</b>](https://file.elecfans.com/web1/M00/D9/4E/pIYBAF_1ac2Ac0EEAABDkS1IP1s689.png)
TSMaster 自定義 LIN 調(diào)度表編程指導
![<b class='flag-5'>TSMaster</b> 自定義 LIN 調(diào)度表<b class='flag-5'>編程</b><b class='flag-5'>指導</b>](https://file.elecfans.com/web2/M00/40/07/pYYBAGJrUk2AaMaTAAAQONQtdzo461.jpg)
重磅!翹首以盼的《TSMaster開發(fā)從入門到精通》正式出版!
![重磅!翹首以盼的《<b class='flag-5'>TSMaster</b>開發(fā)從<b class='flag-5'>入門</b>到精通》正式出版!](https://file.elecfans.com/web2/M00/40/07/pYYBAGJrUk2AaMaTAAAQONQtdzo461.jpg)
新書推薦 | TSMaster開發(fā)從入門到精通
![新書推薦 | <b class='flag-5'>TSMaster</b>開發(fā)從<b class='flag-5'>入門</b>到精通](https://file.elecfans.com/web2/M00/40/07/pYYBAGJrUk2AaMaTAAAQONQtdzo461.jpg)
評論