Nokia D211 User Manual

SUPPORT GUIDE FOR

NOKIA D211

LINUX DEVICE DRIVER

Copyright © 2002 Nokia. All rights reserved. | Date: 05/06/2002.

Contents

1. INTRODUCTION ........................................................................................................... 1

2. REQUIREMENTS.......................................................................................................... 1

3. COMPILING AND INSTALLING THE DEVICE DRIVER ................................................ 1

4. CONFIGURING THE DEVICE DRIVER......................................................................... 2

4.1 GENERAL CONFIGURATION VARIABLES............................................................ 3

4.2 WLAN AD HOC NETWORK.................................................................................... 3

4.3 WLAN INFRASTRUCTURE NETWORK.................................................................. 3

4.4 GSM CONFIGURATION ......................................................................................... 4

5. USING THE DEVICE DRIVER....................................................................................... 4

5.1 NOKIA_CTL ............................................................................................................ 5

6. UNINSTALLING THE DEVICE DRIVER ........................................................................ 6

7. WEP KEYS.................................................................................................................... 6

8. COMPILING THE USER INTERFACE........................................................................... 6

9. SIM SERVICES ............................................................................................................. 7

10. TROUBLESHOOTING................................................................................................... 8

11. GLOSSARY................................................................................................................... 8

Legal Notice

Copyright © 2002 Nokia. All rights reserved.

Reproduction, transfer, distribution or storage of part or all of the contents in this document in any form without the
prior written permission of Nokia is prohibited.

Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation. Other product and company
names mentioned herein may be trademarks or tradenames of their respective owners.

Nokia operates a policy of continuous development. Nokia reserves the right to make changes and improvements
to any of the products described in this document without prior notice.

Under no circumstances shall Nokia be responsible for any loss of data or income or any special, incidental,
consequential or indirect damages howsoever caused.

The contents of this document are provided "as is". Except as required by applicable law, no warranties of any
kind, either express or implied, including, but not limited to, the implied warranties of merchantability and fitness
for a particular purpose, are made in relation to the accuracy, reliability or contents of this document. Nokia
reserves the right to revise this document or withdraw it at any time without prior notice.

The availability of particular products may vary by region. Please check with the Nokia dealer nearest to you.

1. INTRODUCTION

This document is an installation and user's guide for the Linux device driver of the Nokia
D211. The user should be familiar with installing and compiling device drivers in source code
form.

For further information on the use of the Nokia D211, please refer to the User's Guide found
on the product CD-ROM or visit the Nokia Web site at www.forum.nokia.com.

2. REQUIREMENTS

The Linux device driver of the Nokia D211 is provided partly in binary and partly in source
code form. The code must be compiled to a loadable kernel module, which can then be
inserted into a running Linux kernel. A binary userspace daemon is used for the kernel
module management. The included command line utility can be used for configuring the
device driver. The device driver may not work with all Linux kernel versions. See the section
for tested kernel versions.

Note: Although there are Linux versions for many different architectures, the
Nokia D211 device driver has been tested with x86 compatible single processor
Linux only.

To compile and install the device driver, there must be kernel sources available in the
system. In the 2.4 kernel series, the needed PCMCIA support is included in the kernel. A
working PCMCIA support is required in order to make the device driver work. For more
information on this matter, please refer to your Linux distribution documentation or the
documentation provided with the PCMCIA package.

Support for /proc file system in the kernel is required due to the card initialisation scripts.

Note: The system must have kernel sources available because the device driver
compilation requires them. The kernel must have /proc file system support. You
should also have working PCMCIA support.

3. COMPILING AND INSTALLING THE DEVICE DRIVER

First the device driver must be unpacked.

1. Copy the driver packages to the appropriate directory (e.g. /usr/src).

2. Unpack the packages with, for example, the command “tar –zxvf package_name”.
The device driver sources and binaries are now located in the d211 subdirectory.

1/10

After you have unpacked the device driver package, you can begin the compilation.

1. Copy config.mk.orig to config.mk.

2. Edit the config.mk to match your system. It is important that all the directives in
config.mk are correct. Otherwise the device driver may not work or may not even
compile.

Syntax of the file:

LINUX = /usr/src/linux This is the location of the Linux source code

OS_RELEASE=2.4.16 Kernel version for module installation

ROOTDIR=/ Root directory for kernel module and tool

installation

SMAC2=d211fw.bin Firmware for the radio card

3. When the config.mk is correct, compile the device driver by issuing the command
'make all'. If the compilation succeeds, nokia_cs.o appears in the src directory. If the
compilation is not successful, check again the config.mk for possible errors. It is
possible that the device driver does not compile to your system. In that case you
should use one of the setups that Nokia has used in developing the device driver.

4. If you are installing the device driver for the first time, issue the command 'make
config_install' to install the default configuration. If you have previously installed the
device driver and do not want to override the previous setup, you need not do this.

5. Issue the command 'make install' to install the device driver. It installs the kernel
module and the userspace utilities. You may need to restart your PCMCIA system
before using the device driver.

If you need to compile the device driver more than once, it is recommended that you issue
the command 'make clean' before another build is made. This procedure ensures that the
object files from a previous build are recompiled and no version mismatch will occur.

Note: If the device driver does not compile to your system, try one of the setups
listed in the section.

4. CONFIGURING THE DEVICE DRIVER

The configuration file that needs to be edited is /etc/pcmcia/nokia_cs.opts. It defines what the
radio card should do at startup. Currently only the WLAN connection can be activated when
the radio card is inserted. For GSM functionality, see chapter 4.4.

Note: GSM and WLAN functionality cannot be used at the same time.

2/10