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.

EDS0083/set_alarm/current_low.[0-3|ALL|BYTE]

EDS0085/set_alarm/volts_hi.[0-3|ALL|BYTE]

EDS0085/set_alarm/volts_low.[0-3|ALL|BYTE]

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 \t\tEDS00XX/alarm/temp_low

EDS006X/alarm/humidity_hi \tEDS006X/alarm/humidity_low

EDS006X/alarm/dew_point_hi \tEDS006X/alarm/dew_point_low

EDS006X/alarm/heat_index_hi \tEDS006X/alarm/heat_index_low

EDS006X/alarm/humidex_hi \t\tEDS006X/alarm/humidex_low

EDS006X/alarm/pressure_hi \tEDS006X/alarm/pressure_low

EDS006X/alarm/inHg_hi \t\tEDS006X/alarm/inHg_low

EDS006X/alarm/light_hi \t\tEDS006X/alarm/light_low

EDS0070/alarm/vib_hi \t\tEDS007X/alarm/vib_low

EDS007X/alarm/resistance_hi \tEDS007X/alarm/resistance_low

EDS0080/alarm/current_hi.[0-7|ALL|BYTE]

EDS0080/alarm/current_low.[0-7|ALL|BYTE]

EDS0082/alarm/volts_hi.[0-7|ALL|BYTE]

EDS0082/alarm/volts_low.[0-7|ALL|BYTE]

EDS0083/alarm/current_hi.[0-3|ALL|BYTE]

EDS0083/alarm/current_low.[0-3|ALL|BYTE]

EDS0085/alarm/volts_hi.[0-3|ALL|BYTE]

EDS0085/alarm/volts_low.[0-3|ALL|BYTE]

EDS0090/alarm/hi[0-7|ALL] \tEDS0090/alarm/low[0-7|ALL]

read-only, yes-no

Show corresponding out-of-range alarm. "1" means in alarm state. Can only be turned off with clear

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.

EDS0090/counter/pulses.0-7 | ALL

read-only, unsigned integer

Pulses on each channel since power up or reset. Channel should be set to input ( EDS0090/output/set.x =0 )

EDS0090/counter/reset.0-7 | ALL | BYTE

read-write, yes-no

Clear the pulse count on the corresponding channel.

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.

EDS008X/memory

read-write, binary

160 bytes of memory. Not all is writable. Access to EDS008X functions is better accomplished through the data fields, which expose all the chip features. The EDS008X has more memory than the other chips, so a separate entry in the sudbirectory makes it available.

EDS008X/pages/page.0-4 EDS008X/pages/page.ALL

read-write, binary

Memory is split into 5 pages of 32 bytes each. Only page 5 is writable. The EDS008X has more memory than the other chips, so a separate entry in the sudbirectory makes the extra pages available. ALL is an aggregate of the pages. Each page is accessed sequentially.

family

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.

Memory

The EDS00XX sensors are read and controlled by accessing parts of their on-chip memory. Although the raw memory contents are exposed in the memory and pages fields, all the available functionality is best accessed by the other fields. In fact, directly changing memory will confuse OWFS.

Relay and LED

All the EDS00XX sensors have an LED and optional relay. Both can be controlled either directly, or when the sensors reaches an alarm state.

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.