智能柜动态链接库 API SDK开发包

API开发包

接口支持：C++、C#、JAVA语言开发软件对接

1. 接口调用概述

Java 调用接口文件为 trhaBoxDriver.jar 文件，为了实现对 C++动态库的调用，还需要另外两个

jar 文件，即 jna-4.1.0.jar 和 jna-platform-4.1.0.jar，所以在 Java 项目中需要添加这三个 jar 文件，

另外需要把 C++动态库文件 XPS_DLL.dll 放在\Windows\System32\目录下。

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)

接口功能：全物检

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

返回值：

字符串，格式为：3|1:有物品|2:有物品|3:物检失败|4:无物品，其中第一个数字

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

2.14. 单门检

public String Tr_checkDoor(int iBoxIdx)

接口功能：单门检

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

返回值：字符串，成功返回“关门”或者“开门”，失败返回“门检失败”。

2.15. 全门检

public String Tr_checkDoorM(int iBoxCnt)

接口功能：全门检

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

返回值：

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

门检的个数，然后是“箱号:门检结果”，用竖线分隔。

2.16. 单物门检

public String Tr_checkDoorNCon(int iBoxIdx)

接口功能：单物门检

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

返回值：成功返回“无物关门”或者“无物开门”或者“有物关门”或者“有物开

门”， 失败返回“物门检失败”。

2.17. 全物门检

public String Tr_checkDoorNConM(int iBoxCnt)

接口功能：全物门检

传入参数：入参为全物门检的最大箱号，依次顺序物门检。

返回值：

字符串，格式为：3|1:无物关门|2:有物开门|3:物门检失败|4:有物关门，其中第

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