Microtronics myDatalogMUC xG/4G User manual

301102 | Rev.01
Cover
Valid from:
lFirmware version: 03v002
lModem Version: 05v000
lServer version: 49v011
lHardware version: 3.0
User manual
myDatalogMUC xG/4G

Chapter 1 Table of contents
Chapter 1 Table of contents
Cover 1
Chapter 1 Table of contents 3
Chapter 2 Declaration of conformity 13
2.1 myDatalogMUC 2G/4G EU 13
Chapter 3 Technical data 15
Chapter 4 General specifications 19
4.1 Translation 19
4.2 Copyright 19
4.3 General descriptive names 19
4.4 Safety instructions 19
4.4.1 Use of the hazard warnings 20
4.4.2 General safety instructions 20
4.4.3 Safety and preventative measures for handling GSM/GPRS modems 20
4.4.3.1 Safety and precautionary measures for the installation of the GSM/GPRS modem 21
4.4.3.2 Safety measures for installing the antenna 21
4.5 Overview 22
4.5.1 Block diagram 22
4.6 Intended use 24
4.7 General product information 24
4.8 Device labelling 25
4.9 Installation of spare and wear parts 25
4.10 Storage of the product 26
4.11 Warranty 26
4.12 Disclaimer 26
4.13 Obligation of the operator 27
4.14 Personnel requirements 27
Chapter 5 Functional principle 29
5.1 Internal processing of the measurement values 31
5.1.1 Filter module 32
5.1.2 Overflow module 33
5.1.3 Scale module (inputs) 34
Rev. 01 3

5.1.4 Decay module 35
5.1.5 Hold module 36
5.1.6 Alarm/trigger module 36
5.1.7 Control module 37
5.1.8 Record module 38
5.1.9 Setpoint module 39
5.1.10 Scale module (outputs) 40
5.2 Functionality of the internal data memory 40
5.3 Procedure in case of connection aborts 41
5.4 Aloha transmission mode 41
5.5 Automatic selection of the GSM network 42
5.6 Device Logic processing 42
5.6.1 Device Logic parsing 43
Chapter 6 Storage, delivery and transport 47
6.1 Inspection of incoming deliveries 47
6.2 Scope of supply 47
6.3 Storage 47
6.4 Transport 47
6.5 Return 48
Chapter 7 Installation 49
7.1 Dimensions 49
7.2 Installing the myDatalogMUCxG/4G 49
7.2.1 Top-hat rail assembly 50
7.2.2 Assembly in a control cabinet 51
7.3 Safety instructions for the cabling 52
7.3.1 Information on preventing electrostatic discharges (ESD) 52
7.4 Electrical installation 52
7.4.1 Connecting the sensors, actuators and power supply 52
7.4.1.1 Connection examples 56
7.4.2 Connection of the GSM antenna 56
7.4.3 Technical details about the universal inputs 57
7.4.3.1 0/4 to 20mA mode 57
7.4.3.2 0 to 2V mode 57
4Rev. 01

Chapter 1 Table of contents
7.4.3.3 0 to 10V mode 57
7.4.3.4 Standard digital modes (PWM, frequency, digital, day counter, impulse counter) 57
7.4.4 Technical details about the PT100/1000 interface 58
7.4.5 Technical details about the modbus interfaces (Com1, Com3) 58
7.4.5.1 Modbus-Slave Modus 60
7.4.6 Technical details about the RS232 interface (Com2) 60
7.4.6.1 Error codes of the RS232 interface 61
7.4.7 Technical details about the USB interface 61
7.4.8 Technical details about the outputs 62
7.4.8.1 Analogue output1-2 (OUT, GND) 62
7.4.8.2 Relay1-6 62
7.4.9 Technical details about the integrated rechargeable buffer battery 63
7.4.10 Technical details regarding the energy supply 65
Chapter 8 Initial Start-Up 67
8.1 User information 67
8.2 Applicable documents 67
8.3 General principles 67
8.4 Placing the system into operation 67
8.5 Testing communication with the device 68
Chapter 9 User interfaces 71
9.1 User interface on the myDatalogMUCxG/4G 71
9.1.1 Operating elements 71
9.1.1.1 Button to initiate Aloha transmission mode 71
9.1.1.2 Status LED 72
9.1.1.3 Status indication: Self-testing 73
9.1.1.4 Status display: buffer accu active 74
9.1.1.5 Button to initiate self-testing 74
9.1.1.6 Status display: Switching states of the relays 74
9.2 User interface on the myDatanet server 74
9.2.1 Site configuration 74
9.2.1.1 Site 75
9.2.1.2 Comments 75
9.2.1.3 Control 75
Rev. 01 5

9.2.1.4 Interfaces 76
9.2.1.4.1 Basis 76
9.2.1.4.1.1 Com1 and Com3 (modbus master, RS485, Device Logic parsing inactive) 76
9.2.1.4.1.2 Com1 and Com3 (modbus slave, RS485, Device Logic parsing inactive) 78
9.2.1.4.1.3 Com1 and Com3 (RS485, Device Logic parsing active) 79
9.2.1.4.1.4 Com2 (serial, RS232) 82
9.2.1.4.2 Config 85
9.2.1.4.2.1 Com1 and Com3 85
9.2.1.4.2.2 Com2 86
9.2.1.5 Sequences for COM2 87
9.2.1.6 Measurement channels 87
9.2.1.6.1 Basis 87
9.2.1.6.2 Config 90
9.2.1.6.3 Alarms 103
9.2.1.6.4 Trigger 104
9.2.1.7 Interface channels1-32 105
9.2.1.7.1 Basis 106
9.2.1.7.2 Config. 107
9.2.1.7.2.1 Com1 and Com3 (modbus master, RS485) 108
9.2.1.7.2.2 Com1 and Com3 (modbus slave, RS485) 109
9.2.1.7.2.3 Com2 (serial, RS232) 110
9.2.1.7.3 Scale 110
9.2.1.7.3.1 Com1 and Com3 (modbus, RS485) 110
9.2.1.7.3.2 Com2 (serial, RS232) 111
9.2.1.7.4 Alarms 111
9.2.1.7.5 Trigger 112
9.2.1.8 Interface channels 33-64 113
9.2.1.8.1 Basis 113
9.2.1.9 Interface output channels1-32 113
9.2.1.9.1 Basis 114
9.2.1.9.2 Config 115
9.2.1.9.2.1 Com1 and Com3 (modbus master, RS485) 115
9.2.1.9.2.2 Com1 and Com3 (modbus slave, RS485) 117
6Rev. 01

Chapter 1 Table of contents
9.2.1.9.2.3 Com2 (serial, RS232) 118
9.2.1.9.2.4 Device Logic 118
9.2.1.9.3 Scale 118
9.2.1.9.3.1 Com1 and Com3 (modbus, RS485) 118
9.2.1.9.3.2 Com2 (serial, RS232) 119
9.2.1.9.3.3 Device Logic 119
9.2.1.10 Interface output channels33-64 119
9.2.1.11 Calculated channels 119
9.2.1.11.1 Basis 120
9.2.1.11.2 Calculation 121
9.2.1.11.3 Alarms 122
9.2.1.12 Output channels 123
9.2.1.12.1 Basis 123
9.2.1.13 Internal channels 126
9.2.1.13.1 Basis 126
9.2.1.13.2 Alarms 126
9.2.1.13.3 Trigger 127
9.2.1.14 Alarm settings 128
9.2.1.15 Basic setting 129
9.2.1.16 FTP export settings 131
9.2.2 Device configuration 131
9.2.2.1 Comments 131
9.2.2.2 Measurement instrument 132
9.2.2.3 Device-specific settings 133
9.2.2.4 GPRS 133
Chapter 10 myDatanet server 135
10.1 Overview 135
10.1.1 Explanation of the symbols 135
10.2 "Customer" area 136
10.3 "Site" area at customer level 138
10.3.1 Reports 139
10.3.2 Map view 139
10.4 Recommended procedure 139
Rev. 01 7

10.4.1 Creating the site 139
Chapter 11 Pawn script 143
11.1 General 143
11.1.1 Direct input of a pawn Device Logic 143
11.1.2 Uploading a binary file 143
11.2 Compiler options 143
11.3 Device API 144
11.3.1 Constants 144
11.3.2 System 144
11.3.3 Date & Time 144
11.3.4 Encoding 146
11.3.5 Measurement channels 148
11.3.5.1 Constants 148
11.3.5.2 Functions 150
11.3.6 Serial interfaces 154
11.3.6.1 Constants 154
11.3.6.2 Callback functions 155
11.3.6.3 Functions 155
11.3.7 Alarm & Trigger 156
11.3.7.1 Arrays with symbolic indices 156
11.3.7.2 Constants 157
11.3.7.3 Functions 158
11.3.8 Math 160
11.3.9 Char & String 163
11.3.10 Various 168
11.3.10.1 Arrays with symbolic indices 168
11.3.10.2 Constants 168
11.3.10.3 Functions 169
11.3.11 Console functions 172
11.4 Predefined log entries 173
11.5 Device Logic error codes 174
11.6 Syntax 175
11.6.1 General syntax 175
8Rev. 01

Chapter 1 Table of contents
11.6.1.1 Format 175
11.6.1.2 Optional semicolons 175
11.6.1.3 Comments 176
11.6.1.4 Identifier 176
11.6.1.5 Reserved keywords 176
11.6.1.6 Numerical constants 176
11.6.1.6.1 Numerical integer constants 176
11.6.1.6.2 Numerical floating-point constants 177
11.6.2 Variables 177
11.6.2.1 Declaration 177
11.6.2.2 Local declaration 177
11.6.2.3 Global declaration 177
11.6.2.4 Static local declaration 177
11.6.2.5 Static global declaration 178
11.6.2.6 Floating point values 178
11.6.3 Constant variables 178
11.6.4 Array variables 178
11.6.4.1 One-dimensional arrays 178
11.6.4.2 Initialisation 178
11.6.4.3 Progressive initialisation for arrays 179
11.6.4.4 Multi-dimensional arrays 179
11.6.4.5 Arrays and the "sizeof" operator 180
11.6.5 Operators and expressions 180
11.6.5.1 Notational conventions 180
11.6.5.2 Expressions 181
11.6.5.3 Arithmetic 181
11.6.5.4 Bit manipulation 181
11.6.5.5 Assignment 182
11.6.5.6 Comparative operators 182
11.6.5.7 Boolean 183
11.6.5.8 Other 183
11.6.5.9 Priority of the operators 183
11.6.6 Statements 184
Rev. 01 9

11.6.6.1 Statement label 185
11.6.6.2 Composite statements 185
11.6.6.3 Expression statement 185
11.6.6.4 Empty statement 185
11.6.6.5 Assert expression 186
11.6.6.6 Break 186
11.6.6.7 Continue 186
11.6.6.8 Do statement while (expression) 187
11.6.6.9 Exit expression 187
11.6.6.10 For (expression1; expression2; expression3) statement 188
11.6.6.11 Goto label 188
11.6.6.12 If (expression) statement1 else statement2 189
11.6.6.13 Return expression 189
11.6.6.14 switch (expression) {case list} 189
11.6.6.15 While (expression) statement 190
11.6.7 Functions 190
11.6.7.1 Function arguments ("call-by-value" versus "call-by-reference") 191
11.6.7.2 Named parameters versus fixed parameters 193
11.6.7.3 Standard values of function arguments 193
11.7 Example 195
11.7.1 Saw-tooth generator 195
11.7.2 Weekday designation 196
11.7.3 Calculating the flow rate with the table 198
11.7.4 Script parsing 199
11.8 Differences to C 200
Chapter 12 API 203
12.1 General 203
12.2 rapidM2M Playground 203
12.2.1 Overview 204
Chapter 13 Maintenance 205
13.1 General maintenance 205
13.2 Fuse replacement 205
Chapter 14 Removal/disposal 207
10 Rev. 01

Chapter 1 Table of contents
Chapter 15 Troubleshooting and repair 209
15.1 General problems 209
15.2 Log entries and error codes 211
15.2.1 Modem error 216
15.3 Evaluating the device log 219
15.3.1 Evaluating the device log on the myDatanet server 219
15.3.2 Evaluating the device log using DeviceConfig 219
Chapter 16 Spare parts and accessories 221
16.1 Antennas 221
16.2 Power supply 221
16.3 Adapter 221
16.4 Other accessories 221
Chapter 17 Document history 223
Chapter 18 Glossary 225
Chapter 19 Contact information 227
Rev. 01 11

Chapter 2 Declaration of conformity
Chapter 2 Declaration of conformity
2.1 myDatalogMUC 2G/4G EU
Rev. 01 13

Chapter 3 Technical data
Chapter 3 Technical data
Voltage supply 12...30VDC (+/-10%)
Additional information is provided in "Technical details regarding the energy supply"
on page 65.
Power consumption typ. 1W (without sensors)
max. 3W (without sensors)
Integrated
rechargeable buffer
battery
LiPo rechargeable battery with 300mAh to issue a message in the event of a power
supply failure.
Additional information is provided in "Technical details about the integrated
rechargeable buffer battery" on page 63.
Housing Material: Lexan/Noryl, UL94-V0
Weight: 320g
Protection class: IP20
Dimensions (WHD): 157 x 88 x 64mm (without antenna)
Operatingtemperature -20...+60°C
Air humidity 15...90%rH non-condensing
Storage temperature -20...+60°C
Charging temperature
(rechargeable buffer
battery)
0...+40°C
Display LED for indicating the operating state and error codes
LED to display the self-testing result
LED to indicate that the device is being supplied by the rechargeable buffer battery
LEDs to indicate the switching states of the relays
Operation Button to initiate Aloha transmission mode
Button to initiate self-testing
Button to trigger a reset
Antenna connector 2 x SMA
Rev. 01 15

Universal inputs 8 x analogue or digital
Modes:
l0...20mA: Resolution 6,3µA, max. 23,7mA, load 96Ω
l4...20mA: Resolution 6,3µA, max. 23,7mA, load 96Ω
l0...2V: Resolution 610µV, max. 2,5V, load 10k086
l0...10V: Resolution 7,97mV, max. 32V, load 4k7
lPWM: 1...99%, max. 100Hz, min. pulse length 1ms, max. 32V, load 4k7
lFrequency: 1...1000Hz, max. 32V, 4k7
lDigital: low <1,31V, high >2,61V, max. 32V, load 4k7
lDay counter: min. pulse length 1ms, max. 32V, load 4k7
lInterval counter: min. pulse length 1ms, max. 32V, load 4k7
Additional information is provided in "Technical details about the universal inputs" on
page 57.
External temperature
sensor
1 x PT100/1000 (including auto detection)
Additional information is provided in "Technical details about the PT100/1000
interface" on page 58.
Modbus 2 x RS485 switchable between modbus master and modbus slave
lBaud rate: 300-115200
lStop bits: 1, 2
lParity: N, E, O
lData bits: 7, 8
Modes:
lRTU
lASCII
Number of processable interface channels
lInputs: modbus channels + serial channels = 64
lOutputs: modbus channels + serial channels = 64
Additional information is provided in "Technical details about the modbus interfaces
(Com1, Com3)" on page 58.
16 Rev. 01

Chapter 3 Technical data
Serial interface 1 x RS232 for the connection of a digital sensor
lBaud rate: 300-115200
lStop bits: 1, 2
lParity: N, E, O
lData bits: 7, 8
Modes:
lASCII
Number of processable interface channels
lInputs: modbus channels + serial channels = 64
lOutputs: modbus channels + serial channels = 64
Additional information is provided in "Technical details about the RS232 interface
(Com2)" on page 60.
Outputs 6 x relays (2 groups for various potentials)
lU: 240VAC
lUmax: 400VAC
lImax: 3A
2 x analogue output (not galvanically isolated)
lLoad voltage: Corresponds to the supply voltage (12...30VDC , +/-10%)
lmax. load (32V, 20mA): 1200Ω
lIout max: 20mA
Modes:
l4-20mA
l0-20mA
Additional information is provided in "Technical details about the outputs" on page
62.
USB-Schnittstelle 1 x micro-B USB 2.0 slave for the connection to a PC. The DeviceConfig
configuration program must be installed on the PC to enable communication with
the myDatalogMUCxG/4G .
Additional information is provided in "Technical details about the USB interface" on
page 61.
Data memory Internal flash memory for up to 4.470 measurement cycles
Additional information is provided in"Functionality of the internal data memory" on
page 40.
Data type f32 (32Bit floating point)
Exception: Modbus register (see "format" configuration parameters in the chapter
"Interface channels1-32" on page 105)
Rev. 01 17

Data transmission 2G/4G Europe (myDatalogMUC 2G/4G EU )
l2G GPRS 900MHz / 1800MHz
lLTE CAT1 B3, B7, B20
3G/4G US (myDatalogMUC 3G/4G US )
lUMTS B2, B5
lLTE CAT1 B2, B4, B5, B12
SIM The myDatalogMUCxG/4G is equipped with an integrated SIM chip.
Monthly data volume 2,0MB at 2min. measurement cycle and 120min. transmission cycle (only the 8
universal inputs are active)
Additional information is provided in "Basic setting" on page 129.
18 Rev. 01

Chapter 4 General specifications
Chapter 4 General specifications
The information in this manual has been compiled with great care and to the best of our knowledge. The
manufacturer, however, assumes no liability for any incorrect specifications that may be provided in this
manual. The manufacturer is not responsible for direct, indirect, accidental or consequential damages which
arise from errors or omissions in this manual even if advised of the possibility of such damages. In the interest
of continuous product development, the manufacturer reserves the right to make improvements to this
manual and the products described in it at any time and without prior notification or obligation.
Note: The specifications in this manual are valid as of the versions listed on the front page. Revised versions
of this manual, as well as software and driver updates are available in the service area of the myDatanet
server.
4.1 Translation
For deliveries to countries in the European Economic Area, the manual must be translated into the language
of the respective country. If there are any discrepancies in the translated text, the original manual (German)
must be referenced or the manufacturer contacted for clarification.
4.2 Copyright
The copying and distribution of this document as well as the utilisation and communication of its contents to
others without express authorisation is prohibited. Contraventions are liable to compensation. All rights
reserved.
4.3 General descriptive names
The use of general descriptive names, trade names, trademarks and the like in this manual does not entitle
the reader to assume they may be used freely by everyone. They are often protected registered trademarks
even if not marked as such.
4.4 Safety instructions
For the connection, commissioning and operation of the myDatalogMUCxG/4G , the following information
and higher legal regulations of the country (e.g. ÖVE), such as valid EX regulations as well as the applicable
safety and accident prevention regulations for the respective application case must be observed.
Read this manual completely before unpacking, setting up or operating this device. Observe all hazard,
danger and warning information. Non-observance can lead to serious injuries to the operator and/or damage
to the device.
Ensure that the safety equipment of this measurement instrument is not impaired. Install and use the
measurement system only in the manner and method described in this manual.
Important note: The product is not approved for use outdoors as it is not protected from penetrating
moisture and only provides minimal protection against the ingression of dust.
Rev. 01 19

4.4.1 Use of the hazard warnings
DANGER:
Indicates a potential or threatening hazardous situation that will result in death or serious
injuries if not avoided.
WARNING:
Indicates a potential or threatening hazardous situation that can result in death or serious
injuries if not avoided.
CAUTION:
Indicates a potential hazardous situation that can result in minor or moderate injuries or
damage to this instrument.
Important note: Indicates a situation that can result in damages to this instrument if it is not avoided.
Information that must be particularly emphasised.
Note: Indicates a situation that does not result in any injury to persons.
Note: Information that supplements the specifications in the main text.
4.4.2 General safety instructions
WARNING:
Hazardous electric voltage can cause electric shock or burns. Always switch off all of the
used power supplies for the device before installing it, completing any maintenance work
or resolving any faults.
WARNING:
Never use this device in areas where the use of wireless equipment is prohibited. The
device must not be used in hospitals and/or in the vicinity of medical equipment, such as
heart pacemakers or hearing aids, as their functionality could be compromised by the
GSM/GPRS modem contained in the device.
WARNING:
Never use this device in potentially explosive atmospheres and in the vicinity of highly
combustible areas (fuel stations, storage areas for combustible material, chemical plants
and detonation sites) or in the vicinity of flammable gases, vapours or dust.
4.4.3 Safety and preventative measures for handling GSM/GPRS modems
The following safety and preventative measures must be observed during all phases of installation, operation,
maintenance or repair of a GSM/GPRS modem. The manufacturer is not liable if the customer disregards
these preventative measures.
CAUTION:
The GSM/GPRS modem connection must not be used in hazardous environments.
No guarantee of any kind, whether implicit or explicit, is given by the manufacturer and its suppliers for the use
with high risk activities.
In addition to the following safety considerations, all directives of the country in which the device is installed
must be complied with.
20 Rev. 01