owfs - En ligne dans le Cloud

PROGRAMME:

Nom

oufs - Système de fichiers à 1 fil

SYNOPSIS

oufs [ -c configuration ] -d port série | -u | -s [port hôte -m rép_montage

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 DESIGN
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.

oufs
oufs (1) est le client du système de fichiers du OWFS famille de programmes. Il fonctionne sous Linux,
freebsd et Mac OS X, et nécessite le fusible module et bibliothèque du noyau.
(http://fuse.sourceforge.net) qui est un pilote de système de fichiers en mode utilisateur.

Essentiellement, l'ensemble du bus 1-wire est monté à un endroit dans votre système de fichiers. Tous les
Les appareils à 1 fil sont accessibles à l'aide d'opérations de fichier standard (lecture, écriture, répertoire
référencement). Le système est sûr, aucun fichier réel n'est exposé, ces fichiers sont virtuels. Pas
toutes les opérations sont prises en charge. Plus précisément, la création, la suppression, la liaison et le changement de nom de fichiers
ne sont pas permis. (Vous pouvez lier de l'extérieur à un fichier owfs, mais pas l'inverse).

Appareil Options (1 fil Transport public Maître)

Ces options spécifient le périphérique (maître de bus) connectant l'ordinateur au bus 1 fil.
Les esclaves 1 fil sont connectés au bus 1 fil et le maître du bus se connecte à un port
sur l'ordinateur et contrôle le bus 1 fil. Le maître de bus est soit un physique réel
périphérique, le module noyau w1 ou un propriétaire (1).

Au moins une option de périphérique est requise. Il n'y a pas de défaut. Plusieurs appareils peuvent être
répertorié, et tout sera utilisé. (Une union logique à moins que vous n'exploriez le /bus.n/
répertoires.)

Linux et BSD appliquent une politique de sécurité restreignant l'accès aux ports matériels. Vous devez
disposer de droits suffisants pour accéder au port donné, sinon l'accès échouera silencieusement.

* Port série dispositifs

port spécifie un port série, par exemple /dev/ttyS0

-d port | --appareil=port (DS2480B)
Bus master basé sur le DS2480B (comme le DS9097U ou le LINK en mode émulation). Si la
l'adaptateur ne répond pas, un circuit de type passif (DS9907E ou diode/résistance) sera
assumé.

--serial_flextime | --serial_regulartime (DS2480B)
Modifie les détails de la synchronisation du bus (voir la fiche technique DS2480B). Certains appareils, comme le Swart
LCD ne peut pas travailler avec horaire flexible.

--baud=1200|9600|19200|38400|57600|115200 (DS2480B, LIEN, HA5)
Définit la vitesse de communication initiale du port série pour tous les maîtres de bus. Pas tout
les périphériques série prennent en charge toutes les vitesses. Vous pouvez modifier la vitesse individuelle du maître de bus
pour LINK et à la DS2880B dans le répertoire interface/paramètres. Les HA5 la vitesse est réglée
dans le matériel, donc le taux de buad de la ligne de commande doit correspondre à ce taux.
Généralement, les paramètres par défaut (9600 pour LINK et à la DS2480B ) et 115200 pour le HA5
sont sains d'esprit et ne devraient pas être modifiés.

--straight_polarité | --inverse_polarité (DS2480B)
Inversion de polarité des transistors de sortie DS2480B ? Pas nécessaire pour le DS9097U, mais
requis pour d'autres conceptions.

--lien=port (LIEN)
iBoutonLien LINK adaptateur (toutes versions) en mode non émulation. Utilise un ascii
protocole sur série.

--ha7e=port (HA7E)
Embarqué Sauvegarde de Système HA7E adaptateur ( et HA7S ) en mode ascii natif.

--ha5=port | --ha5=port:un | --ha5=port:acg (HA5)
Embarqué Sauvegarde de Système HA5 adaptateur mutidrop en mode ascii natif. Jusqu'à 26 adaptateurs
peuvent partager le même port, chacun avec une lettre assignée. Si aucune lettre n'est spécifiée, le
programme recherchera la première réponse (ce qui peut être lent).

--somme de contrôle | --no_somme de contrôle (HA5)
Activez (par défaut) ou désactivez la fonction de somme de contrôle de la communication HA5.

--passif=port | --ha2=port | --ha3=port | --ha4b=port (Passif)
Adaptateurs passifs 1 fil. Mise hors tension du port série et utilisation électrique passive
composants (résistances et diodes).

--8 bits | --6 bits (Passif)
Synthétisez la forme d'onde à 1 fil à l'aide d'un mot série de 6 bits (par défaut) ou d'un mot de 8 bits.
Tous les appareils UART ne prennent pas en charge le fonctionnement 6 bits.

--timeout_serial=5
Délai d'attente (en secondes) pour toutes les communications série. 5 secondes par défaut. Peut être
modifié dynamiquement sous /paramètres/timeout/série

* USB dispositifs

Les seuls vrais maîtres de bus USB pris en charge sont basés sur la puce DS2490. Le plus courant est
le DS9490R qui a un esclave d'identification à 1 fil inclus avec le code de famille 81.

Il existe également des maîtres de bus basés sur la puce série avec une conversion USB vers série intégrée
in. Ceux-ci sont pris en charge par le protocole maître de bus série.

-u | --USB
Maître de bus basé sur DS2490 (comme le DS9490R).

-U2 | --usb=2
Utilisez le deuxième maître de bus USB. (L'ordre n'est cependant pas prévisible, puisque le
système d'exploitation ne commande pas systématiquement de périphériques USB).

-tous | --usb=TOUS
Utilisez tous les périphériques USB.

--usb_flextime | --usb_regulartime
Modifie les détails de la synchronisation de la forme d'onde à 1 fil pour certaines configurations de réseau.

--altusb
La synchronisation USB alternative de Willy Robion.

--timeout_usb=5
Délai d'attente pour les communications USB. Cela a une valeur par défaut de 5 secondes et peut être modifié
dynamiquement sous /paramètres/timeout/usb

* I2C dispositifs

I2C est un protocole à 2 fils utilisé pour la communication puce à puce. Les maîtres de bus : DS2482-100,
DS2482-101 et à la DS2482-800 peut spécifier (via les tensions de broche) un sous-ensemble d'adresses sur l'i2c
autobus. Ces choix sont

adresse_i2c

0,1,2,3
0x18,0x19,0x1A,0x1B

4,5,6,7
0x1C,0x1D,0x1E,0x1F (DS2482-800 only)

port pour les masters i2c ont la forme /dev/i2c-0, /dev/i2c-1,

-d port | --appareil=port
Ce formulaire simple ne permet qu'un port et le premier disponible adresse_i2c

--i2c=port | --i2c=port:adresse_i2c | --i2c=port:TOUS
i2c spécifique port et les adresse_i2c est soit le premier, spécifique, soit tout ou
leur. La adresse_i2c est 0,1,2,...

--i2c | --i2c= : | --i2c=TOUS:TOUS
Recherchez les bus i2c disponibles pour le premier, le premier ou chaque i2c
adaptateur.

Le DS2482-800 maîtres 8 bus à 1 fil et générera ainsi 8 /bus.n entrées.

* Réseau dispositifs

Ces maîtres de bus communiquent via le protocole réseau tcp/ip et peuvent ainsi être localisés
n'importe où sur le réseau. Les adresse réseau est de la forme tcp_address:port

Par exemple 192.168.0.1:3000 ou localhost:3000

--link=adresse_réseau
Adaptateur réseau LinkHubE LINK par iBoutonLien

--ha7net=adresse_réseau | --ha7net
Adaptateur réseau 7 fil HA1Net avec adresse TCP spécifiée ou découvert par udp
multidiffusion. Par Embarqué Sauvegarde de Système
--timeout_ha7=60 timeout spécifique pour les communications HA7Net (60 secondes par défaut).

--etherweather=adresse_réseau
Adaptateur Ethernet

-s adresse réseau | --server=adresse_réseau
Emplacement d'un propriétaire (1) programme qui communique avec le bus 1 fil. Le port par défaut
est 4304.

--timeout_network=5
Timeout pour les communications du maître du bus réseau. Cela a une valeur par défaut de 1 seconde et peut
être modifié dynamiquement sous /paramètres/timeout/réseau

* Simulé dispositifs

Utilisé pour les tests et le développement. Aucun matériel réel n'est nécessaire. Utile pour séparer les
développement matériel du reste de la conception logicielle.

dispositifs
est une liste de dispositifs à 1 fil séparés par des virgules dans les formats suivants. Notez qu'un
un code CRC8 valide est créé automatiquement.

10,05,21
Hexidécimal famille codes (les DS18S20, DS2405 et DS1921 dans cet exemple).

10.12AB23431211
Une adresse unique hexadécimale plus complète. Utile lorsqu'un périphérique matériel réel
doit être simulé.

DS2408, DS2489
Le nom de l'appareil à 1 fil. (L'ID complet ne peut pas être spécifié dans ce format).

--fake=appareils
Adresse aléatoire et valeurs aléatoires pour chaque lecture. L'ID de l'appareil est également aléatoire
(sauf si spécifié).

--température_basse=12 --température_haute=44
Spécifiez les limites de température pour le faux simulation d'adaptateur. Ceux-ci devraient être en
la même échelle de température que celle spécifiée dans la ligne de commande. Il est possible de
modifier les limites dynamiquement pour chaque adaptateur sous
/bus.x/interface/settings/simulated/[temperature_low|temperature_high]

--tester=périphériques
Adresse prévisible et valeurs prévisibles pour chaque lecture. (Voir le site Web pour le
algorithme).

* w1 kernel module

Il s'agit d'une option spécifique à Linux pour utiliser l'accès du système d'exploitation aux maîtres de bus. Racine
l'accès est requis et la mise en œuvre était toujours en cours à partir de owfs v2.7p12 et
Linux 2.6.30.

Les maîtres de bus sont reconnus et ajoutés dynamiquement. Les détails du maître de bus physique sont
non accessibles, mais ils incluent USB, i2c et un certain nombre de conceptions GPIO sur des cartes embarquées.

L'accès est limité au superutilisateur en raison du protocole de diffusion netlink utilisé par w1.
Le multitâche doit être configuré (threads) sur la compilation.

--w1 Utilisez le maître de bus virtuel w1 du noyau Linux.

--timeout_w1=10
Délai d'attente pour les communications w1 netlink. Cela a une valeur par défaut de 10 secondes et peut être
changé dynamiquement sous /paramètres/timeout/w1

SPÉCIFIQUE OPTIONS

-m --mountpoint=chemin_répertoire
Chemin d'un répertoire pour monter le système de fichiers 1-wire

Le point de montage est requis. Il n'y a pas de défaut.

--allow_other
Raccourci pour l'option de montage de fusible "-o allow_other" Permet aux autres utilisateurs de voir le fusible
(owfs) point de montage et système de fichiers. Nécessite un réglage dans /etc/fuse.conf également.

--fuse-opt Options
Envoie des options au processus de montage des fusibles. Les options doivent être citées, par exemple "

TEMPÉRATURE ÉCHELLE OPTIONS

-C --Celsius
-F --Fahrenheit
-K --Kelvin
-R --Rangine
Échelle de température utilisée pour la sortie des données. Celsius est la valeur par défaut.

Peut également être modifié dans le programme à /paramètres/unités/temperature_scale

PRESSION ÉCHELLE OPTIONS

--mbar (Par défaut)
--au m
--mmHg
--inHg
--psi
--Pennsylvanie
Échelle de pression utilisée pour la sortie des données. Le millibar est la valeur par défaut.

Peut également être modifié dans le programme à /paramètres/unités/pression_scale

Format OPTIONS

Choisissez la représentation des identifiants uniques 1 fil. OWFS utilise ces identifiants comme
noms de répertoire uniques.

Bien que plusieurs formats d'affichage soient sélectionnables, tous doivent être en identifiant-famille-crc8 forme,
contrairement à d'autres programmes et à l'étiquetage des iButtons, qui sont crc8-id-famille formulaire.

-f --format="f[.]i[[.]c]"
Format d'affichage pour les appareils 1 fil. Chaque appareil a une adresse de 8 octets, composée de :

f code famille, 1 octet

i Numéro d'identification, 6 octets

c Somme de contrôle CRC, 1 octet

Les formats possibles sont Fi (default, 01.A1B2C3D4E5F6), fi fic fic fic et à la fi.c

Tous les formats sont acceptés en entrée, mais la sortie sera au format spécifié.

Les éléments d'adresse peuvent être récupérés à partir d'une entrée d'appareil dans owfs par le famille, id et à la
crc8 propriétés, et dans l'ensemble avec adresse. L'identifiant et l'adresse inversés peuvent être
récupéré comme débarrasser et à la r_adresse.

JOB CONTRÔLE OPTIONS

-r --lecture seulement
-w --écrivez
Autorisons-nous l'écriture sur le bus 1 fil (écriture mémoire, réglages des commutateurs, limites, PIO) ?
Le écrire est disponible pour la symétrie, c'est la valeur par défaut.

-P --fichier-pid nom de fichier
Place le PID -- ID de processus de owfs dans le nom de fichier spécifié. Utile pour le démarrage
contrôle des scripts.

--Contexte | --premier plan
Si le programme libère la console et s'exécute dans le fond après avoir évalué
options de ligne de commande. fond est la valeur par défaut.

--error_print=0|1|2|3
=0 destination mixte par défaut : premier plan stderr / arrière-plan syslog

=1 syslog uniquement

=2 stderr uniquement

=3 /dev/null (mode silencieux).

--error_level=0..9
=0 erreurs par défaut uniquement

=1 connexions/déconnexions

=2 tous les appels de haut niveau

=3 résumé des données pour chaque appel

=4 niveau de détails

>4 débogage de la paille

--error_level=9 produit beaucoup de sortie

CONFIGURATION DOSSIER

-c filet | --configuration filet
Nom d'un oufs (5) fichier de configuration avec plus de paramètres de ligne de commande

+.PP +Sur Debian, +.B owfs (1) +lit toujours +.I /etc/owfs.conf

AIDE OPTIONS

Voir aussi cette page de manuel et le site web http://www.owfs.org

-h --help=[appareil|cache|programme|travail|température]
Affiche un résumé de base des options.

dispositif Options de maître de bus à 1 fil

cachette taille et synchronisation du cache et de la communication

Programme
paramètres du point de montage ou du serveur TCP

JOB options de contrôle et de débogage

la réactivité
Format d'affichage d'identification unique et échelle de température

-V --version
Version de ce programme et des bibliothèques associées.

OPTIONS

Les délais d'attente pour les maîtres de bus étaient précédemment répertoriés dans Appareil options. Délais d'attente pour le
cache affectent le temps que les données restent en mémoire. Les valeurs par défaut sont affichées.

--timeout_volatile=15
secondes jusqu'à ce qu'un volatile la propriété expire dans le cache. Les propriétés volatiles sont celles
(comme la température) qui changent d'eux-mêmes.

Peut être modifié dynamiquement à /paramètres/timeout/volatil

--timeout_stable=300
secondes jusqu'à ce qu'un stable la propriété expire dans le cache. Les propriétés stables sont celles qui
ne devrait pas changer à moins qu'il ne soit explicitement modifié. Contenu de la mémoire par exemple.

Peut être modifié dynamiquement à /paramètres/timeout/stable

--timeout_directory=60
secondes jusqu'à ce qu'un annuaire la liste expire dans le cache. Les listes de répertoires sont les 1-wire
appareils trouvés sur le bus.

Peut être modifié dynamiquement à /settings/timeout/répertoire

--timeout_presence=120
secondes jusqu'à ce que le présence et l'emplacement du bus d'un périphérique 1 fil expire dans le cache.

Peut être modifié dynamiquement à /paramètres/timeout/présence

Là aussi délais XNUMX groupe de neurones Programme réponses:

--timeout_server=5
Secondes jusqu'à la réponse attendue du propriétaire (1) est réputé en retard.

Peut être modifié dynamiquement à /paramètres/timeout/serveur

--timeout_ftp=900
Secondes pendant lesquelles une session ftp est maintenue en vie.

Peut être modifié dynamiquement à /paramètres/timeout/ftp

EXEMPLE

owfs -d /dev/ttyS0 -m /mnt/1wire
Bus master sur port série

owfs -F -u -m /mnt/1fil
Adaptateur USB, températures signalées en Fahrenheit

owfs -s 10.0.1.2:4304 -m /mnt/1wire
Connectez-vous à un propriétaire (1) processus qui a été démarré sur une autre machine au port tcp
4304

Utiliser owfs en ligne à l'aide des services onworks.net