Microtronics myDatalogMUC User manual

300101 | Rev.06
Cover
Valid from:
lFirmware version: 03v002
lModem Version: 03v014
lServer version: 44.1
lHardware version: 1.0
User manual
myDatalogMUC

Chapter 1 Table of contents
Chapter 1 Table of contents
Cover 1
Chapter 1 Table of contents 3
Chapter 2 Declaration of conformity 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 Obligation of the operator 26
4.12 Personnel requirements 26
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
5.1.4 Decay module 35
5.1.5 Hold module 36
5.1.6 Alarm/trigger module 36
Rev. 06 3

5.1.7 Control module 36
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 Use of the communication channels 41
5.3.1 Behaviour in connection modes when using both communication channels 42
5.3.1.1 Interval 42
5.3.1.2 Interval & wakeup 42
5.3.1.3 online 42
5.3.1.4 ALOHA 43
5.4 Procedure in case of connection aborts 43
5.5 ALOHA transmission mode 44
5.6 Automatic selection of the GSM network 45
5.6.1 Ban list 45
5.7 Script eradication 46
5.7.1 Script parsing 46
Chapter 6 Storage, delivery and transport 51
6.1 Inspection of incoming deliveries 51
6.2 Scope of supply 51
6.3 Storage 51
6.4 Transport 51
6.5 Return 52
Chapter 7 Installation 53
7.1 Dimensions 53
7.2 Installing the myDatalogMUC 53
7.2.1 Top-hat rail assembly 54
7.2.2 Assembly in a control cabinet 54
7.3 Safety instructions for the cabling 55
7.3.1 Information on preventing electrostatic discharges (ESD) 56
7.4 Electrical installation 56
7.4.1 Connecting the sensors, actuators and power supply 56
7.4.1.1 Connection examples 61
4Rev. 06

Chapter 1 Table of contents
7.4.2 Connection of the GSM antenna 61
7.4.3 Technical details about the universal inputs 62
7.4.3.1 0/4 to 20mA mode 62
7.4.3.2 0 to 2V mode 62
7.4.3.3 0 to 10V mode 62
7.4.3.4 Standard digital modes (PWM, frequency, digital, day counter, impulse counter) 62
7.4.4 Technical details about the PT100/1000 interface 63
7.4.5 Technical details about the modbus interfaces (Com1, Com3) 63
7.4.5.1 Modbus-Slave Modus 65
7.4.6 Technical details about the RS232 interface (Com2) 65
7.4.6.1 Error codes of the RS232 interface 66
7.4.7 Technical details about the outputs 67
7.4.7.1 Analogue output1-2 (OUT, GND) 67
7.4.7.2 Relay1-6 67
7.4.8 Technical details about the integrated rechargeable buffer battery 68
7.4.9 Technical details regarding the energy supply 70
Chapter 8 Initial Start-Up 71
8.1 User information 71
8.2 General principles 71
8.3 Placing the system into operation 71
8.4 Testing communication with the device 72
Chapter 9 User interfaces 75
9.1 User interface on the myDatalogMUC 75
9.1.1 Operating elements 75
9.1.1.1 Button to initiate ALOHA transmission mode 75
9.1.1.2 Status LED 76
9.1.1.3 Status indication: Self-testing 77
9.1.1.4 Status display: buffer accu active 78
9.1.1.5 Button to initiate self-testing 78
9.1.1.6 Status display: Switching states of the relays 78
9.2 User interface on the myDatanet server 78
9.2.1 Site configuration 78
9.2.1.1 Site 79
Rev. 06 5

9.2.1.2 Comments 79
9.2.1.3 Control 79
9.2.1.4 Interfaces 80
9.2.1.4.1 Basis 80
9.2.1.4.1.1 Com1 and Com3 (modbus master, RS485, script parsing inactive) 80
9.2.1.4.1.2 Com1 and Com3 (modbus slave, RS485, script parsing inactive) 83
9.2.1.4.1.3 Com1 and Com3 (RS485, script parsing active) 84
9.2.1.4.1.4 Com2 (serial, RS232) 87
9.2.1.4.2 Config 90
9.2.1.4.2.1 Com1 and Com3 90
9.2.1.4.2.2 Com2 91
9.2.1.5 Sequences for COM2 91
9.2.1.6 Measurement channels 92
9.2.1.6.1 Basis 92
9.2.1.6.2 Config 95
9.2.1.6.3 Alarms 108
9.2.1.6.4 Trigger 109
9.2.1.7 Interface channels1-32 110
9.2.1.7.1 Basis 110
9.2.1.7.2 Config. 112
9.2.1.7.2.1 Com1 and Com3 (modbus master, RS485) 113
9.2.1.7.2.2 Com1 and Com3 (modbus slave, RS485) 114
9.2.1.7.2.3 Com2 (serial, RS232) 115
9.2.1.7.3 Scale 115
9.2.1.7.3.1 Com1 and Com3 (modbus, RS485) 115
9.2.1.7.3.2 Com2 (serial, RS232) 116
9.2.1.7.4 Alarms 116
9.2.1.7.5 Trigger 117
9.2.1.8 Interface channels 33-64 118
9.2.1.8.1 Basis 118
9.2.1.9 Interface output channels1-32 118
9.2.1.9.1 Basis 118
9.2.1.9.2 Config 120
6Rev. 06

Chapter 1 Table of contents
9.2.1.9.2.1 Com1 and Com3 (modbus master, RS485) 120
9.2.1.9.2.2 Com1 and Com3 (modbus slave, RS485) 122
9.2.1.9.2.3 Com2 (serial, RS232) 123
9.2.1.9.2.4 Script 123
9.2.1.9.3 Scale 123
9.2.1.9.3.1 Com1 and Com3 (modbus, RS485) 123
9.2.1.9.3.2 Com2 (serial, RS232) 124
9.2.1.9.3.3 Script 124
9.2.1.10 Interface output channels33-64 124
9.2.1.11 Calculated channels 124
9.2.1.11.1 Basis 124
9.2.1.11.2 Calculation 126
9.2.1.11.3 Alarms 127
9.2.1.12 Output channels 128
9.2.1.12.1 Basis 128
9.2.1.13 Internal channels 131
9.2.1.13.1 Basis 131
9.2.1.13.2 Alarms 131
9.2.1.13.3 Trigger 132
9.2.1.14 Alarm settings 133
9.2.1.15 Basic setting 134
9.2.1.16 LAN settings 137
9.2.1.17 FTP export settings 138
9.2.2 Device configuration 138
9.2.2.1 Comments 138
9.2.2.2 Measurement instrument 138
9.2.2.3 Device-specific settings 139
9.2.2.4 GPRS 140
Chapter 10 myDatanet server 141
10.1 Overview 141
10.1.1 Explanation of the symbols 141
10.2 "Customer" area 142
10.3 "Site" area at customer level 144
Rev. 06 7

10.3.1 Reports 145
10.3.2 Groups 145
10.3.3 Map view 145
10.4 Recommended procedure 145
10.4.1 Creating the site 145
10.4.2 Assigning a device to the customer 147
Chapter 11 Pawn script 149
11.1 General 149
11.1.1 Direct input of a pawn script 149
11.1.2 Uploading a binary file 149
11.2 Compiler options 149
11.3 API 150
11.3.1 Constants 150
11.3.2 System 150
11.3.3 Date & Time 150
11.3.4 Encoding 152
11.3.5 Messkanäle 154
11.3.5.1 Constants 154
11.3.5.2 Functions 156
11.3.6 Serial interfaces 160
11.3.6.1 Constants 160
11.3.6.2 Callback functions 161
11.3.6.3 Functions 161
11.3.7 Alarm & Trigger 162
11.3.7.1 Arrays with symbolic indices 162
11.3.7.2 Constants 163
11.3.7.3 Functions 164
11.3.8 Math 166
11.3.9 Char & String 169
11.3.10 Various 174
11.3.10.1 Arrays with symbolic indices 174
11.3.10.2 Constants 174
11.3.10.3 Functions 174
8Rev. 06

Chapter 1 Table of contents
11.3.11 Console functions 178
11.4 Predefined log entries 179
11.5 Pawn script error codes 180
11.6 Syntax 181
11.6.1 General syntax 181
11.6.1.1 Format 181
11.6.1.2 Optional semicolons 181
11.6.1.3 Comments 182
11.6.1.4 Identifier 182
11.6.1.5 Reserved keywords 182
11.6.1.6 Numerical constants 182
11.6.1.6.1 Numerical integer constants 182
11.6.1.6.2 Numerical floating-point constants 183
11.6.2 Variables 183
11.6.2.1 Declaration 183
11.6.2.2 Local declaration 183
11.6.2.3 Global declaration 183
11.6.2.4 Static local declaration 183
11.6.2.5 Static global declaration 184
11.6.2.6 Floating point values 184
11.6.3 Constant variables 184
11.6.4 Array variables 184
11.6.4.1 One-dimensional arrays 184
11.6.4.2 Initialisation 184
11.6.4.3 Progressive initialisation for arrays 185
11.6.4.4 Multi-dimensional arrays 185
11.6.4.5 Arrays and the "sizeof" operator 186
11.6.5 Operators and expressions 186
11.6.5.1 Notational conventions 186
11.6.5.2 Expressions 187
11.6.5.3 Arithmetic 187
11.6.5.4 Bit manipulation 187
11.6.5.5 Assignment 188
Rev. 06 9

11.6.5.6 Comparative operators 188
11.6.5.7 Boolean 189
11.6.5.8 Other 189
11.6.5.9 Priority of the operators 189
11.6.6 Statements 190
11.6.6.1 Statement label 191
11.6.6.2 Composite statements 191
11.6.6.3 Expression statement 191
11.6.6.4 Empty statement 191
11.6.6.5 Assert expression 191
11.6.6.6 Break 192
11.6.6.7 Continue 192
11.6.6.8 Do statement while (expression) 193
11.6.6.9 Exit expression 193
11.6.6.10 For (expression1; expression2; expression3) statement 193
11.6.6.11 Goto label 194
11.6.6.12 If (expression) statement1 else statement2 194
11.6.6.13 Return expression 194
11.6.6.14 switch (expression) {case list} 194
11.6.6.15 While (expression) statement 195
11.6.7 Functions 196
11.6.7.1 Function arguments ("call-by-value" versus "call-by-reference") 196
11.6.7.2 Named parameters versus fixed parameters 198
11.6.7.3 Standard values of function arguments 198
11.7 Example 200
11.7.1 Saw-tooth generator 200
11.7.2 Weekday designation 200
11.7.3 Calculating the flow rate with the table 202
11.7.4 Script parsing 204
11.8 Differences to C 205
Chapter 12 API 207
12.1 General 207
12.2 rapidM2M Playground 207
10 Rev. 06