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

NAME

6       DS1963L - 256 byte Monetary iButton
7

SYNOPSIS

9       Non-volatile R/W memory with counters
10
11       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

FAMILY CODE

16       1A
17

SPECIAL PROPERTIES

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
24       Only 4 pages are actually connected to counters:
25
26       Counter1
27              page/counter.12
28
29       Counter2
30              page/counter.13
31
32       Counter3
33              page/counter.14
34
35       Counter4
36              page/counter.15
37

STANDARD PROPERTIES

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
48   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
54   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
59   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
67   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
78   present (DEPRECATED)
79       read-only, yes-no
80       Is the device currently present on the 1-wire bus?
81
82   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

ALARMS

88       None.
89

DESCRIPTION

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
96       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
103       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
107       Bus  masters come in a variety of configurations including serial, par‐
108       allel, i2c, network or USB adapters.
109
110   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
117       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
125   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

ADDRESSING

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

DATASHEET

154       http://datasheets.maxim-ic.com/en/ds/DS1963L.pdf
155

SEE ALSO

157   Programs
158       owfs (1) owhttpd (1) owftpd (1)  owserver  (1)  owdir  (1)  owread  (1)
159       owwrite (1) owpresent (1) owtap (1)
160
161   Configuration and testing
162       owfs (5) owtap (1) owmon (1)
163
164   Language bindings
165       owtcl (3) owperl (3) owcapi (3)
166
167   Clocks
168       DS1427  (3)  DS1904  (3)  DS1994  (3) DS2404 (3) DS2404S (3) DS2415 (3)
169       DS2417 (3)
170
171   ID
172       DS2401 (3) DS2411 (3) DS1990A (3)
173
174   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
179   Switches
180       DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
181
182   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       (3)
187
188   Humidity
189       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
190
191   Voltage
192       DS2450 (3)
193
194   Resistance
195       DS2890 (3)
196
197   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
201   Counter
202       DS2423 (3)
203
204   LCD Screen
205       LCD (3) DS2408 (3)
206
207   Crypto
208       DS1977 (3)
209
210   Pressure
211       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
212
213   Moisture
214       EEEF (3) DS2438 (3)
215

AVAILABILITY

217       http://www.owfs.org
218

AUTHOR

220       Paul Alfille (paul.alfille@gmail.com)
221
222
223
224OWFS Manpage                         2003                           DS1963L(3)
Impressum