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  hexadecimal  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 up‐
65       per 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

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  en‐
114       cryption 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 in‐
127       dividual  properties of the device are represented as simple files that
128       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

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

WEBSITE

165       http://www.cmciel.com/products-solutions/individual-products/analog-in
166       put-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) In‐
193       fernoEmbedded (3)
194
195   Temperature
196       DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3)  DS18S20  (3)  DS1920  (3)
197       DS1921  (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
198       EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3)  EDS0072  (3)  MAX31826
199       (3)
200
201   Humidity
202       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
203
204   Voltage
205       DS2450 (3)
206
207   Resistance
208       DS2890 (3)
209
210   Multifunction (current, voltage, temperature)
211       DS2436  (3)  DS2437  (3)  DS2438  (3)  DS2751 (3) DS2755 (3) DS2756 (3)
212       DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
213
214   Counter
215       DS2423 (3)
216
217   LCD Screen
218       LCD (3) DS2408 (3)
219
220   Crypto
221       DS1977 (3)
222
223   Pressure
224       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
225
226   Moisture
227       EEEF (3) DS2438 (3)
228

AVAILABILITY

230       http://www.owfs.org
231

AUTHOR

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