Linux_zd1211_UserGuide.pdf

The User Guide of ZD1211 USB Linux Driver

Amendment History

Release Date Release Version Release Person

Release Description

2006.06.16 1.9

MingZhou Cai Special mode for Embedded station chariot test

2006.05.25 1.8

MingZhou Cai Some revision of incorrect information

2006.05.15 1.7

MingZhou Cai Turbo Mode Support

2005.11.25 1.6

MingZhou Cai Add Customize PID/VID Section

2005.09.15 1.5

MingZhou Cai Add Dual band operation

2005.08.31 1.4

MingZhou Cai Revise Continuous Tx Operation

2005.08.08 1.3

MingZhou Cai Modification of compile process

2005.08.01 1.2

MingZhou Cai Continuous Tx Operation

2005.06.15 1.1

MingZhou Cai Add setRegion operation

2005.06.06 1.0

MingZhou Cai This document is based on ZD1212 User

Guide. Descriptions of unsupported operation is

removed.

1. Introduction

Because more and more people install the Linux operating system in the desktop and

notebook, we provide the Linux solution of our ZD1211 802.11a+b+g Wireless LAN

Card. ZD1211 provides 802.11 a+b+g wireless solution for USB interface. In our

ZD1211 solution, we can run in the Infrastructure (Managed), Ad-hoc or AP (Master)

modes. One can easily change these modes. This document is intended to describe how to

setup and how to use ZD1211 under the Linux operating system.

1.1 Requirements:

1. Kernel 2.4.20+ . The driver had successfully built in Redhat9, Fedora Core2,3 ,and

Debian 3.1. You can easily build it without any problem

2. To build zd1211 you will need: Configured kernel source code for the kernel you are

running. Ideally, Configured means that you have at least run 'make config', 'make

menuconfig', or 'make xconfig'. If your platform is not SMP system, please don't

config SMP supported, because when module loaded, this will make unresolved

symbol.

3. Make sure your kernel usb 2.0 support is running

- Use lsmod to check "ehci-hcd" module is loaded.

- If host is not support usb 2.0, zd1211 will run under pure-b mode.

2. Building the device driver

In this section, we will describe how to build our ZD1211 Linux driver under the Linux

operating system.

2.1 Package Extraction

tar zxvf ZD1211LnxDrv_xxxx.tar.gz

# where xxxx is the version number, such as 2_0_0_0

The first thing one should do is to uncompress this package by tar. After untaring this

package, you can see the source files. One should change directory into this directory for

proceeding the next step.

2.2 Build and install the driver

The package contains drivers for ZD1211 and ZD1211B. If you doesn’t have specified

request, both of them will be installed.

Under the extracted directory, there is a Makefile in it. Because our driver can support for

kernel 2.4 and kernel 2.6, there are two sets of rule in the Makefile. One has to modify

the Makefile according to the path of “kernel source tree” and the version of the kernel

in your system. In the Makefile, you may see the following statements,

# if the kernel is 2.6.x, turn on this

#KERN_26=y

#KERNEL_SOURCE=/usr/src/linux-2.6.7

# if the kernel is 2.4.x, turn on this

KERN_24=y

KERNEL_SOURCE=/usr/src/linux-2.4.20-8

If you want to build the kernel under the kernel of 2.4.x, one has to set the variable

KERN_24=y and comment the KERN_26=y like that as the example above and modify

the variable KERNEL_SOURCE to the path which you install the kernel source. After

doing these things, one just need to type the “ make ” , and the driver module will be

generated and installed.

2.3 Install individual driver

If you only need driver of ZD1211 or ZD1211B, you can issue :

make clean

make ZD1211REV_B=0 (0 for ZD1211, 1 for ZD1211B)

make ZD1211REV_B=0 install (0 for ZD1211, 1 for ZD1211B)

to install the driver.

2.4 Build the debugging tool

There are two debugging tools in this package, “ apdbg ” and “ menudbg ”. Run “ make

debug ” to compile them both. If you don’t have the ncurse library, you may get some

error messages while compiling menudbg . You can ignore it and get apdbg only.

3. Getting Start

3.1 Load the driver

Generally, the driver is automatically loaded when the zd1211 dongle inserts. If not,

one can use the modprobe –v zd1211(or zd1211b) to load our driver. In order to check

whether our driver is loaded successfully, one can use the “ lsmod ” for this check. If our

driver is loaded successfully, the following messages should be seen

...

zd1211 183576 0 (unused)

...

Please note that the 183576 may not be the same as that in your system.

3.2 Open the network interface

In our driver, we will stop all the commands until the network interface assigned to us is

opened. You can open the network interface by the following command

]$ ifconfig ethX up

]$ ifconfig ethX <IP address>

3.3 Configure the Wireless settings

In our driver, we support the wireless extension commands to control our driver.

PARAMETERS:

essid :

Set the ESSID (or Network Name - in some products it may also called Domain

ID). The ESSID is used to identify cells which are part of the same virtual

network.

Examples:

iwconfig ethX essid <ESSID>

mode:

Set the operation mode of our device.

Examples:

iwconfig ethX <mode>

mode:

Managed (Infrastructure Station mode)

Ah-hoc (Ad hoc mode)

Master (Access Point mode)

channel:

Set the channel in the device.

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: