Reliance Netconnect+ AC2737 Installation Guide for Linux

Wireless Data Terminal Installation Guide

ZTE Corporation http://www.zte.com.cn

Reliance Netconnect+ AC2737 Installation Guide for Linux

This Installation Guide is used for Reliance Netconnect+. V 1.0



Installation procedure and method for UI

software

1. Description of installation procedure

The UI software setup package under Linux (Ubuntu, openSUSE, Fedora,…) system contains the driver of USB data card and offers different driver source codes according to different Linux kernel versions. They are put under the setup path: /usr/local/bin/ztemtApp/zteusbserial, and saved in different sub-folders.

The setup package will automatically compile the corresponding driver version and load the driver (insmod ztemt.ko) during the installation. Therefore, you need to install gcc compiler and kernel development package (kernel-devel) in advance. Ubuntu9.04 system is an exception because the USB driver module already exists in the system kernel. The setup package will omit the step of compiling the driver after confirming that the system version is Ubuntu9.04; instead, it would modify the system pilot configuration (menu.lst) in order to support different ZTE USB data cards. Note: You need insert USB data card when installing UI software under Ubuntu9.04 system, otherwise you will be unable to install the drivers for the USB modem Prerequisite conditions for installing UI software Since the installation of Linux system package is rather complicated, you need to have certain experience of using Linux system to complete the installation. It’s recommended to select the corresponding package upon the system installation, which is the simplest method. (The installation methods may vary among different types of Linux system. Here we take openSUSE for example） gcc compiler and kernel-devel should be installed in the system because the driver needs to be compiled during the installation. If gcc compiler and kernel-devel are not yet installed, install them from their respective Linux system installation CD.

Install gcc Recommended method: when installing Linux system, select gcc relevant package at

“Development Tools”. Or install it again from CD after the system is installed. openSUSE: it’s recommened to install with yast setup package manager. Select software,



search the setup package from CD and then select Install.

Take gcc package installed under openSUSE11.1 system for example. The relevant packages installed are listed as below (for reference only): gcc-4.3-34.168 gcc-c++-4.3-34.168 gcc-info-4.3-34.168 gcc43-4.3.3_20081022-9.5 gcc43-info-4.3.3_20081022-9.5 gcc43-gij-4.3.3_20081022-9.2 gcc43-c++-4.3.3_20081022-9.5 libgcc43-4.3.3_20081022-9.5 gcc-gij-4.3-34.168 Ubuntu: Require PC to connect to the network, and then use apt-get install command to install. e.g.: sudo apt-get install gcc Feora: use yum command to install. e.g., yum install gcc.

Install kernel-devel Select the corresponding package when installing Linux system. The detailed name and version might vary according to different Linux system versions. Or add the corresponding setup package from CD after the system is installed. openSUSE: it’s recommended to install with yast setup package manager. Take openSUSE11.1 system for example. The kernel packages installed are listed as below (for reference only): kernel-source-2.6.27.7-9.1 linux-kernel-headers-2.6.27-2.28 kernel-pae-base-2.6.27.7-9.1 kernel-pae-2.6.27.7-9.1 kernel-syms-2.6.27.7-9.1 kernel-pae-extra-2.6.27.7-9.1



Fedora: it’s recommended to use yum manager to install. e.g., yum install kernel-devel (Require PC to connect the network） Ubuntu: Require PC to connect the network, and then use apt-get install to install. e.g.,: sudo apt-get install kernel-devel

2. Get started – Installation

After the installation of gcc compiler and kernel-devel, you could start installing cross-platform UI software. Supposed CDROM will automatically mount at the patch: /media/cdrom0 after USB modem is inserted. 1. Double-click the corresponding Linux version to install Open the directory of CDROM loading point/media/cdrom0, and double click the corresponding Linux version setup package. There are three Linux setup packages contained in CD:

CrossPlatformUI-V1.0.21-i386-ubuntu.deb This is DEB format setup package used for Ubuntu system

CrossPlatformUI-V1.0.16-i586.opensuse.rpm openSUSE system setup package

CrossPlatformUI-V1.0.16-i586.fedora.rpm Fedora system setup package

2. Installation using command line (Terminal) Open the terminal program and key in the command: sudo rpm –ivh /media/cdrom0/ CrossPlatformUI-V1.0.16-i586.opensuse.rpm #openSUSE sudo rpm –ivh /media/cdrom0/ CrossPlatformUI-V1.0.16-i586.fedora.rpm #Fedora

sudo dpkg –i /media/cdrom0/ CrossPlatformUI-V1.0.21-i386.ubuntu.deb #Ubuntu Because it requires super user authority during the installation, it might ask you to input super

user password. 3. Uninstallation using command line (Terminal)

Open the terminal program and key in the command: sudo rpm –e CrossPlatformUI ( #Fedora/openSUSE case sensitive) sudo dpkg –r CrossPlatformUI ( #Ubuntu ) sudo dpkg –P CrossPlatformUI （ #Ubuntu ）

4. Common problems during the installation

Authority/Right problem This problem occurs as other users(non-admin users) are installing. The installation can’t be completed because there are no enough rights. Please use “sudo” command to install (as shown above)

Old version not removed The old version must be removed before installation, otherwise the installation will fail.



Uninstall method: sudo rpm –e CrossPlatformUI ( #Fedora/openSUSE case sensitive) or: sudo dpkg –r CrossPlatformUI ( #Ubuntu ) or: sudo dpkg –P CrossPlatformUI （ #Ubuntu ）

Conflict among setup packages If there is any conflict between the setup package and other software (generally, this won’t happen), you could perform compulsory installation (not recommended). Method:

sudo dpkg –i --force-all CrossPlatformUI-V1.0.21-i386.ubuntu.deb This method is currently applicable for the problem occurred under Ubuntu9.04 system.

Required shared library to run UI software After installing Linux version UI software, you need to install the required shared library to run UI software.

ALSA library. Generally, ALSA audio shared library has been installed into your new Linux version by default. If your system can play sound, it means ALSA library has been successfully installed; If not, your system version might be too old to support ALSA library or you need to use the corresponding setup package manager to reinstall. For detailed steps, refer to the installation method of kernel-devel above. Take openSUSE11.1 system for example. The relevant ALSA library installed are listed as below: (for reference only)

alsa-oss-1.0.17-1.37 alsa-utils-1.0.18-6.4 alsa-devel-1.0.18-8.7 alsa-plugins-pulse-1.0.18-6.12 alsa-1.0.18-8.7 alsa-plugins-1.0.18-6.12

Libaudio2 libaudio2 is another library used by UI to play the sound. The installation of this setup package is simple. You could download the relevant deb or rpm to install. Recommended website: http://rpm.pbone.net/index.php3/stat/4/idpl/12245031/com/libaudio2-1.9.2-0.pm.1.i586.rpm.html http://packages.ubuntu.com/hardy/libaudio2 or you could get the relevant compression package of library files, containing libaudio.so, libaudio.so.2, libaudio.so.2.4, etc., directly unzip to /lib directory and run ldconfig command.



3. Get Started to Run UI

After all above installations, you can run UI software. Insert the usb modem into USB port, wait for the driver to recognize USB modem, and then run UI program.

Two methods to run UI software: １．Click the shortcut menu: Menu ->Connection->ZTEMTUI ２．Execute ztemtapp command through terminal program

a) After running UI in this way, the following information will display on the terminal, which will be used to track the problem.

b) If the shared library required by UI are not completely installed, you will see the system prompt of missing libaudio2 library after executing ztemtapp command. See the figure below:

4. Common Problems and Troubleshooting

Has UI software been installed or no? If UI software has been installed, the program would be located at the following path: /usr/local/bin/ztemtApp. Execute the program through ztemtapp command.

You can use the command line to inquire the name of the package where the files are saved. The name will be used when you want to remove UI software. For example, if you want to inquire which package ztemtapp file is installed, you can run: rpm –qf /bin/ztemtapp or dpkg –S ztemtapp If dialer is already installed, the following information will return: “CrossPlatformUI-V1.x.x-*”, and the package name is CrossPlatformUI.

Can USB device be used or not If the driver is installed successfully, you could inquire that ztemt.ko module has been loaded into the system through lsmod | grep ztemt command. At this point, you will find the device files such as ttyUSB0, ttyUSB1…under the directory: /dev/ after inserting the data card (1~ 2 seconds). ttyUSB0 corresponds to modem port.

If the installation fails, you will not find /dev/ttyUSB0. You are prompted with “Can’t find device” when running UI.



Why is there no response when clicking Application Internet Reliance NetConnect？ Solution: Input “ztemtapp” at the command line（Applications->accessories->terminal）; If the system prompts you with “can’t find command”, the installation isn’t successful, you need install the software again; If the system prompts you with “missing libaudio2” library, you need install the corresponding library file.

What shall we do if there is a prompt with “Can’t access the terminal or can’t find the device” after clicking Reliance NetConnect？ Solution: use the command “ls /dev/ttyU*” to check whether /dev/ttyUSB0, /dev/ttyUSB1, /dev/ttyUSB2 and /dev/ttyUSB3 exist. If they don’t exist, device drivers are not loaded properly. You could manually compile and load the driver which is placed at /usr/local/bin/ztemtApp/, or seek for technical support.

What shall we do if there is a prompt with “insmod ztemt.ko failure” during the

installation? There are two reasons:

1. This usually happens as you remove UI and install again. You need reboot to load normally because the driver module is not well compatible with the system.

2. It also happens under Ubuntu9.04 version system because the USB driver already exists in the system and the ztemt.ko driver file provided by UI can’t be loaded again. However, we have built-in the automatic judgment and handling over Ubuntu9.04 in the setup package; if such an error occurs to your system unexpectedly, use the following method to manually pass two parameters to the kernel, and make the kernel support ZTE USB modem. Method: under the system startup interface, move the highlight to ubuntu9.04, press “e” key to edit, select the item you want to start, add space after the word splash, input “usbserial.vendor=0x19d2 usbserial.product=0xfff1”, press “Enter” to confirm and press “b” to start. (Use “lsusb” command to view PID and VID values.)

Manually compile the driver

1. In some special cases, the setup package can’t automatically compile the driver, so you need change the configurations yourself and manually compile the driver.

Method: enter the directory: /usr/local/bin/ztemtApp/zteusbserial, and find the corresponding kernel version of current system. For example: if the operating system is 2.6.27 kernel, please use the driver in 2.6.27 folder; if the operating system is the version below 2.6.27, use the driver in below2.6.27 folder. Enter the directory, execute make command. If the compiling is successful, ztemt.ko driver will be generated in current directory. Execute insmod ztemt.ko to load and copy the ztemt.ko under zteusbserial directory. 2. If it prompts with “Can’t find kernel source code”, please change the path of

KERNELDIR in Makefile.



（e.g.: KERNELDIR=/usr/src/kernels/2.6.27.4-79.fc10.i686)，and compile it again. 3. If you didn’t find the similar path in the system, follow the method above to install the

kernel development package. Configuration file path

When Linux setup program is being executed, UI configuration file, will be saved in user’s directory. ~/.ztemtapp/ZTEEVDO/

Can’t exit due to exception of UI software In some rare cases, UI process is locked and can’t exit, it will occupy USB device file and driver; it causes the failure of uninstallation, and UI program prompts with “Still can’t find the device” after the device is plug out and plug in again. In this case you could use killall -9 App to end UI process and let the system release all used resources. Plug in/out the device to normally run UI software.

What shall we do if the uninstall fails and the software package can’t be installed again? The common/other users use “sudo dpkg -i --forece-all setup package name” to perform compulsory installation, and this will cover some remaining information and has no influence upon the system. Root users don’t need sudo. Please note that there are two “-” before force and there is no space between “force” and “-all”.

What shall we do if there is no sound for UI or the other party can’t hear the sound?

1. In order to normally use ALSA sound frame, UI software provides the selection of corresponding audio device.

ＵI default settings are select default device. The conflict among these three devices might cause one device unable to make the sound due to different system configurations. Therefore you need select the proper settings. Generally, the following selection method is recommended (the detailed operations might vary according to different Linux system versions and hardware configurations)

During the use of UI, if Capture device can’t be used by default, please manually select one (generally select the last one, namely, the second device). See the figure below:



2. Besides, you need to configure the sound controller in advance to make sure the system

recorder could normally record the sound from Microphone. Refer to the figure below for configuration method:

Capture device is namely input device（Front Mic）as shown in the figure above; the system’s Capture device generally corresponds to Front Mic.

How to download libaudio? fedora libaudio download url: http://rpm.pbone.net/index.php3/stat/3/srodzaj/1/search/libaudio.so.2 opensuse libaudio download url: http://rpm.pbone.net/index.php3/stat/3/limit/3/srodzaj/1/dl/40/search/libaudio.so.2/field%5B%5D/1/field%5B%5D/2 ubuntu libaudio download url: http://packages.ubuntu.com/en/lucid/libaudio2

how to solve the problem with modem-manager? For Linux 2.6.31 kernel such as Fedora12, the prompt like “Cannot access serial port.Make sure you



have appropriate permission.” after installation might appear because this port is occupied by modem-manager program. Simply remove modem-manager or change the name after backup, and then restart the computer to solve this problem.

Why doesn't the system automatically load CD-ROM and can't install the driver and UI software after the data card is inserted?

It's unnecessary to install ZTE driver and UI software since the new version of usb_modeswitch tool integrates the driver of data card. You can directly connect to the Internet through the system's dialer. If you need install ZTE UI software, please open /etc/usb_modeswitch.conf, change the value of DisableSwitching to 1, save the settings, and then insert the data card again. By doing so, the system can automatically load CD-ROM.

How can you make the data card not switch to Modem when you insert the data card again?

1. Turn on the terminal. 2. Use “sudo vim /etc/usb_modeswitch.conf” to open the file. 3. Press “a” to enter the edit-mode, then move the cursor to DisableSwitching=0 and change the value to 1. 4. Press “ESC” to quit the edit-mode, then press “:”, input “wq” and click the “Enter” Key. 5. Now the file is saved. You can use “cat /etc/usb_modeswitch.conf” to check whether it is modified successfully. 6. Insert our data card again. The data card should not be switched to modem.

Reliance Netconnect+ AC2737 Installation Guide for Linux

Documents

Transcript of Reliance Netconnect+ AC2737 Installation Guide for Linux