libownet - Online na nuvem

PROGRAMA:

NOME

proprietário , (libobnet) - interface de 1 fio em linguagem C fácil para o protocolo owserver

SINOPSE

libownet biblioteca para vincular ao seu programa

Handle
OWNET_HANDLE
Identificador para cada conexão do owserver

Inicialização
OWNET_HANDLE OWNET_init ( const carbonizar * owserver_tcp_address_and_port )
Associar um servidor (1) endereço TCP / IP com um identificador.

Diretório listagem
int OWNET_dirlist ( OWNET_HANDLE owserver_handle , const carbonizar * onewire_path , carbonizar **
lista_separada por vírgula )
Crie uma lista separada por vírgulas de elementos de diretório.

int OWNET_dirprocess ( OWNET_HANDLE owserver_handle , const carbonizar * onewire_path , anular (*
função diurna ) (vazio *, const carbonizar *), anular * passou_on_valor )
anular função diurna ( anular * passou_on_valor , const carbonizar * elemento_diretório )
Aplicar função função diurna para cada elemento do diretório, junto com um valor arbitrário passado_on_valor.

Get dados,
int OWNET_read ( OWNET_HANDLE owserver_handle , const carbonizar * onewire_path , const carbonizar **
string_retorno )
Leia um valor (de tamanho especificado) de um dispositivo de 1 fio.

int OWNET_lread ( OWNET_HANDLE owserver_handle , const carbonizar * onewire_path , const carbonizar **
string_retorno , tamanho_t tamanho , desligado_t compensar )
Leia um valor (de tamanho e deslocamento especificados) de um dispositivo de 1 fio.

int OWNET_present ( OWNET_HANDLE owserver_handle , const carbonizar * onewire_path )
Verifique se um dispositivo de 1 fio está presente.

Conjunto dados,
int OWNET_put ( OWNET_HANDLE owserver_handle , const carbonizar * onewire_path , const carbonizar *
valor_string , tamanho_t tamanho )
Grave um valor (de tamanho especificado) em um dispositivo de 1 fio.

int OWNET_lwrite ( OWNET_HANDLE owserver_handle , const carbonizar * onewire_path , const carbonizar *
valor_string , tamanho_t tamanho , desligado_t compensar )
Grave um valor (de tamanho e deslocamento especificados) em um dispositivo de 1 fio.

Fechar
anular OWNET_close ( OWNET_HANDLE owserver_handle )
Feche a conexão com um owserver específico.

anular OWNET_closeall ( anular )
Feche todas as conexões do owserver abertas.

anular OWNET_finish ( anular )
Feche todas as conexões do owserver abertas e libere toda a memória.

Temperatura escada
anular OWNET_set_temperature_scale ( carbonizar temperatura_escala )
carbonizar OWNET_get_temperature_scale ( anular )
Defina e recupere a escala de temperatura usada para todas as comunicações.

dispositivo formato
anular OWNET_set_device_format ( const carbonizar * formato_do_dispositivo )
const carbonizar * OWNET_get_device_format ( anular )
Defina e recupere o formato do número de série do dispositivo de 1 fio usado para todas as comunicações.

FUNÇÕES

OW_init
OW_init_string oferece toda a flexibilidade do Owfs (1) e ohttpd (1) linha de comando.

Argumentos
Pode ser tão simples quanto apenas o nome do dispositivo, uma especificação de parâmetro completa. Um ou
mais nomes de dispositivos (inclui tcp, serial, usb ...) e opções de linha de comando. Ver
Owfs (1) para sintaxe completa.

Returns
0 para sucesso. -1 em caso de erro e erro será definido. OW_finish não precisa ser
chamado se OW_init falha.

Seqüência
Um dos o init as funções devem ser chamadas antes de acessar o barramento de 1 fio.
OW_finish é opcional.

OW_init_args
OW_init_args oferece toda a flexibilidade do Owfs (1) e ohttpd (1) linha de comando.

Argumentos
Um ou mais nomes de dispositivos (inclui tcp, serial, usb ...) e opções de linha de comando.
See Owfs (1) para sintaxe completa. diferente OW_init_string os argumentos estão em argv / argc
formato.

Returns
0 para sucesso. -1 em caso de erro e erro será definido. OW_finish não precisa ser
chamado se OW_init falha.

Seqüência
Um dos o init as funções devem ser chamadas antes de acessar o barramento de 1 fio.
OW_finish é opcional.

OW_get
OW_get é usado para obter listagens de diretório e conteúdo de arquivo. Os resultados são colocados em um
buffer alocado dinamicamente.

Argumentos
caminho é o caminho para o diretório ou arquivo (propriedade). *amortecedor retorna um ponteiro para
um buffer contendo o diretório (separado por vírgulas) ou valor. comprimento_buffer
retorna o comprimento do valor / string em amortecer

Returns
número de bytes em caso de sucesso. -1 em caso de erro (e erro está definido).

Seqüência
Um dos o init as funções devem ser chamadas antes de acessar o barramento de 1 fio.
OW_finish é opcional.

importante nota
amortecer é alocado (com malloc) por OW_get mas deve ser liberado em seu programa.
See Malloc (3) e sem (3)

OW_lread
OW_lread é usado para ler chips de memória de 1 fio. Pense nisso como uma combinação de procurar e
ler Permite acesso aleatório à memória, especificando localização e comprimento. diferente OW_get
diretórios não podem ser obtidos e o buffer deve ser pré-alocado em vez de alocado
pela rotina. amortecer deve ser pelo menos tamanho comprimento.

Argumentos
caminho é o caminho para o arquivo (propriedade). amortecer é a área de memória (pré-alocada)
onde o valor será colocado. tamanho é o comprimento dos bytes solicitados. compensar is
a posição no arquivo para iniciar a leitura.

Returns
número de bytes em caso de sucesso. -1 em caso de erro (e erro está definido).

Seqüência
Um dos o init as funções devem ser chamadas antes de acessar o barramento de 1 fio.
OW_finish é opcional.

OW_put
OW_put é uma maneira fácil de gravar em chips de 1 fio.

Argumentos
caminho é o caminho para o arquivo (propriedade). amortecer é o valor a ser escrito.
comprimento_buffer é o comprimento do valor tampão. Returns número de bytes em
sucesso. -1 em caso de erro (e erro está definido).

Seqüência
Um dos o init as funções devem ser chamadas antes de acessar o barramento de 1 fio.
OW_finish é opcional.

OW_lwrite
OW_lwrite é o companheiro de OW_lread. Permite escrever em posições arbitrárias em
Memória de 1 fio. Pense nisso como uma combinação de procurar e escrever. amortecer deve ser pelo menos
tamanho comprimento.

Argumentos
caminho é o caminho para o arquivo (propriedade). amortecer são os dados a serem gravados. tamanho
é o comprimento dos bytes a serem gravados. compensar é a posição no arquivo para começar
escrevendo.

Returns
número de bytes em caso de sucesso. -1 em caso de erro (e erro está definido).

Seqüência
Um dos o init as funções devem ser chamadas antes de acessar o barramento de 1 fio.
OW_finish é opcional.

OW_finish
OW_finish limpa o OWFS Rotinas de 1 fio, dispositivos de liberação e memória.

Argumentos
Nenhum.

Returns
nenhum

Seqüência
OW_finish é opcional, pois a limpeza é automática na saída do programa.

DESCRIÇÃO

1-Wire
Fio 1 é um protocolo de fiação e uma série de dispositivos projetados e fabricados por Dallas
Semiconductor, Inc. O barramento é um esquema de conector de baixa velocidade e baixa potência em que os dados
linha também pode fornecer energia.

Cada dispositivo é numerado de forma única e inalterável durante a fabricação. Há uma ampla
variedade de dispositivos, incluindo memória, sensores (umidade, temperatura, tensão, contato,
atual), interruptores, temporizadores e registradores de dados. Dispositivos mais complexos (como termopar
sensores) podem ser construídos com esses dispositivos básicos. Existem também dispositivos de 1 fio que têm
criptografia incluída.

O esquema de 1 fio usa um único ônibus dominar e múltiplos escravos no mesmo fio. O ônibus
o mestre inicia toda a comunicação. Os escravos podem ser descobertos individualmente e
endereçados usando seu ID exclusivo.

Bus masters vêm em uma variedade de configurações, incluindo serial, paralela, i2c, rede
ou adaptadores USB.

OWFS design
OWFS é um conjunto de programas projetado para tornar o barramento de 1 fio e seus dispositivos facilmente
acessível. O princípio subjacente é criar um sistema de arquivos virtual, com o ID exclusivo
sendo o diretório, e as propriedades individuais do dispositivo são representadas como simples
arquivos que podem ser lidos e gravados.

Os detalhes do projeto escravo ou mestre individual estão ocultos por trás de uma interface consistente.
O objetivo é fornecer um conjunto fácil de ferramentas para um designer de software criar um monitoramento
ou aplicativos de controle. Existem algumas melhorias de desempenho na implementação,
incluindo caching de dados, acesso paralelo a bus masters e agregação de dispositivo
comunicação. Ainda assim, o objetivo fundamental tem sido facilidade de uso, flexibilidade e
correção ao invés de velocidade.

libowcapi
libowcapi (1) é um encapsulamento de todo libra biblioteca para programas C.

libowcapi (1) permite que um programa C use OWFS princípios (esquema de nomenclatura consistente,
vários adaptadores, dispositivos e compatibilidade) diretamente de um programa C. Existem
módulos análogos para outras linguagens de programação:

C libowcapi

perl coruja

php owphp

python Owpython

tcl owtcl

EXEMPLO

/ * Lista de diretório simples - sem verificação de erros * /
#incluir
char*buf;
size_t s;
OWNET_init ("localhost: 4304");
OWNET_dirlist ("/", & buf, & s);
printf ("Diretório% s0, buf);
grátis (buf);
OWNET_finish ();

Use libownet online usando serviços onworks.net