一体化终端设备技术规范

1、智能终端接口规范版本号1.0福建三元达软件有限公司二o四年六月文档变更说明版本编号v1.0变更简要说明（变更内容和变更范围）类型新建创建并拟制初稿日期变更人2014/6/24朱有文变更类型：新建，修改，增加，删除、，-、.1.前u言 .2.目的范围 .3.原则 .4.术语及缩略语 .5.写卡器设备功能域接口 .5.1组件名称 .5.2函数说明 .5.3调用过程 .6.二代证身份识别设备功能域接口6.1组件名称 .6.2函数说明 .7.6.3调用过程 .写卡器设备功能域接口 .7.1组件名称 .7.2函数说明 .7.3调用过程 .银行卡读卡器设备功能域接口8.1组件名称 .8.2函数说明 .9.

2、8.3调用过程 .10.一体机组件名称 .1)一体机接口规范 .2)一体机二代证读卡.3)一体机sim卡读写卡.一体机打印机.1414141518181819232424242728282828281.前言近几年，随着an droid、ios等智能终端操作系统的推广，智能终端功能越来越丰富，越来越被大众所接受，移动互联网正欣欣向荣。智能终端具有体积小、携带方便、移动办公等优势。移动顺应时代潮流， 利用移动互联网新技术， 采取更为积极主动的营销和服务模式，括智能终端版crm等移动应用，完善了自身的运营支撑能力，以适应市场的需要，提升了自身竞争力，保持自身的行业优势。移动智能终端应用在业务办理过程

3、中， 使用到了多种多样的外接设备辅助办公， 如蓝牙打印机、蓝牙二代证读卡器、蓝牙sim信息读卡器等，为企业办公、客户带来的极大的方便。与此同时也带来了问题， 同种设备不同厂商在实现方式上各有差别，等量的劳动力。因此建立一套智能终端外设接口规范刻不容缓。智能终端外设接口规范明确了外设接入移动智能终端应用的技术规范、外设厂家如何根据规范接入移动智能终端应用。也建立了包要兼容不同的外设厂商就必须付出业务功能， 以指导各智能终端外设接口规范适用于指导各外设厂家将其外设按照规范合理、动智能终端应用， 是各外设厂家接入移动智能终端应用的主要依据。范、业务功能，操作流程。本规范尽可能依据现有外设的行业技术规

4、范，并能尽量最大化兼容各外设厂商。2.目的范围高效、快速地接入移本规范规定了外设的技术规3.原则下列术语和缩略语适用于本规范：android是一种以linux为基础的开放源码操作系统，主要使用于便携设备。ios是由苹果公司开发的手持设备操作系统。ios与苹果的mac os x操作 系统一样，它也是ios以darwin为基础的，因此同样属于类unix的商业操作 系统。是指一个正在使用及可能使用移动（包括第三方合作伙伴）提供的产品和 服务的个人、企业或者其他团体。客户是一种支持设备短距离通信（一般10m内）的无线电技术。能在包括移动电 话、pda无线耳机、笔记本电脑、相关外设等众多设备之间进行无线

5、信息 交换。蓝牙用户是移动客户订购产品的实例。包括资源占用、用户价值、订购信息。用户是指像个人电脑一样， 具有独立的操作系统， 可以由用户自行安装软件、 游戏等第三智能终端方服务商提供的程序， 通过此类程序来不断对终端的功能进 行扩充， 并可以通过移动通讯网络来实现无线网络接入的这样一类终端 的总称。第二代居民身份证二代证4.术语及缩略语crm客户关系管理(customer relationship management)用户识别卡(subscriber identity module)sim5.写卡器设备功能域接口5.1组件名称cmcc_print厂家英文名缩写_厂家设备型号缩写.so5.2

6、函数说明1）连接打印机方法描述连接打印机com.cmcc. native package .prin terp ublic static n ative int openprin ter(i nt prin tert yp e,stri ngdeviceldstri ng p assword)包名+类名方法名属性入口参数变量名称prin tert ype类型int变量含义打印机类型备注prin tert ype1：usb打印机（包括usb智能终端外设一体机中 的打印机）2:蓝牙打印机（包括蓝牙智能终端外设一体机 中的打印机）3:串口打印机（包括串口智能终端外设一体机 中的打印机）4、内置打印机

7、（包括智能终端一体机中的打印机）入口参数deviceidstri ng设备id当printertype为2时,deviceid为打印机mac地址。当printertype为3时,deviceid为usb卡(线)转换的串口，如/dev/ttyusbo。入口参数p asswordstri ng密码预留字段0-success;返回值int非0状态码 fail附加说明password是为了将来可能出现的wifi设备预留的参数。2）关闭打印机方法描述包名+类名方法名属性关闭与打印机的连接com.cmcc. native package .prin terp ublic static n ative in

8、t close prin ter()变量名称类型变量含义备注0success;返回值int非0状态码 fail附加说明无3）获取组件版本信息方法描述包名+类名方法名属性出口参数获取各厂商打印机组件的版本信息。com.cmcc. native package .prin terp ublic static n ative int get prin tervers ion( byte version)变量名称version类型byte变量含义版本号备注各厂商打印机组件的版 本号（三位整数），数值 越大代表版本越高。返回值int0success;非0状态码 fail附加说明无4）初始化打印机方法描述

9、初始化打印机，清除打印缓冲区中的数据，复位打印机打印参数到打印机缺省参数。包名+类名方法名属性返回值com.cmcc. native package .prin terp ublic static n ative int in itia iprin ter()变量名称类型变量含义备注0-success； 非0状态码failint附加说明不是完全恢复到出厂设置，只是将打印指令参数恢复到打印机缺省参数。点距是指打印的内容每个点之间的距离。具体缺省设置包括如下：1.字体宽咼缩放比例：1；2.对齐方式：左对齐；3.左边距：0个点距；4.右边距：0个点距；5.行间距：8个点距；6.字符间距：0个点距；7

10、.打印方向：横打；8.非粗体打印；9.非下划线打印；10.非反白打印。5）设置字体宽高缩放比例方法描述包名+类名方法名属性入口参数设置打印机字符串的字符宽高缩放比例。com.cmcc. native package .prin terpublic static native int setzoonin(int widthzoonin,int heightzoonin)变量名称widthzo onin类型int变量含义字体放大宽度备注相比正常字体宽度的倍数，必须是正整数入口参数heightzo onl nint字体放大高度相比正常字体高度的倍 数，必须是正整数。返回值int0success； 非

11、0状态码fail附加说明打印机字体宽咼缩放比例缺省设置为1。厂商必须支持宽咼缩放比为正常字体两倍或以上。6）设置对齐方式方法描述包名+类名方法名属性入口参数设置打印机字符串的对齐方式。com.cmcc. native package .prin terpublic static native int setaligntype(int aligntype)变量名称alig ntype类型int变量含义对齐方式备注0:左对齐；1：居中对齐；2:右对齐返回值int0-success;非0状态码 fail附加说明1.打印机缺省设置为左对齐。2.仅在一行开始处理时，该命令才有效。3.竖向打印不支持设置对

12、齐方式，默认上对齐。7）设置左边距方法描述包名+类名方法名属性入口参数设置打印机每行字符左边距为com.cmcc. native package .prin tern个点距public static native int setleftmargin(int n)变量名称n类型int变量含义备注左边点距0success; 非0状态码fail返回值int附加说明1.左边距位置表示打印内容的左侧边缘位置。2.点距是指打印的内容每个点之间的距离。8）设置右边距方法描述设置打印机每行字符右边距为n个点距com.cmcc. native package .prin ter包名+类名方法名public st

13、atic native int setrightmargin(int n)属性入口参数变量名称n类型int变量含义备注右边点距0-success;返回值int非0状态码 fail附加说明1.右边距位置表示打印内容的右侧边缘位置。2.点距是指打印的内容每个点之间的距离。9)设置行间距方法描述包名+类名方法名属性入口参数设置打印机字符串的字符行间距为com.cmcc. native package .prin tern个垂直点距public static native int setlinespacingbydotpitch (int n)变量名称n类型int变量含义备注垂直点距0success;

14、返回值int非0状态码 fail附加说明1.打印机行间距缺省设置为 &2.仅在一行开始处理时，该命令才有效。3.点距是指打印的内容每个点之间的距离。10)设置字符间距方法描述包名+类名方法名属性入口参数设置打印机字符串的字符间距为com.cmcc. native package .prin tern个水平点距public static native int setwordspacingbydotpitch(int n)变量名称n类型int变量含义水平点距备注取值范围：0wnsuccess;返回值int非0状态码 fail附加说明1.打印机字符间距缺省设置为0。2.在倍宽模式下，字符右侧

15、间距是正常值的两倍。当字符被放大时，字符右侧间距被放大同样的倍数。 该函数同时影响英文和汉字字符的设定。3.点距是指打印的内容每个点之间的距离。11) 设置打印方向方法描述包名+类名方法名属性入口参数n设置打印机字符串的打印方向com.cmcc. native package .prin terp ublic static n ativeintset prin torie ntati on(intprin torie ntati on)变量名称类型prin torie ntation变量含义打印方向备注0:竖打1：横打返回值int0-success;非0状态码 fail附加说明1.打印机缺省设

16、置为横打。2.设置打印方向后，所有的打印都按照此格式打印。3.竖向不支持设置对齐方式，默认上对齐。12)设置/取消粗体打印设置打印机字符串是否粗体打印com.cmcc. native package .prin terp ublic static n ativeint setbold(i nt n)方法描述包名+类名方法名属性入口参数变量名称n类型int变量含义是否粗体备注0:取消粗体打印设置；1:设置粗体打印返回值int0success;非0状态码 fail附加说明打印机缺省设置为非粗体打印。13)方法描述设置/取消下划线打印设置打印机字符串是否下划线打印com.cmcc. native p

17、ackage .prin terp ublic static n ative int set un derl in e(i nt n)包名+类名方法名属性入口参数变量名称n类型int变量含义是否下划线打印备注0:取消下划线打印；1:设置下划线打印0-success;返回值int非0状态码 fail附加说明打印机缺省设置为非下划线打印。14)设置/取消反白打印方法描述包名+类名方法名属性入口参数设置打印机字符串是否反白打印com.cmcc. native package .prin terpublic static native int setinverse(int n)变量名称n类型int变量

18、含义是否反白打印备注0:取消反白打印；1:设置反白打印返回值int0success;非0状态码 fail附加说明打印机缺省设置为非反白打印。15)打印字符串方法描述包名+类名方法名属性入口参数打印字符串com.cmcc. native package .prin terpublic static native int print(string content)变量名称content类型stri ng变量含义打印字符串备注打印字符串，可包括多行打印数据，使用”n”表示换行。返回值int0success;非0状态码 fail附加说明当每行数据超出打印纸张宽度时打印机输出自动换行。16)打印 htm

19、l 格式数据方法描述包名+类名方法名属性入口参数打印html格式数据com.cmcc. native package .prin terpublic static native int printhtml(string content)变量名称content类型stri ng变量含义备注html格式数据0success;返回值int非0状态码 fail附加说明支持常用html标签。5.3调用过程智能终端版 crmcrm 客户端热敏打印机1.1.加载组件 i i2.2.调用组件：建立连接3.3.调用组件：初始化打印机函数i i 4.4.调用组件：设置打印参数集函数*!5.5.调用组件：打印函数

20、i i6.6.打印票据7.7.调用组件：关闭连接图11、打印流程加载组件，调用加载外设组件流程。建立与热敏打印机的连接。调用组件的初始化打印机方法。调用组件的设置打印机参数方法集,如设置对齐方式、设置行间距等方法。2、3、4、5、调用组件的打印字符或打印html格式数据方法。打印机打印票据。关闭连接。6、7.6.二代证身份识别设备功能域接口6.1组件名称cmcc_idcard厂家英文名缩写_厂家设备型号缩写.so6.2函数说明1）连接二代证身份识别设备方法描述包名+类名方法名属性入口参数入口参数连接二代证身份识别设备com.cmcc. native package.ldcardpublic s

21、tatic native int openidcard(int idcardtype,stringdeviceid,stri ng p assword)变量名称类型变量含义idcardt ypeint二代证身份识别设备类型deviceidstri ng设备id备注idcardt ype1：usb二代证身份识别设备（包括usb智能终端 外设一体机中的二代证 身份识别设备）2:蓝牙二代证身份识别设备（包括蓝牙智能终 端外设一体机中的二代 证身份识别设备）3:串口二代证身份识别设备（包括串口智能终 端外设一体机中的二代 证身份识别设备）4、内置二代证身份识别设备（包括智能终端, 体机中的二代证身份识

22、别设备）当idcardtype为2时deviceid为蓝牙二代证 身份识别设备mac地址 当idcardtype为3时deviceid为usb卡(线)转换的串口，如/dev/ttyusbo。入口参数p asswordstri ng密码预留字段0success;返回值int非0状态码 fail附加说明password是为了将来可能出现的wifi设备预留的参数。2）关闭二代证身份识别设备方法描述包名+类名方法名属性关闭与二代证身份识别设备的连接com.cmcc. native package.ldcardpublic static native int closeldcard()变量名称类型变量含

23、义备注0success;返回值int非0状态码 fail附加说明无3）获取组件版本信息方法描述包名+类名方法名属性出口参数获取各厂商二代证身份识别设备组件的版本信息。com.cmcc. native package.ldcardpublic static native int getidcardversion(byte version)变量名称version类型byte变量含义版本号备注各厂商二代证身份识别 设备组件的版本号（三 位整数），数值越大代表 版本越高。返回值int0success;非0状态码 fail附加说明无4）初始化二代证身份识别设备方法描述初始化二代证身份识别设备，清除二代证

24、身份识别设备内缓存数据。包名+类名方法名属性com.cmcc. native package.ldcardpublic static native int initialldcard ()变量名称类型变量含义备注0success;返回值int非0状态码 fail附加说明无5）获得二代证信息方法描述包名+类名方法名获得二代证信息com.cmcc. native package.ldcardpublic static native int getidcardinfo(string idcardinfo,byte img)属性出口参数变量名称idcardi nfo类型strin g变量含义二代证基本

25、信息备注数组长度为9,内容按顺 序分别为：姓名、性别、 民族、出生年月、地址、 公民身份号码、签发机 关、有效期限，照片保存地址。出口参数imgbyte照片文件内容证件头像图片base64编 码返回值int0success;非0状态码 fail附加说明无6.3调用过程智能终端版 crmcrm 客户端二代证身份识别设备1.1.加载组件2.2.调用组件：建立连接3.3.调用组件：初始化:j j5.5.显示二代身份证信息阡-6.6.调用组件：关闭连接图21、二代证身份识别流程图示加载组件，调用加载外设组件流程。建立与二代证身份识别设备的连接。调用组件的初始化二代证身份识别设备方法。调用组件的获取二代

26、证信息方法。页面显示二代证身份信息。关闭连接。2、3、4、5、6、7.写卡器设备功能域接口7.1组件名称cmcc_simcard厂家英文名缩写_厂家设备型号缩写.so7.2函数说明1）获取版本信息方法描述包名+类名方法名属性出口参数通过该函数获取统一写卡组件的版本信息。com.cmcc. native package.simcardpublic static native int getopsversion( char version)变量名称versio n类型char变量含义版本号备注方法返回，统一写卡组 件版本信息返回值int0success;非0状态码 fail附加说明无2）读空卡序列

27、号方法描述该函数用于读取卡片空卡序列号，该函数支持本标准发布前和发布后的所有 现场写卡系统空卡。因此发布后生产的空卡。crm客户端可通过调用getcardsn判断是否为本标准包名+类名方法名属性出口参数com.cmcc. native package.simcardp ublic static native int getcardsn(char cardsn)变量名称cardsn类型char变量含义空卡序列号备注空卡序列号，如卡片符 合中国移动sim卡远程 写卡业务规范v1.0.0版本，则长度为16位， 如卡片符合中国移动现场写卡技术规范， 则长度为20位。返回值int0success;非0状

28、态码 fail附加说明无3)读取卡片信息方法描述该函数用于读取卡片信息，卡片信息包含卡片com.cmcc. native package.simcardp ublic static n ative int getcard info (char cardinfo)iccid、卡片空卡序列号.包名+类名方法名属性出口参数变量名称cardi nfo类型char变量含义该参数包含卡片iccid、卡片空卡序列号格式【iccid+(iccid+.)+空卡序列号】备注该参数包含卡片iccid、卡片空卡序列 号。格式为tlv格式，具 体见ngboss2-crm(v4 5)(u)sim卡写卡技术规范参支撑分册2

29、0130722.doc 第8.3.3节。其中卡片iccid如果为一多号 卡，可出现多次。具体 请参见ngboss2-crm(v4 5)(u)sim卡写卡技术规范支撑分册20130722.doc 第7.7一卡多号卡写卡 及第8.2.1节空卡判断。返回值int0success;非0状态码 fail附加说明4)实时写卡数据写入方法描述该函数用于实时写卡数据写入。函数返回值为发送写卡数据成功并得到卡片响应。写卡是否成功须根据0时表示统一写卡组件向卡片result判断.包名+类名方法名属性入口参数com.cmcc. native package.simcardp ublic static n ative

30、 int writecard(char issuedata, char result)变量名称issuedata类型char变量含义现场写卡系统生成的写卡下行报文备注现场写卡系统生成的写 卡下行报文，如多条报 文，用“|”分隔。出口参数resultcha叩卡片返回结果卡片返回结果，格式参见ngboss2-crm(v4 5)(u)sim卡写卡技术规范 支撑分册20130722.doc 第833.2节中第3部分“返回数据格式”说明。crm向现场写卡系统回传 写卡结果时须传带的完整结果。ma(值返回值int0-success;非0状态码 fail附加说明无5)获取错误信息方法描述该函数用于获取错误信

31、息，统一写卡组件将返回最近一次函数调用的错 误信息。包名+类名方法名属性出口参数com.cmcc. native package.simcardp ublic static native int get op serrormsg(i nt errorcode, char errormsg)变量名称errorcode类型int变量含义最近一次接口调用的错误代码备注该参数为统一写卡组件 最近一次接口调用的错 误代码，如最近一次执行 成功则该参数返回0。出口参数errormsgchar最近一次接口调用的错误描述该参数为统一写卡组件 最近一次接口调用的错 误描述，如最近一次执行 成功则该参数返回字符

32、串“noerror”。返回值int0success;非0状态码 fail附加说明无6）获取读卡器信息方法描述通过该函数连接读卡器。com.cmcc. native package.simcardp ublic static n ative int con figreader(i nt readert ype, char deviceld, char包名+类名方法名属性入口参数入口参数password)变量名称readert ypedeviceid类型intchar变量含义读卡器类型设备号备注16进1、usb口读卡器mac（cm-reader议）；2、为蓝牙读卡器；3、串口读 卡器；，则4、内置

33、读卡器1.readertype为1时取值 女口下：windows: p cs读 卡器名称,linux: pcsc读 卡器名称android:usb读 卡器vid+pid的16进制字 符串，如vid为23d8,pid为0185，则值为23d801852.readertype为2时为蓝 牙读卡器mac地址的 制字符串，如读卡器 地址11:22:33:44:55:66值为112233445566。3.readertype为3时取值 如下：windows:串口名 称，女n com1linux:终 端主机自带的串口，如/dev/ttys0us味（线）转换的串口, 如/dev/ttyusboan droi

34、d:终端主机自带的串口， 如/dev/ttys0us味（线）转换的串口, 如/dev/ttyusb04.readertype为4时取值如下：可以设置为固定值，也可以不配置入口参数p asswordcha叩蓝牙读卡器连接密码蓝牙读卡器连接密码，该 字段为预留字段。0success;返回值int非0状态码 fail附加说明无7.3调用过程读卡智能终端版 crmcrm 客户端写卡器| |1.1.加载外设组件2.2.加载读卡器控制组件i i| |3.3.加载统一写卡组件 i i i i4.4.调用外设组件读卡5.5.返回读卡结果!success；状态码 failwifi设备预留的参数。2）关闭银行卡读卡器设备方法描述包名+类名方法名属性关闭与银行卡读卡器设备的连接com.cmcc