1mAM001(3) One-Wire File System mAM001(3)
2
3
4
6 mAM001 - Analog Input Module
7
9 Voltage or current meter.
10 B2 [.]XXXXXXXXXXXX[XX][/[ current | volts | address | crc8 | id | loca‐
11 tor | r_address | r_id | r_locator | type ]]
12
14 B2
15
17 Note that the volts and current are mutually exclusive and set by
18 switches on the sensor case.
19
20 Although both volts and current will give a value, only one of the two
21 is correct. (Based on the electrical connections and switch settings).
22
23 current
24 read-write, floating point
25 Reads the current.
26
27 Range 0-20mA
28
29 Resolution
30 12 bit (5 uA)
31
32 Units A (amperes)
33
34 Frequency
35 DC
36
37 volts
38 read-write, floating point
39 Reads the voltage.
40
41 Range 0-10V
42
43 Resolution
44 12 bit (2.5 mV)
45
46 Units V (volts)
47
48 Frequency
49 DC
50
52 address
53 r_address
54 read-only, ascii
55 The entire 64-bit unique ID. Given as upper case hexidecimal digits
56 (0-9A-F).
57 address starts with the family code
58 r address is the address in reverse order, which is often used in other
59 applications and labeling.
60
61 crc8
62 read-only, ascii
63 The 8-bit error correction portion. Uses cyclic redundancy check. Com‐
64 puted from the preceding 56 bits of the unique ID number. Given as
65 upper case hexadecimal digits (0-9A-F).
66
67 family
68 read-only, ascii
69 The 8-bit family code. Unique to each type of device. Given as upper
70 case hexadecimal digits (0-9A-F).
71
72 id
73 r_id
74 read-only, ascii
75 The 48-bit middle portion of the unique ID number. Does not include the
76 family code or CRC. Given as upper case hexadecimal digits (0-9A-F).
77 r id is the id in reverse order, which is often used in other applica‐
78 tions and labeling.
79
80 locator
81 r_locator
82 read-only, ascii
83 Uses an extension of the 1-wire design from iButtonLink company that
84 associated 1-wire physical connections with a unique 1-wire code. If
85 the connection is behind a Link Locator the locator will show a unique
86 8-byte number (16 character hexadecimal) starting with family code FE.
87 If no Link Locator is between the device and the master, the locator
88 field will be all FF.
89 r locator is the locator in reverse order.
90
91 present (DEPRECATED)
92 read-only, yes-no
93 Is the device currently present on the 1-wire bus?
94
95 type
96 read-only, ascii
97 Part name assigned by Dallas Semi. E.g. DS2401 Alternative packaging
98 (iButton vs chip) will not be distiguished.
99
101 None.
102
104 1-Wire
105 1-wire is a wiring protocol and series of devices designed and manufac‐
106 tured by Dallas Semiconductor, Inc. The bus is a low-power low-speed
107 low-connector scheme where the data line can also provide power.
108
109 Each device is uniquely and unalterably numbered during manufacture.
110 There are a wide variety of devices, including memory, sensors (humid‐
111 ity, temperature, voltage, contact, current), switches, timers and data
112 loggers. More complex devices (like thermocouple sensors) can be built
113 with these basic devices. There are also 1-wire devices that have
114 encryption included.
115
116 The 1-wire scheme uses a single bus master and multiple slaves on the
117 same wire. The bus master initiates all communication. The slaves can
118 be individually discovered and addressed using their unique ID.
119
120 Bus masters come in a variety of configurations including serial, par‐
121 allel, i2c, network or USB adapters.
122
123 OWFS design
124 OWFS is a suite of programs that designed to make the 1-wire bus and
125 its devices easily accessible. The underlying principle is to create a
126 virtual filesystem, with the unique ID being the directory, and the
127 individual properties of the device are represented as simple files
128 that can be read and written.
129
130 Details of the individual slave or master design are hidden behind a
131 consistent interface. The goal is to provide an easy set of tools for a
132 software designer to create monitoring or control applications. There
133 are some performance enhancements in the implementation, including data
134 caching, parallel access to bus masters, and aggregation of device com‐
135 munication. Still the fundamental goal has been ease of use, flexibil‐
136 ity and correctness rather than speed.
137
138 mAM001
139 The mAM001 (3) is a voltage or current meter from CMC Industrial Elec‐
140 tronics. It is packaged for industrial use.
141
143 All 1-wire devices are factory assigned a unique 64-bit address. This
144 address is of the form:
145
146 Family Code
147 8 bits
148
149 Address
150 48 bits
151
152 CRC 8 bits
153
154 Addressing under OWFS is in hexadecimal, of form:
155
156 01.123456789ABC
157
158 where 01 is an example 8-bit family code, and 12345678ABC is an example
159 48 bit address.
160
161 The dot is optional, and the CRC code can included. If included, it
162 must be correct.
163
165 http://www.cmciel.com/products-solutions/individual-products/analog-
166 input-mam001/
167
169 Programs
170 owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1)
171 owwrite (1) owpresent (1) owtap (1)
172
173 Configuration and testing
174 owfs (5) owtap (1) owmon (1)
175
176 Language bindings
177 owtcl (3) owperl (3) owcapi (3)
178
179 Clocks
180 DS1427 (3) DS1904 (3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3)
181 DS2417 (3)
182
183 ID
184 DS2401 (3) DS2411 (3) DS1990A (3)
185
186 Memory
187 DS1982 (3) DS1985 (3) DS1986 (3) DS1991 (3) DS1992 (3) DS1993 (3)
188 DS1995 (3) DS1996 (3) DS2430A (3) DS2431 (3) DS2433 (3) DS2502 (3)
189 DS2506 (3) DS28E04 (3) DS28EC20 (3)
190
191 Switches
192 DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
193
194 Temperature
195 DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
196 DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
197 EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
198 [1m(3)
199
200 Humidity
201 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
202
203 Voltage
204 DS2450 (3)
205
206 Resistance
207 DS2890 (3)
208
209 Multifunction (current, voltage, temperature)
210 DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3)
211 DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
212
213 Counter
214 DS2423 (3)
215
216 LCD Screen
217 LCD (3) DS2408 (3)
218
219 Crypto
220 DS1977 (3)
221
222 Pressure
223 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
224
225 Moisture
226 EEEF (3) DS2438 (3)
227
229 http://www.owfs.org
230
232 Paul Alfille (paul.alfille@gmail.com)
233
234
235
236OWFS Manpage 2003 mAM001(3)