Microtronics RapidM2M T32x Manuale utente

301215 | Rev.01

Cover

Valid from:

lFirmware version: 00v007

lServer version: 49v011

lHardware version: 1.2

User manual

rapidM2M T32x

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 15
1 Translation 15
2 Copyright 15
3 General descriptive names 15
4 Safety instructions 15
4.1 Use of the hazard warnings 16
4.2 General safety instructions 16
4.3 Safety and preventative measures for handling GSM/GPRS modems 16
4.3.1 Safety and precautionary measures for the GSM/GPRS modem installation 17
5 Overview 18
5.1 Block diagram 19
6 Intended use 19
7 General product information 20
8 Device labelling 21
9 Installation of spare and wear parts 21
10 Storage of the product 22
11 Warranty 22
12 Disclaimer 23
13 Obligation of the operator 23
14 Personnel requirements 24
Chapter 5 Functional principle 25
1 Recommended procedure 27
1.1 Development of M2M/IoT application 27
2 Functionality of the internal data memory 27
3 Memory organisation 29
4 Procedure in case of connection aborts 30
4.1 Connection abort in "online" mode 31
Rev. 01 3

4.2 Connection abort during a Device Logic download 31
5 Automatic selection of the GSM network 31
6 Determining the GSM/UMTS/LTE signal strength 31
7 Error handling 31
8 Registration memory blocks 32
8.1 REG_APP_OTP 32
9 File transfer 33
10 Meaning of the SIM state 34
Chapter 6 Storage, delivery and transport 35
1 Inspection of incoming deliveries 35
2 Scope of supply 35
3 Storage 35
4 Transport 35
5 Return 35
Chapter 7 Installation 37
1 Dimensions 37
2 Installing the rapidM2M T32x 37
2.1 Installation on magnetic surfaces 38
2.2 Installation using adhesive pad 40
2.3 Installation using screws 42
2.4 Installation using an Action-Cam bracket 43
3 Safety instructions for connecting additional sensors and the alternative power supply 44
3.1 Information on preventing electrostatic discharges (ESD) 44
4 Electrical installation 45
4.1 Connection of additional sensors and the alternative power supply 45
4.2 Technical details about the USB interface 49
Chapter 8 Initial Start-Up 51
1 User information 51
2 Applicable documents 51
3 General principles 51
4 Commissioning the system 51
5 Testing communication with the device 52
Chapter 9 User interfaces 55
4Rev. 01

Chapter 1 Table of contents

9.1 User interface on the rapidM2M T32x 55

9.1.1 Operating elements 55

9.1.1.1 Solenoid switch 55

9.1.1.2 RGB-LED 56

9.1.1.3 Micro vibration motor 56

9.2 User interface on the myDatanet server 56

9.2.1 Site configuration 56

9.2.1.1 Site 56

9.2.1.2 Comments 56

9.2.1.3 Control 57

9.2.1.4 Configuration 0 - Configuration 9 57

9.2.1.5 Alarm settings 58

9.2.1.6 Basic settings 59

9.2.1.7 FTP export settings 59

9.2.2 Device configuration 60

9.2.2.1 Comments 60

9.2.2.2 Measurement instrument 60

9.2.2.3 GPRS 61

Chapter 10 DeviceConfig 63

10.1 General 63

10.2 Prerequisites 63

10.3 Functional principle 64

10.4 Installation 65

10.5 Menu of the DeviceConfig 67

10.5.1 Settings 67

10.5.1.1 Options 67

10.6 Connecting a Device via USB 69

10.7 "Log" tab 71

10.8 "Firmware" tab 73

Chapter 11 myDatanet server 75

11.1 Overview 75

11.1.1 Explanation of the symbols 75

11.2 "Customer" area 76

Rev. 01 5

11.3 "Site" area at customer level 78

11.3.1 Reports 79

11.3.2 Map view 79

11.4 Recommended procedure 79

11.4.1 Creating the site 79

Chapter 12 rapidM2M Studio 83

12.1 General 83

12.2 Prerequisites 84

12.3 Project dashboard 85

12.4 CODEbed 86

12.5 TESTbed 87

Chapter 13 Device Logic (Pawn) 89

13.1 General 89

13.1.1 Direct entry of a device logic 89

13.1.2 Uploading a binary file 89

13.1.3 Using the CODEbed of the web-based development environment rapidM2M Studio 89

13.2 rapidM2M Device API 90

13.2.1 Constants 90

13.2.2 Timer, date & time 91

13.2.2.1 Arrays with symbolic indices 91

13.2.2.2 Constants 91

13.2.2.3 Functions 91

13.2.3 Uplink 96

13.2.3.1 Arrays with symbolic indices 96

13.2.3.2 Constants 96

13.2.3.3 Callback functions 100

13.2.3.4 Functions 101

13.2.4 Encoding 110

13.2.4.1 Constants 110

13.2.4.2 Functions 111

13.2.5 Registry 116

13.2.5.1 Constants 116

13.2.5.2 Callback functions 117

6Rev. 01

Chapter 1 Table of contents

13.2.5.3 Functions 117

13.2.6 Position 121

13.2.6.1 Arrays with symbolic indices 121

13.2.6.2 Constants 123

13.2.6.3 Functions 124

13.2.7 Math 130

13.2.8 Char & String 133

13.2.9 CRC & hash 138

13.2.9.1 Arrays with symbolic indices 138

13.2.9.2 Functions 139

13.2.10 Various 140

13.2.10.1 Arrays with symbolic indices 140

13.2.10.2 Constants 141

13.2.10.3 Functions 141

13.2.11 Console 146

13.2.12 File transfer 147

13.2.12.1 Arrays with symbolic indices 147

13.2.12.2 Constants 147

13.2.12.3 Callback functions 148

13.2.12.4 Functions 149

13.2.13 System 152

13.2.13.1 Arrays with symbolic indices 152

13.2.13.2 Constants 153

13.2.13.3 Callback functions 153

13.2.13.4 Functions 153

13.2.14 GPIO, IRQ 154

13.2.14.1 Constants 154

13.2.14.2 Callback functions 154

13.2.14.3 Functions 155

13.2.15 I2C, UART 157

13.2.15.1 Constants 157

13.2.15.2 Callback functions 157

13.2.15.3 Functions 158

Rev. 01 7

13.2.16 GPS 162

13.2.16.1 Callback functions 162

13.2.16.2 Functions 163

13.2.17 Outputs 163

13.2.17.1 Functions 163

13.2.18 LED 164

13.2.18.1 Functions 164

13.2.19 Micro vibration motor 164

13.2.19.1 Functions 164

13.2.20 Solenoid switch 165

13.2.20.1 Callback functions 165

13.2.20.2 Functions 165

13.3 Device Logic error codes 166

13.4 Syntax 168

13.4.1 General syntax 168

13.4.1.1 Format 168

13.4.1.2 Optional semicolons 168

13.4.1.3 Comments 168

13.4.1.4 Identifier 169

13.4.1.5 Reserved keywords 169

13.4.1.6 Numerical constants 169

13.4.1.6.1 Numerical integer constants 169

13.4.1.6.2 Numerical floating-point constants 169

13.4.2 Variables 170

13.4.2.1 Declaration 170

13.4.2.2 Local declaration 170

13.4.2.3 Global declaration 170

13.4.2.4 Static local declaration 170

13.4.2.5 Static global declaration 170

13.4.2.6 Floating point values 170

13.4.3 Constant variables 171

13.4.4 Array variables 171

13.4.4.1 One-dimensional arrays 171

8Rev. 01

Chapter 1 Table of contents

13.4.4.2 Initialisation 171

13.4.4.3 Progressive initialisation for arrays 172

13.4.4.4 Multi-dimensional arrays 172

13.4.4.5 Arrays and the "sizeof" operator 172

13.4.5 Operators and expressions 173

13.4.5.1 Notational conventions 173

13.4.5.2 Expressions 173

13.4.5.3 Arithmetic 174

13.4.5.4 Bit manipulation 174

13.4.5.5 Assignment 174

13.4.5.6 Comparative operators 175

13.4.5.7 Boolean 175

13.4.5.8 Other 176

13.4.5.9 Priority of the operators 176

13.4.6 Statements 177

13.4.6.1 Statement label 177

13.4.6.2 Composite statements 178

13.4.6.3 Expression statement 178

13.4.6.4 Empty statement 178

13.4.6.5 Assert expression 178

13.4.6.6 Break 179

13.4.6.7 Continue 179

13.4.6.8 Do statement while (expression) 180

13.4.6.9 Exit expression 180

13.4.6.10 For (expression1; expression2; expression3) statement 180

13.4.6.11 Goto label 181

13.4.6.12 If (expression) statement1 else statement2 181

13.4.6.13 Return expression 181

13.4.6.14 switch (expression) {case list} 181

13.4.6.15 While (expression) statement 182

13.4.7 Functions 183

13.4.7.1 Function arguments ("call-by-value" versus "call-by-reference") 183

13.4.7.2 Named parameters versus fixed parameters 185

Rev. 01 9

4.7.3 Standard values of function arguments 185
5 Differences to C 186
Chapter 14 Data Descriptor 189
1 Data structure 189
1.1 Division of a structured measurement data channel into individual data fields 190
1.2 Division of a configuration memory block into individual data fields 191
1.3 Division of the aloha data into individual data fields 192
1.4 Attributes of the field definition 192
2 Example 195
3 Special values of the data types 197
Chapter 15 API 199
1 Backend API 199
2 rapidM2M Playground 199
2.1 Overview 200
Chapter 16 Maintenance 201
1 General maintenance 201
2 Charging the rechargeable battery 201
Chapter 17 Removal/disposal 203
Chapter 18 Troubleshooting and repair 205
1 General problems 205
2 Log entries and error codes 206
2.1 Modem error 209
3 Evaluating the device log 210
3.1 Evaluating the device log on the myDatanet server 210
3.2 Evaluating the device log using DeviceConfig 211
Chapter 19 Spare parts and accessories 213
1 Montagesets 213
2 Other accessories 213
Chapter 20 Document history 215
Chapter 21 Glossary 217
Chapter 22 Contact information 219
Rev. 01