Administrator: /* Troubleshooting */

2018-04-24T09:43:55Z

Troubleshooting

← Older revision		Revision as of 09:43, 24 April 2018
Line 595:		Line 595:
	For mPCIe modems to work in 9xx series devices it is required to set the USB type to mPCIe, this can be done using the following command:		For mPCIe modems to work in 9xx series devices it is required to set the USB type to mPCIe, this can be done using the following command:
	<pre>		<pre>
	/system ~~CableFree~~ device usb set type=mini-PCIe		/system routerboard device usb set type=mini-PCIe
	</pre>		</pre>

	In case your modem is not being recognized after a soft reboot, then you might need to add a delay before the USB port is being initialized. This can be done using the following command:		In case your modem is not being recognized after a soft reboot, then you might need to add a delay before the USB port is being initialized. This can be done using the following command:
	<pre>		<pre>
	/system ~~CableFree~~ device settings set init-delay=5s		/system routerboard device settings set init-delay=5s
	</pre>		</pre>

Administrator: Created page with "{{Versions|v6+,v5.12+}} TOC
==Summary==
Package: `system`

Support for Direct-IP mode type cards only. (QMI..."

2018-04-24T09:40:45Z

Created page with "{{Versions|v6+,v5.12+}} __TOC__ <div class=manual> ==Summary== <p id="shbox"> <b>Package:</b> <code>system</code> </p> <p>Support for Direct-IP mode type cards only. (QMI..."

New page

{{Versions|v6+,v5.12+}}

__TOC__

<div class=manual>

==Summary==

<p id="shbox">
<b>Package:</b> <code>system</code>
</p>
<p>Support for Direct-IP mode type cards only. (QMI Support may be possible in future)</p>
<p>To enable access via a PPP interface instead of a LTE Interface, change direct IP mode with <code>/port firmware set ignore-directip-modem=yes</code> command and a reboot. Note that using PPP emulation mode you may not get the same throughput speeds as using the native lte interface.</p>

==LTE Client==
<p id="shbox"><b>Sub-menu:</b> <code>/interface lte</code></p>

<h3>Properties</h3>

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-table
|arg=add-default-route
|type=yes {{!}} no
|default=no
|desc=Whether to add default route to forward all traffic over the LTE interface. (for RadioOS<=6.40)
}}

{{Mr-arg-table
|arg=allow-roaming
|type=yes {{!}} no
|default=no
|desc=Enable data roaming for connecting to other countries data-providers. Note all LTE modems support this feature
}}

{{Mr-arg-table
|arg=authentication
|type=pap {{!}} chap
|default=
|desc=Allowed protocol to use for authentication (for RadioOS<=6.40)
}}

{{Mr-arg-table
|arg=apn
|type=string
|default=""
|desc=Service Provider's Access Point Name (for RadioOS<=6.40)
}}

{{Mr-arg-table
|arg=band
|type=
|default=""
|desc=Frequency band used in communication <code>[https://en.wikipedia.org/wiki/LTE_frequency_bands#Frequency_bands_and_channel_bandwidths LTE Bands and bandwidths]</code>
}}

{{Mr-arg-table
|arg=comment
|type=string
|default=""
|desc=Descriptive name of an item
}}

{{Mr-arg-table
|arg=default-route-distance
|type=integer
|default=1
|desc=Since v6.2, sets distance value applied to auto created default route, if <var>add-default-route</var> is also selected (for RadioOS<=6.40)
}}

{{Mr-arg-table
|arg=disabled
|type=yes {{!}} no
|default=yes
|desc=Whether interface is disabled or not. By default it is disabled.
}}

{{Mr-arg-table
|arg=mac-address
|type=MAC
|default=""
|desc=Media Access Control number of an interface.
}}

{{Mr-arg-table
|arg=modem-init
|type=string
|default=""
|desc=Modem init string
}}

{{Mr-arg-table
|arg=mtu
|type=integer
|default=1500
|desc=Maximum Transmission Unit. Max packet size that LTE interface will be able to send without packet fragmentation.
}}

{{Mr-arg-table
|arg=name
|type=string
|default=""
|desc=Descriptive name of the interface.
}}

{{Mr-arg-table
|arg=network-mode
|type=3g {{!}} auto {{!}} gsm {{!}} lte
|default=auto
|desc=Select/force mode LTE interface is to operate with
}}

{{Mr-arg-table
|arg=password
|type=string
|default=""
|desc=Password used for authentication. (for RadioOS<=6.40)
}}

{{Mr-arg-table
|arg=pin
|type=string
|default=""
|desc=SIM Card's PIN code.
}}

{{Mr-arg-table
|arg=apn-profiles
|type=string
|default=default
|desc=(for RadioOS=>6.40)
}}

{{Mr-arg-table-end
|arg=user
|type=string
|default=""
|desc=User name used for authentication. (for RadioOS<=6.40)
}}

=== APN profiles ===

All network related settings are moved under profiles, starting from RadioOS 6.41
<p id="shbox"><b>Sub-menu:</b> <code>/interface lte apn</code></p>

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-ro-table
|arg=add-default-route
|type=yes {{!}} no
|default=no
|desc=Whether to add default route to forward all traffic over the LTE interface.
}}

{{Mr-arg-ro-table
|arg=apn
|type=string
|default=""
|desc=Service Provider's Access Point Name
}}

{{Mr-arg-table
|arg=authentication
|type=pap {{!}} chap {{!}} none
|default=none
|desc=Allowed protocol to use for authentication
}}

{{Mr-arg-table
|arg=default-route-distance
|type=integer
|default=1
|desc=Since v6.2, sets distance value applied to auto created default route, if <var>add-default-route</var> is also selected
}}

{{Mr-arg-table
|arg=ip-type
|type=ipv4 {{!}} ipv4-ipv6 {{!}} ipv6
|default=
|desc=Requested PDN type
}}

{{Mr-arg-table
|arg=ipv6-interface
|type=
|default=
|desc=Interface on which to advertise IPv6 prefix
}}

{{Mr-arg-table
|arg=name
|type=string
|default=
|desc=APN profile name
}}

{{Mr-arg-table
|arg=number
|type=integer
|default=
|desc=APN profile number
}}

{{Mr-arg-table
|arg=passthrough-interface
|type=
|default=
|desc=
}}

{{Mr-arg-table
|arg=passthrough-mac
|type=
|default=
|desc=If auto, then will learn MAC from first packet
}}

{{Mr-arg-table
|arg=password
|type=string
|default=
|desc=Password used if any of the authentication protocols are active
}}

{{Mr-arg-table
|arg=use-peer-dns
|type=yes {{!}} no
|default=
|desc=
}}

{{Mr-arg-ro-table-end
|arg=user
|type=integer
|default=
|desc=Username used if any of the authentication protocols are active
}}

=== Scanner ===

It is possible to scan LTE interfaces with <code>/interface lte scan</code> command

Available read only properties:
{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-ro-table
|arg=duration
|type=integer
|desc=Duration of scan in seconds
}}

{{Mr-arg-ro-table
|arg=freeze-frame-interval
|type=
|desc=time between data printout
}}

{{Mr-arg-ro-table-end
|arg=number
|type=integer
|desc=Interface number
}}

=== User Info command ===

It is possible to send special "info" command to LTE interface with <code>/interface lte info</code> command.

<h4>Properties (Up to 6.40)</h4>

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-table
|arg=user-command
|type=string
|default=""
|desc=send a command to LTE card to extract useful information, e.g. with AT commands
}}

{{Mr-arg-table-end
|arg=user-command-only
|type=yes {{!}} no
|default=
|desc=
}}

=== User at-chat command ===

It is possible to send user defined "at-chat" command to LTE interface with <code>/interface lte at-chat</code> command.

<pre>
[admin@CableFree] > /interface lte at-chat lte1 input="AT*mrd_imei\?"
output: *MRD_IMEI:356159060388208

OK
</pre>

You can also use "at-chat" function in scripts and assign command output to variable.

<pre>
[admin@CableFree] > :global "lte_command" [/interface lte at-chat lte1 input="AT*mrd_imei\?" as-value ]
[admin@CableFree] > :put $"lte_command"
output=*MRD_IMEI:356159060388208

OK
</pre>

==Quick setup example==

Start with network settings -

{{Warning | For RadioOS versions up to 6.40
<br><br><br>
Set correct parameters on LTE client interface (provided by network provider):
<pre>
/interface lte
set [ find ] apn=phoneprovider.net authentication=chap name=lte1 network-mode=auto password=web user=web
</pre>
}}

{{Warning | For RadioOS versions from 6.41
<br><br><br>
Add new connection parameters under LTE apn profile (provided by network provider):
<pre>
/interface lte apn
add name=profile1 apn=phoneprovider.net authentication=chap password=web user=web
</pre>

Select newly created profile for LTE connection:
<pre>
/interface lte set [find] apn-profiles=profile1
</pre>
}}

LTE interface should appear with running (R) flag:
<pre>
[admin@CableFree] > /interface lte print
Flags: X - disabled, R - running
0 R name="lte1" mtu=1500 mac-address=AA:AA:AA:AA:AA:AA
</pre>

From RadioOS=>6.41 DHCP client is added automatically. If it's not added - add a DHCP Client to LTE Interface manually:
<pre>
/ip dhcp-client
add default-route-distance=1 disabled=no interface=lte1
</pre>
If required, add NAT Masquerade for LTE Interface to get internet to the local network:
<pre>
/ip firewall nat
add action=masquerade chain=srcnat out-interface=lte1
</pre>

After interface is added, you can use "info" command to see what parameters client acquired (parameters returned depends on LTE hardware device):
<pre>
[admin@CableFree] > /interface lte info lte1 once
status: call in progress
pin-status: no password required
functionality: full
manufacturer: Huawei Technologies Co., Ltd.
model: ME909u-521
revision: 12.631.07.01.00
current-operator: vodafone ES
current-cellid: 44436007
access-technology: Evolved 3G (LTE)
signal-strengh: -79 dBm
frame-error-rate: n/a
earfcn: n/a
imei: 860461024123456
imsi: 234012555034981
uicc: n/a
rssi: -79dBm
rsrp: -109dBm
rsrq: -13dB
sinr: -1dB
[admin@CableFree] >
</pre>

==Passthrough Example==

Starting from RadioOS v6.41 some LTE interfaces support LTE Passthrough feature where the IP configuration is applied directly to the client device. In this case modem firmware is responsible for the IP configuration and router is used only to configure modem settings - APN, Network Technologies and IP-Type. In this configuration the router will not get IP configuration from the modem.
The LTE Passthrough modem can pass both IPv4 and IPv6 addresses if that is supported by modem.
Some modems support multiple APN where you can pass the traffic from each APN to a specific router interface.

Passthrough will only work for one host. Router will automatically detect MAC address of the first received packet and use it for the Passthrough. If there are multiple hosts on the network it is possible to lock the Passthrough to a specific MAC.
Note, that it will not be possible to connect to the LTE router via public lte ip address or from the host which is used by the passthrough. It is suggested to create additional connection from the LTE router to the host for configuration purposes. For example vlan interface between the LTE router and host.

To enable the Passthrough a new entry is required or the default entry should be changed in the '/interface lte apn' menu

Examples.

To configure the Passthrough on ether1:

<pre>
[admin@CableFree] > /interface lte apn add apn=apn1 passthrough-interface=ether1
[admin@CableFree] > /interface lte set lte1 apn-profiles=apn1
</pre>

To configure the Passthrough on ether1 host 00:0C:42:03:06:AB:

<pre>
[admin@CableFree] > /interface lte apn add apn=apn1 passthrough-interface=ether1 passthrough-mac=00:0C:42:03:06:AB
[admin@CableFree] > /interface lte set lte1 apn-profiles=apn1
</pre>

To configure multiple APNs on ether1 and ether2:
<pre>
[admin@CableFree] > /interface lte apn add apn=apn1 passthrough-interface=ether1
[admin@CableFree] > /interface lte apn add apn=apn2 passthrough-interface=ether2
[admin@CableFree] > /interface lte set lte1 apn-profiles=apn1,apn2
</pre>

To configure multiple APNs with the same APN for different interfaces:
<pre>
[admin@CableFree] > /interface lte apn add name=interface1 apn=apn1
[admin@CableFree] > /interface lte apn add name=interface2 apn=apn1 passthrough-interface=ether1
[admin@CableFree] > /interface lte set lte1 apn-profiles=interface1
[admin@CableFree] > /interface lte set lte2 apn-profiles=interface2
</pre>

==Tips and Tricks==

This paragraph contains information for additional features and usage cases.

===Find device location using Cell information===

On devices using R11e-LTE card (wAP LTE kit) some extra information is provided under info command (from 6.41rc61)
<pre>
current-operator: 24701
lac: 40
current-cellid: 2514442
</pre>

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-table
|arg=current-cellid
|type=integer
|default=
|desc=Contains MCC and MNC. For example: current-operator: 24701 breaks to: MCC=247 MNC=01
}}

{{Mr-arg-table
|arg=lac
|type=integer
|default=
|desc=location area code (LAC)
}}

{{Mr-arg-table-end
|arg=current-cellid
|type=integer
|default=
|desc=Station identification number
}}

Values can be used to find location in databases: [http://cellidfinder.com/cells/findcell Cell Id Finder]

===Using Cell lock===

It is possible to lock 11e-LTE modem equipped device to exact LTE tower. LTE info command provides (from 6.41rc61):
<pre>
phy-cellid: 384
earfcn: 1300 (band 3, bandwidth 20Mhz, cqi 0)
</pre>

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-table
|arg=phy-cellid
|type=integer
|default=
|desc=Physical Cell Identification (PCI) of currently used cell tower.
}}

{{Mr-arg-table-end
|arg=earfcn
|type=integer
|default=
|desc=Absolute Radio Frequency Channel Number
}}

By using those acquired variables it's possible to send AT command to modem for locking to tower in current format:

<pre>
AT*Cell=<mode>,<NetworkMode>,<band>,<EARFCN>,<PCI>

where

<mode> :
0 – Cell/Frequency disabled
1 – Frequency lock enabled
2 – Cell lock enabled

<NetworkMode>
0 – GSM
1 – UMTS_TD
2 – UMTS_WB
3 – LTE

<band>
add if band lock is also required (usually can be left blank)

<EARFCN>
earfcn from lte info

<PCI>
phy-cellid from lte info
</pre>

To lock modem at previously used tower at-chat can be used:
<pre>
/interface lte at-chat lte1 input="AT*Cell=2,3,,1300,384"
</pre>

After reboot or modem reset, all set on locks are lost.

==Troubleshooting==

Enable LTE logging:

<pre>
[admin@CableFree] > /system logging add topics=lte
</pre>
Check for errors in log:
<pre>
[admin@CableFree] > /log print

11:08:59 lte,async lte1: sent AT+CPIN?
11:08:59 lte,async lte1: rcvd +CME ERROR: 10
</pre>
search for CME error description online,

in this case:
CME error 10 - SIM not inserted

<h3>Locking band on Huawei and other modems</h3>
To lock band for Huawei modems <code>/interface lte set lte1 band=""</code> option can't be used.

It is possible to use AT commands to lock to desired band manually.

To check all supported bands run at-chat command:
<pre>
[admin@CableFree] /interface lte at-chat lte1 input="AT^SYSCFGEX=\?"

output: ^SYSCFGEX: ("00","03","02","01","99"),((2000004e80380,"GSM850/GSM900/GSM1800/GSM1900/WCDMA BCI/WCDMA BCII/WCDMA BCV/WCDMA BCVIII"),
(3fffffff,"All Bands")),(0-2),(0-4),((800d7,"LTE BC1/LTE BC2/LTE
BC3/LTE BC5/LTE BC7/LTE BC8/LTE BC20"),(7fffffffffffffff,"All Bands"))
OK
</pre>
Example to lock to LTE band 7,
<pre>[admin@CableFree] /interface lte set lte1 modem-init="AT^SYSCFGEX=\"03\",3FFFFFFF,2,4,40,,
</pre>

Change last part <b>40</b> to desired band specified hexadecimal value where:
<pre>
4 LTE BC3
40 LTE BC7
80000 LTE BC20
7FFFFFFFFFFFFFFF All bands
etc
</pre>
All band HEX values and AT commands can be found in [http://download-c.huawei.com/download/downloadCenter?downloadId=29741&version=72288&siteCode= Huawei AT Command Interface Specification guide]

Check if band is locked:

<pre>
[admin@CableFree] /interface lte at-chat lte1 input="AT^SYSCFGEX\?"

output: ^SYSCFGEX: "03",3FFFFFFF,0,2,40
OK
</pre>
For more information check modem manufacturers AT command reference manuals.

<h3>mPCIe modems with 9xx series devices</h3>
For mPCIe modems to work in 9xx series devices it is required to set the USB type to mPCIe, this can be done using the following command:
<pre>
/system CableFree device usb set type=mini-PCIe
</pre>

In case your modem is not being recognized after a soft reboot, then you might need to add a delay before the USB port is being initialized. This can be done using the following command:
<pre>
/system CableFree device settings set init-delay=5s
</pre>

{{Cont}}

[[Category:Manual|P]]
[[Category:VPN|P]]
[[Category:Interface|P]]

Manual:Interface/LTE - Revision history

Administrator: /* Troubleshooting */

Administrator: Created page with "{{Versions|v6+,v5.12+}} __TOC__ ==Summary== Package: system Support for Direct-IP mode type cards only. (QMI..."

Administrator: Created page with "{{Versions|v6+,v5.12+}} TOC
==Summary==
Package: `system`

Support for Direct-IP mode type cards only. (QMI..."