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

NAME

6       DS2433 - EEPROM (4 kBit)
7

SYNOPSIS

9       Erasable programmable read-only memory (EEPROM)
10
11       23  [.]XXXXXXXXXXXX[XX][/[  memory  | pages/page.[0-15|ALL] | address |
12       crc8 | id | locator | r_address | r_id | r_locator | type ]]
13

FAMILY CODE

15       23 DS2433
16

SPECIAL PROPERTIES

18   memory
19       read-write, binary
20       512 bytes of memory. Initially all bits are set to 1. Writing zero per‐
21       manently alters the memory.
22
23   pages/page.0 ... pages/page.15 pages/page.ALL
24       read-write, yes-no
25       Memory is split into 16 pages of 32 bytes each.  ALL is an aggregate of
26       the pages. Each page is accessed sequentially.
27

STANDARD PROPERTIES

29   address
30   r_address
31       read-only, ascii
32       The entire 64-bit unique ID. Given as  upper  case  hexidecimal  digits
33       (0-9A-F).
34       address starts with the family code
35       r address is the address in reverse order, which is often used in other
36       applications and labeling.
37
38   crc8
39       read-only, ascii
40       The 8-bit error correction portion. Uses cyclic redundancy check.  Com‐
41       puted  from  the  preceding  56  bits of the unique ID number. Given as
42       upper case hexidecimal digits (0-9A-F).
43
44   family
45       read-only, ascii
46       The 8-bit family code. Unique to each type of device.  Given  as  upper
47       case hexidecimal digits (0-9A-F).
48
49   id
50   r_id
51       read-only, ascii
52       The 48-bit middle portion of the unique ID number. Does not include the
53       family code or CRC. Given as upper case hexidecimal digits (0-9A-F).
54       r id is the id in reverse order, which is often used in other  applica‐
55       tions and labeling.
56
57   locator
58   r_locator
59       read-only, ascii
60       Uses  an  extension  of the 1-wire design from iButtonLink company that
61       associated 1-wire physical connections with a unique  1-wire  code.  If
62       the  connection is behind a Link Locator the locator will show a unique
63       8-byte number (16 character hexidecimal) starting with family code FE.
64       If no Link Locator is between the device and the  master,  the  locator
65       field will be all FF.
66       r locator is the locator in reverse order.
67
68   present (DEPRECATED)
69       read-only, yes-no
70       Is the device currently present on the 1-wire bus?
71
72   type
73       read-only, ascii
74       Part  name  assigned by Dallas Semi. E.g.  DS2401 Alternative packaging
75       (iButton vs chip) will not be distiguished.
76

ALARMS

78       None.
79

DESCRIPTION

81   1-Wire
82       1-wire is a wiring protocol and series of devices designed and manufac‐
83       tured  by  Dallas  Semiconductor, Inc. The bus is a low-power low-speed
84       low-connector scheme where the data line can also provide power.
85
86       Each device is uniquely and unalterably  numbered  during  manufacture.
87       There  are a wide variety of devices, including memory, sensors (humid‐
88       ity, temperature, voltage, contact, current), switches, timers and data
89       loggers.  More complex devices (like thermocouple sensors) can be built
90       with these basic devices. There  are  also  1-wire  devices  that  have
91       encryption included.
92
93       The  1-wire  scheme uses a single bus master and multiple slaves on the
94       same wire. The bus master initiates all communication. The  slaves  can
95       be individually discovered and addressed using their unique ID.
96
97       Bus  masters come in a variety of configurations including serial, par‐
98       allel, i2c, network or USB adapters.
99
100   OWFS design
101       OWFS is a suite of programs that designed to make the  1-wire  bus  and
102       its  devices easily accessible. The underlying principle is to create a
103       virtual filesystem, with the unique ID being  the  directory,  and  the
104       individual  properties  of  the  device are represented as simple files
105       that can be read and written.
106
107       Details of the individual slave or master design are  hidden  behind  a
108       consistent interface. The goal is to provide an easy set of tools for a
109       software designer to create monitoring or control  applications.  There
110       are some performance enhancements in the implementation, including data
111       caching, parallel access to bus masters, and aggregation of device com‐
112       munication.  Still the fundemental goal has been ease of use, flexibil‐
113       ity and correctness rather than speed.
114
115   DS2433
116       The DS2433 (3) is used for storing memory  which  should  be  available
117       even  after  a  reset  or  power  off. It's main advantage is for audit
118       trails (i.e. a digital purse).  OWFS system handles this automatically.
119

ADDRESSING

121       All 1-wire devices are factory assigned a unique 64-bit  address.  This
122       address is of the form:
123
124       Family Code
125              8 bits
126
127       Address
128              48 bits
129
130       CRC    8 bits
131
132       Addressing under OWFS is in hexidecimal, of form:
133
134              01.123456789ABC
135
136       where 01 is an example 8-bit family code, and 12345678ABC is an example
137       48 bit address.
138
139       The dot is optional, and the CRC code can  included.  If  included,  it
140       must be correct.
141

DATASHEET

143       http://pdfserv.maxim-ic.com/en/ds/DS2433.pdf
144

SEE ALSO

146   Programs
147       owfs  (1)  owhttpd  (1)  owftpd  (1)  owserver (1) owdir (1) owread (1)
148       owwrite (1) owpresent (1) owtap (1)
149
150   Configuration and testing
151       owfs (5) owtap (1) owmon (1)
152
153   Language bindings
154       owtcl (3) owperl (3) owcapi (3)
155
156   Clocks
157       DS1427 (3) DS1904 (3) DS1994 (3) DS2404  (3)  DS2404S  (3)  DS2415  (3)
158       DS2417 (3)
159
160   ID
161       DS2401 (3) DS2411 (3) DS1990A (3)
162
163   Memory
164       DS1982  (3)  DS1985  (3)  DS1986  (3)  DS1991 (3) DS1992 (3) DS1993 (3)
165       DS1995 (3) DS1996 (3) DS2430A (3) DS2431  (3)  DS2433  (3)  DS2502  (3)
166       DS2506 (3) DS28E04 (3) DS28EC20 (3)
167
168   Switches
169       DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
170
171   Temperature
172       DS1822  (3)  DS1825  (3)  DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
173       DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065  (3)
174       EDS0066  (3)  EDS0067  (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
175       (3)
176
177   Humidity
178       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
179
180   Voltage
181       DS2450 (3)
182
183   Resistance
184       DS2890 (3)
185
186   Multifunction (current, voltage, temperature)
187       DS2436 (3) DS2437 (3) DS2438 (3)  DS2751  (3)  DS2755  (3)  DS2756  (3)
188       DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
189
190   Counter
191       DS2423 (3)
192
193   LCD Screen
194       LCD (3) DS2408 (3)
195
196   Crypto
197       DS1977 (3)
198
199   Pressure
200       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
201
202   Moisture
203       EEEF (3) DS2438 (3)
204

AVAILABILITY

206       http://www.owfs.org
207

AUTHOR

209       Christian Magnusson (mag@mag.cx)
210
211
212
213OWFS Manpage                         2003                            DS2433(3)
Impressum