user
29c77a98fa
Add comprehensive documentation for the Kyocera SANE driver package in English and Russian.
6.9 KiB
Драйвер 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:
kyocera
kyocera_gdi_a3
kyocera_wc3
kyocera_wc3_usb
Конфигурация SANE устанавливается в:
/etc/sane.d/dll.d/kyocera.conf
Пакет поддерживает следующие архитектуры x86:
i386
i486
i586
i686
x86_64
Архитектурный Debian-пакет, предоставляемый Kyocera, автоматически выбирается при сборке пакета.
Сканирование по USB
Бэкенд Kyocera SANE требует прямого доступа к USB-устройству через libusb.
По этой причине пакет устанавливает:
/usr/lib/modprobe.d/kyocera-sane.conf
со следующим содержимым:
blacklist usblp
Это предотвращает захват нужного USB-интерфейса принтера драйвером ядра usblp, который необходим бэкенду Kyocera.
Также устанавливается правило udev для USB-устройства Kyocera FS-1020MFP:
/usr/lib/udev/rules.d/71-kyocera-sane.rules
Правило предоставляет активному пользователю рабочего стола доступ к USB-устройству:
Vendor ID: 0482
Product ID: 0495
без необходимости запускать приложения от имени root.
Установка
Склонируйте репозиторий и соберите пакет с помощью makepkg:
git clone https://debver.com/debug-version/kyocera-sane.git
cd kyocera-sane
makepkg -si
Версия пакета автоматически определяется по странице поддержки Kyocera, а не задаётся жёстко в PKGBUILD.
После установки перезагрузите правила udev:
sudo udevadm control --reload-rules
sudo udevadm trigger
При необходимости переподключите сканер.
Проверка SANE-бэкенда
Проверьте наличие конфигурации Kyocera:
cat /etc/sane.d/dll.d/kyocera.conf
Ожидаемый вывод:
kyocera
kyocera_gdi_a3
kyocera_wc3
kyocera_wc3_usb
Затем проверьте, обнаруживает ли SANE сканер:
scanimage -L
Для более подробной диагностики:
SANE_DEBUG_KYOCERA=255 scanimage -L
Конкретная переменная отладки, поддерживаемая бэкендом Kyocera, может зависеть от версии драйвера.
Временные файлы
Проприетарный бэкенд Kyocera создаёт временные файлы в жёстко заданном каталоге:
/usr/local/kyocera/scanner
Поэтому пакет устанавливает для него права:
1777
Это позволяет бэкенду создавать и удалять свои временные файлы, предотвращая при этом удаление файлов, принадлежащих другим пользователям.
Изменения правил udev
Оригинальный пакет Kyocera содержит следующее правило udev:
/etc/udev/rules.d/40-scanner-permissions.rules
Пакет не устанавливает это правило как есть, поскольку оно назначает права 0666 всем USB-устройствам.
Вместо этого исходное правило сохраняется в качестве документации:
/usr/share/doc/kyocera-sane/40-scanner-permissions.rules
и устанавливается отдельное правило только для поддерживаемого сканера Kyocera.
Устанавливаемые файлы
Пакет устанавливает или изменяет следующие важные пути:
/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 пакет помечен как проприетарный:
license=('LicenseRef-proprietary')
Источник
Kyocera Document Solutions — поддержка продуктов и загрузки:
https://www.kyoceradocumentsolutions.eu/
Linux SANE-драйвер распространяется Kyocera в виде ZIP-архива, содержащего Debian-пакеты для отдельных архитектур.
Структура репозитория
kyocera-sane/
├── PKGBUILD
└── kyocera-sane.install
Лицензия
Пакет содержит проприетарное программное обеспечение, распространяемое Kyocera.
Информацию об авторских правах и лицензии исходного ПО см. в установленном файле:
/usr/share/licenses/kyocera-sane/COPYRIGHT