Domnev1: Difference between revisions

From Teltonika Networks Wiki
No edit summary
No edit summary
 
(35 intermediate revisions by the same user not shown)
Line 1: Line 1:
<p style="color:red">The information on this page is updated in accordance with the [https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads'''00.07.09'''] firmware version .</p>
==Introduction==
==Introduction==
This article contains instructions on how to configure


==Tunnelbroker configuration==
This article contains step-by-step instructions on how to set up bidirectional communication between two serial RS232 devices over TCP/IP.
Go to [http://tunnelbroker.net tunnelbroker.net] and log into your account. If you don't have a registered account then you will need to create one - click '''register'''.


[[File:Tunnelbroker login.png|border|center|class=tlt-border|1004x1004px]]
==Configuration overview & prerequisites==
===IPv6 to IPv4 setup===
----
Setup IPv6 over IPv4, also known as 6in4 IPv6 transition mechanism


[[File:Create IPv6 Tunnel.png|border|center|class=tlt-border|954x954px]]
End devices are connected to separate RUT956 routers through RS232 connection, and client connects to the server through its Public IP address.


[[File:OverIP Client Server network topology.png|border|class=tlt-border|1005px]]


'''Prerequisites''':


==Relayd configuration==
*Two devices with RS232 support
Relay is a daemon (computer program that runs as a background process) used to relay and dynamically redirect incoming connections to a target host. Its main purpose in RUTxxx routers is to extend the wireless network. For example, when RUTxxx is in STA Wireless Station mode, it can be used to bridge WAN and LAN interfaces to create a larger Wireless network.
*Two end devices (PCs or RS232 devices able to send and receive data, here we will be using PCs with serial simulators)
*Over IP Server must have a SIM card with a Public Static or Public Dynamic IP address (more on IP address types here) to make remote access possible
{{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer
| series = RUTX
}}


This article provides an extensive configuration example of a basic Relay usage scenario with two RUTxxx devices.
==Over IP Server==
===Relayd installation===
----
Install relayd package if needed, skip this step on RUTX series devices or if you already installed it on your router
<pre>opkg update
opkg install relayd</pre>


===WiFi client configuration===
====Obtaining Public IP: Set an APN====
----
----
Add WiFi interface to make your router act as a WiFi client (connect to another AP)
In this example we are using Public IPs, it also works with Private IPs if routers are in same LAN


<pre>uci add wireless wifi-iface
'''Note:''' If you have a Public IP address already, you can skip this step.
uci set wireless.@wifi-iface[-1]=wifi-iface</pre>


Add new WiFi interface to 2.4ghz device, can specify 'radio1' for 5ghz
To set the APN, while in the router's WebUI, navigate to the '''Network → Mobile → General → Interface mob1s1a1 APN configuration''':


<pre>uci set wireless.@wifi-iface[-1].device='radio0'
[[File:Set APN PF.png|border|class=tlt-border|alt=]]
uci set wireless.@wifi-iface[-1].mode='sta'
uci set wireless.@wifi-iface[-1].network='wifi_wan'</pre>


Change SSID here to an SSID that the router will be connecting to
Once in the '''Interface mob1s1a1 APN configuration''' window, edit your mobile interface, find the '''APN''' field and enter you Internet Service Provider's APN:
# '''Disable the Auto APN option'''
# Choose the correct '''APN''', which gives out a public IP address (for more information about that contact your Internet Service Provider)


<pre>uci set wireless.@wifi-iface[-1].ssid='RUT_4474_2G'</pre>
[[File:Set APN PF APN selected.png|border|class=tlt-border]]


Change BSSID here to BSSID that the router will be connecting to (L2 address)
Additional notes on APN:
* '''NOTE 1''': don't use the exact APN value as seen in the example above as it will not work with your SIM card. APN depends on your Internet Service Provider (ISP), therefore, your ISP should provide you with their APN or, in many case, you can find your ISP's APN with an online search.
* '''NOTE 2''': furthermore, it should be noted that not all SIM cards support this functionality. Static or Dynamic Public IP addresses (obtained through APN) are a paid service and setting any APN value for a SIM card that doesn't support this service will most likely result in losing your data connection. If this is the case, it can be fixed by simply deleting the APN, but it also means that remote access through mobile WAN IP will most likely not work on your SIM card.
* '''NOTE 3''': in some cases the SIM card doesn't require an APN in order to obtain a Public IP address. If that is the case for you, simply check what your router's mobile WAN IP address is - if it's already a Public IP address, then you don't need to set an APN. The easiest way to find what your mobile WAN IP address is to log in to the router's WebUI and check the '''MOB1S1A1''' widget in the '''Overview''' page:


<pre>uci set wireless.@wifi-iface[-1].bssid='00:1E:42:44:44:74'</pre>
[[File:Where public IP.png|border|class=tlt-border]]


Use appropriate auth method, PSK2 = WPA2-PSK here


<pre>uci set wireless.@wifi-iface[-1].encryption='psk2'</pre>
===Over IP Server RS232 configuration===
----
Navigate to the Over IP tab by going to '''Services → Serial Utilities → Over IP''' . Insert desired name and select RS232. Make sure to '''enable the instance''' '''(1)''' and '''configure Serial port in accordance''' '''(2)''' to connected device, these should match on both routers to avoid miscommunication.


Change secret to appropriate one
[[File:OverIP Sever serial config.png|border|class=tlt-border]]


<pre>uci set wireless.@wifi-iface[-1].key='Vc80Tps1'
uci set wireless.@wifi-iface[-1].disabled='0'
uci set wireless.@wifi-iface[-1].skip_inactivity_poll='0'
uci set wireless.@wifi-iface[-1].wifi_id='wifi1'</pre>


New internface configuration
===Over IP Server configuration===
----
After applying RS232 configuration scroll down and configure Over IP Server:


<pre>uci set network.wifi_wan=interface
# Mode '''Server'''- the device waits for incoming connections.
uci set network.wifi_wan.proto='dhcp'
# Select a desired protocol, '''TCP or UDP'''.
uci set network.wifi_wan.metric='6'
# '''TCP/UDP port''' - specify desired port.
uci set network.wifi_wan.disabled='0'
uci set network.wifi_wan.force_link='0'
uci set network.wifi_wan.broadcast='0'</pre>


IPv6 interface creation
[[File:OverIP TCP server configuration port.png|border|class=tlt-border]]


<pre>uci set network.wifi_wan6=interface
uci set network.wifi_wan6.proto='dhcpv6'
uci set network.wifi_wan6.metric='6'
uci set network.wifi_wan6.disabled='0'
uci set network.wifi_wan6.force_link='0'
uci set network.wifi_wan6.reqaddress='try'
uci set network.wifi_wan6.reqprefix='auto'
uci set network.wifi_wan6.device='@wifi_wan'</pre>


<pre>uci set network.lan_repeater=interface
===IP Filter===
uci set network.lan_repeater.proto='relay'
----
uci set network.lan_repeater.lan_mark='lan'
 
uci set network.lan_repeater.enabled='1'
Once finished the above configuration, add interfaces through which routers will be communicating, You can add IP address that will be allowed to connect or enter 0.0.0.0 to allow all connections coming through correct port.
uci set network.lan_repeater.network='lan wifi_wan'</pre>


<pre>uci set network.lan.ipaddr='192.168.1.3'</pre>
[[File:OverIP TPC Server IP filter.png|border|class=tlt-border]]


Set DHCP settings for LAN interface (disable dhcp on LAN) and enable IPv6 relay on wifi_wan interface and


<pre>uci set dhcp.lan.ignore='1'
==OverIP Client==
uci set dhcp.lan.ra='relay'
uci set dhcp.lan.dhcpv6='relay'
uci set dhcp.lan.ndp='relay'</pre>


<pre>uci set dhcp.wifi_wan=dhcp
===OverIP Server RS232 configuration===
uci set dhcp.wifi_wan.ra='relay'
----
uci set dhcp.wifi_wan.dhcpv6='relay'
Navigate to the OverIP tab by going to '''Services → Serial Utilities → OverIP''' . Insert desired name and select RS232. Make sure to '''enable the instance''' '''(1)''' and '''configure Serial port in accordance''' '''(2)''' to connected device, these should match on both routers to avoid miscommunication.
uci set dhcp.wifi_wan.master='1'
uci set dhcp.wifi_wan.ndp='relay'</pre>


Set firewall zone, using WAN firewall zone for newly created wifi_wan network interface
[[File:OverIP Client serial config.png|border|class=tlt-border]]


<pre>uci set firewall.@zone[1].network='wan wan6 mob1s1a1 mob1s2a1 wifi_wan'</pre>


Set mwan3 settings for new interface wifi_wan
===OverIP Client configuration===
----
After applying RS232 configuration scroll down and configure Over IP Server:


<pre>uci set mwan3.wifi_wan=interface
# Mode '''Client''' – the device initiates the connection.
uci set mwan3.wifi_wan.enabled='0'
# Select a desired protocol, '''TCP or UDP'''.
uci set mwan3.wifi_wan.interval='3'
# '''Address''' is the Over IP Sever Public IP address. '''Port''' is the port we have configured on the Over IP Server device.  
uci set mwan3.wifi_wan.family='ipv4'
uci add mwan3 condition
uci set mwan3.@condition[-1].interface='wifi_wan'
uci set mwan3.@condition[-1].track_method='ping'
uci add_list mwan3.@condition[-1].track_ip='1.1.1.1'
uci add_list mwan3.@condition[-1].track_ip='8.8.8.8'
uci set mwan3.@condition[-1].reliability='1'
uci set mwan3.@condition[-1].count='1'
uci set mwan3.@condition[-1].timeout='2'
uci set mwan3.@condition[-1].down='3'
uci set mwan3.@condition[-1].up='3'
uci set mwan3.wifi_wan_member_mwan=member
uci set mwan3.wifi_wan_member_mwan.interface='wifi_wan'
uci set mwan3.wifi_wan_member_mwan.metric='1'
uci set mwan3.wifi_wan_member_balance=member
uci set mwan3.wifi_wan_member_balance.interface='wifi_wan'
uci set mwan3.wifi_wan_member_balance.weight='1'
uci add_list mwan3.mwan_default.use_member='wifi_wan_member_mwan'
uci add_list mwan3.balance_default.use_member='wifi_wan_member_balance'</pre>


Set proper ipv6 settings for wifi_wan6 iface
[[File:OverIP TCP Client configuration IP port.png|border|class=tlt-border]]


<pre>uci set mwan3.wifi_wan6=interface
==Testing configuration==
uci set mwan3.wifi_wan6.enabled='0'
uci set mwan3.wifi_wan6.interval='3'
uci set mwan3.wifi_wan6.family='ipv6'
uci add mwan3 condition
uci set mwan3.@condition[-1].interface='wifi_wan6'
uci set mwan3.@condition[-1].track_method='ping'
uci add_list mwan3.@condition[-1].track_ip='2606:4700:4700::1111'
uci add_list mwan3.@condition[-1].track_ip='2001:4860:4860::8888'
uci set mwan3.@condition[-1].reliability='1'
uci set mwan3.@condition[-1].count='1'
uci set mwan3.@condition[-1].timeout='2'
uci set mwan3.@condition[-1].down='3'
uci set mwan3.@condition[-1].up='3'
uci set mwan3.wifi_wan6_member_mwan=member
uci set mwan3.wifi_wan6_member_mwan.interface='wifi_wan6'
uci set mwan3.wifi_wan6_member_mwan.metric='1'
uci set mwan3.wifi_wan6_member_balance=member
uci set mwan3.wifi_wan6_member_balance.interface='wifi_wan6'
uci set mwan3.wifi_wan6_member_balance.weight='1'
uci add_list mwan3.mwan_default.use_member='wifi_wan6_member_mwan'
uci add_list mwan3.balance_default.use_member='wifi_wan6_member_balance'
uci set mwan3.default_rule_ipv6=rule
uci set mwan3.default_rule_ipv6.dest_ip='::/0'
uci set mwan3.default_rule_ipv6.use_policy='mwan_default'
uci set mwan3.default_rule_ipv6.family='ipv6'</pre>


Save all the changes and restart the configuration
If you followed configuration steps both end devices should be able to send and receive data. In this example we use Hercules program on both computers and open serial communication with routers. We are able to send and receive data through RS232.


<pre>uci commit
[[File:Over IP Client Server hercules test.png|border|class=tlt-border|1004px]]
reload_config</pre>

Latest revision as of 20:49, 13 October 2024

The information on this page is updated in accordance with the 00.07.09 firmware version .

Introduction

This article contains step-by-step instructions on how to set up bidirectional communication between two serial RS232 devices over TCP/IP.

Configuration overview & prerequisites

End devices are connected to separate RUT956 routers through RS232 connection, and client connects to the server through its Public IP address.

Prerequisites:

  • Two devices with RS232 support
  • Two end devices (PCs or RS232 devices able to send and receive data, here we will be using PCs with serial simulators)
  • Over IP Server must have a SIM card with a Public Static or Public Dynamic IP address (more on IP address types here) to make remote access possible

If you're having trouble finding this page or some of the parameters described here on your device's WebUI, you should turn on "Advanced WebUI" mode. You can do that by clicking the "Advanced" button, located at the top of the WebUI.

Over IP Server

Obtaining Public IP: Set an APN


In this example we are using Public IPs, it also works with Private IPs if routers are in same LAN

Note: If you have a Public IP address already, you can skip this step.

To set the APN, while in the router's WebUI, navigate to the Network → Mobile → General → Interface mob1s1a1 APN configuration:

Once in the Interface mob1s1a1 APN configuration window, edit your mobile interface, find the APN field and enter you Internet Service Provider's APN:

  1. Disable the Auto APN option
  2. Choose the correct APN, which gives out a public IP address (for more information about that contact your Internet Service Provider)

Additional notes on APN:

  • NOTE 1: don't use the exact APN value as seen in the example above as it will not work with your SIM card. APN depends on your Internet Service Provider (ISP), therefore, your ISP should provide you with their APN or, in many case, you can find your ISP's APN with an online search.
  • NOTE 2: furthermore, it should be noted that not all SIM cards support this functionality. Static or Dynamic Public IP addresses (obtained through APN) are a paid service and setting any APN value for a SIM card that doesn't support this service will most likely result in losing your data connection. If this is the case, it can be fixed by simply deleting the APN, but it also means that remote access through mobile WAN IP will most likely not work on your SIM card.
  • NOTE 3: in some cases the SIM card doesn't require an APN in order to obtain a Public IP address. If that is the case for you, simply check what your router's mobile WAN IP address is - if it's already a Public IP address, then you don't need to set an APN. The easiest way to find what your mobile WAN IP address is to log in to the router's WebUI and check the MOB1S1A1 widget in the Overview page:


Over IP Server RS232 configuration


Navigate to the Over IP tab by going to Services → Serial Utilities → Over IP . Insert desired name and select RS232. Make sure to enable the instance (1) and configure Serial port in accordance (2) to connected device, these should match on both routers to avoid miscommunication.


Over IP Server configuration


After applying RS232 configuration scroll down and configure Over IP Server:

  1. Mode Server- the device waits for incoming connections.
  2. Select a desired protocol, TCP or UDP.
  3. TCP/UDP port - specify desired port.


IP Filter


Once finished the above configuration, add interfaces through which routers will be communicating, You can add IP address that will be allowed to connect or enter 0.0.0.0 to allow all connections coming through correct port.


OverIP Client

OverIP Server RS232 configuration


Navigate to the OverIP tab by going to Services → Serial Utilities → OverIP . Insert desired name and select RS232. Make sure to enable the instance (1) and configure Serial port in accordance (2) to connected device, these should match on both routers to avoid miscommunication.


OverIP Client configuration


After applying RS232 configuration scroll down and configure Over IP Server:

  1. Mode Client – the device initiates the connection.
  2. Select a desired protocol, TCP or UDP.
  3. Address is the Over IP Sever Public IP address. Port is the port we have configured on the Over IP Server device.

Testing configuration

If you followed configuration steps both end devices should be able to send and receive data. In this example we use Hercules program on both computers and open serial communication with routers. We are able to send and receive data through RS232.