Microtronics myDatalogEASY V3 User manual

300574 | Rev.05
Cover
Valid from:
lFirmware version: 01v015
lServer version: 49v011
lHardware version: 4.0
User manual
myDatalogEASY V3

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 21
4.4.3.1 Safety and precautionary measures for the GSM/GPRS modem installation 21
4.4.3.2 Safety measures for installing the antenna 21
4.5 Overview 22
4.5.1 Block diagram 23
4.6 Intended use 24
4.7 General product information 24
4.8 Device labelling 25
4.9 Installation of spare and wear parts 26
4.10 Storage of the product 26
4.11 Warranty 27
4.12 Disclaimer 27
4.13 Obligation of the operator 27
4.14 Personnel requirements 28
Chapter 5 Functional principle 29
5.1 Recommended procedure 31
5.1.1 Development of M2M/IoT application 31
5.2 Functionality of the internal data memory 31
5.3 Memory organisation 33
5.4 Procedure in case of connection aborts 34
Rev. 05 3

5.4.1 Connection abort in "online" mode 35
5.4.2 Connection abort during a Device Logic download 35
5.5 Automatic selection of the GSM network 35
5.6 Determining the GSM/UMTS/LTE signal strength 35
5.7 Determining the GSM position data 35
5.8 Error handling 36
5.9 Registration memory blocks 36
5.9.1 REG_APP_OTP 37
5.10 File transfer 37
5.11 Meaning of the SIM state 38
5.12 Using the external SIM slot 39
Chapter 6 Storage, delivery and transport 43
6.1 Inspection of incoming deliveries 43
6.2 Scope of supply 43
6.3 Storage 44
6.4 Transport 44
6.4.1 Transporting power supply units 44
6.5 Return 46
Chapter 7 Installation 47
7.1 Dimensions 47
7.2 Assembling the myDatalogEASYV3 47
7.3 Inserting/replacing the SIM card 53
7.4 Installing the myDatalogEASYV3 55
7.4.1 Wall mounting 56
7.4.2 Top-hat rail assembly 57
7.4.3 Pipe assembly 58
7.5 Safety instructions for the cabling 59
7.5.1 Information on preventing electrostatic discharges (ESD) 60
7.6 Electrical installation 60
7.6.1 Connecting the sensors, actuators and power supply 60
7.6.1.1 Connection examples 64
7.6.2 Connecting the GSM antenna 64
7.6.3 Technical details about the universal inputs 65
4Rev. 05

Chapter 1 Table of contents
7.6.3.1 0/4 to 20mA mode 65
7.6.3.2 0 to 2V mode 65
7.6.3.3 0 to 10V mode 65
7.6.3.4 Standard digital modes (PWM, frequency, digital, counter) 66
7.6.4 Technical details about the PT100/1000 interface 66
7.6.5 Technical details about the RS485 interface 66
7.6.6 Technical details about the RS232 interface 67
7.6.7 Technical details about the USB interface 68
7.6.8 Technical details about the outputs 69
7.6.8.1 Switchable sensor supply VOUT 69
7.6.8.2 Switchable sensor supply VEXT 70
7.6.8.3 Switchable sensor supply VEXTRS232 71
7.6.8.4 Isolated switch contact (NO, CC) 71
7.6.9 Technical details about energy management 71
7.6.10 Technical details about the energy supply 72
7.6.10.1 PSU413D+ AP (300524) 73
7.6.10.2 PSU413D AP (300525) 74
7.6.10.3 PSU713 BP (300526) 74
7.6.10.4 PSU DC (300529) 74
7.6.10.5 PSU AC (300558) 75
7.6.10.6 PSU DC+ (300798) 75
7.6.11 Technical details about the system time 75
Chapter 8 Initial Start-Up 77
8.1 User information 77
8.2 Applicable documents 77
8.3 General principles 77
8.4 Commissioning the system 77
8.5 Testing communication with the device 79
Chapter 9 User interfaces 81
9.1 User interface on the myDatalogEASYV3 81
9.1.1 Operating elements 81
9.1.1.1 Solenoid switch 81
9.1.1.2 Two-colour LED 81
Rev. 05 5

9.2 User interface on the myDatanet server 82
9.2.1 Site configuration 82
9.2.1.1 Site 82
9.2.1.2 Comments 82
9.2.1.3 Control 83
9.2.1.4 Configuration 0 - Configuration 9 83
9.2.1.5 Alarm settings 84
9.2.1.6 Basic settings 85
9.2.1.7 FTP export settings 85
9.2.2 Device configuration 86
9.2.2.1 Comments 86
9.2.2.2 Measurement instrument 86
9.2.2.3 GPRS 87
Chapter 10 DeviceConfig 89
10.1 General 89
10.2 Prerequisites 89
10.3 Functional principle 90
10.4 Installation 91
10.5 Menu of the DeviceConfig 93
10.5.1 Settings 93
10.5.1.1 Options 93
10.6 Connecting a Device via USB 95
10.7 "GSM" tab 96
10.8 "Log" tab 98
10.9 "Firmware" tab 100
10.10 "Features" tab 101
Chapter 11 myDatanet server 103
11.1 Overview 103
11.1.1 Explanation of the symbols 103
11.2 "Customer" area 104
11.3 "Site" area at customer level 106
11.3.1 Reports 107
11.3.2 Map view 107
6Rev. 05

Chapter 1 Table of contents
11.4 Recommended procedure 107
11.4.1 Creating the site 107
Chapter 12 rapidM2M Studio 111
12.1 General 111
12.2 Prerequisites 112
12.3 Project dashboard 113
12.4 CODEbed 114
12.5 TESTbed 115
Chapter 13 Device Logic (Pawn) 117
13.1 General 117
13.1.1 Direct entry of a device logic 117
13.1.2 Uploading a binary file 117
13.1.3 Using the CODEbed of the web-based development environment rapidM2M Studio 117
13.2 rapidM2M Device API 118
13.2.1 Constants 118
13.2.2 Timer, date & time 119
13.2.2.1 Arrays with symbolic indices 119
13.2.2.2 Constants 119
13.2.2.3 Functions 119
13.2.3 Uplink 124
13.2.3.1 Arrays with symbolic indices 124
13.2.3.2 Constants 124
13.2.3.3 Callback functions 128
13.2.3.4 Functions 129
13.2.4 System 138
13.2.4.1 Arrays with symbolic indices 138
13.2.4.2 Constants 138
13.2.4.3 Functions 139
13.2.5 Encoding 141
13.2.5.1 Constants 141
13.2.5.2 Functions 142
13.2.6 RS232, RS485 147
13.2.6.1 Constants 147
Rev. 05 7

13.2.6.2 Callback functions 147
13.2.6.3 Functions 149
13.2.7 Registry 155
13.2.7.1 Constants 155
13.2.7.2 Callback functions 156
13.2.7.3 Functions 156
13.2.8 Position 160
13.2.8.1 Arrays with symbolic indices 160
13.2.8.2 Constants 162
13.2.8.3 Functions 163
13.2.9 Math 169
13.2.10 Char & String 172
13.2.11 CRC & hash 177
13.2.11.1 Arrays with symbolic indices 177
13.2.11.2 Functions 177
13.2.12 Various 178
13.2.12.1 Arrays with symbolic indices 178
13.2.12.2 Constants 179
13.2.12.3 Functions 179
13.2.13 Console 185
13.2.14 SMS 186
13.2.14.1 Callback functions 186
13.2.14.2 Functions 186
13.2.15 External SIM 187
13.2.15.1 Arrays with symbolic indices 187
13.2.15.2 Functions 187
13.2.16 File transfer 188
13.2.16.1 Arrays with symbolic indices 188
13.2.16.2 Constants 188
13.2.16.3 Callback functions 189
13.2.16.4 Functions 190
13.2.17 Universal inputs 194
13.2.17.1 Constants 194
8Rev. 05

Chapter 1 Table of contents
13.2.17.2 Functions 195
13.2.18 Outputs 198
13.2.18.1 Constants 198
13.2.18.2 Functions 198
13.2.19 LED 203
13.2.19.1 Constants 203
13.2.19.2 Functions 204
13.2.20 Solenoid switch 206
13.2.20.1 Constants 206
13.2.20.2 Callback Funktionen 206
13.2.20.3 Functions 207
13.2.21 Power management 208
13.2.21.1 Arrays with symbolic indices 208
13.2.21.2 Constants 208
13.2.21.3 Callback functions 209
13.2.21.4 Functions 209
13.3 Device Logic error codes 210
13.4 Syntax 213
13.4.1 General syntax 213
13.4.1.1 Format 213
13.4.1.2 Optional semicolons 213
13.4.1.3 Comments 213
13.4.1.4 Identifier 213
13.4.1.5 Reserved keywords 213
13.4.1.6 Numerical constants 214
13.4.1.6.1 Numerical integer constants 214
13.4.1.6.2 Numerical floating-point constants 214
13.4.2 Variables 214
13.4.2.1 Declaration 214
13.4.2.2 Local declaration 214
13.4.2.3 Global declaration 214
13.4.2.4 Static local declaration 215
13.4.2.5 Static global declaration 215
Rev. 05 9

13.4.2.6 Floating point values 215
13.4.3 Constant variables 215
13.4.4 Array variables 215
13.4.4.1 One-dimensional arrays 215
13.4.4.2 Initialisation 216
13.4.4.3 Progressive initialisation for arrays 216
13.4.4.4 Multi-dimensional arrays 216
13.4.4.5 Arrays and the "sizeof" operator 217
13.4.5 Operators and expressions 218
13.4.5.1 Notational conventions 218
13.4.5.2 Expressions 218
13.4.5.3 Arithmetic 218
13.4.5.4 Bit manipulation 219
13.4.5.5 Assignment 219
13.4.5.6 Comparative operators 220
13.4.5.7 Boolean 220
13.4.5.8 Other 221
13.4.5.9 Priority of the operators 221
13.4.6 Statements 222
13.4.6.1 Statement label 222
13.4.6.2 Composite statements 223
13.4.6.3 Expression statement 223
13.4.6.4 Empty statement 223
13.4.6.5 Assert expression 223
13.4.6.6 Break 224
13.4.6.7 Continue 224
13.4.6.8 Do statement while (expression) 225
13.4.6.9 Exit expression 225
13.4.6.10 For (expression1; expression2; expression3) statement 225
13.4.6.11 Goto label 226
13.4.6.12 If (expression) statement1 else statement2 226
13.4.6.13 Return expression 226
13.4.6.14 switch (expression) {case list} 226
10 Rev. 05