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

NAME

6       mAM001 - Analog Input Module
7

SYNOPSIS

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

FAMILY CODE

14       B2
15

SPECIAL PROPERTIES

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

STANDARD PROPERTIES

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 hexidecimal 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 hexidecimal 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 hexidecimal 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 hexidecimal) 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

ALARMS

101       None.
102

DESCRIPTION

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 fundemental 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

ADDRESSING

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 hexidecimal, 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

WEBSITE

165       http://www.cmciel.com/products-solutions/individual-products/analog-
166       input-mam001/
167

SEE ALSO

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       (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

AVAILABILITY

229       http://www.owfs.org
230

AUTHOR

232       Paul Alfille (paul.alfille@gmail.com)
233
234
235
236OWFS Manpage                         2003                            mAM001(3)
Impressum