Provided by: owfs-doc_2.8p15-1ubuntu4_all bug

NAME

       EDS -Embedded Data Systems Sensors
       EDS0064 -Temperature
       EDS0065 -Temperature and Humidity
       EDS0066 -Temperature and Barometric Pressure
       EDS0067 -Temperature and Light
       EDS0068 -Temperature, Barometric Pressure and Light
       EDS0071 -RTD 4-wire temperature
       EDS0072 -RTD 3-wire temperature

SYNOPSIS

       Embedded Data Systems microprocessor-based sensors

   Sub-type ( all )
       7E [.]XXXXXXXXXXXX[XX][/[ device_id | device_type | tag ]]

   Memory ( all )
       7E [.]XXXXXXXXXXXX[XX][/[ memory | pages/page.[0-2|ALL] ]]

   Standard ( all )
       7E [.]XXXXXXXXXXXX[XX][/[ address | crc8 | id | locator | r_address | r_id | r_locator | type ]]

   Temperature ( EDS0064/5/6/7/8 )
       7E.XXXXXXXXXXXX/EDS006X   [/[   temperature  |  counters/seconds  |  alarm/  temp_[hi|low]  |  set_alarm/
       temp_[hi|low] | threshold/ temp_[hi|low] ]]

   Humidity ( EDS0065/8 )
       7E.XXXXXXXXXXXX/EDS006X [/[ humidity | humidex | dew_point |  heat_index  |  alarm/  humidity_[hi|low]  |
       alarm/   humidex_[hi|low]   |   alarm/  dew_point_[hi|low]  |  alarm/  heat_index_[hi|low]  |  set_alarm/
       humidity_[hi|low]  |  set_alarm/  humidex_[hi|low]   |   set_alarm/   dew_point_[hi|low]   |   set_alarm/
       heat_index_[hi|low]   |   threshold/   humidity_[hi|low]   |  threshold/  humidex_[hi|low]  |  threshold/
       dew_point_[hi|low] | threshold/ heat_index_[hi|low] ]]

   Barometric Pressure ( EDS0066/8 )
       7E.XXXXXXXXXXXX/EDS006X [/[  pressure  |  inHg  |  alarm/  pressure_[hi|low]  |  alarm/  inHg_[hi|low]  |
       set_alarm/  pressure_[hi|low]  |  set_alarm/  inHg_[hi|low]  |  threshold/ pressure_[hi|low] | threshold/
       inHg_[hi|low] ]]

   Light ( EDS0067/8 )
       7E.XXXXXXXXXXXX/EDS006X [/[ light |  alarm/  light_[hi|low]  |  set_alarm/  light_[hi|low]  |  threshold/
       light_[hi|low] ]]

   RTD Temperature ( EDS0071/2 )
       7E.XXXXXXXXXXXX/EDS007X    [/[    temperature    |   resistance   |   raw   |   delay   |   user_byte   |
       calibration/[key|constant] |  counter/[seconds|samples]  |  alarm/temp_[hi|low]  |  alarm/RTD_[hi_low]  |
       set_alarm/temp_[hi|low] | set_alarm/RTD_[hi_low] | threshold/temp_[hi|low] | threshold/RTD_[hi_low] ]]

   LED ( all )
       7E.XXXXXXXXXXXX/EDS00XX/LED/[state|control]

   relay ( all )
       7E.XXXXXXXXXXXX/EDS00XX/relay/[state|control]

FAMILY CODE

       7E

TEMPERATURE

   EDS006X/temperature
       read-only, floating-point
       Temperature  for  the  EDS006X  series  of  chips. In the -55C to 125C range, with 0.0636C precision. The
       temperature is read every second, continually. Data is presented  in  the  specified  temperature  scale,
       Celsius by default.

   EDS007X/temperature
       read-only, floating-point
       Temperature for the EDS007X series of chips. Read using a wide-range precise RTD sensor. Typical range is
       -60C to 260C with 0.15C accuracy, although a range of -200C to 850C is possible. The temperature is  read
       every  second  unless  a  longer  EDS007X/delay  is given. Data is presented in the specified temperature
       scale, Celsius by default.

   EDS007X/resistance
       read-only, floating-point
       Actual measured resistance (Ohms) of the RTD element. Useful if the RTD element doesn't  conform  to  the
       typical European IEC 60751 standard.

HUMIDITY

   EDS006X/humidity
       read-only, floating-point
       Relative humidity in the 0-100 range (percent). Read every 0.2 seconds.

   EDS006X/dew_point
       read-only, floating-point
       Dew  point computed from EDS006X/temperature and EDS006X/humidity computered every 0.2 seconds. Data is a
       calculated temperature and is reported in the specified temperature scale. Default Celsius.

   EDS006X/heat_index
       read-only, floating-point
       Heat index computed from EDS006X/temperature and EDS006X/humidity computered every 0.2 seconds. Data is a
       calculated temperature and is reported in the specified temperature scale. Default Celsius.

   EDS006X/humidex
       read-only, floating-point
       Humidex  (popular  in Canada) computed from EDS006X/temperature and EDS006X/humidity computered every 0.2
       seconds. Data is a percent and reported in the 0-100 range.

LIGHT

   EDS006X/light
       read-only, unsigned integer
       Ambient light in Lux. Measured every 0.2 seconds.

PRESSURE

   EDS006X/pressure
       read-only, floating-point
       Ambient pressure, measured every 0.2 seconds. Data in the selected pressure scale (default mBar).

   EDS006X/inHg
       read-only, floating-point
       Ambient pressure, measured every 0.2 seconds. Data in the inHg scale.

THRESHOLD

       High and low range of acceptable sensor readings. Values outside this range will trigger an alarm if  the
       corresponding EDS00XX/set_alarm flag is set.

   EDS00XX/threshold/temp_hi EDS00XX/threshold/temp_low
       read-write, floating-point
       Threshold temperatures in the specified temperature scale. Default Celsius.

   EDS006X/threshold/humidity_hi EDS006X/threshold/humidity_low
   EDS006X/threshold/dew_point_hi EDS006X/threshold/dew_point_low
   EDS006X/threshold/heat_index_hi EDS006X/threshold/heat_index_low
   EDS006X/threshold/humidex_hi EDS006X/threshold/humidex_low
       read-write, floating-point
       Threshold  humidity  values.   Dew  point  and Heat index are in the specified temperature scale. Default
       Celsius.

   EDS006X/threshold/pressure_hi EDS006X/threshold/pressure_low
   EDS006X/threshold/inHg_hi EDS006X/threshold/inHg_low
       read-write, floating-point
       Threshold barometric pressure values.  Pressure is the specified pressure scale. Default mBar.

   EDS006X/threshold/light_hi EDS006X/threshold/light_low
       read-write, unsigned
       Threshold light (lux) values.

   EDS007X/threshold/resistance_hi EDS007X/threshold/resistance_low
       read-write, floating-point
       Threshold RTD resistance values (Ohm).

SET ALARM

       Set conditional alarm to trigger if corresponding flag is set. Also must set high and low threshold.

   EDS00XX/set_alarm/temp_hi EDS00XX/set_alarm/temp_low
   EDS006X/set_alarm/humidity_hi EDS006X/set_alarm/humidity_low
   EDS006X/set_alarm/dew_point_hi EDS006X/set_alarm/dew_point_low
   EDS006X/set_alarm/heat_index_hi EDS006X/set_alarm/heat_index_low
   EDS006X/set_alarm/humidex_hi EDS006X/set_alarm/humidex_low
   EDS006X/set_alarm/pressure_hi EDS006X/set_alarm/pressure_low
   EDS006X/set_alarm/inHg_hi EDS006X/set_alarm/inHg_low
   EDS006X/set_alarm/light_hi EDS006X/set_alarm/light_low
   EDS007X/set_alarm/resistance_hi EDS007X/set_alarm/resistance_low
       read-write, yes-no
       Flag to set corresponding out-of-range alarm. "1" turns on flag, and "0" turns off.

ALARM

       Show or clear the out-of-range flags. When set, the device will respond to a conditional search. Clearing
       the flags is performed with the EDS00XX/alarm/clear command, not just having the measured value return to
       the center range.

   EDS00XX/alarm/clear
       write-only, yes-no
       Write "1" to clear ALL the alarm flags.

   EDS00XX/alarm/temp_hi EDS00XX/alarm/temp_low
   EDS006X/alarm/humidity_hi EDS006X/alarm/humidity_low
   EDS006X/alarm/dew_point_hi EDS006X/alarm/dew_point_low
   EDS006X/alarm/heat_index_hi EDS006X/alarm/heat_index_low
   EDS006X/alarm/humidex_hi EDS006X/alarm/humidex_low
   EDS006X/alarm/pressure_hi EDS006X/alarm/pressure_low
   EDS006X/alarm/inHg_hi EDS006X/alarm/inHg_low
   EDS006X/alarm/light_hi EDS006X/alarm/light_low
   EDS007X/alarm/resistance_hi EDS007X/alarm/resistance_low
       read-only, yes-no
       Flag to set corresponding out-of-range alarm. "1" turns on flag, and "0" turns off.

RELAY

       Optionally found on the EDS006X and EDS007X. Can be controlled by software or the alarm condition.

   EDS00XX/relay/control
       read-write, unsigned
       Set the relay control scheme:

       0      alarm control with hysteresis

       1      alarm control but need EDS00XX/alarm/clear to unset

       2      Control with EDS00XX/relay/state

       3      Always off

   EDS00XX/relay/state
       read-write, yes-no
       Turn the relay on or off if the EDS00XX/relay/control is set to 2

LED light

       Found on the EDS006X and EDS007X. Can be controlled by software or the alarm condition.

   EDS00XX/LED/control
       read-write, unsigned
       Set the LED control scheme:

       0      alarm control with hysteresis

       1      alarm control but need EDS00XX/alarm/clear to unset

       2      Control with EDS00XX/LED/state

       3      Always off

   EDS00XX/LED/state
       read-write, yes-no
       Turn the LED on or off if the EDS00XX/LED/control is set to 2

COUNTER

   EDS00XX/counter/seconds
       read-only, unsigned integer
       Approximate seconds since power up.

   EDS007X/counter/samples
       read-only, unsigned integer
       Approximate samples since power up.

MEMORY

   memory
       read-write, binary
       96 bytes of memory. Not all is writable. Access to EDS00XX functions is better accomplished  through  the
       data fields, which expose all the chip features.

   pages/page.0 ... pages/page.2 pages/page.ALL
       read-write, binary
       Memory  is  split  into  3  pages  of 32 bytes each. Only page 2 is writable.  ALL is an aggregate of the
       pages. Each page is accessed sequentially.

SUB-TYPE

   tag
       read-only, ascii
       Text description of the device. Up to 30 characters.

   device_type
       read-only, ascii
       Device name. E.g: "EDS0071"

   device_id
       read-only, unsigned
       Number corresponding to the hexidecimal type. E.g:
       EDS0071 -> 0x0071 -> 113 in decimal

STANDARD PROPERTIES

   address
   r_address
       read-only, ascii
       The entire 64-bit unique ID. Given as upper case hexidecimal digits (0-9A-F).
       address starts with the family code
       r address is the address in reverse order, which is often used in other applications and labeling.

   crc8
       read-only, ascii
       The 8-bit error correction portion. Uses cyclic redundancy check. Computed from the preceding 56 bits  of
       the unique ID number. Given as upper case hexidecimal digits (0-9A-F).

   family
       read-only, ascii
       The 8-bit family code. Unique to each type of device. Given as upper case hexidecimal digits (0-9A-F).

   id
   r_id
       read-only, ascii
       The  48-bit  middle  portion  of  the unique ID number. Does not include the family code or CRC. Given as
       upper case hexidecimal digits (0-9A-F).
       r id is the id in reverse order, which is often used in other applications and labeling.

   locator
   r_locator
       read-only, ascii
       Uses an extension of  the  1-wire  design  from  iButtonLink  company  that  associated  1-wire  physical
       connections with a unique 1-wire code. If the connection is behind a Link Locator the locator will show a
       unique 8-byte number (16 character hexidecimal) starting with family code FE.
       If no Link Locator is between the device and the master, the locator field will be all FF.
       r locator is the locator in reverse order.

   present (DEPRECATED)
       read-only, yes-no
       Is the device currently present on the 1-wire bus?

   type
       read-only, ascii
       Part name assigned by Dallas Semi. E.g.  DS2401 Alternative packaging  (iButton  vs  chip)  will  not  be
       distiguished.

ALARMS

       None.

DESCRIPTION

   1-Wire
       1-wire is a wiring protocol and series of devices designed and manufactured by Dallas Semiconductor, Inc.
       The bus is a low-power low-speed low-connector scheme where the data line can also provide power.

       Each device is uniquely and unalterably numbered during manufacture. There are a wide variety of devices,
       including  memory,  sensors (humidity, temperature, voltage, contact, current), switches, timers and data
       loggers. More complex devices (like thermocouple sensors) can be built with these  basic  devices.  There
       are also 1-wire devices that have encryption included.

       The 1-wire scheme uses a single bus master and multiple slaves on the same wire. The bus master initiates
       all communication. The slaves can be individually discovered and addressed using their unique ID.

       Bus masters come in a variety of configurations including serial, parallel, i2c, network or USB adapters.

   OWFS design
       OWFS is a suite of programs that designed to make the 1-wire bus and its devices easily  accessible.  The
       underlying  priciple  is  to create a virtual filesystem, with the unique ID being the directory, and the
       individual properties of the device are represented as simple files that can be read and written.

       Details of the individual slave or master design are hidden behind a consistent interface. The goal is to
       provide  an easy set of tools for a software designer to create monitoring or control applications. There
       are some performance enhancements in the implementation, including data caching, parallel access  to  bus
       masters,  and  aggregation  of  device  communication.  Still  the fundemental goal has been ease of use,
       flexibility and correctness rather than speed.

   EDS00XX Overview
       The EDS00XX sensors are a family of devices from Embedded Data Systems.  Although provisional support for
       several types is included, only early EDS0071 has been tested with OWFS.

       The  sensors  all  share the same 7E family code. They have the same first memory page layout with a text
       tag property that describes them, and a sub-type field giving the particular sensor. The data  properties
       shown in a directory listing will be specific to the sensor sub-type.

   EDS0071
       The  EDS0071  (3)  is a micro-processor based 1-wire slave made by EDS (Embedded Data Systams). Is uses a
       high accuracy and extended range RTD sensor to accurately measure temperatures.

ADDRESSING

       All 1-wire devices are factory assigned a unique 64-bit address. This address is of the form:

       Family Code
              8 bits

       Address
              48 bits

       CRC    8 bits

       Addressing under OWFS is in hexidecimal, of form:

              01.123456789ABC

       where 01 is an example 8-bit family code, and 12345678ABC is an example 48 bit address.

       The dot is optional, and the CRC code can included. If included, it must be correct.

DATASHEET

       https://www.embeddeddatasystems.com/1-Wire-Interface-for-4-Wire-RTD_p_165.html

SEE ALSO

   Programs
       owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1) owwrite (1) owpresent (1) owtap (1)

   Configuration and testing
       owfs (5) owtap (1) owmon (1)

   Language bindings
       owtcl (3) owperl (3) owcapi (3)

   Clocks
       DS1427 (3) DS1904(3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3) DS2417 (3)

   ID
       DS2401 (3) DS2411 (3) DS1990A (3)

   Memory
       DS1982 (3) DS1985 (3) DS1986 (3) DS1991 (3) DS1992 (3) DS1993 (3)  DS1995  (3)  DS1996  (3)  DS2430A  (3)
       DS2431 (3) DS2433 (3) DS2502 (3) DS2506 (3) DS28E04 (3) DS28EC20 (3)

   Switches
       DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)

   Temperature
       DS1822  (3)  DS1825  (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3) DS1921 (3) DS1821 (3) DS28EA00 (3)
       DS28E04 (3) EDS0064 (3) EDS0065 (3) EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3) EDS0072 (3)

   Humidity
       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)

   Voltage
       DS2450 (3)

   Resistance
       DS2890 (3)

   Multifunction (current, voltage, temperature)
       DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3) DS2760 (3) DS2770 (3) DS2780 (3) DS2781
       (3) DS2788 (3) DS2784 (3)

   Counter
       DS2423 (3)

   LCD Screen
       LCD (3) DS2408 (3)

   Crypto
       DS1977 (3)

   Pressure
       DS2406 (3) -- TAI8570 EDS0066 (3) EDS0068 (3)

AVAILABILITY

       http://www.owfs.org

AUTHOR

       Paul Alfille (paul.alfille@gmail.com)