Beyond Linux® From Scratch (Edição systemd ) - Versão 13.0

Capítulo 47. Digitalizando

SANE-1.4.0

Introdução ao SANE

SANE é a abreviação de Scanner Access Now Easy. O acesso à digitalizadora, entretanto, está longe de ser fácil, já que cada fornecedor(a) tem os próprios protocolos deles(as). O único protocolo conhecido que deveria trazer alguma unidade a esse caos é a interface TWAIN, mas isso é muito impreciso para permitir uma estrutura de digitalização estável. Portanto, SANE vem com o próprio protocolo dele e os controladores do(a) fornecedor(a) não podem ser usados.

SANE é dividido em estruturas de retaguarda e estruturas de interação direta com o(a) usuário(a). As estruturas de retaguarda são controladores para as digitalizadoras e câmeras suportadas. As estruturas de interação direta com o(a) usuário(a) são interfaces de usuário(a) para acessar as estruturas de retaguarda.

[Nota]

Nota

Esse pacote é conhecido por construir e funcionar adequadamente usando-se uma plataforma LFS 13.0.

Informações do Pacote de Estruturas de Retaguarda

  • Transferência (HTTP): https://anduin.linuxfromscratch.org/BLFS/sane/sane-backends-1.4.0.tar.gz

  • Transferência (FTP):

  • Soma de verificação MD5 da transferência: fddb8b164ff1b1ffb576c9ba4173610d

  • Tamanho da transferência: 7,2 MB

  • Espaço em disco estimado exigido: 214 MB (Adicionar 58 MB para testes)

  • Tempo de construção estimado: 0,4 UPC (Usando paralelismo=4; adicionar 0,1 UPC para testes)

[Nota]

Nota

O local do fluxo de desenvolvimento para esse arquivo está em https://gitlab.com/sane-project, mas o URL do arquivo usa uma soma de verificação MD5 incorporada. Por conveniência, o pacote foi copiado para o local acima.

Dependências do SANE

Opcionais

Avahi-0.8, Cups-2.4.16, libjpeg-turbo-3.1.3, libtiff-4.7.1, libusb-1.0.29, v4l-utils-1.32.0, Net-SNMP, libieee1284, libgphoto2 e texlive-20250308 (ou install-tl-unx)

Configuração do Núcleo, Controladores e Pacotes Adicionais

Para acessar tua digitalizadora, você provavelmente precisará dos controladores de núcleo relacionados e (ou) pacotes adicionais de suporte. Uma digitalizadora SCSI precisará de controladores SCSI; uma digitalizadora de porta paralela precisa de suporte a porta paralela (você deveria usar modos EPP aprimorados) e talvez libieee1284, e uma digitalizadora USB precisará do pacote libusb-1.0.29. Para dispositivos HP, você possivelmente precise do hplip. Certifique-se de ter os controladores necessários configurados corretamente para acessar os dispositivos.

Instalação do SANE

Instalação do SANE Backends

O processo de segundo plano do SANE deveria executar com o próprio grupo dele. Crie esse grupo emitindo o seguinte comando como o(a) usuário(a) root: 

groupadd -g 70 scanner
[Nota]

Nota

configure assume que o(a) usuário(a) construindo estruturas de retaguarda do SANE é um(a) membro(a) do grupo scanner para testar a existência desse grupo. Como resultado, o(a) usuário(a) construindo o pacote precisa ser adicionado(a) ao grupo scanner. Adicione o(a) usuário(a) ao grupo scanner emitindo o seguinte comando como o(a) usuário(a) root: 

usermod -G scanner -a nome_usuário(a)

Depois de adicionar o grupo scanner como acima, você precisará sair e entrar novamente para ativá-lo.

Para uma digitalizadora USB, se você estiver vinculando ao libusb-1.0.29, inclua a chave de configuração --enable-libusb_1_0. Instale as estruturas de retaguarda do SANE executando os seguintes comandos: 

sg scanner -c "                                 \
PYTHON=python3 ./configure --prefix=/usr        \
                           --sysconfdir=/etc    \
                           --localstatedir=/var \
                           --with-lockdir=/run/lock \
                           --docdir=/usr/share/doc/sane-backends-1.4.0" &&
make

Para testar os resultados, emita: make check.

Agora, como o(a) usuário(a) root: 

make install                                         &&
install -m 644 -v tools/udev/libsane.rules           \
                  /etc/udev/rules.d/65-scanner.rules &&
mkdir -p          /run/lock/sane &&
chgrp -v scanner  /run/lock/sane

Com a digitalizadora ligada, execute scanimage -L e o nome e local do dispositivo deveriam aparecer. Claro, você precisa dos controladores de dispositivo configurados para a finalidade de executar esse teste.

Explicações do Comando

sg scanner -c "...": executa o comando entre aspas duplas com o grupo principal scanner. Isso possivelmente seja necessário se o(a) usuário(a) tiver sido adicionado(a) recentemente ao grupo scanner e não tiver feito logout e login.

PYTHON=python3: Essa chave força o sistema de construção a usar Python 3 em vez de Python 2.

--sysconfdir=/etc: Essa chave instala os arquivos de configuração em /etc/sane.d em vez de /usr/etc/sane.d.

Configurando o SANE

Arquivos de Configuração

/etc/sane.d/*.conf

Informação de Configuração

Configuração da Estrutura de Retaguarda

Os arquivos de configuração de estrutura de retaguarda estão localizados em /etc/sane.d. Informações para configurar as várias estruturas de retaguarda podem ser encontradas usando-se a página de manual(5) para a estrutura de retaguarda desejada. Execute man sane-<estrutura de retaguarda>, substituindo a estrutura de retaguarda desejada.

Adicione quaisquer usuários(as) que usarão uma escaneadora ao grupo scanner.

[Nota]

Nota

Se você planeja usar o cliente escaneador Simple-scan-49.1 para acessar um escaneador na rede de intercomunicação, como uma impressora/escaneadora multifuncional, possivelmente nenhuma configuração seja necessária. Tente isso primeiro.

Se você quiser acessar uma digitalizadora na rede de intercomunicação, inclua duas linhas em net.conf, como usuário(a) root (certifique-se de substituir <ip_servidor> pelo valor atual): 

cat >> /etc/sane.d/net.conf << "EOF"
connect_timeout = 60
<ip_servidor>
EOF

No lado do servidor, inclua o IP do cliente na lista de acesso de /etc/sane.d/saned.conf, reinicie o processo de segundo plano saned e certifique-se de que o firewall, se houver, está aberto ao cliente.

Informação Geral

Para informações gerais acerca de como configurar e usar o SANE, veja-se man sane. Para informações acerca de dispositivos USB de digitalização, execute man sane-usb. Para informações relativas a dispositivos SCSI, execute man sane-scsi.

Configuração e instalação do processo de segundo plano 'saned'

O processo de segundo plano saned não é destinado a ser usado por clientes não confiáveis. Você deveria fornecer proteção Técnicas de Firewall para garantir que somente clientes confiáveis acessem o processo de segundo plano. Devido aos complexos requisitos de segurança para garantir que somente clientes confiáveis acessem o processo de segundo plano, o BLFS não fornece instruções para configurar o processo de segundo plano saned. Algumas informações boas (mas desatualizadas) para configurar e proteger o processo de segundo plano saned podem ser encontradas em https://penguin-breeder.org/sane/saned/.

Conteúdo

Aplicativos Instalados: gamma4scanimage, sane-config, saned, sane-find-scanner, scanimage e umax_pp
Bibliotecas Instaladas: libsane.so e numerosos módulos de estrutura de retaguarda da digitalizadora
Diretórios Instalados: /etc/sane.d, /usr/{include,lib,share}/sane e /usr/share/doc/sane-1.4.0

Descrições Curtas

gamma4scanimage

cria uma tabela gama no formato esperado pelo scanimage

sane-config

é uma ferramenta usada para determinar os sinalizadores do compilador e do vinculador que deveriam ser usados para compilar e vincular o SANE

saned

é o processo de segundo plano do SANE que permite que clientes remotos acessem dispositivos de aquisição de imagens disponíveis no dispositivo local

sane-find-scanner

é uma ferramenta de linha de comando para localizar digitalizadoras SCSI e USB e determinar os arquivos de dispositivos delas. O objetivo principal dela é o de garantir que as digitalizadoras possam ser detectadas pelas estruturas de retaguarda do SANE

scanimage

é uma interface de linha de comando para digitalização a partir de dispositivos de aquisição de imagens, como digitalizadoras de mesa ou câmeras. Também é usada para listar os dispositivos de estrutura de retaguarda disponíveis

umax_pp

é uma ferramenta usada para ler informações oriundas de digitalizadoras de porta paralela UMAX. Ela também pode ser usada para realizar diagnósticos nessas digitalizadoras

libsane.so

é a interface de programação de aplicativos usada para comunicação entre estruturas de interação direta com o(a) usuário(a) e estruturas de retaguarda

libsane-*.so

módulos são plug-ins de estrutura de retaguarda de biblioteca de digitalização usados para interfacear com dispositivos de digitalização. Veja-se http://www.sane-project.org/sane-supported-devices.html para uma lista de estruturas de retaguarda suportadas