0
  • 聊天消息
  • 系統(tǒng)消息
  • 評(píng)論與回復(fù)
登錄后你可以
  • 下載海量資料
  • 學(xué)習(xí)在線課程
  • 觀看技術(shù)視頻
  • 寫文章/發(fā)帖/加入社區(qū)
會(huì)員中心
創(chuàng)作中心

完善資料讓更多小伙伴認(rèn)識(shí)你,還能領(lǐng)取20積分哦,立即完善>

3天內(nèi)不再提示

TSMaster RPC 基礎(chǔ)入門:編程指導(dǎo)和使用說明

上海同星智能科技有限公司 ? 2024-07-13 08:21 ? 次閱讀

介紹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++ 、PythonC#等語言。


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)境。

e0f54276-40ad-11ef-817b-92fbcf53809c.png

這種靈活的拓?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]);

}

聲明:本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人,不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用,如有內(nèi)容侵權(quán)或者其他違規(guī)問題,請(qǐng)聯(lián)系本站處理。 舉報(bào)投訴
  • 編程
    +關(guān)注

    關(guān)注

    88

    文章

    3521

    瀏覽量

    93266
  • RPC
    RPC
    +關(guān)注

    關(guān)注

    0

    文章

    110

    瀏覽量

    11475
  • 網(wǎng)絡(luò)通信
    +關(guān)注

    關(guān)注

    4

    文章

    769

    瀏覽量

    29693
收藏 人收藏

    評(píng)論

    相關(guān)推薦

    微型51AVR編程器裝配說明書、使用說明書V1.2

    微型51AVR編程器裝配說明書、使用說明書V1.2
    發(fā)表于 08-06 22:26

    8051單片機(jī)C語言編程入門指導(dǎo)手冊(cè)

    8051單片機(jī)C語言編程入門指導(dǎo)
    發(fā)表于 09-21 08:18

    編程控制器(PLC)實(shí)驗(yàn)指導(dǎo)書三

    編程控制器(PLC)實(shí)驗(yàn)指導(dǎo)書 一、 使用說明SIEMENS SIMATIC S7-200CPU226 可編程控制器,其編程
    發(fā)表于 09-29 00:23 ?0次下載

    北京煒煌科技編程器使用說明

    本內(nèi)容那個(gè)提供了北京煒煌科技編程器使用說明
    發(fā)表于 04-08 18:19 ?95次下載
    北京煒煌科技<b class='flag-5'>編程器使用說明</b>書

    智能相機(jī)使用說明

    信捷機(jī)器視覺腳本編程使用說明書 V2.3.0(2011.9.23)。
    發(fā)表于 04-05 13:54 ?11次下載

    根據(jù)實(shí)際應(yīng)用編寫MPLAB-IDE入門指導(dǎo) mini-PRO ICD2系列使用說明

    根據(jù)實(shí)際應(yīng)用編寫MPLAB-IDE入門指導(dǎo) mini-PRO ICD2系列使用說明
    發(fā)表于 09-22 10:36 ?12次下載

    歐姆龍手持編程器使用說明

    本文開始介紹了編程器的概念和編程器的使用方法,其次闡述了編程器寫存儲(chǔ)器方法,最后介紹了歐姆龍手持編程器使用說明。
    的頭像 發(fā)表于 04-09 10:14 ?1.8w次閱讀

    LabVIEW和三菱FXPLC編程協(xié)議及使用說明

    本文主要介紹了LabVIEW和三菱FXPLC編程協(xié)議及使用說明。
    發(fā)表于 06-04 09:00 ?42次下載

    LED可編程燈軟件安裝及使用說明

    LED可編程燈軟件安裝及使用說明
    發(fā)表于 01-04 11:05 ?18次下載

    安路ELF3 FPGA編程和配置使用說明

    電子發(fā)燒友網(wǎng)站提供《安路ELF3 FPGA編程和配置使用說明.pdf》資料免費(fèi)下載
    發(fā)表于 09-27 10:16 ?1次下載
    安路ELF3 FPGA<b class='flag-5'>編程</b>和配置<b class='flag-5'>使用說明</b>

    安路ELF2 FPGA編程和配置使用說明

    電子發(fā)燒友網(wǎng)站提供《安路ELF2 FPGA編程和配置使用說明.pdf》資料免費(fèi)下載
    發(fā)表于 09-27 09:33 ?5次下載
    安路ELF2 FPGA<b class='flag-5'>編程</b>和配置<b class='flag-5'>使用說明</b>

    TKScope仿真器編程ATmega8使用說明

    電子發(fā)燒友網(wǎng)站提供《TKScope仿真器編程ATmega8使用說明.pdf》資料免費(fèi)下載
    發(fā)表于 10-14 14:54 ?2次下載
    TKScope仿真器<b class='flag-5'>編程</b>ATmega8<b class='flag-5'>使用說明</b>

    TSMaster 自定義 LIN 調(diào)度表編程指導(dǎo)

    TSMaster(v2023.10.7.990)之后的版本中新增了實(shí)現(xiàn)自定義LIN調(diào)度表相關(guān)API。今天重點(diǎn)和大家分享一下關(guān)于編程實(shí)現(xiàn)TSMaster自定義LIN調(diào)度表
    的頭像 發(fā)表于 05-11 08:21 ?420次閱讀
    <b class='flag-5'>TSMaster</b> 自定義 LIN 調(diào)度表<b class='flag-5'>編程</b><b class='flag-5'>指導(dǎo)</b>

    重磅!翹首以盼的《TSMaster開發(fā)從入門到精通》正式出版!

    TSMaster軟件,大家翹首以盼的《TSMaster開發(fā)從入門到精通》書籍于8月正式出版發(fā)售!《TSMaster開發(fā)從入門到精通》由楊金升
    的頭像 發(fā)表于 08-10 08:21 ?244次閱讀
    重磅!翹首以盼的《<b class='flag-5'>TSMaster</b>開發(fā)從<b class='flag-5'>入門</b>到精通》正式出版!

    新書推薦 | TSMaster開發(fā)從入門到精通

    書名:TSMaster開發(fā)從入門到精通書號(hào):9787302667193作者:楊金升劉矗劉功申定價(jià):99.80元《CANoe開發(fā)從入門到精通》作者又一力作!本書旨在幫助廣大汽車工業(yè)領(lǐng)域的研發(fā)工程師快速
    的頭像 發(fā)表于 08-30 12:37 ?154次閱讀
    新書推薦 | <b class='flag-5'>TSMaster</b>開發(fā)從<b class='flag-5'>入門</b>到精通