====== Troubleshooting GSM interface issues ======

This section explains how to issue the ppp interface on kerOS products.
 
If you see that kind of error in loop in ///var/log/messages//:
<code>
Oct 19 16:27:16 klk-wifc-01008B daemon.warn ofonod[893]: Modem channel disconnected
Oct 19 16:27:17 klk-wifc-01008B daemon.err connmand[860]: Failed to change property: /huawei_0/context1 org.ofono.ConnectionContext.Active: org.ofono.Error.Failed Operation failed
Oct 19 16:27:17 klk-wifc-01008B daemon.warn connmand[860]: Skipping disconnect of /huawei_0/context1, network is connecting.
Oct 19 16:27:17 klk-wifc-01008B daemon.warn ofonod[893]: Modem channel disconnected
</code>

  - Use the gsmdiag.py tool to check first if your SIM card or HUAWEI USB key is correctly inserted into your system
  - Check your provisioning file in /etc/network/ofono: check your APN, pin code, MNC and MCC.
  - Reset the ofono component by typing the following command: ''/etc/init.d/ofono reset'' and watch for errors in /var/log/messages file.
  - If the issue remains, reboot the gateway


**Example of a good insertion of SIM card and HUAWEI key in the system:**

<code>
root@klk-wifc-01008B:~ # [ 1782.038313] usb 1-1: new high-speed USB device number 4 using ci_hdrc
[ 1782.190019] usb 1-1: New USB device found, idVendor=12d1, idProduct=1f01
[ 1782.196755] usb 1-1: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[ 1782.203951] usb 1-1: Product: HUAWEI_MOBILE
[ 1782.208143] usb 1-1: Manufacturer: HUAWEI_MOBILE
[ 1782.212790] usb 1-1: SerialNumber: 0123456789ABCDEF
[ 1782.254198] usb-storage 1-1:1.0: USB Mass Storage device detected
[ 1782.261311] scsi host1: usb-storage 1-1:1.0
[ 1783.050857] usb 1-1: USB disconnect, device number 4
[ 1783.708169] usb 1-1: new high-speed USB device number 5 using ci_hdrc
[ 1783.859890] usb 1-1: New USB device found, idVendor=12d1, idProduct=155e
[ 1783.866626] usb 1-1: New USB device strings: Mfr=1, Product=2, SerialNumber=0
[ 1783.873827] usb 1-1: Product: HUAWEI_MOBILE
[ 1783.878030] usb 1-1: Manufacturer: HUAWEI_MOBILE
[ 1783.926052] option 1-1:1.0: GSM modem (1-port) converter detected
[ 1783.944967] usb 1-1: GSM modem (1-port) converter now attached to ttyUSB0
[ 1783.961167] option 1-1:1.1: GSM modem (1-port) converter detected
[ 1783.991777] usb 1-1: GSM modem (1-port) converter now attached to ttyUSB1
[ 1784.014171] option 1-1:1.2: GSM modem (1-port) converter detected
[ 1784.054636] usb 1-1: GSM modem (1-port) converter now attached to ttyUSB2
[ 1784.140155] cdc_ncm 1-1:1.3: MAC-Address: 00:1e:10:1f:00:00
[ 1784.145749] cdc_ncm 1-1:1.3: setting rx_max = 16384
[ 1784.216120] cdc_ncm 1-1:1.3 wwan0: register 'cdc_ncm' at usb-ci_hdrc.0-1, Mobile Broadband Network Device, 00:1e:10:1f:00:00
</code>

**Example of a good result given by the gsmdiag.py tool:**

<code>
root@klk-wifc-01008B:~ # gsmdiag.py
Diagnostic written in /tmp/gsmdiag.txt
root@klk-wifc-01008B:~ # cat /tmp/gsmdiag.txt
Number of modems: 1
[Modem:/huawei_0]
  Powered:1
  Online:1
  Manufacturer:huawei
  Model:E3372
  Revision:22.200.03.00.1134
  [SimProps]
    Present:1
    CardIdentifier:89331042150325590509
    SubscriberIdentity:208104290505724
    LockedPins:dbus.Array([], signature=dbus.Signature('s'), variant_level=1)
    PinRequired:none
  [NetworkRegistrationProps]
    Status:registered
    MobileCountryCode:208
    MobileNetworkCode:10
    Name:F SFR
    Strength:0
  [ConnectionContexts]
    [/huawei_0/context1]
      Name:Internet
      Active:0
      Type:internet
      Protocol:ip
      AccessPointName:websfr
      Username:
      Password:
      AuthenticationMethod:chap
</code>


**Example of a bad result given by the gsmdiag.py tool:**
<code>
root@klk-wifc-01008B:~ # gsmdiag.py
Diagnostic written in /tmp/gsmdiag.txt
root@klk-wifc-01008B:~ # cat /tmp/gsmdiag.txt
Number of modems: 1
[Modem:/huawei_0]
  Powered:1
  Online:1
  Manufacturer:huawei
  Model:E3372
  Revision:22.200.03.00.1134
  [SimProps]
    Present:1
    CardIdentifier:89331042150325590509
    SubscriberIdentity:208104290505724
    LockedPins:dbus.Array([], signature=dbus.Signature('s'), variant_level=1)
    PinRequired:none
  [NetworkRegistrationProps]
    Status:searching
    MobileCountryCode: property does not exist
    MobileNetworkCode: property does not exist
    Name:
    Strength: property does not exist
  Error: Not attached to GSM network (antenna problem?)
</code>        
      
**Example of a correct provisioning file:**

<code>
root@klk-wifc-01008B:~ # cat /etc/network/ofono/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]
#pin=XXXX => SIM PIN of SIM identified by ICCID
#phone=XXXX => PH-SIM PIN of SIM identified by ICCID
#firstphone=XXXX => PH-FSIM PIN of SIM identified by ICCID
#network=XXXX => PH-NET PIN of SIM identified by ICCID
#netsub=XXXX => PH-NETSUB PIN of SIM identified by ICCID
#service=XXX => PH-SP PIN of SIM identified by ICCID
#corp=XXXX => PH-CORP PIN of SIM identified by ICCID
#
[sim]
pin=0000
#phone=XXXX => default PH-SIM PIN
#firstphone=XXXX => default PH-FSIM PIN
#network=XXXX => default PH-NET PIN
#netsub=XXXX => default PH-NETSUB PIN
#service=XXX => default PH-SP PIN
#corp=XXXX => default PH-CORP PIN

# Orange
[operator:208,01]
internet.AccessPointName=orange

# SFR
[operator:208,10]
internet.AccessPointName=m2minternet

</code>