Microtronics myDatalogEASY IoTmini User manual

301115 | Rev.01
Cover
Valid from:
lFirmware version: 01v015
lServer version: 47.10
lHardware version: 1.0
User manual
myDatalogEASY IoTmini

Chapter 1 Table of contents
Chapter 1 Table of contents
Cover 1
Chapter 1 Table of contents 3
Chapter 2 Declaration of conformity 11
Chapter 3 Specifications 13
Chapter 4 General specifications 17
4.1 Translation 17
4.2 Copyright 17
4.3 General descriptive names 17
4.4 Safety instructions 17
4.4.1 Use of the hazard warnings 18
4.4.2 General safety instructions 18
4.4.3 Safety and preventative measures for handling wireless modules 19
4.4.3.1 Safety and precautionary measures for the wireless module installation 19
4.4.3.2 Safety measures for installing the antenna 19
4.5 Overview 20
4.5.1 Block diagram 21
4.6 Intended use 22
4.7 General product information 22
4.8 Device labelling 23
4.9 Installation of spare and wear parts 24
4.10 Storage of the product 24
4.11 Warranty 24
4.12 Disclaimer 25
4.13 Obligation of the operator 25
4.14 Personnel requirements 26
Chapter 5 Functional principle 27
5.1 Recommended procedure 29
5.1.1 Development of M2M/IoT application 29
5.2 Functionality of the internal data memory 29
5.3 Memory organisation 31
5.4 Error handling 32
Rev. 01 3

5.5 Registration memory blocks 32
5.5.1 REG_SYS_FLASH 33
5.5.2 REG_APP_OTP 33
Chapter 6 Storage, delivery and transport 35
6.1 Inspection of incoming deliveries 35
6.2 Scope of supply 35
6.3 Storage 36
6.4 Transport 36
6.4.1 Transporting power supply units 36
6.5 Return 38
Chapter 7 Installation 39
7.1 Dimensions 39
7.2 Assembling the myDatalogEASYIoTmini 39
7.3 Installing the myDatalogEASYIoTmini 45
7.3.1 Wall mounting 46
7.3.2 Top-hat rail assembly 47
7.3.3 Pipe assembly 48
7.4 Safety instructions for the cabling 49
7.4.1 Information on preventing electrostatic discharges (ESD) 50
7.5 Electrical installation 50
7.5.1 Connecting the sensors, actuators and power supply 50
7.5.1.1 Connection examples 54
7.5.2 Connecting the LoRa antenna 54
7.5.3 Technical details about the universal inputs 55
7.5.3.1 0/4 to 20mA mode 55
7.5.3.2 0 to 2V mode 55
7.5.3.3 0 to 10V mode 55
7.5.3.4 Standard digital modes (PWM, frequency, digital, counter) 56
7.5.4 Technical details about the PT100/1000 interface 56
7.5.5 Technical details about the RS485 interface 56
7.5.6 Technical details about the RS232 interface 57
7.5.7 Technical details about the USB interface 58
7.5.8 Technical details about the outputs 59
4Rev. 01

Chapter 1 Table of contents
7.5.8.1 Switchable sensor supply VOUT 59
7.5.8.2 Switchable sensor supply VEXT 60
7.5.8.3 Switchable sensor supply VEXTRS232 61
7.5.8.4 Isolated switch contact (NO, CC) 61
7.5.9 Technical details about energy management 61
7.5.10 Technical details about the energy supply 62
7.5.10.1 PSU413D+ AP (300524) 63
7.5.10.2 PSU413D AP (300525) 63
7.5.10.3 PSU713 BP (300526) 64
7.5.10.4 PSU DC (300529) 64
7.5.10.5 PSU AC (300558) 64
7.5.10.6 PSU DC+ (300798) 65
7.5.11 Technical details about the system time 65
Chapter 8 Initial Start-Up 67
8.1 User information 67
8.2 Applicable documents 67
8.3 General principles 67
8.4 Commissioning the system 67
8.5 Testing communication with the device 69
Chapter 9 User interfaces 71
9.1 User interface on the myDatalogEASYIoTmini 71
9.1.1 Operating elements 71
9.1.1.1 Solenoid switch 71
9.1.1.2 Two-colour LED 71
9.2 User interface on the myDatanet server 72
9.2.1 Site configuration 72
9.2.1.1 Site 72
9.2.1.2 Comments 72
9.2.1.3 Control 73
9.2.1.4 Configuration 0 - Configuration 9 73
9.2.1.5 Alarm settings 74
9.2.1.6 Basic settings 75
9.2.1.7 FTP export settings 75
Rev. 01 5

9.2.2 Device configuration 76
9.2.2.1 Comments 76
9.2.2.2 Measurement instrument 76
Chapter 10 rapidM2M Studio 79
10.1 General 79
10.2 Prerequisites 80
Chapter 11 myDatanet server 81
11.1 Recommended procedure 81
11.1.1 Creating the site 81
Chapter 12 Device Logic (Pawn) 83
12.1 General 83
12.1.1 Direct entry of a device logic 83
12.1.2 Uploading a binary file 83
12.1.3 Using the CODEbed of the web-based development environment rapidM2M Studio 83
12.2 Compiler options 84
12.3 rapidM2M Device API 84
12.3.1 Constants 84
12.3.2 Timer, date & time 85
12.3.2.1 Arrays with symbolic indices 85
12.3.2.2 Constants 85
12.3.2.3 Functions 85
12.3.3 Uplink 90
12.3.3.1 Constants 90
12.3.3.2 Callback functions 90
12.3.3.3 Functions 91
12.3.4 System 95
12.3.4.1 Arrays with symbolic indices 95
12.3.4.2 Constants 95
12.3.4.3 Functions 97
12.3.5 Encoding 99
12.3.5.1 Constants 99
12.3.5.2 Functions 100
12.3.6 RS232, RS485 105
6Rev. 01

Chapter 1 Table of contents
12.3.6.1 Constants 105
12.3.6.2 Callback functions 105
12.3.6.3 Functions 107
12.3.7 LoRa 113
12.3.7.1 Constants 113
12.3.7.2 Callback functions 113
12.3.7.3 Functions 114
12.3.8 Registry 117
12.3.8.1 Constants 117
12.3.8.2 Callback functions 118
12.3.8.3 Functions 118
12.3.9 Position 122
12.3.9.1 Arrays with symbolic indices 122
12.3.9.2 Constants 122
12.3.9.3 Functions 124
12.3.10 Math 128
12.3.11 Char & String 131
12.3.12 CRC & hash 136
12.3.12.1 Arrays with symbolic indices 136
12.3.12.2 Functions 136
12.3.13 Various 137
12.3.13.1 Arrays with symbolic indices 137
12.3.13.2 Constants 138
12.3.13.3 Functions 138
12.3.14 Console 144
12.3.15 Universal inputs 145
12.3.15.1 Constants 145
12.3.15.2 Functions 146
12.3.16 Outputs 149
12.3.16.1 Constants 149
12.3.16.2 Functions 149
12.3.17 LED 154
12.3.17.1 Constants 154
Rev. 01 7

12.3.17.2 Functions 155
12.3.18 Solenoid switch 157
12.3.18.1 Constants 157
12.3.18.2 Callback Funktionen 157
12.3.18.3 Functions 158
12.3.19 Power management 159
12.3.19.1 Arrays with symbolic indices 159
12.3.19.2 Constants 159
12.3.19.3 Callback functions 160
12.3.19.4 Functions 160
12.4 Device Logic error codes 161
12.5 Syntax 164
12.5.1 General syntax 164
12.5.1.1 Format 164
12.5.1.2 Optional semicolons 164
12.5.1.3 Comments 164
12.5.1.4 Identifier 164
12.5.1.5 Reserved keywords 164
12.5.1.6 Numerical constants 165
12.5.1.6.1 Numerical integer constants 165
12.5.1.6.2 Numerical floating-point constants 165
12.5.2 Variables 165
12.5.2.1 Declaration 165
12.5.2.2 Local declaration 165
12.5.2.3 Global declaration 165
12.5.2.4 Static local declaration 166
12.5.2.5 Static global declaration 166
12.5.2.6 Floating point values 166
12.5.3 Constant variables 166
12.5.4 Array variables 166
12.5.4.1 One-dimensional arrays 166
12.5.4.2 Initialisation 167
12.5.4.3 Progressive initialisation for arrays 167
8Rev. 01

Chapter 1 Table of contents
12.5.4.4 Multi-dimensional arrays 167
12.5.4.5 Arrays and the "sizeof" operator 168
12.5.5 Operators and expressions 169
12.5.5.1 Notational conventions 169
12.5.5.2 Expressions 169
12.5.5.3 Arithmetic 169
12.5.5.4 Bit manipulation 170
12.5.5.5 Assignment 170
12.5.5.6 Comparative operators 171
12.5.5.7 Boolean 171
12.5.5.8 Other 172
12.5.5.9 Priority of the operators 172
12.5.6 Statements 173
12.5.6.1 Statement label 173
12.5.6.2 Composite statements 174
12.5.6.3 Expression statement 174
12.5.6.4 Empty statement 174
12.5.6.5 Assert expression 174
12.5.6.6 Break 175
12.5.6.7 Continue 175
12.5.6.8 Do statement while (expression) 176
12.5.6.9 Exit expression 176
12.5.6.10 For (expression1; expression2; expression3) statement 176
12.5.6.11 Goto label 177
12.5.6.12 If (expression) statement1 else statement2 177
12.5.6.13 Return expression 177
12.5.6.14 switch (expression) {case list} 177
12.5.6.15 While (expression) statement 178
12.5.7 Functions 179
12.5.7.1 Function arguments ("call-by-value" versus "call-by-reference") 179
12.5.7.2 Named parameters versus fixed parameters 181
12.5.7.3 Standard values of function arguments 181
12.6 Differences to C 182
Rev. 01 9

Chapter 13 Data Descriptor 185
Chapter 14 API 187
14.1 Frontend API 187
14.2 rapidM2M Playground 187
14.2.1 Overview 188
Chapter 15 Maintenance 189
15.1 General maintenance 189
15.2 Replacing the power supply unit 189
15.2.1 Charging the power supply unit 191
15.3 Power supply units with integrated energy store 193
Chapter 16 Removal/disposal 195
Chapter 17 Troubleshooting and repair 197
17.1 General problems 197
17.2 Log entries and error codes 199
17.3 Evaluating the device log 201
17.3.1 Evaluating the device log on the myDatanet server 201
17.3.2 Evaluating the device log using DeviceConfig 201
Chapter 18 Spare parts and accessories 203
18.1 Chargeable features 203
18.2 Assembly sets 203
18.3 Antennas 203
18.4 Power supply units 204
18.5 Charging devices and power supply units 204
18.6 Other accessories 204
Chapter 19 Document history 205
Chapter 20 Glossary 207
Chapter 21 Contact information 209
10 Rev. 01