1DS2405(3) One-Wire File System DS2405(3)
2
6 DS2405 - Addressable Switch
7
9 1-wire network branch controller.
10 05 [.]XXXXXXXXXXXX[XX][/[ PIO | sensed | address | crc8 | id | locator
12 | r_address | r_id | r_locator | type ]]
13
15 05
16
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 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
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 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 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 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 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 present (DEPRECATED)
74 read-only, yes-no
75 Is the device currently present on the 1-wire bus?
76 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
83 None implemented.
84
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 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 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 Bus masters come in a variety of configurations including serial, par‐
103 allel, i2c, network or USB adapters.
104 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 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 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
127 All 1-wire devices are factory assigned a unique 64-bit address. This
128 address is of the form:
129 Family Code
131 8 bits
132 Address
134 48 bits
135 CRC 8 bits
137 Addressing under OWFS is in hexadecimal, of form:
139 01.123456789ABC
141 where 01 is an example 8-bit family code, and 12345678ABC is an example
143 48 bit address.
144 The dot is optional, and the CRC code can included. If included, it
146 must be correct.
147
149 http://pdfserv.maxim-ic.com/en/ds/DS2405.pdf
150
152 Programs
153 owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1)
154 owwrite (1) owpresent (1) owtap (1)
155 Configuration and testing
157 owfs (5) owtap (1) owmon (1)
158 Language bindings
160 owtcl (3) owperl (3) owcapi (3)
161 Clocks
163 DS1427 (3) DS1904 (3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3)
164 DS2417 (3)
165 ID
167 DS2401 (3) DS2411 (3) DS1990A (3)
168 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 Switches
175 DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
176 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 [1m(3)
182 Humidity
184 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
185 Voltage
187 DS2450 (3)
188 Resistance
190 DS2890 (3)
191 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 Counter
197 DS2423 (3)
198 LCD Screen
200 LCD (3) DS2408 (3)
201 Crypto
203 DS1977 (3)
204 Pressure
206 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
207 Moisture
209 EEEF (3) DS2438 (3)
210
212 http://www.owfs.org
213
215 Paul Alfille (paul.alfille@gmail.com)
216OWFS Manpage 2003 DS2405(3)