常用扫描仪驱动配置与适配 - 银河麒麟系统一本通

扫描仪适配

以下是该主题的专项运维指导方案及示意配图

扫描仪适配技术指导手册

适配方案的查找

在适配方案

（1）驱动提供以下5个获取渠道，查找驱动请按序号的优先级顺序查询（要注意现场环境的CUP架构来选择相应的驱动安装包）

1）外设适配厂家查找，常见外设厂家官网：https://www.kdocs.cn/l/coa6602tGGoN

2）通过麒麟提供的在线表格进行查找

https://www.kdocs.cn/l/cnZetfCi0VMY

3）通过Excel表格中查找

https://www.kdocs.cn/l/cddK3b7Yu4QN

4）在线表格查询

https://kdocs.cn/l/cfxI5mr8NrkH

关注麒麟软件技术服务公众号---在线客服，在线获取帮助；或通过麒麟软件400（联系电话：400-089-1870）获取技术支持。

在银河麒麟的本地驱动库中查找适配方案

麒麟操作系统已经集成了不少开源驱动。根据下面的查找步骤，可以确认使用的扫描仪是否已支持。一般情况下，已支持的扫描仪不需要额外安装驱动，直接连接使用即可。

查找步骤如下：

确定系统版本和 SANE 版本V10(SP1)的 SANE 版本是 1.0.29，V10 的 SANE 版本是 1.0.27。 SANE 版本越新,集成的扫描仪驱动就越多。

登录网址 http://www.sane-project.org/sane-supported-devices.html

在“Old SANE Versions”模块下选择相应的版本进入(如图 3-2 所示)。

图 3-2SANE - Supported Devices

可以根据扫描仪的型号，进行搜索(Ctrl+F),以 HP ScanJet G4010 型号为例。

搜索结果如图 3-3 所示

图 3-3 HP Scan Jet G4010

由显示的信息可以看出，该扫描仪是 USB 接口。Vendor ID:0x03f0，Product ID:0x4505。设备支持状态：Good。Backend(可以理解为驱动):genesys。SANE支持的扫描仪状态总共有 6 种，详细分类请参考表 3-2。

表 3-2 扫描仪支持状态分类

Complete

完美支持，所有的功能都可以使用。

Good

可以稳定的工作，但是有些高阶功能可能不支持。

Basic

支持最重要的扫描模式，但是扫描质量不会太好。

Minimal

至少可以使用一种扫描模式，但是扫描质量不好，重要的 feature 也不支

持。

Untested

可能支持，但是没有经过测试验证。

Unsupported

不支持。

如果搜到扫描仪型号，且支持状态不是 Unsupported, 则可以直接连接扫描仪，使用扫描软件(如:麒麟扫描、文档扫描仪\扫描易或 XSane)验证扫描仪能否正常工作。

如果搜到扫描仪型号，但是连接扫描仪后，系统下识别不到扫描仪（scanimage

-L），则按下面步骤确认信息。

dll.conf - Configuration file for the SANE dynamic backend loader## Backends can also be enabled by configuration snippets under the dll.d/# directory -- third party backends can drop their configuration file in# this in this directory, named after the backend.## The next line enables the network backend; comment it out if you don't# need to use a remote SANE scanner over the network -- see sane-net(5)# and saned(8) for details. netepson2epsonds进入/etc/sane.d 路径下，查看 dll.conf 文件是否包含 genesys？有没有注释掉？如果没有，自行添加，如果注释掉，则把注释符#去掉。

dll.conf - Configuration file for the SANE dynamic backend loader

Backends can also be enabled by configuration snippets under the dll.d/

directory -- third party backends can drop their configuration file in

this in this directory, named after the backend.

The next line enables the network backend; comment it out if you don't

need to use a remote SANE scanner over the network -- see sane-net(5)

and saned(8) for details. net

epson2

epsonds

escl#fujitsu genesys#gphoto2

escl

fujitsu genesys

gphoto2

Hewlett Packard ScanJet G4010usb 0x03f0 0x4505进入/etc/sane.d 路径下，查看 genesys.conf 文件，确认该文件是否包含该扫描仪型号信息，如果没有请自行添加。

Hewlett Packard ScanJet G4010

usb 0x03f0 0x4505

$ lsusb其中 usb 的 VID 和 PID 信息可以使用指令 lsusb 查看。

$ lsusb

进入路径/usr/lib/x86_64-linux-gnu/sane（X86_64 架构为例）下，查看是否有相关的 so 库文件（驱动文件），如果没有，则代表系统下没有集成该扫描驱动。

$ ls -l |grep genesys

图 3-4 扫描驱动信息

适配解决方案的实施

安装 DEB 驱动包

绝大多数情况下，扫描仪适配解决方案会以单个 DEB 软件包的形式提供。只需通过 apt 命令、dpkg 命令或麒麟安装器（双击软件包）安装 DEB 包。如果驱动包自带应用扫描软件，直接使用该软件操作即可。如果只有驱动，没有扫描软件，可以根据所用系统，自身需要选择使用麒麟扫描，文档扫描仪/扫描易，

XSane。

多 DEB 包安装

有的扫描驱动是多个 DEB 包，这种情况下一般会有一个安装脚本，直接执

行脚本即可。如果没有安装脚本，则把驱动包放到同一文件夹下，使用下面的指令安装即可。

$ sudo dpkg -i *

常见适配问题及解决方法

表 5- 1 列出了一些具有代表性的扫描仪适配问题及解决方法。

表 5- 1 常见问题及解决方法

问题

建议

无法识别扫描仪

检查并尝试更换 USB 线缆、电脑的 USB 接口；

终端输入指令”lsusb”，查看是否识别到硬件设备

检查是否安装驱动；

驱动安装过程中是否报错；

如果系统集成驱动，检查/etc/sane.d/dll.conf 文件，确认驱动是否被注释

驱动安装后，重启电脑和扫描仪

root 权限下，终端输入指令”scanimage -L”，确认是否能

识别扫描仪，如果能识别，则是权限问题，尝试重启电脑

松下扫描仪依赖 libusb-0.1-4 库文件，检查该库是否安装，

如未安装，请执行”$ sudo apt install libusb-0.1-4”安装

自带扫描软件双击打不开

右键解压，找到 desktop 文件 exec 字段，使用终端运行

exec 字段。根据报错内容判断问题，如果提示“缺少相应的依赖库”，则”apt search 依赖库”，如果能找到，直接”apt

install 依赖库”安装即可

扫描出来的图片颜色或格式不正确

扫描仪驱动问题，可联系生态适配相关人员进行确认，确

认后反馈给扫描仪厂商修复此问题

启动 XSane，选择扫描仪后提示开启装置

失败，平台未支援

尝试多启动几次，如果多次尝试仍然报错，则驱动与该扫

描仪不匹配

麒麟扫描功能缺失（比如不能设置颜色）

麒麟扫描与驱动兼容性不好，建议使用 XSane

使用麒麟扫描，提示连接不到扫描仪

麒麟扫描与驱动兼容性不好，建议使用 XSane

非管理员（普通）用户下，使用麒麟扫描

一直提示扫描器失败

麒麟扫描与驱动兼容性不好，建议使用 XSane

获取扫描仪日志

为方便扫描仪的问题排查，结合日志进行分析往往是最有效的方法。不同的扫描软件，获取日志的方式不同，现针对常见的扫描软件，详细描述如何获取日

志。

scanimage

scanimage 是使用命令方式操控扫描仪获取图像的工具。

$sudo scanimage -h -d xxx

查看扫描仪支持的功能和参数，xxx 指 scanimage -L 识别到的扫描设备。如果扫描仪本身支持该功能，而扫描软件不支持或使用该功能异常，说明扫描软件有问题。

图 5-1 扫描仪支持功能

$SANE_DEBUG_DLL=255 scanimage -d xxx >a.pnm

输出 debug 日志信息,把输出的信息手动保存到文档即可。

小提示：输出信息一般比较多，回滚时无法找到全部的输出信息，需要修改一下终端设置，把回滚改成不限制即可（如图 5-2 所示）。

图 5-2 终端滚动设置

.扫描易/文档扫描仪（simple-scan）

$sudo simple-scan -d

日志路径：~/.cache/simple-scan/simple-scan.log

.麒麟扫描（kylin-scanner）

日志路径：/tmp/scanner/kylin-scanner.log

4.XSane

$XSANE_DEBUG=255 xsane

把输出的内容手动保存到文档即可。

银河麒麟共享扫描仪使用指南

在继续操作前，请确认您已知本节中提到的操作可能会给您的计算机及网络环境带来的安全风险（包括但不限于计算机病毒、中间人攻击、 ARP攻击、DDoS攻击等），并有技术手段（包括但不限于防火墙、网络安全审计、网络入侵检测/防御等）可以规避上述风险。

如果只有一台扫描仪，而且房间的大小使得屋内所有人都能够实际使用扫描仪，就像扫描仪实际连接到每台计算机上一样。可以通过建立网络扫描满足该需求。

建立网络扫描需要在每台计算机上进行不同的配置。最复杂的配置工作在于服务器端--直接连接扫描仪的计算机。这个系统必须运行 SANE 服务程序，它就是一个‘中间件’，它位于控制扫描仪的后端程序与客户计算机上的前端程序之间。这个 SANE 服务程序被称为 saned，大多数 Linux 将其保存在/usr/sbin。用户应该将它配置为从超级服务程序（xinetd）上运行。具体步骤如下：

安装扫描仪驱动，使它能够在服务器端上正常工作。

根据需要在/etc/services 下添加 SANE 端口的条目。如果没有，就添加如下内容（kylin 系统已有）。

sane-port6566/tcpsane saned # SANE network scanner daemon

为 saned 创建一个超级服务程序配置。

(1)安装 xinetd

$ sudo apt install xinetd

(2)创建一个包含如下内容的/etc/xinetd.d/saned 文件

service sane-port{

service sane-port

{

socket_type = stream server = /usr/sbin/saned protocol = tcpuser = saned group = saned wait = no disable = no}

socket_type = stream server = /usr/sbin/saned protocol = tcp

user = saned group = saned wait = no disable = no

}

172.17.31.1/24该网段的所有主机都可以访问到该扫描仪。在/etc/sane.d/saned.conf 文件里添加能够访问扫描仪的主机名称或 ip地址。比如

31.1/24该网段的所有主机都可以访问到该扫描仪。

现在 saned 服务程序能够对扫描请求产生响应了，但是需要我们告诉客户端如何访问这个应用程序。因此，用户需要执行如下配置过程。

dll.conf - Configuration file for the SANE dynamic backend loader## Backends can also be enabled by configuration snippets under the dll.d/# directory -- third party backends can drop their configuration file in# this in this directory, named after the backend.## The next line enables the network backend; comment it out if you don't# need to use a remote SANE scanner over the network -- see sane-net(5)# and saned(8) for details. netepson2在客户端下的/etc/sane.d/dll.conf 文件中添加 net 选项（默认已有该字段），这个选项告诉客户端上的 SANE 库搜索网络扫描仪。

dll.conf - Configuration file for the SANE dynamic backend loader

Backends can also be enabled by configuration snippets under the dll.d/

directory -- third party backends can drop their configuration file in

this in this directory, named after the backend.

The next line enables the network backend; comment it out if you don't

need to use a remote SANE scanner over the network -- see sane-net(5)

and saned(8) for details. net

epson2

This is the net backend config file.## net backend options# Timeout for the initial connection to saned. This will prevent the backend# from blocking for several minutes trying to connect to an unresponsive# saned host (network outage, host down, ...). Value in seconds.# connect_timeout = 60## saned hosts# Each line names a host to attach to.# If you list "localhost" then your backends can be accessed either# directly or through the net backend.Going through the net backend# may be necessary to access devices that need special privileges.# localhost 172.17.31.55编辑客户端上的/etc/sane.d/net.conf 文件，添加 SANE 服务程序的 IP地址（假设 IP 地址为 172.17.31.55）。

This is the net backend config file.

net backend options

Timeout for the initial connection to saned. This will prevent the backend

from blocking for several minutes trying to connect to an unresponsive

saned host (network outage, host down, ...). Value in seconds.

connect_timeout = 60

saned hosts

Each line names a host to attach to.

If you list "localhost" then your backends can be accessed either

directly or through the net backend.Going through the net backend

may be necessary to access devices that need special privileges.

localhost 172.17.31.55

现在客户端可以访问扫描仪了，scanimage -L 能够发现网络扫描仪（如图 5-3 所示）

图 5-3 网络扫描仪

扫描仪的设备名称增加两个元素：标识符以关键字 net 开始，在关键字后是服务程序所在的主机名或 IP 地址。

用户可以直接使用扫描软件调用这台网络扫描仪工作了。

用户不仅可以从 Linux 系统上访问基于 SANE 服务的网络扫描仪，在

http://www.sane-project.org/sane-frontends.html 上可以找到用于各种操作系统的前端程序，借助这些前端程序可以访问 SANE 服务的网络扫描仪。下面以

Windows 系统为例。https://sourceforge.net/projects/sanewinds/files/Archive/

该网址可以下载 SANEWinDS,在 Windows 上安装该软件后，可以访问到 linux系统上配置的网络扫描仪（如图 5-4 所示）。

图 5-4 Windows 访问 Linux 系统下的网络扫描仪

常用扫描软件的使用方法

不同的系统版本支持的扫描软件也不尽相同。使用之前，请参考表 6-1 选择适用的扫描软件。

表 6-1 麒麟操作系统支持扫描软件

扫描软件

操作系统

麒麟扫描

文档扫描仪/扫描易

（simple-scan）

XSane

V10(SP1)

√

V10

√

麒麟扫描

麒麟扫描又名扫描，在银河麒麟桌面操作系统 V10(SP1)版本系统下为预装软件，可直接使用，银河麒麟桌面操作系统 V10 版本系统下不支持此软件。若未安装此软件或被卸载，可从软件商店中下载（软件商店中名称为”扫描”）或从源中获取（源中名称为“kylin-scanner”）。

点击左下角“开始菜单”，在“开始菜单”顶部搜索框内输入关键词“扫描”，点击“扫描”启动程序（如图 6-1 所示）。

图 6-1 麒麟扫描启动

扫描

将需要扫描的文件放入到扫描仪中，点击“扫描”图标（如图 6-2 所示）后开始扫描。

图 6-2 扫描

基本功能

可根据不同需求通过点击界面左侧各项功能的“下拉箭头”图标（如图 6-3 所示）选择已连接的设备、以及该款设备支持的扫描类型、色彩、分辨率、尺寸、格式。

图 6-3 基本功能选项

扫描完成的图像通过点击界面右侧的“黑色图标”，可对图像进行裁切、旋

转、对称翻转、水印的操作（如图 6-4 所示）。

图 6-4 裁切、旋转功能

通过点击界面顶部的“一键美化”、“智能纠偏”（如图 6-5 所示）可对图像进行美化、纠偏和文字识别。

图 6-5 美化、纠偏

点击界面左下角的“另存为”（如图 6-6 所示）会弹出另存为路径的对话

框，可将扫描生成的图像另存到一个目录下。

图 6-6 另存为功能

.文档扫描仪

文档扫描仪，在 V10 上又叫扫描易，在银河麒麟桌面操作系统 V10 版本系统下为预装软件可直接使用，如需在银河麒麟桌面操作系统 V10(SP1)版本系统下使用，需先从软件商店中下载（软件商店中名称为”文档扫描仪”）或从源中获取（源中名称为“simple-scan”）。

打开软件商店，搜索“文档扫描仪”，点击下载

点击左下角“开始菜单”，在“开始菜单”顶部搜索框内输入关键词“文档扫描仪”，点击“文档扫描仪”启动程序（如图 6-7 所示）。

图 6-7 文档扫描仪启动

基本功能

点击界面上方的“三条横杠”后点击“首选项”（如图 6-8 所示）可以选择扫描仪、扫描面、页面大小、扫描清晰度等。

图 6-8 首选项设置

扫描完成后的图片可点击界面下方按键进行重新扫描、旋转、剪切、删除等操作（如图 6-9 所示）。

图 6-9 图片操作

多页扫描（针对 ADF 馈纸式扫描仪）

把需要扫描的所有文件放到扫描仪中,然后点击界面左上方的“下拉小三角” 图标,选择“传送来的所有页面”（如图 6-10 所示）后点击“Scan”开始扫描。

图 6-10 多页扫描

保存文件

点击界面上方“保存”按键（如图 6-11 所示）后可选择保存的路径，在此

界面左下角还可选择保存文件的格式（如图 6-12 所示）。

图 6-11 保存

图 6-12 文件格式

打印功能

点击界面上方的“三条横杠”后点击“Print”（如图 6-13 所示），可将已扫描完成的文件进行快捷打印。

图 6-13 打印

3.XSane

XSane 是一个应用非常广泛且功能强大的扫描程序，具有 GTK +接口，可充当 SANE 的所谓“前端” 。XSane 提供了广泛的预览功能，包括扫描程序的所有典型设置，例如分辨率，颜色数量，直方图，用于改进扫描以及旋转预览和最终扫描的选项。该程序还包括影印功能，例如，多页扫描可以另存为 PDF 文件，或者扫描可以作为电子邮件发送。

XSane 在银河麒麟桌面操作系统 V10 与 V10(SP1)版本系统下均可以使用，需先下载安装。

XSane 下载与安装

软件商店搜索“XSane”,下载

$ sudo apt install xsane

点击左下角“开始菜单”，在“开始菜单”顶部搜索框内输入关键词“XSane”

（如图 6-14 所示）点击“XSane”启动程序，选择已连接的扫描仪点击“确

定”进入程序（如图 6-15 所示）。

图 6-14 XSane 启动

图 6-15 选择扫描仪

多页扫描

在主界面左上方“页数”中输入被扫描文件的页数后即可扫描多页文件。如果扫描单面，页数设置成大于等于扫描的纸张数即可。如果是扫描双面，页数设

置成大于等于扫描的纸张数的 2 倍即可。（如图 6-16 所示）。