Contact Us    

Linux - KPPP Dialer on Ubuntu - UMTS/HSPA

Note: This document is provided for information purpose only. Novatel Wireless cannot accept any responsibility for the use of information provided in this document.

The information contained in this document is subject to change without notice and should not be construed as a commitment by Novatel Wireless Inc. unless such commitment is expressly given in a covering document.

Detailed example: KPPP Dialer on Ubuntu.

1. Make sure you have a working connection to the internet. It is recommended that you have an Ethernet connection in order to download the necessary packages for this setup.

You can verify your computer’s connection to the internet using one or both of the following commands, separately:
  • "ifconfig": You should see eth0 interface for a wired Ethernet interface connection with an acquired IP address,
or use the command:
  • "ping" the name of your favorite web site without quote - to verify a connection.

2. Download packages: Please note that the instructions in this section describe the procedure for installing the necessary software packages on Ubuntu Linux 8.04. The procedure is very similar on other Linux distributions which support KPPP and KPPPLogview

  1. From the Ubuntu Applications menu, click on Add/Remove, and Add/Remove Applications utility should start.
  2. Select "All" from the software application category on the left.
  3. In the Search field type "ppp"
  4. Select KPPP and KPPPLogview.
  5. Click on Apply button located at the bottom of the Add/Remove Applications Window.
  6. The downloading of these software packages will start and automatic installation will follow automatically. You should see something similar to the windows shown in Figure 1 below.


Figure 1. Add/Remove Applications utility downloading the selected packages. Installation should follow downloading automatically.

3. When the software installation procedure, you should see something similar to Figure 2 below:


Figure 2. Add/Remove Applications utility finished installing the select software packages and successfully applied changes to the system.

4. Start the KPPP software application by clicking the KPPP item from the Applications/Internet Menu. When the KPPP windows opens, click on Configure... button to launch KPPP Configuration windows. You should see the KPPP Configuration window similar to the one shown at the bottom in Figure 3 below.


Figure 3. KPPP application window and KPPP Configuration window.

5. On the KPPP Configuration window's Accounts tab, click on New... button to start a "Create New Account - KPPP" dialog window. Figure 4 below shows this dialog window. Click Manual Setup button in the latter window. The New Account Manual Setup dialog window will open as shown in Figure 5


Figure 4. Create New Account - KPPP dialog window is open as a child window of the KPPP Configuration dialog window.

Figure 5. New Account - KPPP dialog window is open as a child window of the Create New Account dialog window.

6. On the Dial tab, type "HSPA" in the Connection name field as shown above in Figure 5.

7. Click Add... button to open the Add Phone Number dialog window.

In the Add Phone Number dialog enter *99# and click OK.
Click OK button on the New Account dialog window without any further changes.
Some networks may need a different Number such as "*99***1#".
Check with your service provider if *99# does not work for you.

8. Once you are back to the KPPP Configuration dialog window, click on Modems tab at the top and then click New... button as shown in Figure 6 below.


Figure 6. Modem tab of the KPPP Configuration Window.

9. In the New Modem Window, click on the Device tab and enter the data as shown in Figure 7 below. After entering/selecting the parameters in the New Modem dialog window, click OK and return back to the KPPP Configuration dialog window.

Figure 7. Device tab of the New Modem dialog window showing the parameters needed for Modem Name, Modem device, Flow control, Line termination, and Connection Speed fields.

10. To verify that KPPP is able to communicate with the modem card, select the Novatel Wireless Modem (or whatever you entered in the Modem name field of the New Modem dialog window) and click on Edit... button in the KPPP Configuration dialog window.

11. When the Edit Modem window for Novatel Wireless Modem is open as shown in Figure 8 below, click on the Modem tab and then click on Query Modem... button.

Figure 8. Modem tab in the New Modem window.


12. If the modem driver is properly setup and the connection is properly configured then you should see a multi-line response similar to the window shown in Figure 9. If you do not see this response, please try the setup procedure again. Click OK to dismiss the Modem Query Results window.

Figure 9. Successful Modem Query Results window showing the response sent by the card to ATI command sent when the Query Modem button is clicked.

13. Under "Modem Commands" in 'Initialization String 2', enter

NOTEAPNstring is the APN required by your service provider. For example: "isp.cingular", "". IF your do not know your APN, please check with your service provider.
Then select "OK

14. On the KPPP Configuration window, select Misc tab. Check Dock into panel on connection as shown in the bottom window in Figure 10 below then click OK to save KPPP configuration.


Figure 10. KPPP Configuration Misc tab settings.


15. At this point you are done with setting up your software to connect to the network using your Novatel Wireless 3G broadband modem card.

Connecting to the wireless network over ppp

In this section, you will start a ppp connection to the network.

1. If KPPP is not launched, start KPPP from the Application/Internet menu.

2. In the KPPP window, select the connection you have set up according to the instructions above. We suggested naming the connection as "HSPA" for simplicity. This connection name should be shown in the "Connect to" drop down list of KPPP


Figure 11. KPPP's main window showing the HSPA Connection selected.

3. Click on Connect button to start a PPP connection to your service provider's wireless network. If the connection is established successfully you should see a Globe icon close to the Network Connection icon on the system panel as shown in Figure 12 below.


Figure 12. Connection established and a Globe icon is shown at the top right side of the window.

4. If you Network Connection icon still shows eth0 as in Figure 13, click on the Network Connection icon and select ppp0 in the Connection Name drop down list as shown Figure 14.

Figure 13. Connection Properties dialog launched by double-clicking on the Network Connection icon at the top right side in the system panel next to the speaker (sound volume) icon.
Figure 14. Connection Properties dialog showing General tab's Connection Name drop down menu selection switched to ppp0.

5. Once connected, you can click on the Globe icon to show your KPPP connection window as shown in Figure 15. You can also click on the Details button on the KPPP connection window to show the connection statistics.

Figure 15. KPPP Connection window showing successfully established HSPA Connection including time connected and connection statistics in the KPPP statistics window.

6. Launch your favorite internet browser to request your favorite website. Since we are using Ubuntu Linux, we chose to view Ubuntu's website. Figure 16 below shows successful loading of the main page over ppp0 connection.


Figure 16. Ubuntu web-site

Disconnecting from the WIRELESS Network

To disconnect your connection session, click on Disconnect button on KPPP's main HSPA Connection window as shown in Figure 16.



Dropped connection:

In the event that the connection is lost due to any reason, a manual reconnect is required. You can configure your Connection to automatically redial on disconnect.DNS issues

For DNS-related issues, please verify entries in /etc/resolv.conf file. Please refer to your Linux distribution's user manual for more information about fixing this problem.