<!--
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
```