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

NAME

6       DS2405 - Addressable Switch
7

SYNOPSIS

9       1-wire network branch controller.
10
11       05  [.]XXXXXXXXXXXX[XX][/[ PIO | sensed | address | crc8 | id | locator
12       | r_address | r_id | r_locator | type ]]
13

FAMILY CODE

15       05
16

SPECIAL PROPERTIES

18   PIO
19       read-write, yes-no
20       State of the open-drain output ( PIO ) pin. 0 = non-conducting (off), 1
21       = conducting (on).
22       Writing  zero  will  turn  off  the  switch,  non-zero will turn on the
23       switch. Reading the PIO state will return the switch setting. To deter‐
24       mine  the  actual  logic level at the switch, refer to the sensed prop‐
25       erty.
26
27   sensed
28       read-only, yes-no
29       Logic level at the PIO pin. 0 = ground. 1 = high (~2.4V - 5V ).  Really
30       makes  sense only if the PIO state is set to zero (off), else will read
31       zero.
32

STANDARD PROPERTIES

34   address
35   r_address
36       read-only, ascii
37       The entire 64-bit unique ID. Given as  upper  case  hexidecimal  digits
38       (0-9A-F).
39       address starts with the family code
40       r address is the address in reverse order, which is often used in other
41       applications and labeling.
42
43   crc8
44       read-only, ascii
45       The 8-bit error correction portion. Uses cyclic redundancy check.  Com‐
46       puted  from  the  preceding  56  bits of the unique ID number. Given as
47       upper case hexadecimal digits (0-9A-F).
48
49   family
50       read-only, ascii
51       The 8-bit family code. Unique to each type of device.  Given  as  upper
52       case hexadecimal digits (0-9A-F).
53
54   id
55   r_id
56       read-only, ascii
57       The 48-bit middle portion of the unique ID number. Does not include the
58       family code or CRC. Given as upper case hexadecimal digits (0-9A-F).
59       r id is the id in reverse order, which is often used in other  applica‐
60       tions and labeling.
61
62   locator
63   r_locator
64       read-only, ascii
65       Uses  an  extension  of the 1-wire design from iButtonLink company that
66       associated 1-wire physical connections with a unique  1-wire  code.  If
67       the  connection is behind a Link Locator the locator will show a unique
68       8-byte number (16 character hexadecimal) starting with family code FE.
69       If no Link Locator is between the device and the  master,  the  locator
70       field will be all FF.
71       r locator is the locator in reverse order.
72
73   present (DEPRECATED)
74       read-only, yes-no
75       Is the device currently present on the 1-wire bus?
76
77   type
78       read-only, ascii
79       Part  name  assigned by Dallas Semi. E.g.  DS2401 Alternative packaging
80       (iButton vs chip) will not be distiguished.
81

ALARMS

83       None implemented.
84

DESCRIPTION

86   1-Wire
87       1-wire is a wiring protocol and series of devices designed and manufac‐
88       tured  by  Dallas  Semiconductor, Inc. The bus is a low-power low-speed
89       low-connector scheme where the data line can also provide power.
90
91       Each device is uniquely and unalterably  numbered  during  manufacture.
92       There  are a wide variety of devices, including memory, sensors (humid‐
93       ity, temperature, voltage, contact, current), switches, timers and data
94       loggers.  More complex devices (like thermocouple sensors) can be built
95       with these basic devices. There  are  also  1-wire  devices  that  have
96       encryption included.
97
98       The  1-wire  scheme uses a single bus master and multiple slaves on the
99       same wire. The bus master initiates all communication. The  slaves  can
100       be individually discovered and addressed using their unique ID.
101
102       Bus  masters come in a variety of configurations including serial, par‐
103       allel, i2c, network or USB adapters.
104
105   OWFS design
106       OWFS is a suite of programs that designed to make the  1-wire  bus  and
107       its  devices easily accessible. The underlying principle is to create a
108       virtual filesystem, with the unique ID being  the  directory,  and  the
109       individual  properties  of  the  device are represented as simple files
110       that can be read and written.
111
112       Details of the individual slave or master design are  hidden  behind  a
113       consistent interface. The goal is to provide an easy set of tools for a
114       software designer to create monitoring or control  applications.  There
115       are some performance enhancements in the implementation, including data
116       caching, parallel access to bus masters, and aggregation of device com‐
117       munication.  Still the fundamental goal has been ease of use, flexibil‐
118       ity and correctness rather than speed.
119
120   DS2405
121       The DS2405 (3) allows control of other devices, like LEDs  and  relays.
122       It is an early design and has been superceeded by the DS2406 and DS2408
123       or even DS2450 that have more PIO pins, and do not employ an arcane use
124       the the alarm state to signal PIO status.
125

ADDRESSING

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

DATASHEET

149       http://pdfserv.maxim-ic.com/en/ds/DS2405.pdf
150

SEE ALSO

152   Programs
153       owfs (1) owhttpd (1) owftpd (1)  owserver  (1)  owdir  (1)  owread  (1)
154       owwrite (1) owpresent (1) owtap (1)
155
156   Configuration and testing
157       owfs (5) owtap (1) owmon (1)
158
159   Language bindings
160       owtcl (3) owperl (3) owcapi (3)
161
162   Clocks
163       DS1427  (3)  DS1904  (3)  DS1994  (3) DS2404 (3) DS2404S (3) DS2415 (3)
164       DS2417 (3)
165
166   ID
167       DS2401 (3) DS2411 (3) DS1990A (3)
168
169   Memory
170       DS1982 (3) DS1985 (3) DS1986 (3)  DS1991  (3)  DS1992  (3)  DS1993  (3)
171       DS1995  (3)  DS1996  (3)  DS2430A  (3) DS2431 (3) DS2433 (3) DS2502 (3)
172       DS2506 (3) DS28E04 (3) DS28EC20 (3)
173
174   Switches
175       DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
176
177   Temperature
178       DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3)  DS18S20  (3)  DS1920  (3)
179       DS1921  (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
180       EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3)  EDS0072  (3)  MAX31826
181       (3)
182
183   Humidity
184       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
185
186   Voltage
187       DS2450 (3)
188
189   Resistance
190       DS2890 (3)
191
192   Multifunction (current, voltage, temperature)
193       DS2436  (3)  DS2437  (3)  DS2438  (3)  DS2751 (3) DS2755 (3) DS2756 (3)
194       DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
195
196   Counter
197       DS2423 (3)
198
199   LCD Screen
200       LCD (3) DS2408 (3)
201
202   Crypto
203       DS1977 (3)
204
205   Pressure
206       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
207
208   Moisture
209       EEEF (3) DS2438 (3)
210

AVAILABILITY

212       http://www.owfs.org
213

AUTHOR

215       Paul Alfille (paul.alfille@gmail.com)
216
217
218
219OWFS Manpage                         2003                            DS2405(3)
Impressum