~ubuntu-branches/ubuntu/intrepid/kdebluetooth/intrepid-proposed

<sect1 id="components.othertools">

<title

>Ferramentas Adicionais de Integração e de Linha de Comando</title>

<para

>Esta secção lista todas as outras pequenas ferramentas e 'scripts' que vêm com o kdebluetooth. A maior parte delas tem por si só uma utilidade limitada, mas destinam-se a ser chamadas de 'scripts' ou de outros programas. </para>

 

<sect2 id="components.othertools.kioclient">

<title

>kioclient: Acesso por 'scripts' ao 'framework' KIO</title>

<para

>Este é um pequeno utilitário para aceder a 'kioslaves' da linha de comandos. Portanto o <command

>kioclient</command

> é um utilitário de utilidade geral, mas uma vez que não existia teve que ser programado. </para>

<para

>Com o <command

>kioclient</command

> pode copiar, listar ou apagar qualquer ficheiro sou pasta acessível através da Infra-estrutura KIO do KDE. Pode copiar um ficheiro de um servidor FTP directamente para ouro servidor utilizando WebDAV ou listar uma pasta via SSH com o kio_fish. Ou - e é aqui que isto se torna interessante para nós - pode aceder a ficheiro no seu telemóvel com o kio_obex. O kioclient é utilizando pelo 'script' exemplo que vem com o kbluetoothd: o 'script' <command

>copy_images</command

>. </para>

<para

>Pode obter uma lista de possíveis argumentos com <command

>kioclient --help</command

>, por isso segue-se apenas alguns exemplos: <screen

>$ kioclient cat http://www.kde.org | head -1

&lt;?xml version="1.0" encoding="UTF-8"?>

$ kioclient ls -s ftp://ftp.kde.org | head -4

     4096 .

     4096 ..

     4096 bin

     4096 dev

$ kioclient ls bluetooth:/

local system

Fred's 6230

Fred's 3650

$ kioclient ls "sdp://Fred's 6230/"

OBEX Object Push

OBEX File Transfer

Dial-up networking

Nokia PC Suite

COM 1

Voice Gateway

Audio Gateway

SIM ACCESS

.More Services

$

</screen>

</para>

<para

>Repare que o kioclient - embora seja um programa de linha de comandos - precisa de ser corrido de dentro do KDE, por isso não o pode utilizar, por exemplo, em trabalhos de cron. Mas esta limitação não se aplica quando o utiliza em 'scripts' de descoberta no kbluetoothd. </para>

 

</sect2>

 

<sect2>

<title

>kbtsearch: Procura por dispositivos a partir de 'scripts'</title>

<para

>Tal como o <command

>kioclient</command

> ou o <command

>kdialog</command

> do KDE, esta é uma ferramenta de linha de comando que pode ser utilizada em 'scripts'. Dá uma interface de linha de comandos às duas janelas de procura mais comuns do kdebluetooth - a procura de dispositivos e a procura de serviços. </para>

<para

>Pode utilizá-lo quando quiser que o utilizador seleccione um dispositivo bluetooth ou um serviço específico de um dos dispositivos ao seu alcance. Tal como em todos os lados, a janela de escolha de serviço recorda os dispositivos encontrados e preenche imediatamente a lista com as entradas encontradas anteriormente. Os serviços actualmente disponíveis são adicionados à lista após alguns segundos. </para>

<para

>Para procura por um dispositivo, escreva <command

>kbtsearch --device</command

>. Quando o utilizador escolheu um dispositivo ou inseriu um endereço, e carregou em <guibutton

>OK</guibutton

>, o kbtsearch irá imprimir o endereço do dispositivo para o stdout e sair com o estado 0. Se o utilizador carregar em <guibutton

>Cancelar</guibutton

>, nada é escrito e o código de estado devolvido é 1: <screen

>$ if ADDR=$(kbtsearch --device) ;

 

> then echo "Endereço seleccionado: $ADDR.";

 

> else echo "Nenhum endereço seleccionado."; fi

Endereço seleccionado: 00:60:57:5C:E6:BD.

$

</screen>

</para>

<para

>Também pode procurar por um dispositivo que implemente um dado perfil Bluetooth com <command

>kbtsearch --uuid &lt;UUID-do-Serviço

></command

>. Para uma lista completa de UUIDs possível no perfil Bluetooth normal, veja os <ulink url="https://www.bluetooth.org/foundry/assignnumb/document/service_discovery"

>'Bluetooth Assigned Numbers (SDP)'</ulink

>. kbtsearch também define alguns nomes alternativos para os perfis mais utilizados. Execute <command

>kbtsearch --aliases</command

> para obter uma lista de nomes possíveis. </para>

<para

>Quando o utilizador seleccione um serviço e carrega em <guibutton

>OK</guibutton

>, o kbtsearch devolve 0 e imprime uma linha no formato '[address] [rfcommchannel]'. É claro que isto só faz sentido para serviços que define um canal rfcomm. Actualmente não há maneira de obter, por exemplo, um PSM de L2CAP. Se precisar contacte-me. <screen>

$ if RET=( $(kbtsearch --uuid=FAX) ) ; 

 

> then ADDRESS=${RET[0]}; CHANNEL=${RET[1]}; 

 

> echo "Seleccionado endereço=$ADDRESS, canal=$CHANNEL."; 

 

> else echo "Nenhum serviço seleccionado."; 

 

> fi

Seleccionado endereço=00:60:57:5C:E6:BD, canal=1.

$

</screen

> Para mais opções veja <command

>kbtsearch --help</command

>. </para>

</sect2>

 

<sect2>

<title

>kbtfax: Enviar mensagens de fax messages com aplicações KDE</title>

<para

>Este 'script' torna mais fácil o envio de faxes de qualquer aplicação KDE. Depende de <command

>efax</command

> (pacote externo), <command

>kdeprintfax</command

> e <command

>kdesu</command

> (ambos parte do kdebase) e a ferramenta <command

>rfcomm</command

> (parte do bluez-utils). </para>

<para

>Quando envia um fax com o <command

>kdeprintfax</command

> pode seleccionar a infra-estrutura a utilizar. Um opção é "EFax", outra "Outra". Seleccione "Outra", e depois procura o 'script' kbtfax na instalação do kdebluetooth. Indique a linha de comando tal como indicada no 'script'. Já está. Há no entanto muitas coisas que podem correr mal. Esteja à vontade para melhorar o 'script' e enviar correcções :) </para>

</sect2>

 

</sect1>