PK体系 打印机驱动接口.docxVIP

1

PK体系打印机驱动接口

1范围

本标准规定了打印机驱动开发运行环境要求和第三方软件调用接口。

本标准适用于打印机研制生产厂商及第三方软件厂商。

2术语和定义

下列术语和定义适用于本文件。

2.1

开发环境softwaredevelopmentenvironment

指在基本硬件和数字软件的基础上，为支持系统软件和应用软件的工程化开发和维护而使用的一组软件。

2.2

运行环境runtimeenvironment

一种把半编译的运行码在目标机器上运行的环境，具体为打印机驱动在操作系统上正常运行的系统环境。

2.3

接口interface

计算机系统中两个独立的部件进行信息交换的共享边界。

2.4

打印机日志printerlog

用于记录打印机打印作业时打印任务名称、打印时间等信息的文件。

2.5

组件component

数据和方法的简单封装，在本文中是开发环境、运行环境需要的软件包或库。

2.6

驱动程序devicedriver

是一种使计算机和打印机设备通信的程序。

2.7

第三方软件third-partysoftware

指可运行在国产计算机且与打印机功能相关的应用程序。

2

3缩略语

下列缩略语适用于本文件。

CPU中央处理器（centralprocessingunit）

CUPS通用打印系统（commonunixprintingsystem）

ID打印机设备唯一标识（identitydocument）

USB通用串行总线（universalserialbus）

4开发运行环境要求

4.1基础环境

国产终端CPU。

国产操作系统。

USB打印机、网络打印机。

4.2开发环境

为打印机厂家提供统一的驱动开发环境，开发环境提供了驱动编译所需要的组件及对应的版本号，形成统一的组件列表及组件号版本。打印机开发环境组件列表参见附录A。

4.3运行环境

操作系统应为打印机驱动程序提供统一的运行环境，不需用户单独安装运行环境，运行环境各组件和组件版本号，可以支撑多个打印机厂家多种设备的运行，操作系统版本可向下兼容打印机驱动，减少驱动重复适配。打印机运行环境组件列表参见附录B。

4.4配置信息

对于操作系统而言，在实际调用各厂商的具体设备时，应明确某打印机对应的具体调用文件路径及文件名。因此当各打印机驱动开发商将驱动包安装到系统上或当操作系统集成这些驱动包时，要求打印机驱动厂商提供相应的配置文件放置于指定目录下，以满足运行时的必要配置文件要求。

配置文件应遵循以下要求：

a)配置文件存放于/etc/kylin-printer/目录下,以.conf为后缀，配置文件名以各厂商名命名，如printer-xxx.conf；

b)同一厂商的不同型号打印机，均写入该配置文件中，允许出现同一驱动库对应不同型号的打印机。

c)有新驱动库安装入系统时，要求驱动包自行向该配置文件内追加内容。

d)配置文件中应指明打印机的具体型号，以及该型号的驱动库存放在操作系统上的具体路径。

e)驱动库应具有明确的标识符，安装于系统/usr/lib/kylin-printer/目录下，各厂商在此目录下

建立以厂商名命名的目录，将其驱动库放置于其中。

具体的配置格式实例参见附录C。

3

5第三方软件调用接口

5.1概述

第三方应用程序（例如流版签软件、集中文印、集中管控软件等）通过统一规范的打印机接口能够准确地获取打印机的实时状态信息，第三方应用程序通过第三方调用接口对打印机物理设备的状态信息进行读取并执行相应的操作，接口设计遵循通用、可扩展、易开发的原则。

5.2第三方接口定义

第三方调用接口标准，包含了获取操作系统连接的打印机列表、获取打印机当前运行状态、获取当

前正在执行的打印任务对应的页数状态等4种接口，接口列表见表1。

表1第三方调用接口列表

序号

接口名

释义

1

Printer_Get_Connected_Uri

获取操作系统连接的打印机uri列表

2

Printer_Get_Dev_Status

获取打印机当前运行状态

3

Printer_Get_Prt_PageNums

获取当前正在执行的打印任务对应的页数状态

4

Printer_Get_Dev_Info

获取打印机固件相关信息

接口函数的定义及描述见附录D。

5.3打印机状态定义

为规范打印机状态，打印机的状态分为三类：正常、异常和扩展。正常类为打印机正常运行时的状态信息；异常类为打印机遇到错误无法打印的状态信息；扩展类为打印机个性化功能的状态信息。打印

机概要状态见表2。

表2打印机概要状态表

序号

概要状态

状态描述

1

Nor