介绍RPC模块前，我们先浅聊一下RPC的相关说明，以及在什么样的情况下需要了解本文 。
1. RPC 说明
远程过程调用（RPC, Remote Procedure Call）是一种网络通信协议，使得程序可以调用另一台计算机上的程序或服务，就像调用本地的程序一样。RPC 的主要目的是简化分布式计算，使得开发者无需关注底层的网络通信细节。
2. 什么情况下需要了解此文章？
用户基于 TSMaster 开发了对应的应用工程，想在外部程序中自动化控制TSMaster，可以查阅此文章。（备注：除了 RPC，TSMaster还提供了基于COM的接口，有需求可另行查阅相关文章。）
本文适用程控模式：TSMaster1 控制 TSMaster2，或者其他进程控制 TSMaster 进程（使用 TSMaster.dll）适用于语言:C++ 、Python、 C#等语言。
一、RPC的基本概念
客户端和服务器：
客户端：发起 RPC 请求的程序。
服务器：接收 RPC 请求并执行相应过程的程序。
代理:
客户端代理：封装请求并将其发送到服务器。
服务器代理：接收请求，解包并调用本地过程，之后将结果返回给客户端代理。
通信机制:
传输协议：底层使用的协议，比如 TCP、UDP。
数据序列化：将数据结构或对象转换成可以传输的格式，比如 JSON、XML、Protocol Buffers。
RPC 工作流程:
● 客户端调用本地代理方法：客户端调用一个看似本地的方法，但实际上这个方法由客户端代理负责处理；
● 客户端代理序列化请求：将方法名、参数等信息打包成消息；
● 消息传输：客户端代理将消息通过网络传输到服务器；
● 服务器代理解包请求：接收到消息后，服务器代理解包消息并调用实际的本地方法；
● 执行方法并生成响应：本地方法执行完毕后，生成响应结果；
● 服务器代理打包响应：服务器代理将结果打包成消息并通过网络发送回客户端；
● 客户端代理解包响应：客户端代理接收到响应消息后，解包并将结果返回给客户端。
二、TSMaster RPC 应用
1.RPC 功能
基于 TSMaster 的 RPC 机制，用户可以在 TSMaster 上位机环境中搭建完整的工程，涵盖从测试用例开发到程控设备管理、总线通讯配置以及控制板卡操作等一系列流程。通过这一机制，用户能够高效地在客户端远程控制 TSMaster 服务器，实现对系统变量、CAN 信号、LIN 信号、FlexRay 信号以及以太网（ETH）信号等的读写操作。此外，用户还可以调用 TSMaster 服务器上定义的各种函数，进一步扩展和定制系统功能。
这种集成化的解决方案使得工程管理和自动化测试更加便捷和高效。用户无需在多个平台之间切换，即可完成包括硬件配置、信号监控、数据采集和测试执行等复杂任务。通过TSMaster 的 RPC 机制，用户在客户端即可实现对服务器的远程程控，简化了操作流程，提高了测试和开发效率，确保了系统的稳定性和可靠性。
TSMaster 提供了强大的接口和丰富的功能模块，用户可以根据需求灵活组合使用，实现对各种信号和设备的精细控制和管理。这种架构不仅适用于研发测试阶段，也适用于生产环境中的实时监控和故障诊断，极大提升了工程项目的整体质量和效率。
不仅如此，TSMaster 的 RPC 机制支持多种拓扑结构，不仅可以实现客户端与服务器之间的一对一通信，还能够实现以下复杂的通信拓扑：
1：一对多 (One-to-Many)：单个客户端可以同时控制多个 TSMaster 服务器，适用于需要同时管理多个测试环境或设备的情况。
2：多对一 (Many-to-One)：多个客户端可以同时连接到一个 TSMaster 服务器，这样不同的用户或测试系统可以共享同一个服务器资源，实现协同工作和资源共享。
3：多对多 (Many-to-Many)：多个客户端和多个服务器之间可以进行灵活的通信和控制，构建复杂的分布式测试和控制系统，适用于大型工程项目和分布式测试环境。
这种灵活的拓扑结构使得 TSMaster 能够适应各种复杂的工程需求，无论是在单一项目中还是在跨项目、跨地域的分布式测试中，都能提供高效、可靠的解决方案。通过这种多样化的通信模式，用户可以最大限度地利用硬件和软件资源，提高系统的扩展性和灵活性，满足不同规模和复杂度的工程项目需求。
三、TSMaster RPC 使用说明
基于RPC本身机制，TSMaster提供了相应接口，在需要被程控的工程中，激活RPC server端，为程控脚本提供相应资源。
1. 激活 server
开启server端操作如下：
新建一个C脚本，在启动事件中输入下面代码，即表示激活了当前工程的rpc server rpc_tsmaster_activate_server(true);
实际上，在 TSMaster v2024.06.05.1124 版本之后，所有TSMaster工程已经默认激活了RPC功能。
2. 激活 client
native_int h; //client 句柄
//参数 1 为提供 rpc 服务的 TSMaster 应用程序名
com.rpc_tsmaster_create_client(“TSMaster”,&h);
//激活 client 端
Com.rpc_tsmaster_activate_client(h,true);
3. 修改 server 端数据
3.1 启动停止 server 工程
启动工程：
TSMaster 小程序：
com.rpc_tsmaster_cmd_start_simulation(h);
API(C\C++\C#\Python):
rpc_tsmaster_cmd_start_simulation(h);
3.2 读写系统变量
设置系统变量：
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");
获取系统变量：
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 信号
设置 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 信号
设置 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 信号
设置 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 系统函数
// 第一步：准备调用函数的输入参数
#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：调用任意 API
s32 ret;
ret = com.rpc_tsmaster_call_system_api(h, "app.create_system_var", 4, STR_BUFFER_SIZE,
&pArgs[0]);
// 步骤 3：处理参数中的返回值（如果可用）
s32 i;
log("API call result = %d", ret);
<
最低0.47元/天 解锁文章
扫一扫
961
到【灌水乐园】发言
