1DS2413(3) One-Wire File System DS2413(3)
2
6 DS2413 - Dual Channel Addressable Switch
7
9 Dual Switch
10 3A [.]XXXXXXXXXXXX[XX][/[ PIO.[A|B|ALL|BYTE] | sensed.[A|B|ALL|BYTE] |
12 address | crc8 | id | locator | r_address | r_id | r_locator | type ]]
13
15 3A
16
18 PIO.A PIO.B PIO.ALL PIO.BYTE
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 ALL references both channels simultaneously, comma separated.
27 BYTE references both channels simultaneously as a single byte, with
28 channel A in bit 0.
29 sensed.A sensed.B sensed.ALL sensed.BYTE
31 read-only, yes-no
32 Logic level at the PIO pin. 0 = ground. 1 = high (~2.4V - 5V ). Really
33 makes sense only if the PIO state is set to zero (off), else will read
34 zero.
35 ALL references both channels simultaneously, comma separated.
36 BYTE references both channels simultaneously as a single byte, with
37 channel A in bit 0.
38
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 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 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 Use the set_alarm property to set the alarm triggering criteria.
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
102 encryption 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
115 individual properties of the device are represented as simple files
116 that 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 DS2413
127 The DS2413 (3) allows control of other devices, like LEDs and relays.
128 It differs from the DS2405 with a cleaner interface and two channels
129 The DS2413 also has two channels like the DS2406 and DS2407 but has no
130 memory, and no alarm. There is also varying types of switch and sens‐
131 ing in the DS2408, DS2409, LCD, DS276x, DS2450.
132 Unique among the switches, the DS2413 can switch higher voltages, up to
133 28V.
134
136 All 1-wire devices are factory assigned a unique 64-bit address. This
137 address is of the form:
138 Family Code
140 8 bits
141 Address
143 48 bits
144 CRC 8 bits
146 Addressing under OWFS is in hexadecimal, of form:
148 01.123456789ABC
150 where 01 is an example 8-bit family code, and 12345678ABC is an example
152 48 bit address.
153 The dot is optional, and the CRC code can included. If included, it
155 must be correct.
156
158 http://datasheets.maxim-ic.com/en/ds/DS2413.pdf
159
161 Programs
162 owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1)
163 owwrite (1) owpresent (1) owtap (1)
164 Configuration and testing
166 owfs (5) owtap (1) owmon (1)
167 Language bindings
169 owtcl (3) owperl (3) owcapi (3)
170 Clocks
172 DS1427 (3) DS1904 (3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3)
173 DS2417 (3)
174 ID
176 DS2401 (3) DS2411 (3) DS1990A (3)
177 Memory
179 DS1982 (3) DS1985 (3) DS1986 (3) DS1991 (3) DS1992 (3) DS1993 (3)
180 DS1995 (3) DS1996 (3) DS2430A (3) DS2431 (3) DS2433 (3) DS2502 (3)
181 DS2506 (3) DS28E04 (3) DS28EC20 (3)
182 Switches
184 DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
185 Temperature
187 DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
188 DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
189 EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
190 [1m(3)
191 Humidity
193 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
194 Voltage
196 DS2450 (3)
197 Resistance
199 DS2890 (3)
200 Multifunction (current, voltage, temperature)
202 DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3)
203 DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
204 Counter
206 DS2423 (3)
207 LCD Screen
209 LCD (3) DS2408 (3)
210 Crypto
212 DS1977 (3)
213 Pressure
215 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
216 Moisture
218 EEEF (3) DS2438 (3)
219
221 http://www.owfs.org
222
224 Paul Alfille (paul.alfille@gmail.com)
225OWFS Manpage 2005 DS2413(3)