Microtronics MyDatalogEASY IoTmini Manuale utente

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
1 Translation 17
2 Copyright 17
3 General descriptive names 17
4 Safety instructions 17
4.1 Use of the hazard warnings 18
4.2 General safety instructions 18
4.3 Safety and preventative measures for handling wireless modules 19
4.3.1 Safety and precautionary measures for the wireless module installation 19
4.3.2 Safety measures for installing the antenna 19
5 Overview 20
5.1 Block diagram 21
6 Intended use 22
7 General product information 22
8 Device labelling 23
9 Installation of spare and wear parts 24
10 Storage of the product 24
11 Warranty 24
12 Disclaimer 25
13 Obligation of the operator 25
14 Personnel requirements 26
Chapter 5 Functional principle 27
1 Recommended procedure 29
1.1 Development of M2M/IoT application 29
2 Functionality of the internal data memory 29
3 Memory organisation 31
4 Error handling 32
Rev. 01 3

5 Registration memory blocks 32
5.1 REG_SYS_FLASH 33
5.2 REG_APP_OTP 33
Chapter 6 Storage, delivery and transport 35
1 Inspection of incoming deliveries 35
2 Scope of supply 35
3 Storage 36
4 Transport 36
4.1 Transporting power supply units 36
5 Return 38
Chapter 7 Installation 39
1 Dimensions 39
2 Assembling the myDatalogEASYIoTmini 39
3 Installing the myDatalogEASYIoTmini 45
3.1 Wall mounting 46
3.2 Top-hat rail assembly 47
3.3 Pipe assembly 48
4 Safety instructions for the cabling 49
4.1 Information on preventing electrostatic discharges (ESD) 50
5 Electrical installation 50
5.1 Connecting the sensors, actuators and power supply 50
5.1.1 Connection examples 54
5.2 Connecting the LoRa antenna 54
5.3 Technical details about the universal inputs 55
5.3.1 0/4 to 20mA mode 55
5.3.2 0 to 2V mode 55
5.3.3 0 to 10V mode 55
5.3.4 Standard digital modes (PWM, frequency, digital, counter) 56
5.4 Technical details about the PT100/1000 interface 56
5.5 Technical details about the RS485 interface 56
5.6 Technical details about the RS232 interface 57
5.7 Technical details about the USB interface 58
5.8 Technical details about the outputs 59
4Rev. 01

Chapter 1 Table of contents
5.8.1 Switchable sensor supply VOUT 59
5.8.2 Switchable sensor supply VEXT 60
5.8.3 Switchable sensor supply VEXTRS232 61
5.8.4 Isolated switch contact (NO, CC) 61
5.9 Technical details about energy management 61
5.10 Technical details about the energy supply 62
5.10.1 PSU413D+ AP (300524) 63
5.10.2 PSU413D AP (300525) 63
5.10.3 PSU713 BP (300526) 64
5.10.4 PSU DC (300529) 64
5.10.5 PSU AC (300558) 64
5.10.6 PSU DC+ (300798) 65
5.11 Technical details about the system time 65
Chapter 8 Initial Start-Up 67
1 User information 67
2 Applicable documents 67
3 General principles 67
4 Commissioning the system 67
5 Testing communication with the device 69
Chapter 9 User interfaces 71
1 User interface on the myDatalogEASYIoTmini 71
1.1 Operating elements 71
1.1.1 Solenoid switch 71
1.1.2 Two-colour LED 71
2 User interface on the myDatanet server 72
2.1 Site configuration 72
2.1.1 Site 72
2.1.2 Comments 72
2.1.3 Control 73
2.1.4 Configuration 0 - Configuration 9 73
2.1.5 Alarm settings 74
2.1.6 Basic settings 75
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
5.4.4 Multi-dimensional arrays 167
5.4.5 Arrays and the "sizeof" operator 168
5.5 Operators and expressions 169
5.5.1 Notational conventions 169
5.5.2 Expressions 169
5.5.3 Arithmetic 169
5.5.4 Bit manipulation 170
5.5.5 Assignment 170
5.5.6 Comparative operators 171
5.5.7 Boolean 171
5.5.8 Other 172
5.5.9 Priority of the operators 172
5.6 Statements 173
5.6.1 Statement label 173
5.6.2 Composite statements 174
5.6.3 Expression statement 174
5.6.4 Empty statement 174
5.6.5 Assert expression 174
5.6.6 Break 175
5.6.7 Continue 175
5.6.8 Do statement while (expression) 176
5.6.9 Exit expression 176
5.6.10 For (expression1; expression2; expression3) statement 176
5.6.11 Goto label 177
5.6.12 If (expression) statement1 else statement2 177
5.6.13 Return expression 177
5.6.14 switch (expression) {case list} 177
5.6.15 While (expression) statement 178
5.7 Functions 179
5.7.1 Function arguments ("call-by-value" versus "call-by-reference") 179
5.7.2 Named parameters versus fixed parameters 181
5.7.3 Standard values of function arguments 181
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