Microtronics rapidM2M T32x User manual

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
4.1 Translation 15
4.2 Copyright 15
4.3 General descriptive names 15
4.4 Safety instructions 15
4.4.1 Use of the hazard warnings 16
4.4.2 General safety instructions 16
4.4.3 Safety and preventative measures for handling GSM/GPRS modems 16
4.4.3.1 Safety and precautionary measures for the GSM/GPRS modem installation 17
4.5 Overview 18
4.5.1 Block diagram 19
4.6 Intended use 19
4.7 General product information 20
4.8 Device labelling 21
4.9 Installation of spare and wear parts 21
4.10 Storage of the product 22
4.11 Warranty 22
4.12 Disclaimer 23
4.13 Obligation of the operator 23
4.14 Personnel requirements 24
Chapter 5 Functional principle 25
5.1 Recommended procedure 27
5.1.1 Development of M2M/IoT application 27
5.2 Functionality of the internal data memory 27
5.3 Memory organisation 29
5.4 Procedure in case of connection aborts 30
5.4.1 Connection abort in "online" mode 31
Rev. 01 3

5.4.2 Connection abort during a Device Logic download 31
5.5 Automatic selection of the GSM network 31
5.6 Determining the GSM/UMTS/LTE signal strength 31
5.7 Error handling 31
5.8 Registration memory blocks 32
5.8.1 REG_APP_OTP 32
5.9 File transfer 33
5.10 Meaning of the SIM state 34
Chapter 6 Storage, delivery and transport 35
6.1 Inspection of incoming deliveries 35
6.2 Scope of supply 35
6.3 Storage 35
6.4 Transport 35
6.5 Return 35
Chapter 7 Installation 37
7.1 Dimensions 37
7.2 Installing the rapidM2M T32x 37
7.2.1 Installation on magnetic surfaces 38
7.2.2 Installation using adhesive pad 40
7.2.3 Installation using screws 42
7.2.4 Installation using an Action-Cam bracket 43
7.3 Safety instructions for connecting additional sensors and the alternative power supply 44
7.3.1 Information on preventing electrostatic discharges (ESD) 44
7.4 Electrical installation 45
7.4.1 Connection of additional sensors and the alternative power supply 45
7.4.2 Technical details about the USB interface 49
Chapter 8 Initial Start-Up 51
8.1 User information 51
8.2 Applicable documents 51
8.3 General principles 51
8.4 Commissioning the system 51
8.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

13.4.7.3 Standard values of function arguments 185
13.5 Differences to C 186
Chapter 14 Data Descriptor 189
14.1 Data structure 189
14.1.1 Division of a structured measurement data channel into individual data fields 190
14.1.2 Division of a configuration memory block into individual data fields 191
14.1.3 Division of the aloha data into individual data fields 192
14.1.4 Attributes of the field definition 192
14.2 Example 195
14.3 Special values of the data types 197
Chapter 15 API 199
15.1 Backend API 199
15.2 rapidM2M Playground 199
15.2.1 Overview 200
Chapter 16 Maintenance 201
16.1 General maintenance 201
16.2 Charging the rechargeable battery 201
Chapter 17 Removal/disposal 203
Chapter 18 Troubleshooting and repair 205
18.1 General problems 205
18.2 Log entries and error codes 206
18.2.1 Modem error 209
18.3 Evaluating the device log 210
18.3.1 Evaluating the device log on the myDatanet server 210
18.3.2 Evaluating the device log using DeviceConfig 211
Chapter 19 Spare parts and accessories 213
19.1 Montagesets 213
19.2 Other accessories 213
Chapter 20 Document history 215
Chapter 21 Glossary 217
Chapter 22 Contact information 219
10 Rev. 01

Chapter 2 Declaration of conformity
Chapter 2 Declaration of conformity
Rev. 01 11

Chapter 3 Specifications
Chapter 3 Specifications
Voltage supply Rechargeable battery: LiPo cell with 500mAh
Alternative ext. power
supply1) 3...5VDC
Charging voltage 5VDC via USB-C connector
Housing Material:
Weight:
Degree of protection:
Dimensions (WHD):
MJF-PA12
50g
IP64
66 x 52 x 21mm
Operating temperature -20...+60°C
Air humidity 15...90%rH non-condensing
Storage and transport
temperature
-60...+60°C
Display lMicro vibration motor (freely usable)
lRGB-LED (freely usable)
Operation Solenoid switch (freely usable)
Antenna connector Internal antenna
Internal sensors 3D acceleration meter
lMeasurement range: ±2 / ±4 / ±8 / ±16g
lResolution: 0,061 / 0,122 / 0,244 / 0,488 mg
3D gyroscope
lMeasurement range: ±125 / ±250 / ±500 / ±1000 / ±2000dps
lResolution: 4,375 / 8,75 / 17,5 / 35 / 70 mdps
Temperature sensor
lMeasurement range: -20...+60°C
lResolution: 0,1°C
Positioning GNSS module (GPS/QZSS, GLONAS)
Serial interface 1) 2) 1 x UART (2-wire)
lBaud rate: 600...3.000.000
lStop bits: 1, 2
lParity: N, E, O
lData bits: 7, 8
1 x I2C (master)
lClock frequency: max. 1MHz
I/Olines 1) 3) 2 x GPIO or interrupt inputs
Outputs 1) 1 x switchable 3,3V supply (max. 150mA )
Rev. 01 13

USB interface 1 x USB 2.0 slave via USB-C connector for the connection to a PC and to charge
the rechargeable battery. The DeviceConfig configuration program must be
installed on the PC or the web-based development environment rapidM2M
Studio must be used to enable communication with the rapidM2M T32x .
Additional information is provided in "Technical details about the USB interface"
on page 49.
Data memory 3MB internal flash memory.
The size of the data records is variable (max. 1023 Byte ) and is determined by
the device logic created by the user. The system-related overhead is 11 Byte per
data record.
Additional information is provided in"Functionality of the internal data memory"
on page 27.
Configuration memory 10 independent blocks each with 4000 Byte
Registration memory Flash: 4 blocks each with 1kB and pre-defined purposes for storing device-
specific data.
RAM: 1 optional block with max. 1kB for storing application-specific data.
Additional information is provided in "Registration memory blocks" on page 32.
Memory for the PAWN
binary
256kB (uncompressed size)
Additional information is provided in "Memory organisation" on page 29.
Data transmission M1/NB1 Europe:
lLTE B3, B20
M1 US:
lLTE B4, B13
SIM The rapidM2M T32x is equipped with an integrated SIM chip.
1) only accessible when the housing is open
2) UART and I2C interface cannot be used simultaneously
3) individually configurable per I/O line
14 Rev. 01

Chapter 4 General specifications
Chapter 4 General specifications
The information in this manual has been compiled with great care and to the best of our knowledge. The
manufacturer, however, assumes no liability for any incorrect specifications that may be provided in this
manual. The manufacturer is not responsible for direct, indirect, accidental or consequential damages which
arise from errors or omissions in this manual even if advised of the possibility of such damages. In the interest
of continuous product development, the manufacturer reserves the right to make improvements to this
manual and the products described in it at any time and without prior notification or obligation.
Note: The specifications in this manual are valid as of the versions listed on the front page. Revised versions
of this manual, as well as software and driver updates are available in the service area of the myDatanet
server.
4.1 Translation
For deliveries to countries in the European Economic Area, the manual must be translated into the language
of the respective country. If there are any discrepancies in the translated text, the original manual (German)
must be referenced or the manufacturer contacted for clarification.
4.2 Copyright
The copying and distribution of this document as well as the utilisation and communication of its contents to
others without express authorisation is prohibited. Contraventions are liable to compensation. All rights
reserved.
4.3 General descriptive names
The use of general descriptive names, trade names, trademarks and the like in this manual does not entitle
the reader to assume they may be used freely by everyone. They are often protected registered trademarks
even if not marked as such.
4.4 Safety instructions
For the connection, commissioning and operation of the rapidM2M T32x , the following information and
higher legal regulations of the country (e.g. ÖVE), such as valid EX regulations as well as the applicable
safety and accident prevention regulations for the respective application case must be observed.
Read this manual completely before unpacking, setting up or operating this device. Observe all hazard,
danger and warning information. Non-observance can lead to serious injuries to the operator and/or damage
to the device.
Ensure that the safety equipment of this measurement instrument is not impaired. Install and use the
measurement system only in the manner and method described in this manual.
Important note: The manufacturer's products that are designed for outdoor use include minimal
protection against the ingress of moisture and extensive protection against the ingress of dust.
Connectors that are not used must be covered with protective caps to protect against penetrating
moisture and dust. The operator is responsible for complying with local safety regulations.
Rev. 01 15

4.4.1 Use of the hazard warnings
DANGER:
Indicates a potential or threatening hazardous situation that will result in death or serious
injuries if not avoided.
WARNING:
Indicates a potential or threatening hazardous situation that can result in death or serious
injuries if not avoided.
CAUTION:
Indicates a potential hazardous situation that can result in minor or moderate injuries or
damage to this instrument.
Important note: Indicates a situation that can result in damages to this instrument if it is not avoided.
Information that must be particularly emphasised.
Note: Indicates a situation that does not result in any injury to persons.
Note: Information that supplements the specifications in the main text.
4.4.2 General safety instructions
WARNING:
Ensure that the device is fully deactivated and cannot activate automatically when
sending/returning it as air freight. Information on this is provided in chapter "Storage of
the product" on page 22. If you have any unanswered questions, contact the manufacturer
(see "Contact information" on page 219).
WARNING:
Never use this device in areas where the use of wireless equipment is prohibited. The
device must not be used in hospitals and/or in the vicinity of medical equipment, such as
heart pacemakers or hearing aids, as their functionality could be compromised by the
GSM/GPRS modem contained in the device.
WARNING:
Never use this device in potentially explosive atmospheres and in the vicinity of highly
combustible areas (fuel stations, storage areas for combustible material, chemical plants
and detonation sites) or in the vicinity of flammable gases, vapours or dust.
4.4.3 Safety and preventative measures for handling GSM/GPRS modems
The following safety and preventative measures must be observed during all phases of installation, operation,
maintenance or repair of a GSM/GPRS modem. The manufacturer is not liable if the customer disregards
these preventative measures.
CAUTION:
The GSM/GPRS modem connection must not be used in hazardous environments.
No guarantee of any kind, whether implicit or explicit, is given by the manufacturer and its suppliers for the use
with high risk activities.
16 Rev. 01

Chapter 4 General specifications
In addition to the following safety considerations, all directives of the country in which the device is installed
must be complied with.
Important note: No liability shall be assumed at any time and under no circumstances for
connections via a GSM/GPRS modem for which wireless signals and networks are utilized. The
GSM/GPRS modem must be switched on and operated in an area where sufficient signal strength is
present.
4.4.3.1 Safety and precautionary measures for the GSM/GPRS modem installation
lThis device must only be installed by a trained technician who applies the recognised installation
practices for a radio frequency transmitter including the correct grounding of external antennas.
lThe device must not be operated in hospitals and/or in the vicinity of medical equipment such as heart
pacemakers or hearing aids.
lThe device must not be operated in highly flammable areas such as petrol filling stations, fuel storage
sites, chemical factories and explosion sites.
lThe device must not be operated in the vicinity of flammable gases, vapours or dusts.
lThe device must not be subjected to strong vibrations or impacts.
lThe GSM/GPRS modem can cause interferences if it is located in the vicinity of television sets, radios
or computers.
lDo not open the GSM/GPRS modem. Any modification to the device is prohibited and will result in the
operating licence being revoked.
lThe use of GSM services (SMS messages/data communication/GPRS, etc.) may incur additional
costs. The user is solely responsible for any resulting damages and costs.
lDo not install the device in any other way to the one described in the operating instructions. Improper
use will invalidate the warranty.
Rev. 01 17

4.5 Overview
Top of the rapidM2M T32x Left side of therapidM2M T32x
1RGB-LED (freely usable) 2Pressure compensation
3USB-C connector (only for charging the
rechargeable battery, debugging and device logic
development/update)
18 Rev. 01

Chapter 4 General specifications
4.5.1 Block diagram
Block diagram of the rapidM2M T32x
4.6 Intended use
The compact and freely programmable ultra low power NB-IoT sensor is designed to record, process and
transmit information. The device is battery-operated. The measured and recorded data is stored on a non-
volatile memory medium. This stored data is sent via the mobile network to a central server for further
processing. The device is equipped with an integrated SIM chip for establishing a mobile connection. The
maximum permissible limit values specified in chapter "Specifications" on page 13 must be observed. The
manufacturer shall not be liable for any operational cases that deviate from these limit values and have not
been approved by the manufacturer in writing.
Note: This device is exclusively intended to be used for the purposes as described before. Any other
use or use beyond what is specified or a modification of the device shall be deemed to be not for the
intended purpose and is not permitted without the express written consent of the manufacturer. The
manufacturer shall not be held liable for any damages that may result from such unauthorised use or
modification. The operator alone bears the associated risk.
Note: The manufacturer is not liable for data loss of any kind.
Note: The integrated SIM chip provides a mobile communications connection to a variety of
international service providers. In order to be able to utilise all functions of the device, you must
ensure that the device is located in the service area of one of these service providers. You can find a
list of all supported countries and associated service providers under
www.microtronics.com/footprint. A Managed Service contract with Microtronics Engineering GmbH
is required for use of the mobile data transmission (see www.microtronics.com/managedservice).
This includes the provisioning of the mobile communications connection via the network of the service
provider included in the above-mentioned list.
Rev. 01 19

4.7 General product information
The device is a compact, freely programmable device for determining, processing and transferring
information.
The following internal sensors are available for acquiring measurement data:
l3D acceleration meter
l3D gyroscope
lTemperature sensor
lGNSS module (GPS/QZSS, GLONAS) used for positioning
In addition, the interfaces listed below are also available to connect additional sensors. However, these are
only accessible after opening the housing.
l1 x UART (2-wire)1)
l1 x I2C (master)1)
l2 x GPIO or interrupt inputs2)
l1 x switchable 3,3V power supply
The housing of the rapidM2M T32x has a small storage space to store additional sensors (see "Connection of
additional sensors and the alternative power supply" on page 45).
The user can create their own application via the rapidM2M Studio (see "rapidM2M Studio " on page 83).
During development the part of the application that needs to be installed on the device (i.e. the device logic) is
loaded into the rapidM2M T32x via the USB interface. For applications that are provided via the rapidM2M
Store installation of the device logic is performed via the mobile network in the course of connecting the site
with the rapidM2M T32x . The device logic also enables access to the available interfaces (UART, I2C, GPIO,
interrupt inputs and switchable power supply), thus providing the user with the option to connect to almost all
of the sensors that are compatible with these interfaces and to implement the corresponding communication
protocols.
The rapidM2M T32x provides the user with a memory area for their data (3MB ) as well as 10 independent
memory blocks each with 4000 Byte for the configuration data. In addition to the 4 registration memory blocks
each with 1kB , that are saved in the flash, the rapidM2M T32x has another one that can optionally be
initialised via the "rM2M_RegInit()" function and that is saved in the RAM. Its size can be specified during
initialisation, although it is limited to a maximum of 1kB . The registration memory blocks are assigned to
predefined purposes and are designed for storing device-specific data (see "Registration memory blocks" on
page 32).
Recorded data can be sent to a central myDatanet server via the mobile network for further processing. The
device is equipped with an integrated SIM chip for establishing a mobile connection. The user holds the
responsibility for initialising the connection to the central myDatanet server (see "rM2M_TxStart()").
However, the system automatically synchronises the configuration, registration and measurement data with
the server.
1) UART and I2C interface cannot be used simultaneously
2) individually configurable per I/O line
20 Rev. 01