Summary of Contents for esera automation 1-Wire Controller 1
Page 1
Programming Manual 1-Wire Gateway 1-Wire Controller ESERA-Station 1-Wire Controller 1 1-Wire Controller 2 / 1-Wire Controller ECO 200 1-Wire Gateway 10 1-Wire Gateway 11 1-Wire Gateway 20 ESERA-Station 200 As of firmware V1.19_11 All rights reserved. Reproduction as well as electronic duplication of this guide, complete or in part, requires the written consent of ESERA- Automation or E-Service GmbH.
ESERA Concept of Automation 1.1. 1-Wire Controller and 1-Wire Gateway Sensors and actuators of the 1-Wire bus system are automatically detected, integrated and queried at very high speed via the 1-Wire Controller / 1-Wire Gateway. The sensor and actuator data are transmitted to your controller via Ethernet interface, via ASCII (1-Wire Controller) or via ASCII and Modbus protocol.
1.2. ESERA Station-200 Central Control Unit Based on the know-how of the 1-Wire Gateway series, the ESERA Station-200 central control unit was developed. Sensors and actuators of the 1-Wire bus system are automatically detected, integrated and interrogated at very high speed via the integrated 1-Wire gateway. The data of the sensors and actuators are transmitted via an internal serial interface as ASCII or Modbus protocol to the very powerful Quad Code Embedded Computer of the ESERA Station.
Page 4
ESERA Station-200 is a combination of 1-Wire Gateway and embedded computer • The 1-Wire Gateway System is based on a standardized bus system that has been successfully used in industrial environments for many years. • Open bus-system, compatible with sensors and actuators of third-party manufacturers •...
1-Wire Controller 2 Ethernet interface In addition to the functions of the 1-Wire Controller 1, the 1-Wire Controller 2 offers the following features: • Digital input 4 x 10-30VDC, isolated • Digital output 4 + 1 (relay) for switching function and alarming •...
For reasons of maintainability, we have compiled the following command list uniformly for all units of the 1-Wire Controller 1 and 1-Wire Controller 2. We have added a note to those parts that are specifically intended for the 1-Wire Controller 2.
Power supply 1-Wire Controller / 1-Wire Gateway Any DC voltage source with a stabilized output voltage between 9 - 30VDC for 1-Wire Controller 1 and 1-Wire Gateway 10 and 11 and 15-30VDC for 1-Wire Controller 2 and 1-Wire Gateway 20 and a minimum power rating of 1A can be used as power supply.
Modbus Communication 1-Wire Gateway Modbus is de-facto the common bus standard for communication among PLC machine controls and the machine- oriented environment in industry. No PLC control on the market can operate without this bus interface. The success story of the Modbus standard was launched in 1979 by Gould-Modicon for communication with its programmable logic controllers.
5.2. Interface configuration Modbus TCP Settings for the Modbus TCP interface are set via the Network Config-Tool. In the standard system the interface is set to port 5000. If you want to use port 502 for Modbus TCP, change the port for the Ethernet interface in the Network Config-Tool, Figure 4.2.1.
5.3. Modbus and ASCII data output Modbus data of the 1-Wire gateway and the ESERA Station-200 can be queried in a 1-second cycle and can be read or written. A maximum of 20 data points can be read with one Modbus query. The 1-Wire Gateway and the ESERA Station-200 are equipped with automatic protocol recognition.
Page 14
Controller No. Transactionsno high Function code Transactionsno low Startaddress high (word) Protocol-Ident high Startaddress low (word) Protocol-Ident low Writing value high Bytes from here Writing value low Recognition e.g. 1 CRC high Function code CRC low Startaddress high (Wort) Startaddress low (Wort) Writing value high Writing value low FC16 (writes several...
5.5. Modbus reading addresses, 1-Wire Gateway 10, 11 and 20, system variables Reading addresses Number Description Note Type Address words address data (16Bit) System variables Controller 2, Gateway 20 Word Status binary input 1-Wire Controller 2 / 1-Wire Gateway 20 HHLL inputs Controller 2,...
5.6. Modbus reading addresses 1-Wire Sensors Temperature- Reading addresses and Humidity- Temperature-, sensor Temperature, Humidity- and Air Brightness- e.g. Art. No. Brightness and Number Quality-Sensor sensor Note Type 11131, 11132, Solar Radiation e.g. 11151 and e.g. 11129 Address 11134, 11135, e.g.
Page 17
Status output HH HL LH 40207,40208 Dword Brightness Brightness Solar radiation binary HH HL LH 40209,40210 Dword Not in use (255) Air Quality Not in use (255) Not in use (255) HH HL LH 40211,40212 Dword Status Status Status Status HH HL LH 40213,40214 Dword...
Page 18
HH HL LH 40409,40410 Dword Not in use (255) Air Quality Not in use (255) Not in use (255) HH HL LH 40411,40412 Dword Status Status Status Status HH HL LH 40413,40414 Dword Error Counter Error Counter Error Counter Error Counter Articlenumber / Articlenumber / Articlenumber /...
5.7. Modbus reading addresses 1-Wire Temperature Sensors Reading addresses Temperature Number Note Type Sensors Address words address data (16Bit) 1-Wire Temperature Sensors 40100 Integer Temperature Temperature 1632 to HH HL LH 40101,40102 Dword 1639 Not in use (255) (102*16) Not in use (255) HH HL LH 40103,40104 Dword...
Page 20
Not in use (255) HH HL LH 40207,40208 Dword Not in use (255) HH HL LH 40209,40210 Dword HH HL LH 40211,40212 Dword Status HH HL LH 40213,40214 Dword Error Counter Articlenumber / HH HL LH 40215,40216 Dword Type All rights reserved. Reproduction as well as electronic duplication of this guide, complete or in part, requires the written consent of ESERA-Automation or E-Service GmbH. Errors and technical modification subject to change.
5.8. Modbus Reading addresses 1-Wire actuators Description Reading addresses 8-fold binary output/ Dual 8-fold switching module switching switching iButton Number (binary output) Type module module DS2401 and Note with push-button Address e.g. 11218, (binary output) further more words address interface data 11233 e.g.
Page 22
Articlenumber / Articlenumber / Articlenumber / Articlenumber / 40215,40216 Dword HH HL LH LL Type Type Type Type 4832 to 4839 Not in use Not in use 40300 Integer Not in use (255) Temperature Temperature (302*16) (255) (255) OWD 3 Status input 40301,40302 Dword...
5.9. Modbus write addresses Reading addresses Number Description Note Type Address words address data (16Bit) System variables Controller 2, Gateway 20 Inputs Controller 2, Gateway 20 Word 32 to 36 Outputs Controller 2, Gateway 20 Word Analog outputs Controller No. Article-No.
5.10. Modbus write addresses 1-Wire sensors Temperature- Reading addresses and Humidity- Temperature-, Temperature, sensor Brightness Description Humidity- and Air Brightness and Number e.g. Art. No. sensor Note Type Quality sensor Solar Radiation 11131, 11132, e.g. 11129 Address e.g. 11127 e.g. 11112 words address 11134, 11135 and...
5.11. Modbus write addresses 1-Wire actuators 8-fold binary Description Write addresses output/ Dual 8-fold switching module switching switching iButton Number Type (binary output) module module DS2401 and Note Address with push-button e.g. 11218, (binary output) further more words address data interface 11233 e.g.
Page 27
Output binary Range of 40307,40308 Dword Output binary Output binary values 0-255 40309,40310 Dword 311,312 Dword 313,314 Dword 315,316 Dword 6432 to 6439 40400 Integer (402*16) OWD 4 40401,40402 Dword 40403,40404 Dword Output binary Range of 40405,40406 Dword Output decimal Output decimal values 0-255 Output binary...
1-Wire Gateway 10 with RS485 + USB interface The firmware of the 1-Wire Controller 1 RS485 can only be updated via the USB interface. All rights reserved. Reproduction as well as electronic duplication of this guide, complete or in part, requires the written consent of ESERA- Automation or E-Service GmbH.
Command structure ASCII protocol There are basically four types of command- and output identifiers. They can be used to differentiate and evaluate the various data of the outputs and inputs. SET: Set values or modes of the 1-Wire Controller GET: Querying data or modes INF: Data output after a GET command...
Page 30
Settings and 1-Wire devices By command (SET,SYS,SAVE) all settings of the 1-Wire Controller / 1-Wire Gateway and all 1-Wire devices and modules (SET,OWB,SAVE) can be stored permanently. If these settings are not saved, the 1- Wire Controller / 1-Wire Gateway will start after a reset or a power interruption with the previous basic settings and possibly different device sequence.
Debug output Various debug outputs for the 1-Wire Controller / 1-Wire Gateway can be used, e.g. system status, system setting, 1-Wire sensor and actuator setting etc. can be output via the data connection. In some cases internal 1- Wire Controller / 1-Wire Gateway data are also output. Data request 1-Wire blocks In a time window of 1-2 seconds, the 1-Wire Controller / 1-Wire Gateway asks all blocks of the 1-Wire network and, if the data has been recognized as valid, stores it in the internal data register.
„Data header“ 8.5. Each data output of the 1-Wire Controller / 1-Wire Gateway starts with an abbreviation, e.g. "EVT" for Event. The chart below shows various "data headers". Example data header „EVT|time“ 8.5.1. Event (EVT), data output Cyclically output data are 1-Wire data and "Keep Alive" messages (KAL). In order to be able to check that the data outputs are up-to-date, each cyclic data string contains the current time of the 1-Wire Controller / 1-Wire Gateway.
Data output: ECHO 0: Error message as numerical value. 0=ok, 1=first command part, 2=second command part, etc. ECHO 1: Error message in plain text The command, "set,sys,echo,0 or 1", for the change of the acknowledgement of receipt can be entered via the "Command"...
Options – settings 9.1. KAL = Keep Alive or heartbeat of the 1-Wire Controller / 1-Wire Gateway With the Config-Tool 3 you can comfortably set all settings for the KAL function and save them permanently. 9.1.1. Keep Alive Send, KAL SEND ON/OFF (KAL = Keep Alive or heartbeat) At a fixed time interval, the 1-Wire Controller / 1-Wire Gateway outputs a so-called "Keep Alive"...
The assignment of the "KAL alarm output" is performed with the Command: SET,SYS,CALARM,OWD-NUMBER,OUTPUT,VALUE Example for 1-Wire Controller 1 or 1-Wire Gateway 10 or 1-Wire Gateway 11: SET,SYS,KALALARM,2,3,1 => OWD 2, binary output 3 becomes 1 when KAL alarm is triggered. Example for 1-Wire Controller 2 or 1-Wire Gateway 20: SET,SYS,KALALARM,0,1,1 =>...
9.2. DATA PRINT ON/OFF Setting of the operating mode for data output of the sensor data Selectable states: ON = 1 / OFF = 0 OFF = 0 => Data output in one line with one CR, ON = 1 => Continuous output in one line with separator "|". Factory setting: ON = 1 Command: SET,SYS,DATAPRINT,0 or 1 9.3.
9.7. OWD FORMAT 0, 1 or 2 Defines the number of decimal places for measured values of the temperature sensors. Selectable range: 0 - 2 decimal places Factory setting: 2 decimal places, e.g. 23.45 °C are used as output value 2345 Command: SET,OWD,FORMAT,0 - 2 9.8.
OWDIDFORMAT 0: 1_LST3|11:25:05 LST|1_OWD1|2810AFAF07000050|S_0|DS1820| LST|1_OWD2|26B460FB010000E5|S_0|11121| OWDIDFORMAT 1: 1_LST3|11:37:56 LST|1_OWD1|50000007AFAF1028|S_0|DS1820| LST|1_OWD2|E5000001FB60B426|S_0|11121| Note: This switching of the output formatting cannot be changed directly via the input field in Config-Tool 3. For this an input via the "Command" field is necessary. Factory setting: OWDIDFORMAT 1 Command to change: SET,OWB,OWDIDFORMAT,0 or 1 9.12.
Lists of 1-Wire devices 10.1. List output to 1-Wire devices (LST) There are different formatted lists available for the output of the 1-Wire devices or sensors and actuators connected to the 1-Wire Controller / 1-Wire Gateway. In the lists the type of the device, the device serial number and the position on the list are stored. Each of the output lists begins with a clearly identifiable data header in order to ensure correct software assignment.
List of all stored devices: LST|1_OWD1|A10000000BF08920|DS2450 => Controller No._OWDNo|SerialNo|Type of device LST|1_OWD2|890000067A5CD728|DS1820 10.2. List 0, active devices or sensors and actuators The following command will output all 1-Wire-devices with “OWD” and serial number (ID) as well as type of component. Command: GET,OWB,LIST0 Example: 1_LST0|18:47:55...
Example: 1_LST2|18:49:50 LST|1_OWD1|2863DD51040000FF|DS18B20 LST|1_OWD2|26D9DA88010000BE|DS2438 LST|1_OWD3|FFFFFFFFFFFFFFFF|none … LST|1_OWD30|FFFFFFFFFFFFFFFF|none Data output of system-internal inputs / outputs Controller 2 / Gateway 20 The following functions are available only for the 1-Wire Controller 2 / 1-Wire Gateway 20. For the system-internal inputs and outputs a cyclic data output takes place, identical to the 1-Wire devices / modules.
Data output of 1-Wire devices Basically there is a cyclic data output for every active 1-Wire device. In addition, status changes for iButton and digital input modules are updated via immediate data output. Event-controlled data output does not differ from cyclic data output in terms of formatting.
12.6. Data output DS2408 Input/Output For the 8-fold Digital I/O the data output is in the following data format. The input value represents all 8 inputs and is displayed as byte value (0-255). Each input has a value that is summed up.
Note: To save this setting permanently, press the „SAVE PERMANENT“ button below the „SETTINGS” tab. Data output is either in millivolt or integer raw format, depending on the selected setting. For data output with analog values you have to divide the values by 1000, then you get the analog value in volts with decimal places.
1_EVT|13:37:42 1_OWD3|0 Command to change: SET,KEY,DATA,0, 1 or 2 12.11. iButton status output (STATUS) It can be queried whether at least one iButton is connected or contacted with the 1-Wire Controller / 1-Wire Gateway. STATUS = 0, STATUS = 1 if at least one iButton is contacted Example: 1_EVT|13:35:03 1_OWD1|2712...
Article number assignment for OWD You can assign ESERA-Automation article numbers to various ESERA-Automation 1-Wire modules. After assignment they receive a data formatting adapted to the 1-Wire module, extended data output or data conversion. 1-Wire / OWD management of Config-Tool 3 b.
13.1. Wrong assigned article number, delete article number If you have accidentally assigned a wrong ESERA-Automation article number to a 1-Wire device, there are two ways to fix it: Select OWD / 1-Wire Nummer Selection of ESERA sensors and actuators Delete OWD number The highlighted OWD number will be deleted.
Event data output of 1-Wire devices with digital inputs For 1-Wire devices with digital inputs, a separate event is output for each status change. The new status of the digital input is output with the cyclic data output. This function is supported for the devices DS2405, DS2413 and DS2408.
Data output to ESERA-Automation modules If you are using a 1-Wire module from ESERA-Automation, you can assign the article number for this module and the module data will be adjusted accordingly. If, for example, you have a multisensor (temperature-humidity) with Art.
16.6. Solar-, Brightness- and Temperature sensor V3, Art. No. 11112 The following data is output for the ESERA-Automation solar and brightness sensor 11112. If you divide the value by 100, you receive the data with two decimal places. Data output: 1_EVT|10:29:35 1_OWD1_1|2401 =>...
16.13. Binary / Digital output dual, Art. No. 11233 The following data is output for the ESERA-Automation dual digital switching module. For the ESERA-Automation dual digital output with push-button interface, the following data are output for the status of the output relays and the digital inputs. The output value is output as decimal value 0-3.
SET,OWD,OUTA,OWD number,output voltage example: SET,OWD,OUTA,1,1000 Example: SET,OWD,OUTA,1,1000 => OWD1,10,00V 16.18. Analog output 0-20mA, Art. No. 11219 For the ESERA-Automation analog output module 0-20mA the following data for the status of the analog value are output. The following formatting is available as of firmware version 1.18_43. Data output: 1_OWD1|1500 =>...
Page 53
1_OWD1_1|1 => Controller No._module No. data record | decimal value input 1_OWD1_2|10000001 => Controller No._module No. data record | binary display input 1_OWD1_3|16 => Controller No._module No. data record | dimmer value channel 1 setting level 16 1_OWD1_4|28 => Controller No._module No. data record | dimmer value channel 2 setting level 28 All rights reserved.
Inputs and outputs Controller 2 / Gateway 20 / Station The following function described below is only available for the 1-Wire Controller 2 / 1-Wire Gateway 20. 17.1. Switching binary / digital output 1-Wire Controller 2 / Gateway 20 / Station The 5 digital outputs (relay, 4 ON/OFF +1xUM) can be easily switched and DC voltage values can be output via the 0-10V interface.
Page 55
Functions of inputs Displays 1-4 show the status of the digital inputs. DIGITAL INPUT TO OUTPUT MODE The function of the digital inputs can be switched between normal operation and pulse control using the "DIO" command. Thus, e.g. push-buttons and switches can be used as input devices. The command "DIO" 0 and 1 is used to switch between these two operating modes for the digital inputs.
Page 56
Function of inputs Displays 1-5 show the status of the digital outputs. By pressing displays 1-5, the corresponding digital outputs can be switched directly. After switching the output, the new status is output as confirmation. Function of analog output 0-10VDC You can use the slid-control function to set an analog output value.
Switching binary / digital output, all 1-Wire actuators You can easily process a data output or a switching command via the DS2405, DS2413 and DS2408 modules. The switching commands for the 1-Wire bus are the same as the switching commands for the outputs of the 1- Wire Controller / 1-Wire Gateway.
18.4. Output analog value 0-20mA, 1-Wire actuator The 0-20mA module is not yet available at the time of creation of this document. Via the ESERA-Automation module "Analog output 0-20mA" (Art. No. 11219) you can output analog values in the range of 0-10V with a resolution of 39.2mV (8 bit, 255 levels). Command: SET,OWD,OUTAMA,OWD-number,output current Example: set,owd,outama,2,1000 =>...
Group commands 1-Wire actuators A large number (=> group) of 1-Wire actuators can be controlled with a single function. The advantage is that not a single command is required for each individual 1-Wire actuator (OWD). All 1-Wire actuators (OWD´s) included in a group respond to this single command. Previous individual commands remain completely unaffected by group commands.
General 1-Wire / OWD functions 20.1. Search-function 1-Wire Bus The automatic search for new 1-Wire components can be performed in a selectable time window of 10-240 seconds. It is also possible to start a new search by command. The 1-Wire Controller / 1-Wire Gateway uses two diverse search methods at different times. 20.2.
20.5. Move device (OWD) The selection button can be used to change the position of the 1-Wire device on the OWD list, which means that another OWD number can be assigned to the 1-Wire device. There are two options to assign a new OWD number to an OWD device. Either by drag and drop, by selection via the "OWD MOVE TO"...
A command can also be entered via the command field. Command: SET,OWD,NAME,OWD_number,name Note: An individual text (name) with max. 18 characters can be added to an OWD device. The name is only intended for a more accurate differentiation. No umlauts are accepted and all letters will be saved in upper case. 20.7.
Functional enhancements and options Various function extensions are planned or available for the 1-Wire Controller / 1-Wire Gateway, which are only activated by entering a function key. Each function key is only valid for one 1-Wire Controller / 1-Wire Gateway and cannot be transferred to other 1-Wire Controllers / 1-Wire Gateways.
21.1.1. Transfer function enhancements After registration of the 1-Wire Controller / 1-Wire Gateway, the function extension can be uploaded into the Config-Tool 3 when payment has successfully been made. Press the "REFRESH" button to upload the function keys into Config-Tool 3 which are currently released for your device.
Command list / command set Commands can be sent directly via a terminal program or the Config-Tool 3. With the "SEND" button the entered command is sent to the 1-Wire Controller / 1-Wire Gateway. Blank lines should not be inserted. The separator between the command parts is a comma.
Page 66
Loads the entire factory settings • Settings are reset • Deletes the One Wire List (OWD List) DATAPRINT Sets the operating mode for the data output of the sensor data 0 = in one line with one CR 1 = Continuous output with separator "|". Default=1 DATATIME 0 or 10-...
22.3. Set One Wire Bus Command Commands valid for the entire 1-Wire network Description One Wire Bus Reset OWDID 0 or 1 Switches the output of the module name either with "OWD" or the own serial number 0=Output "OWD", 1=Output of device serial number Default = 0 OWDIDFORMAT 0 or 1...
22.4. Set One Wire Device Command Befehle die die 1-Wire Bausteine im Einzelnen betreffen Description FORMAT Defines the decimal places for temperature sensors. Range: 0-2 digits Default: Integer value for 2 digits DS2408INV 0 or 1 Inverts the data of DS2408 devices (8-fold I/O).
22.4.1. Set One Wire Device Command, group commands With the group command, a large number of actuators can perform the same function without having to send a single command to each individual 1-Wire device. Description group steering data Control command addres command, value...
22.4.2. Set KEY Command Befehle die die 1-Wire Bausteine im Einzelnen betreffen Description DATA value The data output can be changed with the command "SET,KEY,DATA,0, 1 or 2". After changing the data output, it needs to be saved with the button "SAVE PERMANENT" in the Setting area! Value: 0 = if iButton available data output...
22.5. GET Command Commands to retrieve data- or 1-Wire Controller / 1-Wire Gateway settings via the data interface (GET). The subcommand is divided into System (SYS), One Wire Bus (OWB) and One Wire Device (OWD). 22.5.1. System Get Command (System Command) Description TIME time...
List 1: Value: 0 = Disabled, 1 = Enabled (list2) List 2: Value: 0 = Disabled or if enabled output of the function extension Password / BTID key for Bluetooth data connection factory default key is 1304 This function is only available for 1-Wire Controller 2 and 1-Wire Gateway 20. 22.5.2.
ERRSUM value Output error counter in total since operation, max. 65000 ERROWD 1-30 value Output of the requested OWD number Error counter max. 65000 Default: 255 Note: error counters are reset at midnight. ERRLISTALL List output of all stored OWDs Error counter per OWD, max.
Page 74
FAST Status query of iButton fast mode. Value: 0=Standard query speed 1=Fast mode active, query in approx. 120ms cycle* (query speed depends on number of connected OWDs) Note: Activation is only possible after purchase of function extension no. 2 or no. 3. All rights reserved.
Output „Echo“ and Error code Echo output: Setting Output Description Output „0“ ECHO = 0 0 = command recognized, otherwise error code (see below) • Confirmation of command input ECHO = 1 Command/Data/Response • Response to GET query • Data output on GET request ECHO = 2 Command echo Output of the received command...
Error list of all OWDs Hier werden als Liste die Error Counter für alle 30 OWDs (1-Wire Bausteine) des 1-Wire Controller / 1-Wire Gateways ausgegeben. Wenn es beim Lesen eines OWD einen Fehler gibt, wird der OWD Error Counter um einen Zählerwert erhöht. Der maximale Error Counter Wert beträgt 65000.
Conclusion and feedback During the development of the 1-Wire Controller / 1-Wire Gateway, we put a lot of effort into integrating as many practical aspects as possible from a user's point of view. As we are manufacturer and not the "end user", we certainly won’t succeed to 100%.
Need help?
Do you have a question about the 1-Wire Controller 1 and is the answer not in the manual?
Questions and answers