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 hexadecimal 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 up‐
52 per 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 en‐
101 cryption 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 in‐
114 dividual properties of the device are represented as simple files that
115 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) In‐
181 fernoEmbedded (3)
182 Temperature
184 DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
185 DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
186 EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
187 [1m(3)
188 Humidity
190 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
191 Voltage
193 DS2450 (3)
194 Resistance
196 DS2890 (3)
197 Multifunction (current, voltage, temperature)
199 DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3)
200 DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
201 Counter
203 DS2423 (3)
204 LCD Screen
206 LCD (3) DS2408 (3)
207 Crypto
209 DS1977 (3)
210 Pressure
212 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
213 Moisture
215 EEEF (3) DS2438 (3)
216
218 http://www.owfs.org
219
221 Paul Alfille (paul.alfille@gmail.com)
222OWFS Manpage 2003 DS1963L(3)