2024年6月7日发(作者：)

1. 接口调用 接口调用概述

天瑞恒安 Java 调用接口文件为 文件，为了实现对 C++动态库的调用，还

需要另外两个jar 文件，即 和 ，所以在 Java 项目中需要添加

这三个 jar 文件，另外需要把 C++动态库文件 XPS_ 放在WindowsSystem32目录下。

2. 接口描述 接口描述

2.1. 初识化 初识化并打开串口 并打开串口

public int Tr_initPort(int portNumber)

接口功能：初始化并打开串口

传入参数：portNumber 为串口号

返回值：1，表示成功初始化打开串口，可以进行调用柜箱操作接口。

0，表示打开串口失败。

2.2. 打开串口

public Boolean Tr_Open()

接口功能：打开串口

传入参数：无

返回值：true，表示成功打开串口，可以进行调用柜箱操作接口。

false，表示打开串口失败。

2.3. 当前串口是否打开

public Boolean Tr_IsOpen()

接口功能：获取当前串口是否打开

传入参数：无

返回值：true，表示串口已经打开，可以进行调用柜箱操作接口。

false，表示串口已经关闭。

2.4. 当前串口是否忙

public Boolean Tr_IsBusy()

接口功能：获取当前串口是否忙

传入参数：无

返回值：true，表示串口忙

false，表示串口闲

2.5. 关闭串口

public void Tr_Close()

接口功能：关闭串口

传入参数：无

返回值：无

2.6. 单开箱

public String Tr_openBox(int iBoxIdx)

接口功能：单开箱

传入参数：开箱操作的箱号

返回值：字符串，“开箱成功”表示开箱成功，“开箱失败”表示开箱失败

2.7. 全开箱

public String Tr_openBoxM(int iBoxCnt)

接口功能：全开箱

传入参数：入参为开箱的最大箱号，依次顺序开箱。

返回值：

字符串，格式为：3|1:开箱成功|2:开箱成功|3:开箱失败|4:开箱成功，其中第一

个数字是成功开箱的个数，然后是“箱号:开箱结果”，用竖线分隔。

2.8. 单开灯

public String Tr_lightBox(int iBoxIdx)

接口功能：单开灯

传入参数：开灯操作的箱号

返回值：字符串，“开灯成功”表示开灯成功，“开灯失败”表示开灯失败

2.9. 全开灯

public String Tr_lightBoxM(int iBoxCnt)

接口功能：全开灯

传入参数：入参为开灯的最大箱号，依次顺序开灯。

返回值：

字符串，格式为：3|1:开灯成功|2:开灯成功|3:开灯失败|4:开灯成功其中第一个

数字是成功开灯的个数，然后是“箱号:开灯结果”，用竖线分隔。

2.10. 单关灯

public String Tr_lightOffBox(int iBoxIdx)

接口功能：单关灯

传入参数：关灯操作的箱号

返回值：字符串，“关灯成功”表示关灯成功，“关灯失败”表示关灯失败

2.11. 全关灯

public String Tr_lightOffBoxM(int iBoxCnt)

接口功能：全关灯

传入参数：入参为关灯的最大箱号，依次顺序关灯。

返回值：

字符串，格式为：3|1:关灯成功|2:关灯成功|3:关灯失败|4:关灯成功，其中第一

个数字是成功关灯的个数，然后是“箱号:关灯结果”，用竖线分隔。

2.12. 单物检

public String Tr_checkBoxCon(int iBoxIdx)

接口功能：单物检

传入参数：物检操作的箱号

返回值：字符串，成功返回“无物品”或者“有物品”，失败返回“物检失败”。

2.13. 全物检

public String Tr_checkBoxConM(int iBoxCnt)

接口功能：全物检