NetModule NB3710 User manual

NetModule Router NB3710
User Manual for Software Version 4.4
Manual Version 1.13
NetModule AG, Switzerland
September 30, 2022

NB3710
User Manual for NRSW version 4.4
NetModule Router NB3710
This manual covers all variants of the NB3710 product type.
The specifications and information regarding the products in this manual are subject to change without notice. We would
like to point out that NetModule makes no representation or warranties with respect to the contents herein and shall not
be responsible for any loss or damage caused to the user by the direct or indirect use of this information This document
may contain information about third party products or processes. Such third party information is generally out of influence
of NetModule and therefore NetModule shall not be responsible for the correctness or legitimacy of this information. Users
must take full responsibility for their application of any products.
Copyright ©2022 NetModule AG, Switzerland All rights reserved
This document contains proprietary information of NetModule. No parts of the work described herein may be reproduced.
Reverse engineering of the hardware or software is prohibited and protected by patent law. This material or any portion of
it may not be copied in any form or by any means, stored in a retrieval system, adopted or transmitted in any form or by
any means (electronic, mechanical, photographic, graphic, optic or otherwise), or translated in any language or computer
language without the prior written permission of NetModule.
A large amount of the source code to this product is available under licenses which are both free and open source. Most of it
is covered by the GNU General Public License which can be obtained from www.gnu.org. The remainder of the open source
software which is not under the GPL, is usually available under one of a variety of more permissive licenses. A detailed
license information for a particular software package can be provided on request.
All other products or company names mentioned herein are used for identification purposes only and may be trademarks or
registered trademarks of their respective owners. The following description of software, hardware or process of NetModule or
other third party provider may be included with your product and will be subject to the software, hardware or other license
agreements.
Contact
www.netmodule.com/support
NetModule AG Tel [phone]
Maulbeerstrasse 10 Fax [phone]
CH-3011 Bern inf[email protected]
Switzerland http://www.netmodule.com
2

NB3710
User Manual for NRSW version 4.4
Contents
1. Welcome to NetModule ..................................... 6
2. Conformity ............................................ 7
2.1. Safety Instructions ...................................... 7
2.2. Declaration of Conformity .................................. 9
2.3. Waste Disposal ........................................ 9
2.4. National Restrictions ..................................... 9
2.5. Open Source Software .................................... 10
3. Specifications ........................................... 11
3.1. Appearance .......................................... 11
3.2. Features ............................................ 12
3.3. Environmental Conditions .................................. 14
3.4. Interfaces ........................................... 15
3.4.1. Overview ......................................... 15
3.4.2. LED Indicators ...................................... 16
3.4.3. Reset ........................................... 17
3.4.4. Mobile .......................................... 18
3.4.5. WLAN .......................................... 18
3.4.6. GNSS ........................................... 20
3.4.7. USB 2.0 Host Port .................................... 20
3.4.8. M12 Ethernet Connectors ............................... 21
3.4.9. Power Supply ...................................... 22
3.4.10.Digital Inputs and Outputs ............................... 24
3.4.11.Extension Connector .................................. 26
4. Installation ............................................. 33
4.1. Installation of the Mini-SIM Card ............................... 33
4.2. Installation of the GSM/UMTS/LTE Antenna ........................ 33
4.3. Installation of the WLAN Antennas ............................. 35
4.4. Installation of the GPS Antenna ............................... 35
4.5. Installation of the Local Area Network ............................ 36
4.6. Installation of the Power Supply ............................... 36
4.7. Installation of the Audio Interface .............................. 37
5. Configuration ........................................... 38
5.1. First Steps ........................................... 38
5.1.1. Initial Access ....................................... 38
5.1.2. Automatic Mobile Data Connection .......................... 39
5.1.3. Recovery ......................................... 40
5.2. HOME ............................................. 41
5.3. INTERFACES ......................................... 44
5.3.1. WAN ........................................... 44
5.3.2. Ethernet ......................................... 50
5.3.3. Mobile .......................................... 55
5.3.4. WLAN .......................................... 60
5.3.5. Software Bridges .................................... 71
5.3.6. USB ............................................ 72
5.3.7. Serial Port ........................................ 75
5.3.8. Digital I/O ......................................... 80
5.3.9. Audio ........................................... 81
3

NB3710
User Manual for NRSW version 4.4
5.3.10.GNSS ........................................... 82
5.4. ROUTING ........................................... 85
5.4.1. Static Routes ....................................... 85
5.4.2. Extended Routing .................................... 87
5.4.3. Multipath Routes ..................................... 88
5.4.4. Mobile IP ......................................... 89
5.4.5. Quality Of Service .................................... 93
5.4.6. Multicast ......................................... 95
5.4.7. OSPF ........................................... 96
5.4.8. BGP ........................................... 97
5.5. FIREWALL ........................................... 98
5.5.1. Administration ...................................... 98
5.5.2. Adress/Port Groups ................................... 98
5.5.3. Rules ........................................... 99
5.5.4. NAPT ........................................... 101
5.6. VPN .............................................. 104
5.6.1. OpenVPN ........................................ 104
5.6.2. IPsec ........................................... 110
5.6.3. PPTP ........................................... 116
5.6.4. GRE ........................................... 119
5.6.5. L2TP ........................................... 120
5.6.6. Dial-In .......................................... 121
5.7. SERVICES ........................................... 123
5.7.1. SDK ............................................ 123
5.7.2. DHCP Server ...................................... 132
5.7.3. DNS Server ....................................... 134
5.7.4. NTP Server ....................................... 137
5.7.5. Dynamic DNS ...................................... 138
5.7.6. E-Mail ........................................... 140
5.7.7. Events .......................................... 142
5.7.8. SMS ........................................... 143
5.7.9. SSH/Telnet Server .................................... 145
5.7.10.SNMP Agent ....................................... 147
5.7.11.Web Server ....................................... 152
5.7.12.Softflow .......................................... 153
5.7.13.Discovery ......................................... 154
5.7.14.Redundancy ....................................... 155
5.7.15.Voice Gateway ...................................... 157
5.8. SYSTEM ............................................ 163
5.8.1. System .......................................... 163
5.8.2. Authentication ...................................... 167
5.8.3. Software Update ..................................... 170
5.8.4. Module Firmware Update ................................ 171
5.8.5. Software Profiles .................................... 172
5.8.6. Configuration ....................................... 173
5.8.7. Troubleshooting ..................................... 176
5.8.8. Keys and Certificates .................................. 179
5.8.9. Licensing ......................................... 184
5.8.10.Legal Notice ....................................... 185
4

NB3710
User Manual for NRSW version 4.4
5.9. LOGOUT ............................................ 186
6. Command Line Interface ..................................... 187
6.1. General Usage ........................................ 187
6.2. Print Help ........................................... 188
6.3. Getting Config Parameters .................................. 188
6.4. Setting Config Parameters .................................. 189
6.5. Checking Config Completed ................................. 189
6.6. Getting Status Information .................................. 189
6.7. Scanning Networks ...................................... 190
6.8. Sending E-Mail or SMS .................................... 190
6.9. Updating System Facilities .................................. 190
6.10. Manage keys and certificates ................................ 191
6.11. Restarting Services ...................................... 191
6.12. Debug System ......................................... 192
6.13. Resetting System ....................................... 193
6.14. Rebooting System ...................................... 193
6.15. Running Shell Commands .................................. 193
6.16. Working with History ..................................... 193
6.17. CLI-PHP ............................................ 193
A. Appendix ............................................. 199
A.1. Abbrevations ......................................... 199
A.2. System Events ........................................ 200
A.3. Factory Configuration ..................................... 203
A.4. SNMP VENDOR MIB ..................................... 204
A.5. SDK Examples ........................................ 205
5

NB3710
User Manual for NRSW version 4.4
List of Figures
5.1. Initial Login .......................................... 39
5.2. Home ............................................. 41
5.3. WAN Links .......................................... 44
5.4. WAN Settings ......................................... 47
5.5. Link Supervision ....................................... 48
5.6. Ethernet Ports ......................................... 50
5.7. Ethernet Link Settings .................................... 51
5.8. VLAN Management ...................................... 52
5.9. LAN IP Configuration ..................................... 53
5.10. SIMs .............................................. 55
5.11. WWAN Interfaces ....................................... 58
5.12. WLAN Management ..................................... 60
5.13. WLAN Configuration ..................................... 65
5.14. WLAN IP Configuration ................................... 69
5.15. USB Administration ...................................... 72
5.16. USB Device Management .................................. 73
5.17. Serial Port Administration .................................. 76
5.18. Serial Port Settings ...................................... 77
5.19. Digital I/O Ports ........................................ 80
5.20. Static Routing ......................................... 85
5.21. Extended Routing ....................................... 87
5.22. Multipath Routes ....................................... 88
5.23. Mobile IP ........................................... 91
5.24. Firewall Groups ........................................ 98
5.25. Firewall Rules ......................................... 99
5.26. Masquerading ......................................... 101
5.27. Inbound NAPT ........................................ 102
5.28. OpenVPN Administration .................................. 104
5.29. OpenVPN Configuration ................................... 105
5.30. OpenVPN Client Management ............................... 109
5.31. IPsec Administration ..................................... 111
5.32. IPsec Configuration ...................................... 112
5.33. PPTP Administration ..................................... 116
5.34. PPTP Tunnel Configuration ................................. 117
5.35. PPTP Client Management .................................. 118
5.36. Dial-in Server Settings .................................... 121
5.37. SDK Administration ...................................... 127
5.38. SDK Jobs ........................................... 128
5.39. DHCP Server ......................................... 132
5.40. DNS Server .......................................... 134
5.41. NTP Server .......................................... 137
5.42. Dynamic DNS Settings .................................... 138
5.43. E-Mail Settings ........................................ 140
5.44. SMS Configuration ...................................... 143
5.45. SSH and Telnet Server .................................... 145
5.46. SNMP Agent ......................................... 148
6

NB3710
User Manual for NRSW version 4.4
5.47. Web Server .......................................... 152
5.48. VRRP Configuration ..................................... 155
5.49. Voice Gateway Administration ................................ 157
5.50. System ............................................ 163
5.51. Regional settings ....................................... 165
5.52. User Accounts ........................................ 167
5.53. Remote Authentication .................................... 169
5.54. Manual File Configuration .................................. 173
5.55. Automatic File Configuration ................................. 174
5.56. Factory Configuration ..................................... 175
5.57. Log Viewer .......................................... 177
5.58. Tech Support File ....................................... 178
5.59. Keys and certificates ..................................... 179
5.60. Certificate Configuration ................................... 181
5.61. Licensing ........................................... 184
7

NB3710
User Manual for NRSW version 4.4
List of Tables
3.1. Environmental Conditions .................................. 14
3.2. NB3710 Interfaces ...................................... 16
3.3. NB3710 Status Indicators .................................. 17
3.4. Ethernet Status Indicators .................................. 17
3.5. Mobile Interface ........................................ 18
3.6. Mobile Antenna Port Specification ............................. 18
3.7. IEEE 802.11 Standards ................................... 19
3.8. WLAN Antenna Port Specification .............................. 19
3.9. GNSS Specifications option G ................................ 20
3.10. GNSS Specifications option Ge ............................... 20
3.11. GNSS / GPS Antenna Port Specification .......................... 20
3.12. USB 2.0 Host Port Specification ............................... 21
3.13. Ethernet Port Specification .................................. 21
3.14. Pin Assignments of Ethernet Connectors .......................... 22
3.15. Power Input Specifications Variant Pa ........................... 22
3.16. Power Input Specifications Variant Pb ........................... 23
3.17. Pin Assignments of Power Connector ............................ 23
3.18. Common Digital I/O Specification .............................. 24
3.19. Isolated Digital Outputs Specification ............................ 24
3.20. Isolated Digital Inputs Specification ............................. 24
3.21. Pin Assignments of Digital Inputs and Outputs ....................... 25
3.22. Pin Assignments of Digital Inputs and Outputs ....................... 26
3.23. Audio Port Specification ................................... 27
3.24. Pin Assignments of Audio Port Signals (EP1 / EP2) .................... 27
3.25. CAN Port Specification .................................... 28
3.26. Pin Assignments of CAN Port Signals (EP1 / EP2) .................... 28
3.27. IBIS Port Specification .................................... 29
3.28. Pin Assignments of IBIS Port Signals (EP1 / EP2) ..................... 29
3.29. Non-isolated RS-232 Port Specification .......................... 30
3.30. Pin Assignments of RS-232 Port Signals (EP1 / EP2) ................... 30
3.31. Isolated RS-232 Port Specification ............................. 31
3.32. Pin Assignments of RS-232 Port Signals (EP1 / EP2) ................... 31
3.33. RS-485 Port Specification .................................. 32
3.34. Pin Assignments of RS-485 Port Signals (EP1 / EP2) ................... 32
4.1. LTE/UMTS antenna port types ............................... 34
4.2. WLAN antenna port types .................................. 35
5.20. IEEE 802.11 Network Standards .............................. 62
5.48. Static Route Flags ...................................... 86
5.95. SMS Control Commands ................................... 131
5.105. SMS Number Expressions .................................. 144
5.141. Certificate Sections ...................................... 180
5.142. Certificate Operations .................................... 180
A.1. Abbreviations ......................................... 200
A.2. System Events ........................................ 202
8

NB3710
User Manual for NRSW version 4.4
A.3. SDK Examples ........................................ 207
9

NB3710
User Manual for NRSW version 4.4
1. Welcome to NetModule
Thank you for purchasing a NetModule Router. This document should give you an introduction to the
router and its features. The following chapters describe any aspects of commissioning the device,
installation procedure and provide helpful information towards configuration and maintenance.
Please find further imformation such as sample SDK script or configuration samples in our wiki on
http://wiki.netmodule.com.
10

NB3710
User Manual for NRSW version 4.4
2. Conformity
This chapter provides general information for putting the router into operation.
2.1. Safety Instructions
Please carefully observe all safety instructions in the manual that are marked with the symbol .
Compliance information: The NetModule routers must be used in compliance with
any and all applicable national and international laws and with any special restrictions
regulating the utilization of the communication module in prescribed applications and
environments.
Information about the accessories / changes to the device:
– Please only use original accessories to prevent injuries and health risks.
– Changes made to the device or the use of non-authorized accessories will render the
warranty null and void and potentially invalidate the operating license.
– NetModule routers must not be opened (SIM cards may be used according to the
instructions).
11

NB3710
User Manual for NRSW version 4.4
Information about the device interfaces:
– All systems that are connected to the NetModule router interfaces must meet the
requirements for SELV (Safety Extra Low Voltage) systems.
– Interconnections must not leave the building nor penetrate the body shell of a vehicle.
– Connections for antennas may only exit the building or the vehicle hull if transient
overvoltages (according to IEC 62368-1) are limited by external protection circuits
down to 1 500 Vpeak. All other connections must remain within the building or the vehicle
hull.
– Always keep a distance of more than 40 cm from the antenna in order to reduce
exposure to electromagnetic fields below the legal limits.
– Devices with a WLAN interface may be operated only with applicable Regulatory Do-
main configured. Special attention must be paid to country, number of antennas and
the antenna gain (see also chapter 5.3.4). The maximum allowed gain is 3dBi in
the relevant frequency range. WLAN antennas with a higher amplification may be
used with the NetModule router "Enhanced-RF-Configuration" software license and
the antenna gain and cable attenuation that have been correctly configured by certi-
fied specialized personnel. A misconfiguration will lead to loss of the approval.
– Cellular antennas attached to the router must have an antenna gain of equal or less
than 2.5 dBi. The user is responsible for the compliance with the legal regulations.
– Only CE-compliant power supplies with a current-limited SELV output voltage range
may be used with the NetModule routers.1
General safety instructions:
– Observe the usage limitations of radio units at filling stations, in chemical plants, in
systems with explosives or potentially explosive locations.
– The devices may not be used in airplanes.
– Exercise particular caution near personal medical aids, such as pacemakers and hear-
ing aids.
– The NetModule routers may also cause interference in the nearer distance of TV sets,
radio receivers and personal computers.
– Never perform work on the antenna system during a thunderstorm.
– The devices are generally designed for normal indoor use. Do not expose the devices
to extraordinary environmental conditions worse than IP40.
– Protect them against aggressive chemical atmospheres and humidity or temperatures
outside specifications.
– We highly recommended creating a copy of a working system configuration. It can be
easily applied to a newer software release afterwards.
1Note: Power supplies for routers with the Pb option (72-110 VDC) cannot be a SELV circuit, since the voltage is greater
than 60 VDC.
12

NB3710
User Manual for NRSW version 4.4
2.2. Declaration of Conformity
NetModule hereby declares that under our own responsibility that the routers
comply with the relevant standards following the provisions of the RED Directive
2014/53/EU. The signed version of the Declaration of Conformity can be obtained
from http://www.netmodule.com/downloads
2.3. Waste Disposal
In accordance with the requirements of the Council Directive 2012/19/EU regard-
ing Waste Electrical and Electronic Equipment (WEEE), you are urged to ensure
that this product will be segregated from other waste at end-of-life and delivered
to the WEEE collection system in your country for proper recycling.
2.4. National Restrictions
This product may be generally used in all EU countries (and other countries following the RED Directive
2014/53/EU) without any limitation. Please refer to our WLAN Regulatory Database for getting further
national radio interface regulations and requirements for a particular country.
13

NB3710
User Manual for NRSW version 4.4
2.5. Open Source Software
We inform you that NetModule products may contain in part open-source software. We are distributing
such open-source software to you under the terms of GNU General Public License (GPL)2, GNU
Lesser General Public License (LGPL)3or other open-source licenses4. These licenses allow you to
run, copy, distribute, study, change and improve any software covered by GPL, Lesser GPL, or other
open-source licenses without any restrictions from us or our end user license agreement on what
you may do with that software. Unless required by applicable law or agreed to in writing, software
distributed under open-source licenses is distributed on an "AS IS" basis, WITHOUT WARRANTIES
OR CONDITIONS OF ANY KIND, either express or implied.
To obtain the corresponding open source codes covered by these licenses, please contact our techni-
cal support at [e-mail].
Acknowledgements
This product includes:
– PHP, freely available from http://www.php.net
– Software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org)
– Cryptographic software written by Eric Young ([email protected])
– Software written by Tim Hudson ([e-mail])
– Software written Jean-loup Gailly and Mark Adler
– MD5 Message-Digest Algorithm by RSA Data Security, Inc.
– An implementation of the AES encryption algorithm based on code released by Dr Brian Glad-
man
– Multiple-precision arithmetic code originally written by David Ireland
– Software from The FreeBSD Project (http://www.freebsd.org)
2Please find the GPL text under http://www.gnu.org/licenses/gpl-2.0.txt
3Please find the LGPL text under http://www.gnu.org/licenses/lgpl.txt
4Please find the license texts of OSI licenses (ISC License, MIT License, PHP License v3.0, zlib License) under
http://opensource.org/licenses
14

NB3710
User Manual for NRSW version 4.4
3. Specifications
3.1. Appearance
15

NB3710
User Manual for NRSW version 4.4
3.2. Features
All models of NB3710 have the following standard functionalities:
– Galvanically isolated power supply
– 5 Ethernet ports (M12, 10/100 Mbit/s)
– 1 USB 2.0 host port
– 2 digital inputs, 2 digital outputs
– 4 mini SIM card slots
– Extension port
The NB3710 can be equipped with the following options:
– LTE / LTE 450MHz / LTE US
– WLAN IEEE 802.11abgn
– GPS/GNSS
16

NB3710
User Manual for NRSW version 4.4
– GSM-R
– RS-232
– RS-485
– IBIS
– CAN
– Audio
– Power Supply 72 , 96, 110 VDC
– 64 GB internal storage
– Software Key Server
– Software Key Voice
Note:All LTE models include support for UMTS/EDGE/GPRS.
Due to its modular approach, the NB3710 router and its hardware components can be arbitrarily
assembled according to its indented usage or application. Please contact us in case of special project
requirements.
17

NB3710
User Manual for NRSW version 4.4
3.3. Environmental Conditions
Parameter Rating
Input Voltage (Variant Pa) 12 VDC to 48 VDC (−15% / +30%)
Input Voltage (Variant Pb) 72 VDC to 110 VDC (−30% / +30%)
Operating Temperature Range 12-48 VDC: EN50155 TX (−40 ◦Cto +70 ◦C) with
max. 5 radio modules
72-110 VDC: EN50155 TX (−40 ◦Cto +70 ◦C) with
max. 3 radio modules
72-110 VDC: EN50155 T2 (−40 ◦Cto +55 ◦C) with
max. 4 radio modules
Storage Temperature Range −40 ◦Cto +85 ◦C
Humidity 0 to 95% (non-condensing)
Altitude up to 4000m
Over-Voltage Category I
Pollution Degree 2
Ingress Protection Rating IP40 (with SIM and USB covers mounted)
Table 3.1.: Environmental Conditions
Attention: When using the Pb variant with an input voltage higher than 60 VDC, the
router MUST be connected to an earth protection.
18

NB3710
User Manual for NRSW version 4.4
3.4. Interfaces
3.4.1. Overview
Nr. Label Function
1 LED Indicators LED Indicators for the different interfaces
2 Reset Reboot and factory reset button
3 SIM 1-4 SIM 1-4, they can be assigned dynamically to any modem by configuration.
4 USB USB 2.0 host port, can be used for software/configuration updates.
5 Ethernet 1-5 FastEthernet switch ports, can be used as LAN or WAN interface.
6 Digital I/O Galvanically isolated digital I/O M12 connector
7 M6 earth protection connector, connected to the ground of the power sup-
ply VGND. If used, connect a yellow-green marked cable with at least 6mm2
copper area. Avoid corrosion and protect the screws against loosening.
8 Power Power supply (galvanically isolated)
9Mob 1 TNC female connectors for MIMO mobile antenna 1
10 Mob 2 TNC female connectors for MIMO mobile antenna 2
19

NB3710
User Manual for NRSW version 4.4
Nr. Label Function
11 WLAN 1 TNC female connectors for MIMO WLAN antenna 1
12 WLAN 2 TNC female connectors for MIMO WLAN antenna 2
13 Extension Galvanically isolated extension port M12 connector
14 GNSS TNC female connector for GPS/GLONASS antenna
Table 3.2.: NB3710 Interfaces
3.4.2. LED Indicators
Status LEDs
The following table describes the NB3710 status indicators.
Label Color State Function
Status lblinking The device is busy due to startup, software or configuration up-
date.
lon The device is ready. The captions of the top bank apply.
lon The device is ready. The captions of the bottom bank apply.
Mob1 lll[1] on Mobile connection 1 is up.
lblinking Mobile connection 1 is being established.
moff Mobile connection 1 is down.
Mob2 lll[1] on Mobile connection 2 is up.
lblinking Mobile connection 2 is being established.
moff Mobile connection 2 is down.
WLAN1 lll[1] on WLAN connection 1 is up.
lblinking WLAN connection 1 is being established.
moff WLAN connection 1 is down.
WLAN2 lll[1] on WLAN connection 2 is up.
lblinking WLAN connection 2 is being established.
moff WLAN conne ction 2 is down.
GNSS lon GNSS is turned on and a valid NMEA stream is available.
lblinking GNSS is searching for satellites.
moff GNSS is turned off or no valid NMEA stream is available.
Voice lon A voice call is currently active.
moff No voice call is active.
DO1 lon Normally open output port 1 is closed.
moff Normally open output port 1 is open.
20