珠海泰坦软件密集架SDK使用手册(V1.1)

珠海泰坦软件系统有限公司

密集架SDK V1.1密集架通信接口使用手册

版本日期修正人修正内容

V 1.0 2012-10-31 李振威最初定制

V 1.1 2012-11-16 李振威接口修正

非常感谢您使用我们公司的产品，我们将竭诚为您提供最好的服务。

本手册可能包含技术上不准确的地方或文字错误。

本手册的内容将做定期的更新，恕不另行通知。更新的内容将会在本手册的新版本中加入。

我们随时会改进或更新本手册中描述的产品或程序。

1 内容简介 (4)

1.1概述 (4)

1.2功能 (4)

1.3组件 (4)

2返回码释义表 (5)

3接口说明 (6)

3.1初始化设备 (6)

3.2打开设备连接 (6)

3.3关闭设备连接 (6)

3.4查询设备总数 (7)

3.5移动密集架，定位至<列> (7)

3.6移动密集架，定位至<单元格> (7)

3.7恢复密集架 (8)

3.8查询所有设备信息 (8)

3.9查询单个设备信息 (9)

3.10查询所有设备状态 (9)

3.11查询单个设备状态 (9)

3.12查询温湿度 (10)

3.13设置恒定温湿度 (10)

4调用流程 (11)

1 内容简介

1.1概述

该密集架SDK仅用于由珠海泰坦软件系统有限公司研发生产的密集架设备。

1.2功能

主要功能是：密集架列的移动/复位控制、状态查询、温湿度查询等等。1.3组件

TT_MJJ.dll 动态库文件

TT_MJJ_CONFIG.xml 动态库配置文件

2返回码释义表

序号返回码类型释义

1 R000 String 无效返回

2 R900 String 成功返回

3 R901 String 失败返回

4 R902 String 网络故障

3接口说明

命名空间：namespace TiTanSoft。密集架类：class MJJ。

以下接口示例均采用静态密集架类对象进行调用，若应用于 Web应用程序中，请在添加引用后，在class Global类中添加如下属性代码：public static MJJ Mjj = new MJJ( );

3.1初始化设备

String InitDevice( )

①功能描述：初始化密集架设备环境。

②参数列表：无参数。

③返回值：【R900 / R901】，释义请查阅【返回码释义表】。

④备注：在使用其它接口前，必须先初始化密集架环境。

⑤示例：String strRes = Mjj.InitDevice( );

3.2打开设备连接

String OpenLinkDevice( )

①功能描述：打开与密集架设备的连接。

②参数列表：无参数。

③返回值：【R900 / R901】，释义请查阅【返回码释义表】。

④备注：在初始化密集架设备环境之后，使用此接口。

⑤示例：String strRes = Mjj.OpenLinkDevice( );

3.3关闭设备连接

String CloseLinkDevice( )

①功能描述：关闭与密集架设备的连接。

②参数列表：无参数。

③返回值：【R900 / R901】，释义请查阅【返回码释义表】。

④备注：无。

⑤示例：String strRes = Mjj.CloseLinkDevice( );

3.4查询设备总数

String GetDeviceCount()

①功能描述：查询设备的总数量。

②参数列表：无。

③返回值：失败返回【R901】，成功返回设备总数。

④备注：无。

⑤示例：String strRes = Mjj.GetDeviceCount( );

3.5移动密集架，定位至<列>

String OpenColumn( int Area, int Column, int Side )

①功能描述：打开指定库区指定列的指定方向，此接口定位至密集架列。

②参数列表：Area : 库区编号。

Column : 列编号。

Side : 方向编号。（1<左> | 2<右> ）

③返回值：【R900 / R901 / R902】，释义请查阅【返回码释义表】。

④备注：无。

⑤示例：String strRes = Mjj.OpenColumn( 1, 2, 1 );

3.6移动密集架，定位至<单元格>

String OpenColumn( int Area, int Column, int Side, int Cell )

①功能描述：打开指定库区指定列的指定方向，此接口定位至密集架单元格。

②参数列表：Area : 库区编号。

Column : 列编号。

Side : 方向编号。（1<左> | 2<右> ）

Cell : 单元格。（如：12 <1表示第一格，2表示第二层>）

③返回值：【R900 / R901 / R902】，释义请查阅【返回码释义表】。

④备注：无。

⑤示例：String strRes = Mjj.OpenColumn( 1, 2, 1, 12 );

3.7恢复密集架

String CloseColumn( int Area, int Column, int Side )

①功能描述：关闭指定库区指定列的指定方向。在SDK V1.0版本下，此接口功

能为关闭指定库区的所有列。

②参数列表：Area : 库区编号。

Column : 列编号。

Side : 方向编号。（1<左> | 2<右> ）

③返回值：【R900 / R901 / R902】，释义请查阅【返回码释义表】。

④备注：无。

⑤示例：String strRes = Mjj.CloseColumn( 1, 2, 1 );

3.8查询所有设备信息

String GetAllDeviceInfo( )

①功能描述：查询所有库区的相关信息。

②参数列表：无参数。

③返回值：失败返回【R901】，成功返回Xml格式的库区信息字符串。示例：

2

密集架一区-10-1-R-6-6-200

密集架二区-8-8-L-6-6-200

为库区总数；表示第一库区；

值格式说明：

库区名称-列数量-固定列位置-库区移动方向-列格数-列层数-库区

连接状态【100：断开连接、200：连接正常、404：连接故障】