MC Technologies MC100 Terminal User manual

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
1
User Manual
MC100 Terminal
MC100 Gateway
MC100 GPIO
MC100 SensT2
MC100 WMBUS
Version v1.0.1

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
2
This documentation applies to MC 100 SW version 1.0.4.
1 GENERAL ...................................................................................................................................................... 5
1.1 WARRANTY PROVISIONS ............................................................................................................................. 5
2 SAFETY ......................................................................................................................................................... 5
2.1 TECHNICAL LIMITING VALUES........................................................................................................................ 5
2.2 OBLIGATIONS OF THE OPERATOR................................................................................................................... 5
2.3 QUALIFICATION OF PERSONNEL .................................................................................................................... 6
2.4 GUIDELINES FOR TRANSPORT AND STORAGE .................................................................................................... 6
2.5 LABELS ON THE PRODUCT ............................................................................................................................ 6
2.6 ENVIRONMENTAL PROTECTION..................................................................................................................... 6
2.7 BASIC SAFETY REQUIREMENT........................................................................................................................ 7
3 USE OF OPEN-SOURCE SOFTWARE ............................................................................................................... 7
3.1 GENERAL ................................................................................................................................................. 7
3.2 LIABILITY REGULATIONS............................................................................................................................... 8
3.3 USED OPEN-SOURCE SOFTWARE ................................................................................................................... 8
4 DEVICE VARIANTS......................................................................................................................................... 8
5 CONTENTS.................................................................................................................................................... 9
6 TECHNICAL SPECIFICATIONS ......................................................................................................................... 9
6.1 TECHNICAL DATA....................................................................................................................................... 9
Physical properties ............................................................................................................................ 96.1.1 Technological mobile network features ............................................................................................ 96.1.2
7 CHECK MODEM VERSION ........................................................................................................................... 10
8 PORTS AND DISPLAY................................................................................................................................... 11
9 INSTALLATION............................................................................................................................................ 13
9.1 ANTENNA............................................................................................................................................... 13
9.2 INSERTING THE SIM CARD ......................................................................................................................... 13
9.3 POWER SUPPLY ....................................................................................................................................... 13
9.4 CONFIGURATION VIA WEB INTERFACE .......................................................................................................... 13
9.5 SETTING UP THE SIM AND ESTABLISHING A CONNECTION................................................................................. 14
9.6 ONLINE‐TEST.......................................................................................................................................... 16
9.7 INTERNET ACCESS .................................................................................................................................... 16
9.8 ACCESS VIA SSH...................................................................................................................................... 16
9.9 COMMAND LINE INTERFACE....................................................................................................................... 16
9.10 CHANGE IP-ADDRESS ............................................................................................................................... 17
 NODE-RED WEB INTERFACE ..................................................................................................................... 18
Enable the Node-Red installed in MC100: ....................................................................................... 189.11.1 Install extra modules: ...................................................................................................................... 189.11.2 Add a node ...................................................................................................................................... 189.11.3 Add a debug node ........................................................................................................................... 199.11.4 Wire the nodes ................................................................................................................................ 199.11.5 Deploy ............................................................................................................................................. 199.11.6
10 READOUT ANALOG AND DIGITAL IO'S VIA NODE-RED WEBSITE INTERFACE ............................................. 20
10.1 MC100 GPIO ....................................................................................................................................... 20
Analog Inputs (mA/V)...................................................................................................................... 2010.1.1 Digital Inputs ................................................................................................................................... 2010.1.2 Digital Outputs ................................................................................................................................ 2010.1.3 Dashboard ....................................................................................................................................... 2110.1.4
10.2 MC100 SENST2..................................................................................................................................... 22
Analog Inputs .................................................................................................................................. 2210.2.1

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
3
Write Analog Inputs ........................................................................................................................ 22
10.2.2 PT100/1000 ..................................................................................................................................... 2210.2.3
11 CONTOL AND READOUT OF ANALOG AND DIGITAL IO'S AND LEDS VIA COMMAND LINE INTERFACE ....... 23
11.1 MC100 CIRCUIT..................................................................................................................................... 23
11.2 ETHERNET-INTERFACE (ALL) ...................................................................................................................... 24
11.3 POWER SUPPLY (ALL)................................................................................................................................ 24
11.4 MC100 GATEWAY.................................................................................................................................. 25
Digital inputs ................................................................................................................................... 2511.4.1 Digital Outputs ................................................................................................................................ 2511.4.2 RS485 interface 2-wire bus without galvanic isolation ................................................................... 2611.4.3 CAN-Interface .................................................................................................................................. 2611.4.4 RS232-Interface ............................................................................................................................... 2611.4.5 USB-Port 2.0 Type A ........................................................................................................................ 2711.4.6
11.5 MC100 GPIO ....................................................................................................................................... 27
Digital Inputs ................................................................................................................................... 2711.5.1 Digital Outputs ................................................................................................................................ 2811.5.2 Voltage inputs 0 –10V .................................................................................................................... 2911.5.3 Current inputs 0 - 20mA .................................................................................................................. 2911.5.4 PWM................................................................................................................................................ 3011.5.5
11.6 MC100 SENST2..................................................................................................................................... 31
Digital Inputs ................................................................................................................................... 3111.6.1 Digital Outputs ................................................................................................................................ 3211.6.2 Voltage inputs 0 –10V .................................................................................................................... 3311.6.3 Current inputs 0 - 20mA .................................................................................................................. 3311.6.4 Current outputs 0 - 20mA................................................................................................................ 3411.6.5 PT100 / PT1000 Inputs .................................................................................................................... 3511.6.6
11.7 LEDS.................................................................................................................................................... 36
12 OPENVPN ................................................................................................................................................. 37
12.1 CLIENT CONFIGURATION ........................................................................................................................... 37
12.2 SERVER CONFIGURATION .......................................................................................................................... 39
13 WMBUS.................................................................................................................................................... 41
13.1 GENERAL INFORMATION ........................................................................................................................... 41
13.2 INSTALLING COMMAND LINE TOOL MCWMBUS .............................................................................................. 41
13.3 BASIC FUNCTIONALITY .............................................................................................................................. 41
13.4 OUTPUT FORMATS................................................................................................................................... 41
hex................................................................................................................................................... 4113.4.1 json .................................................................................................................................................. 4213.4.2 XML ................................................................................................................................................. 4313.4.3 json_hex .......................................................................................................................................... 4313.4.4
13.5 SEND MESSAGES TO REST API .................................................................................................................. 43
13.6 WRITING ON DISK.................................................................................................................................... 43
13.7 VIEW LIVE INFORMATION IN NODE-RED ...................................................................................................... 44
13.8 COMBINE DATA FOR 1H,6H,1DAY AND SEND VIA FTP/SCP............................................................................ 45
13.9 SUPPORT ............................................................................................................................................... 46
14 MODBUS .................................................................................................................................................. 47
14.1 MODBUS FOR NODE-RED ...................................................................................................................... 47
Creating a first flow......................................................................................................................... 4714.1.1
14.2 MODBUS COMMAND LINE TOOL................................................................................................................. 48
Installation ...................................................................................................................................... 4814.2.1
14.3 USAGE AND COMMAND LINES.................................................................................................................... 49
15 MBUS ....................................................................................................................................................... 50
15.1 SETTING UP THE MBUS MODULE ............................................................................................................... 50
15.2 USING LIBMBUS....................................................................................................................................... 50

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
4
16 1-WIRE ..................................................................................................................................................... 51
16.1 FOR V1.0.4 OR OLDER.............................................................................................................................. 51
Using 1-wire driver .......................................................................................................................... 5116.1.1 Function files ................................................................................................................................... 5116.1.2
 probe_bus........................................................................................................................................ 51
 read ................................................................................................................................................. 51
 write ................................................................................................................................................ 52
 reset................................................................................................................................................. 52
Select device: ................................................................................................................................... 5216.1.3
16.2 FOR V1.0.5 (FUTURE RELEASE) .................................................................................................................. 53
Using OWFS file system ................................................................................................................... 5316.2.1 OWhttpd.......................................................................................................................................... 5316.2.2
17 UPDATING MC100 1.0.3RC10 TO1.0.4 ...................................................................................................... 54
17.1 USING COMMAND LINE ............................................................................................................................ 54
17.2 USING LUCI WEB INTERFACE ..................................................................................................................... 55
Update Feeds................................................................................................................................... 5517.2.1 Installing Certificates....................................................................................................................... 5517.2.2 Updating the system ....................................................................................................................... 5517.2.3
18 FACTORY RESET ........................................................................................................................................ 56
19 MAINTENANCE, REPAIR AND TROUBLESHOOTING ................................................................................... 57
19.1 MAINTENANCE........................................................................................................................................ 57
19.2 TROUBLESHOOTING ................................................................................................................................. 57
19.3 REPAIR .................................................................................................................................................. 57
20 DISPOSAL.................................................................................................................................................. 57
20.1 RETURN OF THE OLD EQUIPMENT................................................................................................................ 57

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
5
1 General
These instructions enable the safe and efficient handling of the product. The instructions
are an integral part of the product and must be kept accessible at all times to installation,
commissioning and operating personnel.
1.1 Warranty provisions
Unauthorized use, non-observance of this documentation, the use of insufficiently qualified
personnel and unauthorized modifications exclude the manufacturer's liability for resulting
damages. The manufacturer's warranty is void. The provisions of our terms and conditions
of delivery and purchase (AGB) apply. These can be found on our website (https://www.mc-
technologies.net/en/terms-and-conditions.php)
2 Safety
The Safety section provides an overview of the safety instructions to be observed when
operating the product.
The product has been constructed in compliance with the currently valid rules of technology
and is safe to operate. It has been tested and has left the factory in perfect condition in
terms of safety. In order to maintain this condition over the operating time, the information
in the applicable publications and certificates must be observed and followed.
The basic safety instructions must be strictly maintained when operating the product. In
addition to the basic safety instructions, the individual sections of the documentation
contain descriptions of procedures and operating instructions with specific safety
information.
Furthermore, the local guidelines for the prevention of accidents and general safety
regulations for the area of application of the device should be applied.
Only the consideration of all safety instructions enables the optimum protection of
personnel and the environment against hazards as well as the safe and trouble-free
operation of the product.
2.1 Technical limiting values
The product is exclusively intended for use within the technical limits specified in the data
sheets.
The following limit values must be observed:
The surrounding temperature limits must not be exceeded or dropped below.
The supply voltage range must not be violated under or above.
The maximum air humidity must not be exceeded and condensation must be
avoided.
The maximum switching voltage and the maximum switching current load must not
be exceeded.
The maximum input voltage and the maximum input current must not be exceeded.
2.2 Obligations of the operator
The operator must always observe the national regulations applicable in his country
regarding the operation, functional testing, repair and maintenance of electronic devices.

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
6
2.3 Qualification of personnel
Installation, commissioning and maintenance of the product may only be carried out by
trained specialist personnel authorised by the system operator. The qualified personnel
must have read and understood this documentation and follow the instructions.
The electrical installation and commissioning of the product may only be carried out by a
person who, due to his or her specialist training, knowledge and experience as well as
knowledge of the relevant standards and regulations, is able to carry out work on electrical
systems and independently detect and avoid possible hazards.
2.4 Guidelines for transport and storage
The following instructions must be observed:
Do not expose the product to moisture or other potentially harmful environmental
conditions (radiation, gases, etc.) during transport and storage. Pack the product
properly.
Pack the product so that it is protected from shocks during transport and storage,
e.g. by using air-cushioned packaging.
Before installing the product, check it for possible damage that may have been
caused by improper transport or storage. Damage in transit must be noted on the
shipping documents. All claims for damages must be made immediately and before
installation to the carrier / company responsible for storage.
2.5 Labels on the product
The type plate of the product is located as a sticker on one surface of the product. It may
contain the following markings, among others, which are explained in more detail here.
Dispose of old equipment in an environmentally responsible manner
This symbol indicates that old devices must be disposed of separately from residual
waste at suitable collection points. See also the disposal section in this manual.
CE-label
By affixing the CE marking, the manufacturer confirms that the product complies
with the product-specific applicable European regulations.
2.6 Environmental protection
Dispose the product and its packaging in accordance with the relevant environmental
protection regulations. Refer to the disposal section of this manual for instructions on how
to dispose of the product. Separate the packaging components made of cardboard and
paper as well as plastic and recycle them using the appropriate collection systems.

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
7
2.7 Basic safety requirement
Electrostatic discharges can damage the product!
Damage the product.
Observe the general precautions for handling electrostatically sensitive
components.
Moisture and liquids from the surrounding area can get inside the
product!
Risk of fire and damage to the product.
The product must not be used in wet or humid environments or in the immediate
vicinity of water. Install the product in a dry place protected from splashing
water. Turn off the power before performing any work on a device that has been
exposed to moisture.
Short circuits and damage due to improper repairs and
modifications and opening of maintenance areas!
Risk of fire and damage to the product.
It is not permitted to open the product for repair work or
modifications beyond the removal and insertion of the plug-in cards
provided for this purpose.
Overvoltage and voltage peaks from the power supply system!
Fire hazard and damage to the device due to overvoltage.
Install a suitable surge protection.
Distance between antennas and persons!
Too small distance between mobile phone antennas and people can affect
their health.
Please note that the mobile phone antenna must be at least 20 cm away from
persons during operation.
3 Use of open-source software
3.1 General
This product includes, among other things, so-called open-source software, which was
produced by third parties and published for free use by everyone. The open-source
software is subject to special open-source software licenses and the copyright of third
parties. Every customer can use the open-source software according to the license terms
of the respective manufacturer. The rights of the customer to use the open-source software
beyond the purpose of our product are regulated in detail by the respective open source
software license. The customer may freely use the open-source software, as provided for in
the respective valid license, beyond the purpose of the open-source software in our
product. In the case that there is a contradiction between our license terms for our product
and the respective open-source software license, the respective open-source software
license takes priority over our license terms as far as the respective open-source software
is affected.
The use of the open-source software used is free of charge. We do not charge any user
fees or comparable fees for the use of the open-source software contained in our product.
The use of the open-source software by the customer in our product is not part of the profit
we make with the contractual remuneration.

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
8
The provided list shows all open source software programs that are included in our product.
The most important open-source software licenses are listed in the licenses section at the
end of this publication.
As far as programs contained in our product are under the GNU General Public License
(GPL), GNU Lesser General Public License (LGPL), the Clarified Artistic License or any
other open-source software license, which stipulates that the source code must be made
available, we will send the source code at any time on request. Our offer to send the source
code on demand automatically ends 3 years after delivery of our product to the customer.
Requests should be sent to the following address, if possible stating the serial number of
our product:
MC Technologies GmbH
Kabelkamp 2
30179 Hannover
3.2 Liability regulations
We do not assume any warranty or liability if the open-source software programs contained
in our product are used by the customer in a way that no longer corresponds to the purpose
of the contract on which the purchase of our product is based. This applies in particular to
any use of the open source software programs outside of our product. For the use of the
open source software beyond the purpose of the contract, the warranty and liability
provisions provided for in the applicable open source software license for the
corresponding open source software, as listed below, shall apply. In particular, we shall not
be liable if the open source software in our product or the entire software configuration in
our product is changed. The warranty given in the contract on which the purchase of our
product is based shall only apply to the unchanged open source software and the
unchanged software configuration in our product.
3.3 Used open-source software
Please contact our support department (suppo[email protected]t) for a list of open
source software used in this product. Alternatively, a list of the open source software used
can be found in the MC100 web interface under System -> Software -> Installed.
4 Device variants
This manual describes different variants of the MC100 terminal / gateway from MC
Technologies GmbH. The devices are collectively referred to as MC100 in the manual. The
MC100 are:
4G LTE MC100 Terminal
4G LTE MC100 Gateway
4G LTE MC100 GPIO Terminal
4G LTE MC100 GPIO Gateway
4G LTE MC100 SensT2 Terminal
4G LTE MC100 SensT2 Gateway
4G LTE MC100 WMBUS Gateway
If the MC100 differ, this is mentioned separately in the corresponding sections.

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
9
5 Contents
The package includes the accessories listed below. Please check that all accessories listed
are included in your box. If a part is missing or damaged, please contact MC Technologies
directly.
MC 100 Terminal / Gateway
Quick Installation Guide
Safety Instructions
Screw terminals
Optional accessories are not included. Among others, the following parts are available at MC
Technologies:
Mobile phone antennas
Antenna extensions and accessories
DIN Rail
Ethernet cable
GSM (LTE)-Antenna
6 Technical specifications
The following specifications apply to all versions of the MC100. If these variants differ
from one another, the different values are indicated separately.
6.1 Technical Data
Physical properties6.1.1
Physical characteristics
Value
Supply Voltage
8 V ... 30 V DC
Dimensions (W x H x D)
120 x 75 x 35mm
Operation temperature
-20°C to +70°C
Housing
Plastic
Mounting
Wall mounting (DIN rail adapter optional)
The extended temperature range allows temporary operation at increased temperatures.
This may result in functional restrictions (especially during data transmission). This serves
to protect the internal electronics.
Technological mobile network features6.1.2
Technological feature
Description
Supporting networks
LTE Cat1 (4G): Band 1,3,5,7,8 and 20
HSDPA/HSUPA/HSPA+ (3G): Band 1,5,8, all
bands with diversity
GSM/GPRS/EDGE (2G): Band 3,8
Transmission rates LTE
Up to 50 Mbps uplink and 10 Mbps downlink
Transmission rates HSPA+
Up to 5.76 Mbps uplink and 21.6 Mbps downlink
Transmission rates EDGE
Up to 236.8 kbps uplink and 236.8 kbps downlink
Antenna connections
SMA (female)
LED 4 shows the statues of the network connection:
LED 4:
Long-time Off: Searching for connection.
Long-time ON: Connected.
Flashing quickly: Packet Data transfer.

MC100
Mobile programmable gateway
MC Technologies GmbH, Kabelkamp 2, 30179 Hannover, Germany
Tel: [phone], Fax: [phone], Website & Shop: www.mc-technologies.net, Email: [email protected]
10
7 Check Modem Version
To check the firmware version of your MC100:
1. Login to Luci web interface using your device IP address (default: 192.168.2.1)
2. On the main page, scroll down to MC info Tab
3. Under Modem Revision, you can read the firmware version of your MC100 Model Chip.
a. As of release 1.0.4 the latest firmware for the model chip is AR06A03.