Differences

This shows you the differences between two versions of the page.

--- wiki:network_mana:backhaul [2023/01/26 12:01]
cro [Cellular configuration]
+++ wiki:network_mana:backhaul [2024/03/07 13:49] (current)
ehe
@@ Line 122: / Line 122: @@
 </note>
+=== Fallback DNS servers ===
+Fallback DNS server are used if no DNS server is given by DHCP server of a particular service. They can be configure using following parameter:
+<code bash>
+FallbackNameservers = 9.9.9.9,8.8.8.8,1.1.1.1
+</code>
 ==== Ethernet configuration ====
@@ Line 191: / Line 198: @@
 ==== Cellular configuration ====
-<note warning>
-  * If a Roaming SIM card is inserted in the gateway, the **MCC/MNC** codes to configure should be those ones of the SIM and not those of the local operator.
-  * Please see **SubscriberIdentity** line in gsmdiag.py result to know the **MCC/MNC** of the SIM card (5 first digits).
-  * The **APN** to configure is the one of the SIM provider also, not the one of the local operator.
-</note>
@@ Line 217: / Line 217: @@
 It is used to define APN, PIN code and cellular context:
-  * Multiple PIN code for multiple SIM card can be stored in this file (using SIM card ICCID).
+  * A default APN for all SIM cards can be stored in this file. In this case, the MCC/MNC are not needed.
+  * Multiple APN for multiple SIM card can be stored (using MCC/MNC of the SIM).
   * A default PIN code for all SIM cards can be stored.
+  * Multiple PIN code for multiple SIM card can be stored (using SIM card ICCID).
   * Usually SIM cards only need ''SIM PIN'' code to be unlocked but sometimes other types of PIN code can be used, as described in the example below.
+A file named ''/etc/network/ofono/default_provisioning'' contains several operators configuration (MCC, MNC, APN) for several countries. \\
+If the SIM used is already configured in this file, there is no need of configuring the APN the ''/etc/network/ofono/provisioning''.
+<note important>The PIN code, if set, still needs to be configured in ''/etc/network/ofono/provisioning''.</note>
+<note warning> On Wirnet iZeptoCell-Cellular, the APN that must be used is ''bicsapn''. It is pre-configured on this gateway and this configuration should not be changed
+</note>
 <file ini provisioning>
 # Syntax:
-#[operator:MCC,MNC]
-#internet.AccessPointName=APN => only mandatory field
-#internet.Username=myUsername
-#internet.Password=myPassword
-#internet.AuthenticationMethod=[chap, pap] => default is chap
-#internet.Protocol=[ip, ipv6, dual] => default is ip
 #
-#[sim:ICCID]
+## Default "operator" configuration:
-#pin=XXXX => SIM PIN of SIM identified by ICCID
+#[operator]
-#phone=XXXX => PH-SIM PIN of SIM identified by ICCID
+#internet.AccessPointName=<APN>              # Mandatory
-#firstphone=XXXX => PH-FSIM PIN of SIM identified by ICCID
+#internet.Username=<username>
-#network=XXXX => PH-NET PIN of SIM identified by ICCID
+#internet.Password=<password>
-#netsub=XXXX => PH-NETSUB PIN of SIM identified by ICCID
+#internet.AuthenticationMethod=<method>      # chap (default), pap, none
-#service=XXX => PH-SP PIN of SIM identified by ICCID
+#internet.Protocol=<protocol>                # ip (default), ipv6, dual
-#corp=XXXX => PH-CORP PIN of SIM identified by ICCID
 #
+## Specific "operator" configuration:
+#[operator:<MCC>,<MNC>]
+#internet.AccessPointName=<APN>              # Mandatory
+#internet.Username=<username>
+#internet.Password=<password>
+#internet.AuthenticationMethod=<method>      # chap (default), pap, none
+#internet.Protocol=<protocol>                # ip (default), ipv6, dual
+#
+## Default "sim" configuration:
 #[sim]
-#pin=XXXX => default SIM PIN
+#pin=<pin>                                   # SIM pin
-#phone=XXXX => default PH-SIM PIN
+#phone=<pin>                                 # PH-SIM pin
-#firstphone=XXXX => default PH-FSIM PIN
+#firstphone=<pin>                            # PH-FSIM pin
-#network=XXXX => default PH-NET PIN
+#network=<pin>                               # PH-NET pin
-#netsub=XXXX => default PH-NETSUB PIN
+#netsub=<pin>                                # PH-NETSUB pin
-#service=XXX => default PH-SP PIN
+#service=<pin>                               # PH-SP pin
-#corp=XXXX => default PH-CORP PIN
+#corp=<pin>                                  # PH-CORP pin
+#
-# Orange
+## Specific "sim" configuration:
-[operator:208,01]
+#[sim:<ICCID>]
-internet.AccessPointName=orange.m2m.spec
+#pin=<pin>                                   # SIM pin
+#phone=<pin>                                 # PH-SIM pin
-# SFR
+#firstphone=<pin>                            # PH-FSIM pin
-[operator:208,10]
+#network=<pin>                               # PH-NET pin
-internet.AccessPointName=websfr
+#netsub=<pin>                                # PH-NETSUB pin
+#service=<pin>                               # PH-SP pin
+#corp=<pin>                                  # PH-CORP pin
 </file>
@@ Line 260: / Line 276: @@
 <note important>
-  * If a Roaming SIM card is inserted in the gateway, the **MCC/MNC** codes to configure should be those ones of the SIM and not those of the local operator.
+  * If a Roaming SIM card is inserted in the gateway, the **APN** codes to configure should be those ones of the SIM and not those of the local operator.
-  * Please see **SubscriberIdentity** line in gsmdiag.py result to know the **MCC/MNC** of the SIM card (5 first digits).
+  * If needed, please see **SubscriberIdentity** line in gsmdiag.py result to know the **MCC/MNC** of the SIM card (5 first digits).
-  * The **APN** to configure is the one of the SIM provider also, not the one of the local operator.
+  * The **MCC/MNC** to configure is the one of the SIM provider also, not the one of the local operator.
 </note>
@@ Line 268: / Line 284: @@
-To update oFono with the last configuration, each time the provisioning file is changed, a service ''reset'' has to be performed.
+To update oFono with the last configuration, each time the file is changed, a service ''reset'' has to be performed.
 <code bash>
@@ Line 282: / Line 298: @@
 == GSM diagnosis tool ==
-<note important>
-The //GSM diagnosis// tool is delivered //as-is// (not fully validated).
-</note>
 GSM diagnosis tool is a script using oFono interfaces to detect most common problems on cellular modems. It can also be used to have a quick view of cellular modems status on board.
-It produces a text file ''/tmp/gsmdiag.txt''  with information on modem status inside.
+It produces information on modem status directly on the console and also a text file ''/tmp/gsmdiag.txt''.
-Call of script:
+Call of script: ''# gsmdiag.py''
+Diagnosis output examples:
+++++ Modem ready to connect|
 <code bash>
 # gsmdiag.py
-Diagnostic written in /tmp/gsmdiag.txt
-</code>
-Diagnosis file (wrong pin code case):
-<file>
-Number of modems: 1
-[Modem:/sierra_1]
-  Powered:1
-  Online:0
-  Manufacturer:Sierra Wireless, Incorporated
-  Model:MC7304
-  Revision:SWI9X15C_05.05.39.02 r22713 carmd-fwbuild1 2014/06/19 16:48:58
-  [SimProps]
-    Present:1
-    CardIdentifier:89330120403002181830
-    SubscriberIdentity: property does not exist
-    LockedPins:dbus.Array([dbus.String(u'pin')], signature=dbus.Signature('s'), variant_level=1)
-    PinRequired:pin
-  Error: SIM code required (PIN, PUK, ...)
-</file>
-Diagnosis file (modem ready to connect):
-<file>
 Number of modems: 1
 [Modem:/sierra_0]
@@ Line 348: / Line 338: @@
       Password:
       AuthenticationMethod:chap
-</file>
+Diagnostic written in /tmp/gsmdiag.txt
+</code>
+++++
+++++ SIM not detected|
+<code bash>
+# gsmdiag.py
+Number of modems: 1
+[Modem:/quectelqmi_2]
+  Syspath:/sys/devices/soc0/soc/2100000.aips-bus/2184200.usb/ci_hdrc.1/usb2/2-1/2-1.1
+  HardwarePosition:internal
+  Powered:1
+  Online:1
+  Manufacturer:QUALCOMM INCORPORATED
+  Model:QUECTEL Mobile Broadband Module
+  Revision:EG25GGBR07A08M2G
+  [SimProps]
+    Present:0
+  Error: no SIM in modem (double checked with AT commands)
+Diagnostic written in /tmp/gsmdiag.txt
+</code>
+++++
+++++ SIM detected but not operational|
+<code bash>
+# gsmdiag.py
+Number of modems: 1
+[Modem:/quectelqmi_1]
+  Syspath:/sys/devices/soc0/soc/2100000.aips-bus/2184200.usb/ci_hdrc.1/usb1/1-1/1-1.1
+  HardwarePosition:internal
+  Powered:1
+  Online:1
+  Manufacturer:QUALCOMM INCORPORATED
+  Model:QUECTEL Mobile Broadband Module
+  Revision:EG25GGBR07A07M2G
+  [SimProps]
+    Present:0
+  Error: SIM detected (ICCID: 8959102062181454741F) but not usable by Ofono
+Diagnostic written in /tmp/gsmdiag.txt
+</code>
+++++
+++++ Wrong pin code case|
+<code bash>
+# gsmdiag.py
+Number of modems: 1
+[Modem:/sierra_1]
+  Powered:1
+  Online:0
+  Manufacturer:Sierra Wireless, Incorporated
+  Model:MC7304
+  Revision:SWI9X15C_05.05.39.02 r22713 carmd-fwbuild1 2014/06/19 16:48:58
+  [SimProps]
+    Present:1
+    CardIdentifier:89330120403002181830
+    SubscriberIdentity: property does not exist
+    LockedPins:dbus.Array([dbus.String(u'pin')], signature=dbus.Signature('s'), variant_level=1)
+    PinRequired:pin
+  Error: SIM code required (PIN, PUK, ...)
+Diagnostic written in /tmp/gsmdiag.txt
+</code>
+++++
 == getmodeminfo.py tool ==
@@ Line 398: / Line 452: @@
 </note>
-On Wirnet iZeptoCell Cellular, serial port to access cellular module //AT// command interface is ''/dev/ttymxc2'' (speed: 115200).
+On other gateways with an internal modem, serial port to access cellular module //AT// command interface is ''/dev/ttyAT'' (speed: 115200).
-On other gateways with an internal modem, serial port to access cellular module //AT// command interface is ''/dev/ttyAT'' (speed does not matter).
 It is not possible to send AT commands to external USB dongles used on Wirnet iFemtoCell.
   * Get IMEI (iStation and iFemtoCell Evolution):<code bash>echo $'AT+CGSN\r' | microcom /dev/ttyAT
-# result:
-root@klk-wiis-xxxxxx:~ # echo $'AT+CGSN\r' | microcom /dev/ttyAT
-AT+CGSN
-xxxxxxxxx8
-OK</code>
-  * Get IMSI (iZeptoCell Cellular):<code bash>echo $'AT+CIMI\r' | microcom -s 115200 /dev/ttymxc2
 # result:
 root@klk-wiis-xxxxxx:~ # echo $'AT+CGSN\r' | microcom /dev/ttyAT
@@ Line 532: / Line 578: @@
 ifup eth0
 </code>
+===== Router Mode =====
+==== Purpose ====
+The aim of the router mode is to bring data connection to a sub-network thanks to a connection from a single gateway.
+Here is an example of how it could be used :\\
+{{:images:router_mode.jpg?850|}}
+==== Router configuring ====
+To activate the router mode on a gateway, some commands need to be made in the gateway console.
+Here are the commands :
+<code bash>
+# Activate router mode
+echo "ROUTER=yes" > /etc/default/localnet.conf
+# Edition of /etc/network/connman/main.conf to disable handling of eth0:
+NetworkInterfaceBlacklist = vmnet,vboxnet,virbr,ifb,eth1,wlan-adm,usb,eth0
+# Add eth0 to localnet handling by adding this line in /etc/udev/rules.d/localnet.rules
+SUBSYSTEM=="net", KERNEL=="eth0", RUN+="/etc/udev/scripts/localnet.sh"
+# Make sure this config is saved in case of firmware upgrade
+echo "/etc/udev/rules.d/localnet.rules" > /etc/sysupgrade.d/localnet.conf
+</code>
+These commands need to be made on the gateway which will host the connection only. Nothing has to be done on other gateway(s).\\
+A reboot of the gateway is needed to apply this configuration. You can do so with the command ''reboot''
+The host gateway can now provide data connection locally to another gateway or to multiple gateways thanks to an ethernet switch. \\
+Local connections to the switch can be:
+  * Ethernet and/or
+  * WLAN

Wirnet™ i-series

User Tools

Site Tools

Differences

Page Tools