1OWMON(1) One-Wire File System OWMON(1)
2
6 owmon - Monitor for owserver settings and statistics
7
9 owmon -s owserver-tcp-port
10
12 1-Wire
13 1-wire is a wiring protocol and series of devices designed and manufac‐
14 tured by Dallas Semiconductor, Inc. The bus is a low-power low-speed
15 low-connector scheme where the data line can also provide power.
16 Each device is uniquely and unalterably numbered during manufacture.
18 There are a wide variety of devices, including memory, sensors (humid‐
19 ity, temperature, voltage, contact, current), switches, timers and data
20 loggers. More complex devices (like thermocouple sensors) can be built
21 with these basic devices. There are also 1-wire devices that have
22 encryption included.
23 The 1-wire scheme uses a single bus master and multiple slaves on the
25 same wire. The bus master initiates all communication. The slaves can
26 be individually discovered and addressed using their unique ID.
27 Bus masters come in a variety of configurations including serial, par‐
29 allel, i2c, network or USB adapters.
30 OWFS design
32 OWFS is a suite of programs that designed to make the 1-wire bus and
33 its devices easily accessible. The underlying principle is to create a
34 virtual filesystem, with the unique ID being the directory, and the
35 individual properties of the device are represented as simple files
36 that can be read and written.
37 Details of the individual slave or master design are hidden behind a
39 consistent interface. The goal is to provide an easy set of tools for a
40 software designer to create monitoring or control applications. There
41 are some performance enhancements in the implementation, including data
42 caching, parallel access to bus masters, and aggregation of device com‐
43 munication. Still the fundamental goal has been ease of use, flexibil‐
44 ity and correctness rather than speed.
45 owserver
47 owserver (1) is the backend component of the OWFS 1-wire bus control
48 system. owserver (1) arbitrates access to the bus from multiple client
49 processes. The physical bus is usually connected to a serial or USB
50 port, and other processes connect to owserver (1) over network sockets
51 (tcp port).
52 Frontend clients include a filesystem representation: owfs (1) , and a
54 webserver: owhttpd (1). Direct language bindings are also available,
55 e.g: owperl (3).
56 There are also many light-weight clients that can only talk to owserver
58 [1m(1) and not to the 1-Wire bus directly. They include shell and multiple
59 language modules (perl, Visual Basic, python,...)
60 owserver protocol
62 All the owserver (1) clients use the owserver protocol for communica‐
63 tion. The owserver protocol is a well documented tcp/ip client/server
64 protocol. Assigned the "well known port" default of 4304.
65 owmon
67 owmon (1) is connects to owserver (1) and displays the bus structure
68 and contents of the interface, statistics and settings directories.
69
71 -s
72 TCP port or IPaddress:port for owserver
73 The tcp port (IP:port) for the "upstream" owserver.
74
76 If owserver (1) is started:
77 owserver -p 4304 -d /dev/ttyS0
78 owserver on tcp port 4304 and connects to a physical 1-wire bus on a
79 serial port.
80 You can monitor owserver (1) with
82 owmon -s 4304 /
83
85 owmon (1) is a pure Tcl/TK program and will run wherever Tcl/TK is
86 available (Windows, Macintosh, Linux, Unix)
87
89 owserver protocol
90 http://www.owfs.org/index.php?page=owserver-protocol
91 Tcl/TK
93 http://www.tcl.tk
94
96 Programs
97 owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1)
98 owwrite (1) owpresent (1) owtap (1)
99 Configuration and testing
101 owfs (5) owtap (1) owmon (1)
102 Language bindings
104 owtcl (3) owperl (3) owcapi (3)
105 Clocks
107 DS1427 (3) DS1904(3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3)
108 DS2417 (3)
109 ID
111 DS2401 (3) DS2411 (3) DS1990A (3)
112 Memory
114 DS1982 (3) DS1985 (3) DS1986 (3) DS1991 (3) DS1992 (3) DS1993 (3)
115 DS1995 (3) DS1996 (3) DS2430A (3) DS2431 (3) DS2433 (3) DS2502 (3)
116 DS2506 (3) DS28E04 (3) DS28EC20 (3)
117 Switches
119 DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
120 Temperature
122 DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
123 DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3)
124 Humidity
126 DS1922 (3)
127 Voltage
129 DS2450 (3)
130 Resistance
132 DS2890 (3)
133 Multifunction (current, voltage, temperature)
135 DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3)
136 DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
137 Counter
139 DS2423 (3)
140 LCD Screen
142 LCD (3) DS2408 (3)
143 Crypto
145 DS1977 (3)
146 Pressure
148 DS2406 (3) -- TAI8570
149
151 http://www.owfs.org
152
154 Paul Alfille (paul.alfille@gmail.com)
155OWTAP Manpage 2007 OWMON(1)