1DS1963L(3) One-Wire File System DS1963L(3)
2
6 DS1963L - 256 byte Monetary iButton
7
9 Non-volatile R/W memory with counters
10 1A [.]XXXXXXXXXXXX[XX][/[ pages/count.[0-15|ALL] | memory |
12 pages/page.[0-15|ALL] | address | crc8 | id | locator | r_address |
13 r_id | r_locator | type ]]
14
16 1A
17
19 page/count.[0-15|ALL]
20 read-only, unsigned
21 Each write to the memory page increments the counter. An application
22 can tell if the memory has been changed by another process.
23 Only 4 pages are actually connected to counters:
25 Counter1
27 page/counter.12
28 Counter2
30 page/counter.13
31 Counter3
33 page/counter.14
34 Counter4
36 page/counter.15
37
39 address
40 r_address
41 read-only, ascii
42 The entire 64-bit unique ID. Given as upper case hexidecimal digits
43 (0-9A-F).
44 address starts with the family code
45 r address is the address in reverse order, which is often used in other
46 applications and labeling.
47 crc8
49 read-only, ascii
50 The 8-bit error correction portion. Uses cyclic redundancy check. Com‐
51 puted from the preceding 56 bits of the unique ID number. Given as
52 upper case hexadecimal digits (0-9A-F).
53 family
55 read-only, ascii
56 The 8-bit family code. Unique to each type of device. Given as upper
57 case hexadecimal digits (0-9A-F).
58 id
60 r_id
61 read-only, ascii
62 The 48-bit middle portion of the unique ID number. Does not include the
63 family code or CRC. Given as upper case hexadecimal digits (0-9A-F).
64 r id is the id in reverse order, which is often used in other applica‐
65 tions and labeling.
66 locator
68 r_locator
69 read-only, ascii
70 Uses an extension of the 1-wire design from iButtonLink company that
71 associated 1-wire physical connections with a unique 1-wire code. If
72 the connection is behind a Link Locator the locator will show a unique
73 8-byte number (16 character hexadecimal) starting with family code FE.
74 If no Link Locator is between the device and the master, the locator
75 field will be all FF.
76 r locator is the locator in reverse order.
77 present (DEPRECATED)
79 read-only, yes-no
80 Is the device currently present on the 1-wire bus?
81 type
83 read-only, ascii
84 Part name assigned by Dallas Semi. E.g. DS2401 Alternative packaging
85 (iButton vs chip) will not be distiguished.
86
88 None.
89
91 1-Wire
92 1-wire is a wiring protocol and series of devices designed and manufac‐
93 tured by Dallas Semiconductor, Inc. The bus is a low-power low-speed
94 low-connector scheme where the data line can also provide power.
95 Each device is uniquely and unalterably numbered during manufacture.
97 There are a wide variety of devices, including memory, sensors (humid‐
98 ity, temperature, voltage, contact, current), switches, timers and data
99 loggers. More complex devices (like thermocouple sensors) can be built
100 with these basic devices. There are also 1-wire devices that have
101 encryption included.
102 The 1-wire scheme uses a single bus master and multiple slaves on the
104 same wire. The bus master initiates all communication. The slaves can
105 be individually discovered and addressed using their unique ID.
106 Bus masters come in a variety of configurations including serial, par‐
108 allel, i2c, network or USB adapters.
109 OWFS design
111 OWFS is a suite of programs that designed to make the 1-wire bus and
112 its devices easily accessible. The underlying principle is to create a
113 virtual filesystem, with the unique ID being the directory, and the
114 individual properties of the device are represented as simple files
115 that can be read and written.
116 Details of the individual slave or master design are hidden behind a
118 consistent interface. The goal is to provide an easy set of tools for a
119 software designer to create monitoring or control applications. There
120 are some performance enhancements in the implementation, including data
121 caching, parallel access to bus masters, and aggregation of device com‐
122 munication. Still the fundamental goal has been ease of use, flexibil‐
123 ity and correctness rather than speed.
124 DS1963L
126 The DS1963L (3) is used for read/write storage. It's main advantage is
127 for audit trails (i.e. a digital purse). Each write to pages 12-15 will
128 increment the read-only counter. OWFS system handles this automati‐
129 cally.
130
132 All 1-wire devices are factory assigned a unique 64-bit address. This
133 address is of the form:
134 Family Code
136 8 bits
137 Address
139 48 bits
140 CRC 8 bits
142 Addressing under OWFS is in hexadecimal, of form:
144 01.123456789ABC
146 where 01 is an example 8-bit family code, and 12345678ABC is an example
148 48 bit address.
149 The dot is optional, and the CRC code can included. If included, it
151 must be correct.
152
154 http://datasheets.maxim-ic.com/en/ds/DS1963L.pdf
155
157 Programs
158 owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1)
159 owwrite (1) owpresent (1) owtap (1)
160 Configuration and testing
162 owfs (5) owtap (1) owmon (1)
163 Language bindings
165 owtcl (3) owperl (3) owcapi (3)
166 Clocks
168 DS1427 (3) DS1904 (3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3)
169 DS2417 (3)
170 ID
172 DS2401 (3) DS2411 (3) DS1990A (3)
173 Memory
175 DS1982 (3) DS1985 (3) DS1986 (3) DS1991 (3) DS1992 (3) DS1993 (3)
176 DS1995 (3) DS1996 (3) DS2430A (3) DS2431 (3) DS2433 (3) DS2502 (3)
177 DS2506 (3) DS28E04 (3) DS28EC20 (3)
178 Switches
180 DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
181 Temperature
183 DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
184 DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
185 EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
186 [1m(3)
187 Humidity
189 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
190 Voltage
192 DS2450 (3)
193 Resistance
195 DS2890 (3)
196 Multifunction (current, voltage, temperature)
198 DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3)
199 DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
200 Counter
202 DS2423 (3)
203 LCD Screen
205 LCD (3) DS2408 (3)
206 Crypto
208 DS1977 (3)
209 Pressure
211 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
212 Moisture
214 EEEF (3) DS2438 (3)
215
217 http://www.owfs.org
218
220 Paul Alfille (paul.alfille@gmail.com)
221OWFS Manpage 2003 DS1963L(3)