User Tools

Site Tools


venus-os:gx-gsm

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
venus-os:gx-gsm [2019-10-03 16:30]
mvader [5. Trouble shooting]
venus-os:gx-gsm [2019-10-03 22:57]
mvader [6. Trouble shooting]
Line 25: Line 25:
   * GSM900200100 - Active GPS Antenna for GX GSM   * GSM900200100 - Active GPS Antenna for GX GSM
  
-See bottom of this manual for photos and specs of both optional antennas.+[[venus-os:gx-gsm#accessory_antennas|See bottom of this manual for photos and specs of both optional antennas.]]
  
 ==== Compatibility ==== ==== Compatibility ====
Line 68: Line 68:
 {{:venus-os:gsm-apn-config.png?direct&480|}} {{:venus-os:gsm-apn-config.png?direct&480|}}
  
-===== 4. Status ===== 
-GSM modem status can be checked at a glance by looking at the status bar. 
  
-^ Icon ^ Details ^ +===== 4. GPS =====
-| {{:venus-os:gsm-status-signalstrength.png?nolink&27}}     | GSM modem is connected to network, but not to the internet (no data connection). Either on purpose, because an ethernet or WiFi connection is available. +
-| {{:venus-os:gsm-status-gsm-internet.png?nolink&48|}}      | GSM modem is properly configured, the 3G/E/etc icon reflects that the GSM modem internet connection is in use.  | +
-| {{:venus-os:gsm-status-gsm-plus-wifi.png?nolinkx&54|}}    | WiFi is available and its internet connection is in use. WiFi has priority over GSM.  | +
-| {{:venus-os:gsm-status-pin-required.png?nolink&27|}}      | SIM PIN code is required. +
-| {{:venus-os:gsm-status-roaming.png?nolink&27|}}           | Roaming, only informative. To use internet connection while roaming it needs to be enabled in \\ Settings -> GSM modem -> Allow roaming. | +
- +
-===== 6. GPS =====+
  
 When the optional antenna is added; the position will be visible like this: When the optional antenna is added; the position will be visible like this:
Line 87: Line 78:
  
  
-===== 5. Trouble shooting =====+===== 5. Status ===== 
 + 
 +==== Status Bar ==== 
 +GSM modem status can be checked at a glance by looking at the status bar. 
 + 
 +^ Icon ^ Details ^ 
 +| {{:venus-os:gsm-status-signalstrength.png?nolink&27}}     | GSM modem is connected to network, but not to the internet (no data connection).\\ Either on purpose, because an ethernet or WiFi connection is available. 
 +| {{:venus-os:gsm-status-gsm-internet.png?nolink&48|}}      | GSM modem is properly configured, the 3G/E/etc icon reflects that the GSM modem internet connection is in use.  | 
 +| {{:venus-os:gsm-status-gsm-plus-wifi.png?nolinkx&54|}}    | WiFi is available and its internet connection is in use. WiFi has priority over GSM.  | 
 +| {{:venus-os:gsm-status-pin-required.png?nolink&27|}}      | SIM PIN code is required. 
 +| {{:venus-os:gsm-status-roaming.png?nolink&27|}}           | Roaming, only informative. To use internet connection while roaming it needs to be enabled in \\ Settings -> GSM modem -> Allow roaming. | 
 + 
 +==== SIM Status ==== 
 +^ Status ^ Description ^ 
 +| Ready | SIM card is installed properly and registered to the network | 
 +| SIM not inserted | SIM card is missing or not inserted properly. SIM tray might hang out a little. | 
 +| PIN required | SIM card requires 4 digit PIN for unlock. | 
 +| PUK required | SIM is locked due to wrong PIN inputs. 8 digit PUK is required to release the lock state. | 
 +| SIM failure | SIM does not respond - might be broken | 
 +| SIM busy | SIM is in busy state | 
 +| SIM wrong | Type of SIM is not supported |  
 + 
 +[[http://example.com|External Link]]===== 6. Trouble shooting =====
  
-Whilst usually working well, in case the modem does not connect to the internet it can one of many reasons. Carefully go through each step of this trouble shooting guide, starting at the first.+There are many reasons for modem internet connection to not work. Carefully go through each step of this trouble shooting guide. Make sure to start at the first step. When asking for help, make sure to mention each step taken and the result.
  
 ^ Step   ^^ Details                                   ^ ^ Step   ^^ Details                                   ^
-| 1 | Check power  | Check that the blue LED is either lit continuous or blinking +| 1 | Power  | Check that the blue LED is either lit continuous or blinking 
-| 2 | Check USB connection   | The modem must be connected to USB, and visible in the Settings -> GSM modem menu | +| 2 | USB connection   | The modem must be connected to USB, and visible in the Settings -> GSM modem menu | 
-| 3 | Simcard status | Check the SIM Status in the menu, it must show "Ready". It will show "SIM not inserted", or "PIN required", or "PUK required" and more related errors when there is a problem. |+| 3 | Simcard status | Check the SIM Status in the menu, it must show "Ready". It will show "SIM not inserted", or "PIN required", or "PUK required" and more related errors when there is a problem. Please refer to the [[venus-os:gx-gsm#sim_status|SIM Status list]] for details. |
 | 4 | Signal strength | 1 bar minimum for VRM logging, 2 or 3 bars are necessary for a working remote console | | 4 | Signal strength | 1 bar minimum for VRM logging, 2 or 3 bars are necessary for a working remote console |
 | 5 | Carrier registration | Check that a name of a Cellular provider is visible in the "Carrier" field. If it is not, check signal strength and otherwise contact your simcard provider and/or insert the simcard in a phone to double check its operation and subscription status. | | 5 | Carrier registration | Check that a name of a Cellular provider is visible in the "Carrier" field. If it is not, check signal strength and otherwise contact your simcard provider and/or insert the simcard in a phone to double check its operation and subscription status. |
-| 6 | Internet connection | Verify that the Internet shows "Online". Reasons for the system to not go "Online" whilst properly registered on the Network are: 1) APN not configured, contact the network operator for details. 2) The network is a different one than the home network (ie. roaming), and the setting to permit Roaming is disabled. 3)  Signal strength is strong enough to register on the network, but not to open the data connection to the internet. |+| 6 | Internet connection | Verify that the Internet shows "Online". Reasons for the system to not go "Online" whilst properly registered on the Network are:\\ 1) APN not configured, contact the network operator for details.\\ 2) The network is a different one than the home network (ie. roaming), and the setting to permit Roaming is disabled.\\ 3) Signal strength is strong enough to register on the network, but not to open the data connection to the internet. |
 | 7 | Connection to VRM Portal | Verify that the VRM Portal menu shows a recent last connection time. See Settings -> VRM Portal. For more details, see [[https://www.victronenergy.com/live/ccgx:start#trouble_shooting_data_logging|the VRM Connection troubleshooting chapter of the GX Manual]]. |  | 7 | Connection to VRM Portal | Verify that the VRM Portal menu shows a recent last connection time. See Settings -> VRM Portal. For more details, see [[https://www.victronenergy.com/live/ccgx:start#trouble_shooting_data_logging|the VRM Connection troubleshooting chapter of the GX Manual]]. | 
  
-An outdoor antenna typically increases received signal by 15 dB to 25 dB.+An [[venus-os:gx-gsm#accessory_antennas|outdoor antenna]] typically increases received signal by 15 dB to 25 dB.
  
-Note that when the GX Device is already connected to Ethernet or WiFi, these have priority over the cellular connection. Even when the available Ethernet  or WiFi connection does **not** have a good connection to the internet. There is **no** automatic detection in place which in such case switches over to the GX GSM. In more technical language: when the cellular data connection is active, it is configured with a high routing metric. This way, the Linux kernel prioritises Ethernet or Wifi when these are available.+Note that Ethernet and WiFi connections have priority over the cellular connection. Even when the available Ethernet  or WiFi connection does **not** have a good connection to the internet. There is **no** automatic detection in place which in such case switches over to the GX GSM. In more technical language: when the cellular data connection is active, it is configured with a high routing metric. This way, the Linux kernel prioritises Ethernet or Wifi when these are available.
  
 This screenshot shows how all details look when everything is OK: This screenshot shows how all details look when everything is OK:
  
 {{:venus-os:gsm-settings-full.png?direct&480|}} {{:venus-os:gsm-settings-full.png?direct&480|}}
-===== 6. Supported Frequencies (2G/3G) =====+===== 7. Supported Frequencies (2G/3G) =====
  
   * 2G (GSM/GPRS/EDGE): 850/900/1800/1900 MHz (Quad-Band)   * 2G (GSM/GPRS/EDGE): 850/900/1800/1900 MHz (Quad-Band)
Line 119: Line 132:
  
 In case of uncertainty please double-check: [[https://www.worldtimezone.com/gsm.html|GSM World Coverage Map]] In case of uncertainty please double-check: [[https://www.worldtimezone.com/gsm.html|GSM World Coverage Map]]
-===== 7. Technical Data =====+===== 8. Technical Data =====
  
 ^ Outer dimensions (LxWxH) | 106x42.5x22 mm ([[https://www.victronenergy.de/upload/documents/GX-GSM-Dimensions.pdf|Drawing]]) | ^ Outer dimensions (LxWxH) | 106x42.5x22 mm ([[https://www.victronenergy.de/upload/documents/GX-GSM-Dimensions.pdf|Drawing]]) |
Line 129: Line 142:
 ^ SIM card | Regular Mini SIM | ^ SIM card | Regular Mini SIM |
  
-===== 8. Accessory / Antennas =====+===== 9. Accessory / Antennas =====
 ==== Outdoor 2G and 3G GSM Antenna ==== ==== Outdoor 2G and 3G GSM Antenna ====
 {{:venus-os:gsm900100100.png?nolink&250 |}} {{:venus-os:gsm900100100.png?nolink&250 |}}
venus-os/gx-gsm.txt · Last modified: 2020-06-24 13:53 by mvader