Page 2
Caution : any changes or modifications not expressly approved by Coronis- Systems could void the user's authority to operate the equipment. WaveTherm modules – application handbook...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw TABLE OF CONTENTS 1 PRESENTATION........................... 6 2 REFERENCE DOCUMENTS......................6 3 PRESENTATION OF THE WAVETHERM MODULES FUNCTIONALITIES........ 7 3.1 SENSORS INTERFACE.........................7 3.2 READ TEMPERATURES........................8 3.3 PERIODIC TEMPERATURE READING (DATALOGGING)..............8 3.4 MANAGEMENT OF THRESHOLD ALARMS..................9 3.4.1 Threshold Alarm Detection......................9 3.4.2 Storage of Threshold Alarm occurences..................9 3.4.3 Transmission of a Threshold Alarm Frame..................9 3.5 STORAGE OF CALIBRATION PARAMETERS..................10...
Page 4
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7 WAVETHERM MODULE FUNCTIONS ..................27 7.1 PARAMETER SETTING OF THE WAVETHERM MODULE...............27 7.1.1 Reading of the module type......................27 7.1.2 Reading of the firmware version....................28 7.1.3 Reading of the date and time of the module.................29 7.1.4 Setting the date and time of the module..................30 7.1.5 Access to the user data area......................31 7.1.6 Initialization of the sensors......................
Page 5
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.6.6 Configuration of the measurement period of the threshold detection...........59 7.6.7 Reading the threshold detection table..................60 7.7 MANAGEMENT OF THE ALARM FRAMES..................61 7.7.1 Description of the parameters used....................61 7.7.2 Configuration of the route to reach the alarm frames recipient............ 61 7.7.3 Configuration of the alarms to be sent..................62 7.7.4 Triggering an alarm frame......................63 7.8 END OF BATTERY LIFE DETECTION....................64...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 1 PRESENTATION This document describes the functionalities of WaveTherm radio modules : WaveTherm – DALLAS Used with DALLAS sensor WaveTherm – PT100 Used with PT100 sensor WaveTherm – PT1000 Used with PT1000 sensor This document defines in an exhaustive way the applicatives data relating to serial dialog frames between a Wavecard and a host equipment , used to reach the data of the WaveTherm radio module.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 3 PRESENTATION OF THE WAVETHERM MODULES FUNCTIONALITIES 3.1 SENSORS INTERFACE ➢ WaveTherm – DALLAS : The module is designed to manage to the maximum two DALLAS temperature sensors (type DS18B20). This DALLAS sensor of 1-wire type integrates a 12-bit internal converter. Each external sensor is connected to the module by a cable equipped with a BINDER connector of 3-pin type.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 3.2 READ TEMPERATURES The WaveTherm module has the following possibilities: To read the current temperature ; To transmit the last N temperatures stored, in one frame. If two temperature sensors are used, then the WaveTherm return the last N/2 values of each sensor. •...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 3.4 MANAGEMENT OF THRESHOLD ALARMS The WaveTherm module detects when the values exceed the threshold levels (high or low) for a given period of time. The WaveTherm – PT100 and PT1000 may be configured with a precision level offering a more reliable measurement even in environments with excessive interference (see chapter 7.2.1).
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 3.5 STORAGE OF CALIBRATION PARAMETERS The WaveTherm module manage a non-volatile memory area accessible by radio command, and allowing to store up to 32 bytes. This area is not used by the internal process, and is generally used to store the parameters relative to the calibration of the module, and can be read, or modified by specifying the start address, and the size of the data.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 3.8 SENSOR FAULT DETECTION (if supported by the module) For all modules, temperature probe absence or error detection is carried out during a write request and is indicated by the presence of a specific value which does not correspond to a possible temperature value. However, in the case of the WaveTherm –...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 4 DATA EXCHANGE PRINCIPLE WITH A WAVETHERM MODULE The WaveTherm module uses the WAVENIS protocol. The choice of mode used is initiated by the read element which uses a different set of commands (see WaveCard document) when sending commands to the WaveCard. The following chart indicates the read modes possible as well as their typical applications.
Page 13
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw ➢ Example in Point-to-point mode : Remark : Generally, the exchanges examples given in this document will be in Point-to-point mode, except when the context depends directly on the mode of exchanges. This type of radio exchange allows to send a request, then to await a response of the remote equipment. Note : the commands of Point-to-point exchanges, have the following format: (all the exchanges modes are treated in document [DR1]) NAME...
Page 14
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw The data field of each command must be formatted according to the following table : DATA 6 bytes variable ( max : 152 bytes) 0x20 Radio address from equipment to reach Data to transmit Radio address from transmitter 0x30 Received Data equipment...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 5 INFORMATION RELATIVE TO THE PROBES ASSOCIATED WITH THE WAVETHERM MODULES 5.1 DALLAS Probes 5.1.1 Coding of temperatures for the DALLAS probe type DS18B20 These probes have a resolution of 12 bits and their value is coded on two bytes (MSB first) Negative values are expressed in two's complements with addition of a sign.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 5.1.3 Setting of the probe coefficient parameters The precision of DALLAS probes is indicated by the manufacturer as ±0.5°C (-10°C to +85°C) and requires no calibration before use. However, it is possible to improve this precision if the user wishes to calibrate the probe. In this case, the WaveTherm module contains a 32-byte memory zone for storage of transfer coefficients after calibration.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 5.2 PT100 and PT1000 probes 5.2.1 Representation of temperature values Due to the high level of precision required of the temperature values processed by the module, WaveTherm PT100 or PT1000 are true numbers (with a mantissa and exponent). They are represented in the form of a 32-bit floating number.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 5.2.2 Calibration of radio module ➢ Factory calibration The precision of PT100 and PT1000 probes is such that the WaveTherm module measurement chain requires calibration. This calibration is carried out automatically in the factory and the product is supplied ready for use. ➢...
The coefficients to be transferred to the radio module are based on the coefficients A,B and C (given by the manufacturer of the PT100 or PT1000 probes) in a mathematical formula. When required, CORONIS is able to provide a utility enabling calculation of these coefficients. There are 8 in total (coeff A to H).
Page 20
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw All coefficients are regarded by the radio module as a single parameter. Parameters Description 0x32 Coefficients of probe 1 0x33 Coefficients of probe 2 Each parameter is composed of 8 coefficients of 32 bits (floating IEEE) with a total size of 32 bytes. The coefficients are represented in the radio buffer during use of the parameter read/write commands as follows : Remark:...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 6 MODIFICATION OF THE INTERNAL PARAMETERS 6.1 INTERNAL PARAMETERS LIST ACCESSIBLE BY RADIO COMMANDS 6.1.1 Parameters common to all WAVETHERM versions The table below describes the internal parameters accessible by standard read and write commands. Default value Size Access N°...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 6.1.2 Parameters specific to the WaveTherm – DALLAS module Default value Size Access N° Description (in bytes) right Hexa. Decimal 0x25 Parameter A relative to the sensor 1 0xFFFF 0x26 Parameter B relative to the sensor 1 0xFFFF 0x27 Parameter A relative to the sensor 2...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 6.1.4 Parameters specific to theWaveTherm – PT1000 module Default value Size Access N° Description (in bytes) right Hexa. Decimal 0x0C Precision level of the measurement 0x00 0x21 Extended Application Status 0x00 0x23 Measurement period of the threshold detection (in minutes) 0x00 0x15 High Threshold Alarm –...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 6.1.5 Definition of the module control bytes ➢ Definition of the Operating Mode byte (0x01) : Operanting Mode Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 Threshold Low Threshold High Threshold Datalogging Stop Mode of the...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 6.2 PRINCIPLE OF READING AND WRITING OF INTERNAL PARAMETERS Document [DR1] details the exchanges modes, and their associated requests; with an aim of sending data to a distant module. This chapter details the data field in order to configure the internal parameters of the WaveTherm modules. DATA Field 1 byte Max = 151 bytes...
Page 26
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw ➢ Format of access for parameter (s) writing Contents of request REQ_SEND_FRAME Data field (max : 152 bytes) Number of Number of Size of the Data of the Number Size of the Data of Applicative parameters the 1 of the n the n...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7 WAVETHERM MODULE FUNCTIONS 7.1 Parameter setting of the WaveTherm module some of the parameters of module information are accessible by standard internal parameters read and write commands, described in chapter 6.2; whereas other parameters of information are accessible by specific applicative commands.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.1.2 Reading of the firmware version The firmware version of the module is obtained by interrogating the distant module with GET_FIRMWARE_VERSION command. Applicative Description command 0x28 Request of reading the firmware version (GET_FIRMWARE_VERSION) 0xA8 Response to the request of reading the firmware version ➢...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.1.3 Reading of the date and time of the module Applicative Description command 0x12 Request to read the date and time of the module 0x92 Response to request to read the date and time of the module Remark : In the command byte coding, the Response frame type are taking the Request command byte value with the MSB bit set to 1.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.1.4 Setting the date and time of the module Applicative Description command 0x13 Request to set the date and time of the module 0x93 Response to request to set the date and time of the module Remark : In the command byte coding, the Response frame type are taking the Request command byte value with the MSB bit set to 1.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.1.5 Access to the user data area The WaveTherm module manage a non-volatile memory area accessible by radio command, and allowing to store up to 32 bytes. This area is generally used to store the parameters relative to the calibration of the module, and can be read, or modified by specifying the start address, and the size of the data.
Page 32
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw ➢ Access in Writing The user has to specify the address of the first byte to be written, the total number of bytes to be written, and then the data. Contents of the request REQ_SEND_FRAME Data Field (max : 152 bytes) Applicative MSB address of the LSB address of the fisrt...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.1.6 Initialization of the sensors The initialization command returns the number of sensors detected. Remark : For the WaveTherm – DALLAS only, when the sensors are detected, the module returns their identifier. Applicative Description Command 0x04 Request to initialize the sensors 0x84 Response to the request to initialize the sensors ...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.2 READING THE CURRENT VALUE OF THE TEMPERATURE SENSORS The WaveTherm module has the possibility to read the current temperature when the sensors are wired, and initialized. If not the input relative to the sensor not wired (or initialized) returns the following values : ...
Page 35
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw Contents of request REQ_SEND_FRAME Data Field (max : 152 bytes) Applicative Command Precision level 1 byte 1 byte 0x01 (*) The precision field is used only for the modules : - WaveTherm – PT100 - WaveTherm – PT1000 The WaveTherm –...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.2.3 Reading the current ohmic values of the sensors Compatibility : - WaveTherm – PT100 - WaveTherm – PT1000 When using WaveTherm – PT100, or PT100 modules, it is possible to read the current ohmic value of the sensors.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.3 WAKE-UP SYSTEM MANAGEMENT In order to reduce module power consumption, a wake-up period parameter setting system is incorporated. This system enables modification of the module wake-up period (default setting 1 s) by entering a time and day of the week : ...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.3.3 Set a new wake-up period The WaveTherm module wake-up default setting is every second. The wake-up period may be easily modified by entering a new value in the 'default wake-up period parameter'. Attention, the value associated with this parameter may not exceed 10 seconds. Attention, an erroneous value of this parameter involves a wake-up every second, the maximum value is 0x0A (10 seconds).
Page 39
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw The time windows function as follows, Set the start time for the first time window and its wake-up period ; Set the start time for the second time window and its wake-up period ; Select the days of the week during which the time windows are enabled ;...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.3.6 Set the day/night system parameters according to day of the week The day/night system according to the day of the week parameter setting procedure is the same as that described in the previous chapter with the exception that the “Enable time window according to the day of the week”...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.4 PARAMETER SETTING OF THE DATALOGGING MODE The Datalogging mode enables periodic logging of temperatures at each input (by selecting the precision index for PT100 and PT1000 probes). The frequency of these readings may be set in three modes: ...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw The precision levels may be described as follows, Precision = 0x00 : normal precision (fastest measurement) Precision = 0x01 : high precision Precision = 0x02 : very high precision Precision = 0x03 : maximum precision (slowest measurement) Remark: Above all, the primary function is to preserve measurement precision, even in an...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.4.4 Index logging in time steps This type of datalogging is used to log the index value for each input at periods ranging from one minute to over thirty hours. The time of the first logging may be set with a parameter. When the datalogging mode in time steps is enabled, the system only logs the memorised index values as soon as the preset time is attained;...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.4.5 Index logging once a week This type of datalogging is used to log the index value for each input once a week. The time and day of the week logging is carried out may be set with a parameter. The parameters to be used, are the following : •...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.4.6 Index logging once a month This type of datalogging is used to log the index value for each input once a month. The time and day (from 1 to 28) logging is carried out may be set with a parameter. The parameters to be used, are the following : •...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.4.7 Reading the logged temperature values Standard datalogging allows a periodic collection of temperature measurements up to N temperatures. If two temperature sensors are used, then the WaveTherm return the last N/2 values of each sensor. It functions in 'permanent loop' mode, i.e. the most recent measurements replace the oldest measurements. ...
Page 47
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw ➢ WaveTherm – DALLAS : The maximal number of logged values is 48 if only one sensor is activated, and 24 when two sensors are activated. The storage table is defined as follow : Structure of the storage table Number of Number of values activated sensor...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.5 ADVANCED DATALOGGING When the WaveTherm support the Advanced Datalogging, the datalogging allows a periodic collection of temperature measurements up to M temperatures. If two temperature sensors are used, then the WaveTherm return the last M/2 values of each sensor. ...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.5.2 Parameter setting of the Advanced Datalogging mode To activate the advanced datalogging, the user have to follow the following steps : Configure the index logging in time steps (see chapter 7.4.4); Choose the measurement period; ...
Page 50
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw Start Reading the number of logged values Step 1 (parameter 0x0B) Reading of the totality, or a part Step 2 of the storage table Number of Step 3 measurements > M Step 4 Re-initialization of the storage table Remark : The step 3 could be suppressed.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw ➢ Reading the number of logged values WaveTherm modules supporting the Advanced Datalogging has the possibility to store up to M temperature values. If one sensor is wired, up to M values are affected to this sensor, if two sensors are wired, up to M/2 values are affected to each sensor.
Page 52
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw ➢ In case of error If the numbers of the requested recordings doesn't exist, then the response frame will have the following format : Contents of the response RECEIVED_FRAME Data Field (max : 152 bytes) Applicative Frame number Command 1 byte...
Page 53
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw (*) Data relative to the recordings : The format of this field varies according to the type of WaveTherm used. ➢ WaveTherm – DALLAS : Data relative to the recordings Number of the Number of the last first recording Temperature Temperature...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.5.5 Structure of the data when two sensors are activated When two sensors are wired to the module, the numbering of the recordings is processed as follow : Number of the recordings, from Description the most recent to the oldest Most recent recording of the input 2, at instant t Most recent recording of the input 1, at instant t Recording of the input 2, at instant ( t –...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.5.6 Usage limit of the multi-frame mode The Wavenis protocol doesn't allow the usage of the multi-frame mode in repeater mode, i.e. When the module is reach through relaying equipments. It is up to the interrogator equipment to format the frames so that the response fit in a single frame. Typically in repeater mode, the interrogator module have to read the logged temperature values by packets of M measurements (M corresponding to the maximal number of measurements that can be read through 3 repeaters).
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.6 MANAGEMENT OF THRESHOLD ALARMS The WaveTherm module may be configured to detect when the values exceed threshold levels (high or low). Three types of threshold alarm detection methods may be programmed : immediate threshold alarm detection ...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.6.2 Precision level of the measurement Compatibility : - WaveTherm – PT100 - WaveTherm – PT1000 Temperature measurement may be started with one of several precision levels (0 to 3). In general, precision level 0 is sufficient. The other precision levels are used in difficult environments. The aim of these precision levels is to compensate for measurement errors induced by the 50 Hz frequency.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.6.4 Principle of the detection modes ➢ In cumulative mode, an alarm is detected when the total temperature threshold alarm time is higher than the set duration parameter. Temperature High Threshold Time Measurement period Alarm > t With a threshold excess duration, t = 10 measurement periods, one gets threshold...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.6.5 Selection of the threshold detection modes, and activation of the detection The threshold detection modes are selected by positionning the bit b6 of the Operating Mode byte. By default, the successive mode is selected. The threshold detection is activated by positioning the bit b4, or b5 of the Operating Mode byte. ➢...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.6.7 Reading the threshold detection table The module store in an internal table the information relative to the detection of a threshold alarm. This table can store up to 5 events relative to high threshold detection, and up to 5 events relative to Low Threshold detection.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.7 MANAGEMENT OF THE ALARM FRAMES The WaveTherm module offers the possibility to automatically transmit radio frames when an occurrence is detected. The following occurrences may provoke an automatic alarm: High threshold detection; Low threshold detection; ...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.7.3 Configuration of the alarms to be sent The alarms to be sent are configured by writing to the parameter 0x22, or by sending the following command : Applicative Description Command 0x23 Request to configure the alarms to be sent 0xA3 Acknowledgement of the request ...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.7.4 Triggering an alarm frame After detection of a fault, if the configuration mode authorises transmission of alarms, the module transmits an alarm frame (applicative command 0x40). Structure of the alarm frame Data Field (max : 152 bytes) Applicative Data field Alarm Status...
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw 7.8 END OF BATTERY LIFE DETECTION To detect the end of battery life, the WaveTherm module uses the power metering principle rather than measurement of the battery voltage. Lithium batteries are, in particular during passivation, unsuitable for the voltage measurement method to determine the remaining capacity.
File : CS-SUP-MUTI-WTHERMAPP-E01.sxw APPENDIX A : SET OF THE APPLICATIVE COMMANDS Applicative Commands Description INTERNAL PARAMETERS SETTING 0x10 Request of parameter(s) reading 0x90 Acknowledgement of the request of parameter(s) reading 0x11 Request of parameter(s) writing 0x91 Acknowledgement of the request of parameter(s) writing MODULES INFORMATION 0x20 Request to read the module type...
Need help?
Do you have a question about the WaveTherm DALLAS and is the answer not in the manual?
Questions and answers