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