217 lines
6.9 KiB
Markdown
217 lines
6.9 KiB
Markdown
|
<!--
|
|||
|
|
SPDX-FileCopyrightText: 2026 Contributors to kyocera-sane
|
|||
|
|
|
|||
|
|
SPDX-License-Identifier: CC0-1.0
|
|||
|
|
-->
|
|||
|
|
|
|||
|
|
# Драйвер Kyocera SANE для Arch Linux
|
|||
|
|
|
|||
|
|
Пакет Arch Linux для проприетарного драйвера сканера Kyocera для SANE.
|
|||
|
|
|
|||
|
|
Пакет перепаковывает Linux-драйвер Kyocera SANE, распространяемый в виде Debian-пакета, и интегрирует его со структурой файловой системы Arch Linux и механизмами управления устройствами.
|
|||
|
|
|
|||
|
|
Kyocera распространяет Linux-драйвер сканера в ZIP-архиве. В официальном разделе загрузок Kyocera для Linux указан драйвер **SANE Driver 2.2.1511**.
|
|||
|
|
|
|||
|
|
## Возможности
|
|||
|
|
|
|||
|
|
Пакет предоставляет следующие SANE-бэкенды Kyocera:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
kyocera
|
|||
|
|
kyocera_gdi_a3
|
|||
|
|
kyocera_wc3
|
|||
|
|
kyocera_wc3_usb
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Конфигурация SANE устанавливается в:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
/etc/sane.d/dll.d/kyocera.conf
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Пакет поддерживает следующие архитектуры x86:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
i386
|
|||
|
|
i486
|
|||
|
|
i586
|
|||
|
|
i686
|
|||
|
|
x86_64
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Архитектурный Debian-пакет, предоставляемый Kyocera, автоматически выбирается при сборке пакета.
|
|||
|
|
|
|||
|
|
## Сканирование по USB
|
|||
|
|
|
|||
|
|
Бэкенд Kyocera SANE требует прямого доступа к USB-устройству через `libusb`.
|
|||
|
|
|
|||
|
|
По этой причине пакет устанавливает:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
/usr/lib/modprobe.d/kyocera-sane.conf
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
со следующим содержимым:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
blacklist usblp
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Это предотвращает захват нужного USB-интерфейса принтера драйвером ядра `usblp`, который необходим бэкенду Kyocera.
|
|||
|
|
|
|||
|
|
Также устанавливается правило udev для USB-устройства Kyocera **FS-1020MFP**:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
/usr/lib/udev/rules.d/71-kyocera-sane.rules
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Правило предоставляет активному пользователю рабочего стола доступ к USB-устройству:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
Vendor ID: 0482
|
|||
|
|
Product ID: 0495
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
без необходимости запускать приложения от имени `root`.
|
|||
|
|
|
|||
|
|
## Установка
|
|||
|
|
|
|||
|
|
Склонируйте репозиторий и соберите пакет с помощью `makepkg`:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://debver.com/debug-version/kyocera-sane.git
|
|||
|
|
cd kyocera-sane
|
|||
|
|
|
|||
|
|
makepkg -si
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Версия пакета автоматически определяется по странице поддержки Kyocera, а не задаётся жёстко в `PKGBUILD`.
|
|||
|
|
|
|||
|
|
После установки перезагрузите правила udev:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
sudo udevadm control --reload-rules
|
|||
|
|
sudo udevadm trigger
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
При необходимости переподключите сканер.
|
|||
|
|
|
|||
|
|
## Проверка SANE-бэкенда
|
|||
|
|
|
|||
|
|
Проверьте наличие конфигурации Kyocera:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cat /etc/sane.d/dll.d/kyocera.conf
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Ожидаемый вывод:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
kyocera
|
|||
|
|
kyocera_gdi_a3
|
|||
|
|
kyocera_wc3
|
|||
|
|
kyocera_wc3_usb
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Затем проверьте, обнаруживает ли SANE сканер:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
scanimage -L
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Для более подробной диагностики:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
SANE_DEBUG_KYOCERA=255 scanimage -L
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Конкретная переменная отладки, поддерживаемая бэкендом Kyocera, может зависеть от версии драйвера.
|
|||
|
|
|
|||
|
|
## Временные файлы
|
|||
|
|
|
|||
|
|
Проприетарный бэкенд Kyocera создаёт временные файлы в жёстко заданном каталоге:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
/usr/local/kyocera/scanner
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Поэтому пакет устанавливает для него права:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
1777
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Это позволяет бэкенду создавать и удалять свои временные файлы, предотвращая при этом удаление файлов, принадлежащих другим пользователям.
|
|||
|
|
|
|||
|
|
## Изменения правил udev
|
|||
|
|
|
|||
|
|
Оригинальный пакет Kyocera содержит следующее правило udev:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
/etc/udev/rules.d/40-scanner-permissions.rules
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Пакет не устанавливает это правило как есть, поскольку оно назначает права `0666` всем USB-устройствам.
|
|||
|
|
|
|||
|
|
Вместо этого исходное правило сохраняется в качестве документации:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
/usr/share/doc/kyocera-sane/40-scanner-permissions.rules
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
и устанавливается отдельное правило только для поддерживаемого сканера Kyocera.
|
|||
|
|
|
|||
|
|
## Устанавливаемые файлы
|
|||
|
|
|
|||
|
|
Пакет устанавливает или изменяет следующие важные пути:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
/etc/sane.d/dll.d/kyocera.conf
|
|||
|
|
/usr/lib/modprobe.d/kyocera-sane.conf
|
|||
|
|
/usr/lib/udev/rules.d/71-kyocera-sane.rules
|
|||
|
|
/usr/local/kyocera/scanner
|
|||
|
|
/usr/share/doc/kyocera-sane/README.txt
|
|||
|
|
/usr/share/doc/kyocera-sane/40-scanner-permissions.rules
|
|||
|
|
/usr/share/licenses/kyocera-sane/COPYRIGHT
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Документация из исходного пакета устанавливается в `/usr/share/doc/kyocera-sane/README.txt`.
|
|||
|
|
|
|||
|
|
## Примечания по упаковке
|
|||
|
|
|
|||
|
|
Этот репозиторий не содержит собственной реализации бэкенда сканера Kyocera. Он упаковывает проприетарный драйвер Kyocera, предоставляемый производителем.
|
|||
|
|
|
|||
|
|
Исходный пакет загружается с официальной инфраструктуры Kyocera во время сборки Arch-пакета.
|
|||
|
|
|
|||
|
|
В `PKGBUILD` пакет помечен как проприетарный:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
license=('LicenseRef-proprietary')
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Источник
|
|||
|
|
|
|||
|
|
Kyocera Document Solutions — поддержка продуктов и загрузки:
|
|||
|
|
|
|||
|
|
https://www.kyoceradocumentsolutions.eu/
|
|||
|
|
|
|||
|
|
Linux SANE-драйвер распространяется Kyocera в виде ZIP-архива, содержащего Debian-пакеты для отдельных архитектур.
|
|||
|
|
|
|||
|
|
## Структура репозитория
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
kyocera-sane/
|
|||
|
|
├── PKGBUILD
|
|||
|
|
└── kyocera-sane.install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Лицензия
|
|||
|
|
|
|||
|
|
Пакет содержит проприетарное программное обеспечение, распространяемое Kyocera.
|
|||
|
|
|
|||
|
|
Информацию об авторских правах и лицензии исходного ПО см. в установленном файле:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
/usr/share/licenses/kyocera-sane/COPYRIGHT
|
|||
|
|
```
|