libowcapi - En ligne dans le Cloud

PROGRAMME:

Nom

oucapi - interface simple à 1 fil en langage C

SYNOPSIS

libowcapi bibliothèque à lier avec votre programme

Initialisation
taille_t OW_init( dispositif nom or plein paramètre string )
taille_t OW_init_args( int argc, carboniser ** args )

L'ensemble complet des options d'initialisation est vaste. Ils correspondent grosso modo aux
options de ligne de commande de oufs (1) owhttpd (1) et owftpd (1)

Obtenez données,
int OW_présent( const carboniser * chemin )
int OW_get( const carboniser * chemin, carboniser ** tampon, taille_t * longueur_tampon )
taille_t OW_lread( const carboniser * chemin, non signé carboniser * tampon, const taille_t Taille, const
off_t compenser )

complet » données,
taille_t OW_put( const carboniser * chemin, const carboniser * tampon, taille_t * longueur_tampon )
taille_t OW_lwrite( const carboniser * chemin, const non signé carboniser * tampon, const taille_t Taille,
const off_t compenser )

Déboguer
annuler OW_set_error_level( const carboniser *paramètre )
annuler OW_set_error_print( const carboniser *paramètre )

Fermer
annuler OW_finir( annuler )

FONCTIONS

OW_init
OW_init_string offre toute la flexibilité du oufs (1) et owhttpd (1) ligne de commande.

Arguments
Peut être aussi simple que le nom de l'appareil, une spécification complète des paramètres. Un ou
plus de noms de périphériques (y compris tcp, série, usb...) et de commutateurs de ligne de commande. Voir
oufs (1) pour la syntaxe complète.

Retours de produits
0 pour le succès. -1 en cas d'erreur et errno sera mis. OW_finir n'a pas besoin d'être
appelé si OW_init échoue.

Séquence
Un de init les fonctions doivent être appelées avant d'accéder au bus 1 fil.
OW_finir Est facultatif.

OW_init_args
OW_init_args offre toute la flexibilité du oufs (1) et owhttpd (1) ligne de commande.

Arguments
Un ou plusieurs noms de périphérique (y compris tcp, série, usb...) et des commutateurs de ligne de commande.
See oufs (1) pour la syntaxe complète. contrairement à OW_init_string les arguments sont dans argv/argc
le format.

Retours de produits
0 pour le succès. -1 en cas d'erreur et errno sera mis. OW_finir n'a pas besoin d'être
appelé si OW_init échoue.

Séquence
Un de init les fonctions doivent être appelées avant d'accéder au bus 1 fil.
OW_finir Est facultatif.

OW_présent
OW_présent permet de vérifier la présence d'un appareil 1 fil.

Arguments
chemin est le chemin d'accès au répertoire ou au fichier (propriété).

Retours de produits
0 en cas de réussite. -1 en cas d'erreur (et errno est réglé).

Séquence
Un de init les fonctions doivent être appelées avant d'accéder au bus 1 fil.
OW_finir Est facultatif.

OW_get
OW_get est utilisé pour obtenir les listes de répertoires et le contenu des fichiers. Les résultats sont mis dans un
tampon alloué dynamiquement.

Arguments
chemin est le chemin d'accès au répertoire ou au fichier (propriété). *amortir renvoie un pointeur vers
un tampon contenant le répertoire (séparé par des virgules) ou la valeur. longueur_tampon
renvoie la longueur de la valeur/chaîne dans tampon

Retours de produits
nombre d'octets en cas de succès. -1 en cas d'erreur (et errno est réglé).

Séquence
Un de init les fonctions doivent être appelées avant d'accéder au bus 1 fil.
OW_finir Est facultatif.

Important noter
tampon est alloué ( avec malloc ) par OW_get mais doit être libéré dans votre programme.
See malloc (3) et gratuitement (3)

OW_lread
OW_lread est utilisé pour lire les puces mémoire à 1 fil. Considérez-le comme une combinaison de je cherche et
lire Il permet un accès aléatoire à la mémoire, en spécifiant l'emplacement et la longueur. contrairement à OW_get
les répertoires ne peuvent pas être obtenus et le tampon doit être pré-alloué plutôt qu'alloué
par la routine. tampon doit être au moins longueur du câble longueur.

Arguments
chemin est le chemin d'accès au fichier (propriété). tampon est la zone mémoire (pré-allouée)
où la valeur sera placée. longueur du câble est la longueur d'octets demandée. compenser is
la position dans le fichier pour commencer la lecture.

Retours de produits
nombre d'octets en cas de succès. -1 en cas d'erreur (et errno est réglé).

Séquence
Un de init les fonctions doivent être appelées avant d'accéder au bus 1 fil.
OW_finir Est facultatif.

OW_put
OW_put est un moyen facile d'écrire sur des puces à 1 fil.

Arguments
chemin est le chemin d'accès au fichier (propriété). tampon est la valeur à écrire.
longueur_tampon est la longueur de la valeur un tampon. Retours de produits nombre d'octets sur
Succès. -1 en cas d'erreur (et errno est réglé).

Séquence
Un de init les fonctions doivent être appelées avant d'accéder au bus 1 fil.
OW_finir Est facultatif.

OW_lwrite
OW_lwrite est le compagnon de OW_lread. Il permet d'écrire à des positions arbitraires dans
Mémoire à 1 fil. Considérez-le comme une combinaison de je cherche et écrire. tampon doit être au moins
longueur du câble longueur.

Arguments
chemin est le chemin d'accès au fichier (propriété). tampon sont les données à écrire. longueur du câble
est la longueur d'octets à écrire. compenser est la position dans le fichier pour commencer
en train d'écrire.

Retours de produits
nombre d'octets en cas de succès. -1 en cas d'erreur (et errno est réglé).

Séquence
Un de init les fonctions doivent être appelées avant d'accéder au bus 1 fil.
OW_finir Est facultatif.

OW_set_error_level
OW_set_error_level définit la sortie de débogage à un certain niveau. 0 est la valeur par défaut, et plus
valeur donne plus de sortie.
(0=par défaut, 1=err_connect, 2=err_call, 3=err_data, 4=err_detail, 5=err_debug,
6=erreur_au-delà)

Arguments
params est le niveau. Doit être un entier.

Retours de produits
Aucun

Séquence
Un de init fonctions doivent être appelées avant de régler le niveau, car init
par défaut au niveau 0.

OW_set_error_print
OW_set_error_print définit où la sortie de débogage doit être dirigée. 0=sortie mixte,
1=syslog, 2=console.

Arguments
params est le niveau. Doit être un entier compris entre 0 et 2.

Retours de produits
Aucun

Séquence
Un de init fonctions doivent être appelées avant de régler le niveau, car init
par défaut à 0 (sortie mixte).

OW_finir
OW_finir nettoie le OWFS Routines à 1 fil, libère les appareils et la mémoire.

Arguments
Aucun.

Retours de produits
Aucun

Séquence
OW_finir est facultatif puisque le nettoyage est automatique à la sortie du programme.

DESCRIPTION

1-Wire
Fil 1 est un protocole de câblage et une série d'appareils conçus et fabriqués par Dallas
Semiconductor, Inc. Le bus est un schéma de connexion basse vitesse et basse consommation dans lequel les données
la ligne peut également fournir de l'énergie.

Chaque appareil est numéroté de manière unique et inaltérable lors de la fabrication. Il y a un large
variété d'appareils, y compris la mémoire, les capteurs (humidité, température, tension, contact,
courant), interrupteurs, minuteries et enregistreurs de données. Des appareils plus complexes (comme le thermocouple
capteurs) peuvent être construits avec ces appareils de base. Il existe également des appareils à 1 fil qui ont
cryptage inclus.

Le schéma à 1 fil utilise un seul bus maître et multiple esclaves sur le même fil. Le bus
le maître initie toutes les communications. Les esclaves peuvent être découverts individuellement et
adressé à l'aide de leur identifiant unique.

Les maîtres de bus sont disponibles dans une variété de configurations, y compris série, parallèle, i2c, réseau
ou adaptateurs USB.

OWFS unique
OWFS est une suite de programmes conçus pour rendre le bus 1 fil et ses appareils facilement
accessible. Le principe sous-jacent est de créer un système de fichiers virtuel, avec l'ID unique
étant le répertoire, et les propriétés individuelles de l'appareil sont représentées comme de simples
fichiers qui peuvent être lus et écrits.

Les détails de la conception individuelle de l'esclave ou du maître sont cachés derrière une interface cohérente.
L'objectif est de fournir un ensemble d'outils simple pour un concepteur de logiciels pour créer une surveillance
ou contrôler les applications. Il y a quelques améliorations de performances dans la mise en œuvre,
y compris la mise en cache des données, l'accès parallèle aux maîtres de bus et l'agrégation de périphériques
la communication. L'objectif fondamental a toujours été la facilité d'utilisation, la flexibilité et la
l'exactitude plutôt que la vitesse.

libowcapi
libowcapi (1) est une encapsulation de la pleine libow bibliothèque pour les programmes C.

libowcapi (1) permet à un programme C d'utiliser OWFS principes (schéma de nommage cohérent,
plusieurs adaptateurs, périphériques et compatibilité) directement à partir d'un programme C. Il y a
modules analogues pour d'autres langages de programmation :

C libowcapi

perl chouette

php owphp

python owpython

tcl chouette

EXEMPLE

/* Liste simple des répertoires -- pas de vérification d'erreur */
#comprendre
caractère non signé * buf;
size_t s ;
OW_init("/dev/ttyS0");
OW_set_error_print("2");
OW_set_error_level("6");
OW_get("/",&buf,&s) ;
printf("Répertoire %s0,buf);
libre (buff);
OW_finish() ;

Utilisez libowcapi en ligne en utilisant les services onworks.net