介紹RPC模塊前,我們先淺聊一下RPC的相關(guān)說明,以及在什么樣的情況下需要了解本文。
1.
RPC 說明
遠(yuǎn)程過程調(diào)用(RPC, Remote Procedure Call)是一種網(wǎng)絡(luò)通信協(xié)議,使得程序可以調(diào)用另一臺(tái)計(jì)算機(jī)上的程序或服務(wù),就像調(diào)用本地的程序一樣。RPC 的主要目的是簡化分布式計(jì)算,使得開發(fā)者無需關(guān)注底層的網(wǎng)絡(luò)通信細(xì)節(jié)。
2.
什么情況下需要了解此文章?
用戶基于 TSMaster 開發(fā)了對(duì)應(yīng)的應(yīng)用工程,想在外部程序中自動(dòng)化控制TSMaster,可以查閱此文章。(備注:除了 RPC,TSMaster還提供了基于COM的接口,有需求可另行查閱相關(guān)文章。)
本文適用程控模式:TSMaster1 控制 TSMaster2,或者其他進(jìn)程控制 TSMaster 進(jìn)程(使用 TSMaster.dll)適用于語言:C++ 、Python、 C#等語言。
1
RPC的基本概念
客戶端和服務(wù)器:
客戶端:發(fā)起 RPC 請(qǐng)求的程序。
服務(wù)器:接收 RPC 請(qǐng)求并執(zhí)行相應(yīng)過程的程序。
代理:
客戶端代理:封裝請(qǐng)求并將其發(fā)送到服務(wù)器。
服務(wù)器代理:接收請(qǐng)求,解包并調(diào)用本地過程,之后將結(jié)果返回給客戶端代理。
通信機(jī)制:
傳輸協(xié)議:底層使用的協(xié)議,比如 TCP、UDP。
數(shù)據(jù)序列化:將數(shù)據(jù)結(jié)構(gòu)或?qū)ο筠D(zhuǎn)換成可以傳輸?shù)母袷?,比?JSON、XML、ProtocolBuffers。
RPC 工作流程:
● 客戶端調(diào)用本地代理方法:客戶端調(diào)用一個(gè)看似本地的方法,但實(shí)際上這個(gè)方法由客戶端代理負(fù)責(zé)處理;
●客戶端代理序列化請(qǐng)求:將方法名、參數(shù)等信息打包成消息;
●消息傳輸:客戶端代理將消息通過網(wǎng)絡(luò)傳輸?shù)椒?wù)器;
●服務(wù)器代理解包請(qǐng)求:接收到消息后,服務(wù)器代理解包消息并調(diào)用實(shí)際的本地方法;
●執(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 機(jī)制,用戶可以在 TSMaster 上位機(jī)環(huán)境中搭建完整的工程,涵蓋從測(cè)試用例開發(fā)到程控設(shè)備管理、總線通訊配置以及控制板卡操作等一系列流程。通過這一機(jī)制,用戶能夠高效地在客戶端遠(yuǎn)程控制 TSMaster 服務(wù)器,實(shí)現(xiàn)對(duì)系統(tǒng)變量、CAN 信號(hào)、LIN 信號(hào)、FlexRay 信號(hào)以及以太網(wǎng)(ETH)信號(hào)等的讀寫操作。此外,用戶還可以調(diào)用 TSMaster 服務(wù)器上定義的各種函數(shù),進(jìn)一步擴(kuò)展和定制系統(tǒng)功能。
這種集成化的解決方案使得工程管理和自動(dòng)化測(cè)試更加便捷和高效。用戶無需在多個(gè)平臺(tái)之間切換,即可完成包括硬件配置、信號(hào)監(jiān)控、數(shù)據(jù)采集和測(cè)試執(zhí)行等復(fù)雜任務(wù)。通過TSMaster 的 RPC 機(jī)制,用戶在客戶端即可實(shí)現(xiàn)對(duì)服務(wù)器的遠(yuǎn)程程控,簡化了操作流程,提高了測(cè)試和開發(fā)效率,確保了系統(tǒng)的穩(wěn)定性和可靠性。
TSMaster 提供了強(qiáng)大的接口和豐富的功能模塊,用戶可以根據(jù)需求靈活組合使用,實(shí)現(xiàn)對(duì)各種信號(hào)和設(shè)備的精細(xì)控制和管理。這種架構(gòu)不僅適用于研發(fā)測(cè)試階段,也適用于生產(chǎn)環(huán)境中的實(shí)時(shí)監(jiān)控和故障診斷,極大提升了工程項(xiàng)目的整體質(zhì)量和效率。
不僅如此,TSMaster 的 RPC 機(jī)制支持多種拓?fù)浣Y(jié)構(gòu),不僅可以實(shí)現(xiàn)客戶端與服務(wù)器之間的一對(duì)一通信,還能夠?qū)崿F(xiàn)以下復(fù)雜的通信拓?fù)洌?/p>
1:一對(duì)多 (One-to-Many):單個(gè)客戶端可以同時(shí)控制多個(gè) TSMaster 服務(wù)器,適用于需要同時(shí)管理多個(gè)測(cè)試環(huán)境或設(shè)備的情況。
2:多對(duì)一 (Many-to-One):多個(gè)客戶端可以同時(shí)連接到一個(gè) TSMaster 服務(wù)器,這樣不同的用戶或測(cè)試系統(tǒng)可以共享同一個(gè)服務(wù)器資源,實(shí)現(xiàn)協(xié)同工作和資源共享。
3:多對(duì)多 (Many-to-Many):多個(gè)客戶端和多個(gè)服務(wù)器之間可以進(jìn)行靈活的通信和控制,構(gòu)建復(fù)雜的分布式測(cè)試和控制系統(tǒng),適用于大型工程項(xiàng)目和分布式測(cè)試環(huán)境。
這種靈活的拓?fù)浣Y(jié)構(gòu)使得 TSMaster 能夠適應(yīng)各種復(fù)雜的工程需求,無論是在單一項(xiàng)目中還是在跨項(xiàng)目、跨地域的分布式測(cè)試中,都能提供高效、可靠的解決方案。通過這種多樣化的通信模式,用戶可以最大限度地利用硬件和軟件資源,提高系統(tǒng)的擴(kuò)展性和靈活性,滿足不同規(guī)模和復(fù)雜度的工程項(xiàng)目需求。
3
TSMaster RPC 使用說明
基于RPC本身機(jī)制,TSMaster提供了相應(yīng)接口,在需要被程控的工程中,激活RPC server端,為程控腳本提供相應(yīng)資源。
1.
激活 server
開啟server端操作如下:
新建一個(gè)C腳本,在啟動(dòng)事件中輸入下面代碼,即表示激活了當(dāng)前工程的rpc server rpc_tsmaster_activate_server(true);
實(shí)際上,在 TSMaster v2024.06.05.1124 版本之后,所有TSMaster工程已經(jīng)默認(rèn)激活了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 啟動(dòng)停止 server 工程
啟動(dòng)工程:
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 信號(hào)
設(shè)置 CAN 信號(hào):
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 信號(hào):
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 信號(hào)
設(shè)置 LIN 信號(hào):
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 信號(hào):
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 信號(hào)
設(shè)置 FR 信號(hào):
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 信號(hào):
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ù)
// 第一步:準(zhǔn)備調(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]);
}
上述代碼等價(jià)與在 TSMaster 進(jìn)程中使用 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ù)為指針類型(報(bào)文類型除外)的函數(shù)。
3.7 RPC使用小程序庫函數(shù)
// 第一步:準(zhǔn)備調(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 編程指導(dǎo)
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)建一個(gè) 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) |
功能介紹 | 激活或者停用一個(gè) 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) |
功能介紹 | 獲取遠(yuǎn)程 TSMaster 仿真運(yùn)行的狀態(tài) |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 AIsRunning:遠(yuǎn)程 TSMaster 仿真運(yùn)行的狀態(tài)的數(shù)據(jù)指針 True=正在運(yùn)行,false=未運(yùn)行 |
返回值 | ==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 配置為實(shí)時(shí)模式 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后,仿真運(yùn)行之前 |
輸入?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)行之前 |
輸入?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) |
功能介紹 | 啟動(dòng) 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) |
功能介紹 | 在遠(yuǎn)程 TSMaster 上修改數(shù)據(jù)庫中的 CAN 信號(hào)值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號(hào)的路徑 AValue: 信號(hào)值 |
返回值 | ==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) |
功能介紹 | 在遠(yuǎn)程 TSMaster 上獲取數(shù)據(jù)庫中的 CAN 信號(hào)值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號(hào)的路徑 AValue: 信號(hào)值指針 |
返回值 | ==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) |
功能介紹 | 在遠(yuǎn)程 TSMaster 上修改數(shù)據(jù)庫中的 LIN 信號(hào)值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號(hào)的路徑 AValue: 信號(hào)值 |
返回值 | ==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) |
功能介紹 | 在遠(yuǎn)程 TSMaster 上獲取數(shù)據(jù)庫中的 LIN 信號(hào)值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號(hào)的路徑 AValue: 信號(hào)值指針 |
返回值 | ==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) |
功能介紹 | 在遠(yuǎn)程 TSMaster 上修改數(shù)據(jù)庫中的 flexray 信號(hào)值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號(hào)的路徑 AValue: 信號(hào)值 |
返回值 | ==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) |
功能介紹 | 在遠(yuǎn)程 TSMaster 上獲取數(shù)據(jù)庫中的 flexray 信號(hào)值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ASgnAddress:數(shù)據(jù)庫中信號(hào)的路徑 AValue: 信號(hào)值指針 |
返回值 | ==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) |
功能介紹 | 從遠(yuǎn)程 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) |
功能介紹 | 從遠(yuǎn)程 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) |
功能介紹 | 從遠(yuǎn)程 TSMaster 按名稱寫入信號(hào)值 |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ABusType:總線類型 AAddr:數(shù)據(jù)庫中信號(hào)的路徑 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) |
功能介紹 | 從遠(yuǎn)程 TSMaster 按名稱讀取信號(hào) |
調(diào)用位置 | 創(chuàng)建 TSMaster Rpc 客戶端之后 |
輸入?yún)?shù) | AHandle : TSMaster Rpc 客戶端句柄 ABusType:總線類型 AAddr:數(shù)據(jù)庫中信號(hào)的路徑 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) |
功能介紹 | 停止遠(yuǎn)程 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ù)字符串?dāng)?shù)組 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | // 第一步:準(zhǔn)備調(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ù)字符串?dāng)?shù)組 |
返回值 | ==0: 函數(shù)執(zhí)行成功 其他值:函數(shù)執(zhí)行失敗 |
示例 | // 第一步:準(zhǔn)備調(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文章
3521瀏覽量
93266 -
RPC
+關(guān)注
關(guān)注
0文章
110瀏覽量
11475 -
網(wǎng)絡(luò)通信
+關(guān)注
關(guān)注
4文章
769瀏覽量
29693
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
評(píng)論