1mDI001(3) One-Wire File System mDI001(3)
2
6 mDI001 - Digital Input Module
7
9 Monitor 4 digital lines
10 A5 [.]XXXXXXXXXXXX[XX][/[ switch_closed.[0-3|ALL|BYTE] |
11 loop_open.[0-3|ALL|BYTE] | loop_shorted.[0-3|ALL|BYTE] | address | crc8
12 | id | locator | r_address | r_id | r_locator | type ]]
13
15 A5
16
18 switch_closed.[0-3|ALL|BYTE]
19 read-only, yes-no
20 Is the relay closed? (1=yes, 0=no).
21 Note that OWFS uses 0 through 3 as the index and the datasheet uses 1
23 through 4.
24 loop_shorted.[0-3|ALL|BYTE]
26 read-only, yes-no
27 Is the loop shorted? (1=yes, 0=no). Failsafe mode.
28 Note that OWFS uses 0 through 3 as the index and the datasheet uses 1
30 through 4.
31 loop_open.[0-3|ALL|BYTE]
33 read-only, yes-no
34 Is the loop open? (1=yes, 0=no). Failsafe mode.
35 Note that OWFS uses 0 through 3 as the index and the datasheet uses 1
37 through 4.
38
40 address
41 r_address
42 read-only, ascii
43 The entire 64-bit unique ID. Given as upper case hexadecimal digits
44 (0-9A-F).
45 address starts with the family code
46 r address is the address in reverse order, which is often used in other
47 applications and labeling.
48 crc8
50 read-only, ascii
51 The 8-bit error correction portion. Uses cyclic redundancy check. Com‐
52 puted from the preceding 56 bits of the unique ID number. Given as up‐
53 per case hexadecimal digits (0-9A-F).
54 family
56 read-only, ascii
57 The 8-bit family code. Unique to each type of device. Given as upper
58 case hexadecimal digits (0-9A-F).
59 id
61 r_id
62 read-only, ascii
63 The 48-bit middle portion of the unique ID number. Does not include the
64 family code or CRC. Given as upper case hexadecimal digits (0-9A-F).
65 r id is the id in reverse order, which is often used in other applica‐
66 tions and labeling.
67 locator
69 r_locator
70 read-only, ascii
71 Uses an extension of the 1-wire design from iButtonLink company that
72 associated 1-wire physical connections with a unique 1-wire code. If
73 the connection is behind a Link Locator the locator will show a unique
74 8-byte number (16 character hexadecimal) starting with family code FE.
75 If no Link Locator is between the device and the master, the locator
76 field will be all FF.
77 r locator is the locator in reverse order.
78 present (DEPRECATED)
80 read-only, yes-no
81 Is the device currently present on the 1-wire bus?
82 type
84 read-only, ascii
85 Part name assigned by Dallas Semi. E.g. DS2401 Alternative packaging
86 (iButton vs chip) will not be distiguished.
87
89 None.
90
92 1-Wire
93 1-wire is a wiring protocol and series of devices designed and manufac‐
94 tured by Dallas Semiconductor, Inc. The bus is a low-power low-speed
95 low-connector scheme where the data line can also provide power.
96 Each device is uniquely and unalterably numbered during manufacture.
98 There are a wide variety of devices, including memory, sensors (humid‐
99 ity, temperature, voltage, contact, current), switches, timers and data
100 loggers. More complex devices (like thermocouple sensors) can be built
101 with these basic devices. There are also 1-wire devices that have en‐
102 cryption included.
103 The 1-wire scheme uses a single bus master and multiple slaves on the
105 same wire. The bus master initiates all communication. The slaves can
106 be individually discovered and addressed using their unique ID.
107 Bus masters come in a variety of configurations including serial, par‐
109 allel, i2c, network or USB adapters.
110 OWFS design
112 OWFS is a suite of programs that designed to make the 1-wire bus and
113 its devices easily accessible. The underlying principle is to create a
114 virtual filesystem, with the unique ID being the directory, and the in‐
115 dividual properties of the device are represented as simple files that
116 can be read and written.
117 Details of the individual slave or master design are hidden behind a
119 consistent interface. The goal is to provide an easy set of tools for a
120 software designer to create monitoring or control applications. There
121 are some performance enhancements in the implementation, including data
122 caching, parallel access to bus masters, and aggregation of device com‐
123 munication. Still the fundamental goal has been ease of use, flexibil‐
124 ity and correctness rather than speed.
125 mDI001
127 The mDI001 (3) is used to monitor digital lines for simple switching.
128
130 All 1-wire devices are factory assigned a unique 64-bit address. This
131 address is of the form:
132 Family Code
134 8 bits
135 Address
137 48 bits
138 CRC 8 bits
140 Addressing under OWFS is in hexadecimal, of form:
142 01.123456789ABC
144 where 01 is an example 8-bit family code, and 12345678ABC is an example
146 48 bit address.
147 The dot is optional, and the CRC code can included. If included, it
149 must be correct.
150
152 http://www.cmciel.com/products-solutions/individual-products/4-channel-
153 fail-safe-digital-module-mdi001/
154 Programs
156 owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1)
157 owwrite (1) owpresent (1) owtap (1)
158 Configuration and testing
160 owfs (5) owtap (1) owmon (1)
161 Language bindings
163 owtcl (3) owperl (3) owcapi (3)
164 Clocks
166 DS1427 (3) DS1904 (3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3)
167 DS2417 (3)
168 ID
170 DS2401 (3) DS2411 (3) DS1990A (3)
171 Memory
173 DS1982 (3) DS1985 (3) DS1986 (3) DS1991 (3) DS1992 (3) DS1993 (3)
174 DS1995 (3) DS1996 (3) DS2430A (3) DS2431 (3) DS2433 (3) DS2502 (3)
175 DS2506 (3) DS28E04 (3) DS28EC20 (3)
176 Switches
178 DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3) In‐
179 fernoEmbedded (3)
180 Temperature
182 DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
183 DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
184 EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
185 [1m(3)
186 Humidity
188 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
189 Voltage
191 DS2450 (3)
192 Resistance
194 DS2890 (3)
195 Multifunction (current, voltage, temperature)
197 DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3)
198 DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
199 Counter
201 DS2423 (3)
202 LCD Screen
204 LCD (3) DS2408 (3)
205 Crypto
207 DS1977 (3)
208 Pressure
210 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
211 Moisture
213 EEEF (3) DS2438 (3)
214
216 http://www.owfs.org
217
219 Paul Alfille (paul.alfille@gmail.com)
220OWFS Manpage 2003 mDI001(3)