Wireless Data Terminal Installation Guide

Reliance Netconnect+ AC2737 Installation Guide for Linux

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

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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. Its 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: its recommened to install with yast setup package manager. Select software,
ZTE Corporation http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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: its 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
http://www.zte.com.cn

ZTE Corporation

Wireless Data Terminal Installation Guide

Fedora: its 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 cant 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.

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

Uninstall method: sudo rpm e CrossPlatformUI or: sudo dpkg r CrossPlatformUI or: sudo dpkg P CrossPlatformUI

( #Fedora/openSUSE case sensitive) ( #Ubuntu ) #Ubuntu

Conflict among setup packages

If there is any conflict between the setup package and other software (generally, this wont 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.

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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. z Two methods to run UI software: Click the shortcut menu: Menu ->Connection->ZTEMTUI Execute ztemtapp command through terminal program a) b) After running UI in this way, the following information will display on the terminal, which will be used to track the problem. 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

z 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. z 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, ttyUSB1under 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 Cant find device when running UI.

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

Why is there no response when clicking ApplicationInternetReliance NetConnect Solution: Input ztemtapp at the command lineApplications->accessories->terminal; If the system prompts you with cant find command, the installation isnt 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 Cant access the terminal or cant 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 dont 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 cant 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 cant 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 Cant find kernel source code, please change the path of KERNELDIR in Makefile.
http://www.zte.com.cn

ZTE Corporation

Wireless Data Terminal Installation Guide

e.g.: KERNELDIR=/usr/src/kernels/2.6.27.4-79.fc10.i686)and compile it again. 3. If you didnt 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 users directory. ~/.ztemtapp/ZTEEVDO/ Cant exit due to exception of UI software In some rare cases, UI process is locked and cant exit, it will occupy USB device file and driver; it causes the failure of uninstallation, and UI program prompts with Still cant 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 cant 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 dont 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 cant 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 cant be used by default, please manually select one (generally select the last one, namely, the second device). See the figure below:

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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 deviceFront Micas shown in the figure above; the systems 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/fiel d%5B%5D/2 ubuntu libaudio download url: http://packages.ubuntu.com/en/lucid/libaudio2

z 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
ZTE Corporation http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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. z 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.

ZTE Corporation

http://www.zte.com.cn