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  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
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 up‐
53       per case hexadecimal 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 hexadecimal 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 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
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 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
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  en‐
102       cryption 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 in‐
115       dividual  properties of the device are represented as simple files that
116       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 fundamental 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 hexadecimal, 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) In‐
179       fernoEmbedded (3)
180
181   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       (3)
186
187   Humidity
188       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
189
190   Voltage
191       DS2450 (3)
192
193   Resistance
194       DS2890 (3)
195
196   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
200   Counter
201       DS2423 (3)
202
203   LCD Screen
204       LCD (3) DS2408 (3)
205
206   Crypto
207       DS1977 (3)
208
209   Pressure
210       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
211
212   Moisture
213       EEEF (3) DS2438 (3)
214

AVAILABILITY

216       http://www.owfs.org
217

AUTHOR

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