1mDI001(3)                    One-Wire File System                    mDI001(3)
2
3
4

NAME

6       mDI001 - Digital Input Module
7

SYNOPSIS

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

FAMILY CODE

15       A5
16

SPECIAL PROPERTIES

18   switch_closed.[0-3|ALL|BYTE]
19       read-only, yes-no
20       Is the relay closed? (1=yes, 0=no).
21
22       Note  that  OWFS uses 0 through 3 as the index and the datasheet uses 1
23       through 4.
24
25   loop_shorted.[0-3|ALL|BYTE]
26       read-only, yes-no
27       Is the loop shorted? (1=yes, 0=no). Failsafe mode.
28
29       Note that OWFS uses 0 through 3 as the index and the datasheet  uses  1
30       through 4.
31
32   loop_open.[0-3|ALL|BYTE]
33       read-only, yes-no
34       Is the loop open? (1=yes, 0=no). Failsafe mode.
35
36       Note  that  OWFS uses 0 through 3 as the index and the datasheet uses 1
37       through 4.
38

STANDARD PROPERTIES

40   address
41   r_address
42       read-only, ascii
43       The entire 64-bit unique ID. Given as  upper  case  hexidecimal  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
49   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
53       upper case hexidecimal digits (0-9A-F).
54
55   family
56       read-only, ascii
57       The 8-bit family code. Unique to each type of device.  Given  as  upper
58       case hexidecimal digits (0-9A-F).
59
60   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 hexidecimal 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
68   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 hexidecimal) 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
79   present (DEPRECATED)
80       read-only, yes-no
81       Is the device currently present on the 1-wire bus?
82
83   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

ALARMS

89       None.
90

DESCRIPTION

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
97       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
102       encryption included.
103
104       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
108       Bus  masters come in a variety of configurations including serial, par‐
109       allel, i2c, network or USB adapters.
110
111   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
115       individual  properties  of  the  device are represented as simple files
116       that can be read and written.
117
118       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 fundemental goal has been ease of use, flexibil‐
124       ity and correctness rather than speed.
125
126   mDI001
127       The mDI001 (3) is used to monitor digital lines for simple switching.
128

ADDRESSING

130       All 1-wire devices are factory assigned a unique 64-bit  address.  This
131       address is of the form:
132
133       Family Code
134              8 bits
135
136       Address
137              48 bits
138
139       CRC    8 bits
140
141       Addressing under OWFS is in hexidecimal, of form:
142
143              01.123456789ABC
144
145       where 01 is an example 8-bit family code, and 12345678ABC is an example
146       48 bit address.
147
148       The dot is optional, and the CRC code can  included.  If  included,  it
149       must be correct.
150

WEBSITE

152       http://www.cmciel.com/products-solutions/individual-products/4-channel-
153       fail-safe-digital-module-mdi001/
154
155   Programs
156       owfs (1) owhttpd (1) owftpd (1)  owserver  (1)  owdir  (1)  owread  (1)
157       owwrite (1) owpresent (1) owtap (1)
158
159   Configuration and testing
160       owfs (5) owtap (1) owmon (1)
161
162   Language bindings
163       owtcl (3) owperl (3) owcapi (3)
164
165   Clocks
166       DS1427  (3)  DS1904  (3)  DS1994  (3) DS2404 (3) DS2404S (3) DS2415 (3)
167       DS2417 (3)
168
169   ID
170       DS2401 (3) DS2411 (3) DS1990A (3)
171
172   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
177   Switches
178       DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
179
180   Temperature
181       DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3)  DS18S20  (3)  DS1920  (3)
182       DS1921  (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
183       EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3)  EDS0072  (3)  MAX31826
184       (3)
185
186   Humidity
187       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
188
189   Voltage
190       DS2450 (3)
191
192   Resistance
193       DS2890 (3)
194
195   Multifunction (current, voltage, temperature)
196       DS2436  (3)  DS2437  (3)  DS2438  (3)  DS2751 (3) DS2755 (3) DS2756 (3)
197       DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
198
199   Counter
200       DS2423 (3)
201
202   LCD Screen
203       LCD (3) DS2408 (3)
204
205   Crypto
206       DS1977 (3)
207
208   Pressure
209       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
210
211   Moisture
212       EEEF (3) DS2438 (3)
213

AVAILABILITY

215       http://www.owfs.org
216

AUTHOR

218       Paul Alfille (paul.alfille@gmail.com)
219
220
221
222OWFS Manpage                         2003                            mDI001(3)
Impressum