owcapi - Online en la nube

PROGRAMA:

NOMBRE

ocapi - Interfaz sencilla de 1 cable en lenguaje C

SINOPSIS

libowcapi biblioteca para vincular con su programa

Inicialización
talla_t OW_init ( dispositivo nombre or ser completados parámetro cadena )
talla_t OW_init_args ( int argc, tanque ** args )

El conjunto completo de opciones de inicialización es extenso. Corresponden aproximadamente a la
opciones de línea de comando de ay (1) owhttpd (1) owftpd (1)

Recibe datos
int OW_present ( const tanque * camino )
int OW_get ( const tanque * camino, tanque ** buffer, tamaño_t * longitud_búfer )
talla_t OW_lread ( const tanque * camino, no firmado tanque * buffer, const tamaño_t XNUMX participantes const
apagado_t compensar )

Set datos
talla_t OW_put ( const tanque * camino, const tanque * buffer, tamaño_t * longitud_búfer )
talla_t OW_lwrite ( const tanque * camino, const no firmado tanque * buffer, const tamaño_t XNUMX participantes
const apagado_t compensar )

Depurar
vacío OW_set_error_level ( const tanque * param )
vacío OW_set_error_print ( const tanque * param )

Cerrar
vacío OW_finish ( vacío )

Las funciones

OW_init
OW_init_cadena ofrece toda la flexibilidad del ay (1) owhttpd (1) línea de comando.

Argumentos
Puede ser tan simple como el nombre del dispositivo, una especificación de parámetros completa. Uno o
más nombres de dispositivos (incluye tcp, serial, usb ...) e interruptores de línea de comando. Ver
ay (1) para obtener una sintaxis completa.

Returns
0 para el éxito. -1 en caso de error y error se establecerá. OW_terminar no necesita ser
llamado si OW_init falla.

Secuencia
El init las funciones deben llamarse antes de acceder al bus de 1 hilo.
OW_terminar es opcional.

OW_init_args
OW_init_args ofrece toda la flexibilidad del ay (1) owhttpd (1) línea de comando.

Argumentos
Uno o más nombres de dispositivo (incluye tcp, serial, usb ...) e interruptores de línea de comando.
See ay (1) para obtener una sintaxis completa. diferente a OW_init_cadena los argumentos están en argv / argc
formato.

Returns
0 para el éxito. -1 en caso de error y error se establecerá. OW_terminar no necesita ser
llamado si OW_init falla.

Secuencia
El init las funciones deben llamarse antes de acceder al bus de 1 hilo.
OW_terminar es opcional.

OW_presente
OW_presente se utiliza para comprobar la presencia de un dispositivo de 1 cable.

Argumentos
camino es la ruta al directorio o archivo (propiedad).

Returns
0 en caso de éxito. -1 en caso de error (y error Está establecido).

Secuencia
El init las funciones deben llamarse antes de acceder al bus de 1 hilo.
OW_terminar es opcional.

OW_obtener
OW_obtener se utiliza para obtener listados de directorios y contenido de archivos. Los resultados se ponen en un
búfer asignado dinámicamente.

Argumentos
camino es la ruta al directorio o archivo (propiedad). *buffer devuelve un puntero a
un búfer que contiene el directorio (separado por comas) o el valor. longitud_búfer
devuelve la longitud del valor / cadena en buffer

Returns
número de bytes en caso de éxito. -1 en caso de error (y error Está establecido).

Secuencia
El init las funciones deben llamarse antes de acceder al bus de 1 hilo.
OW_terminar es opcional.

Importante: nota
buffer es asignado (con malloc) por OW_obtener pero debe ser liberado en su programa.
See malloc (3) gratuita, (3)

OW_lread
OW_lread se utiliza para leer chips de memoria de 1 cable. Piense en ello como una combinación de buscar
read Permite el acceso aleatorio a la memoria, especificando ubicación y longitud. diferente a OW_obtener
los directorios no se pueden obtener y el búfer debe estar preasignado en lugar de asignado
por la rutina. buffer debe ser por lo menos tamaño longitud.

Argumentos
camino es la ruta al archivo (propiedad). buffer es el área de memoria (preasignada)
donde se colocará el valor. tamaño es la longitud de bytes solicitados. compensar is
la posición en el archivo para comenzar a leer.

Returns
número de bytes en caso de éxito. -1 en caso de error (y error Está establecido).

Secuencia
El init las funciones deben llamarse antes de acceder al bus de 1 hilo.
OW_terminar es opcional.

OW_poner
OW_poner es una forma fácil de escribir en chips de 1 cable.

Argumentos
camino es la ruta al archivo (propiedad). buffer es el valor a escribir.
longitud_búfer es la longitud del valor tampón. Returns número de bytes en
éxito. -1 en caso de error (y error Está establecido).

Secuencia
El init las funciones deben llamarse antes de acceder al bus de 1 hilo.
OW_terminar es opcional.

OW_escribir
OW_escribir es el compañero de OW_lread. Permite escribir en posiciones arbitrarias en
Memoria de 1 hilo. Piense en ello como una combinación de buscar escribir. buffer debe ser por lo menos
tamaño longitud.

Argumentos
camino es la ruta al archivo (propiedad). buffer son los datos que se escribirán. tamaño
es la longitud de bytes que se escribirán. compensar es la posición en el archivo para comenzar
escritura.

Returns
número de bytes en caso de éxito. -1 en caso de error (y error Está establecido).

Secuencia
El init las funciones deben llamarse antes de acceder al bus de 1 hilo.
OW_terminar es opcional.

OW_establecer_nivel_error
OW_establecer_nivel_error establece la salida de depuración a un cierto nivel. 0 es el predeterminado y superior
el valor da más salida.
(0 = predeterminado, 1 = err_connect, 2 = err_call, 3 = err_data, 4 = err_detail, 5 = err_debug,
6 = err_beyond)

Argumentos
params es el nivel. Debe ser un número entero.

Returns
Ninguna

Secuencia
El init Las funciones deben llamarse antes de configurar el nivel, ya que init
predeterminado al nivel 0.

OW_set_error_imprimir
OW_set_error_imprimir establece dónde debe dirigirse la salida de depuración. 0 = salida mixta,
1 = syslog, 2 = consola.

Argumentos
params es el nivel. Debe ser un número entero entre 0 y 2.

Returns
Ninguna

Secuencia
El init Las funciones deben llamarse antes de configurar el nivel, ya que init
por defecto es 0 (salida mixta).

OW_terminar
OW_terminar limpia el OWFS Rutinas de 1 cable, dispositivos de liberación y memoria.

Argumentos
Ninguna.

Returns
Ninguna

Secuencia
OW_terminar es opcional ya que la limpieza es automática al salir del programa.

DESCRIPCIÓN

1-Wire
Cable 1 es un protocolo de cableado y una serie de dispositivos diseñados y fabricados por Dallas
Semiconductor, Inc. El bus es un esquema de conector de baja velocidad y baja potencia donde los datos
La línea también puede proporcionar energía.

Cada dispositivo se numera de forma única e inalterable durante la fabricación. Hay una amplia
variedad de dispositivos, incluyendo memoria, sensores (humedad, temperatura, voltaje, contacto,
actual), interruptores, temporizadores y registradores de datos. Dispositivos más complejos (como termopar
sensores) se pueden construir con estos dispositivos básicos. También hay dispositivos de 1 cable que tienen
cifrado incluido.

El esquema de 1 cable utiliza un solo horarios dominar y múltiple esclavos en el mismo cable. El autobús
el maestro inicia todas las comunicaciones. Los esclavos pueden ser descubiertos individualmente y
direccionado utilizando su identificación única.

Los maestros de bus vienen en una variedad de configuraciones que incluyen serie, paralelo, i2c, red
o adaptadores USB.

OWFS personalizable
OWFS es un conjunto de programas diseñado para hacer que el bus de 1 cable y sus dispositivos sean fáciles
accesible. El principio subyacente es crear un sistema de archivos virtual, con la identificación única
siendo el directorio, y las propiedades individuales del dispositivo se representan como simples
archivos que se pueden leer y escribir.

Los detalles del diseño esclavo o maestro individual se ocultan detrás de una interfaz coherente.
El objetivo es proporcionar un conjunto sencillo de herramientas para que un diseñador de software cree
o aplicaciones de control. Hay algunas mejoras de rendimiento en la implementación,
incluido el almacenamiento en caché de datos, el acceso paralelo a los maestros de bus y la agregación de dispositivos
comunicación. Aún así, el objetivo fundamental ha sido la facilidad de uso, la flexibilidad y
corrección en lugar de velocidad.

libowcapi
libowcapi (1) es una encapsulación de la completa libow biblioteca para programas C.

libowcapi (1) permite que un programa en C utilice OWFS principios (esquema de nomenclatura coherente,
múltiples adaptadores, dispositivos y compatibilidad) directamente desde un programa C. Existen
módulos análogos para otros lenguajes de programación:

C libowcapi

perl búho

php owphp

pitón owpython

TCL owtcl

EJEMPLO

/ * Listado de directorios simple - sin verificación de errores * /
#incluir
char * buf sin firmar;
size_t s;
OW_init ("/ dev / ttyS0");
OW_set_error_print ("2");
OW_set_error_level ("6");
OW_get ("/", & buf, & s);
printf ("Directorio% s0, buf);
libre (buf);
OW_finish ();

Utilice owcapi en línea utilizando los servicios de onworks.net