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 5. 4.
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.
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.
4.1 GENERAL CONFIGURATION VARIABLES The configuration file contains three general configuration variables. They configure the actions that are performed after the card is inserted. MODE=WLAN PROFILE=My_profile NETWORK_START=yes MODE selects the operating mode. It can be set to WLAN or GSM to enable WLAN or GSM functionality after startup. PROFILE is used to specify the used profile for the selected operating mode. If NETWORK_START is set to “yes”, the network is started after the profile startup.
ssid=Nokia WLAN shared_key1=0x123456789a In this case the network name is Nokia WLAN and the network has one shared WEP key. The card will automatically find the best matching WLAN access point with the desired SSID and matching WEP key. The profile must contain: mode (infra) and the desired ssid (network name). 4.4 GSM CONFIGURATION Note: When referring to GSM data or GSM connection, the information also applies to GPRS connections.
WLAN ChMinor minor number of the character device GSM TTYDev name of the GSM serial port GSM ChMajor major number of the serial port GSM ChMinor minor number of the serial port GSM status GSM radio status, possible states are: on, off WLAN status WLAN radio status, possible states are: off, initialized, on WLAN state WLAN state, possible values are: disabled, initialized, reset, hidden scan, scanning, joining, authenticating, associating, closed, creating BSS, infra, adhoc WLAN BSSID BSSID of
enable_gsm Command gives a PIN code and enables GSM disable_gsm Command disables GSM and stops any connections gsm GSM commands Most important command is enable_gsm which will ask for the PIN code and then give it to the radio card. Giving the PIN code is necessary if GSM is going to be used. One of the command classes is 'gsm'. You can give commands in the 'gsm' set by writing 'nokia_ctl gsm enableGSMradio,' for example.
of the user interface is also an example of how to develop software for the Nokia D211 radio card. In order to compile the user interface, the programmer needs to obtain the C++ headers from http://www.forum.nokia.com. The headers can be found in the D211 SDK package and they should be copied from there to control/public/ directory in the Linux driver main directory. After that you can compile the user interface with the command 'make –f Makefile.sdk' in the user interface directory. 9.
A sample configuration file "config.example" can be found in the same directory as the client. Note: The client assumes that GSM has been enabled on the Nokia D211 radio card, i.e. the user has manually enabled it by issuing the command 'nokia_ctl enable_gsm' before running the client. See chapter 5.1 for further information on how to use the nokia_ctl utility. 10. TROUBLESHOOTING I cannot compile the device driver. Make sure you have the right kernel sources. The kernel must match the kernel in config.
BSSID Basic Service Set Identifier. A six-byte address that distinguishes one WLAN access point from another. Sometimes called network ID. Channel A specified frequency band for the transmission and reception of signals. GSM Global System for Mobile Communications. GSM is a digital telecommunications system used widely in Europe, Asia and the Pacific. GPRS General Packet Radio Service. GPRS is a technology that enables sending and receiving data over a mobile network.
