Motorola LA-5137 User manual

Brand: Motorola

Model: LA-5137

Type: User manual



LA-51XX Compact Flash Adapter

Linux Driver User’s Guide

MOTOROLA and the Stylized M Logo are registered in the US Patent & Trademark Office. Symbol is a registered

trademark of Symbol Technologies, Inc. All other product or service names are the property of their respective owners.

LA-51XX Compact Flash Adapter Linux Driver

User’s Guide

1.1 Introduction

The Linux Driver build for the LA-51XX 802.11a/b/g client NIC card is done on a RedHat Linux 9 machine,

installed with gcc, and Linux kernel 2.4.22 or later. For the driver to run successfully, you would also need the

LA-51XX firmware.

1.2 Pre Requisites

• RedHat Linux 9 system, with gcc, make, patch etc., to build the device driver from the sources

• RedHat Linux 9 system, with a kernel of 2.4.22 or later

• The kernel should have NETLINK, PCI and HOTPLUG support enabled.

1.3 Installation

You can use either of the below mentioned methods to install the LA-51XX Driver and associated software:

• Install using install script

• Manual install

1.4 Install using install script

The Linux driver needs the following components to work, which are installed by the installation script.

• openssl-0.9.7j

• wireless_tools version 28

- iwconfig, iwlist, iwevent tools used for configuration

• wpa-supplicant-0.4.9

1. Run the installation script from the installation CD. The user should have root permissions.

/mnt/cdrom/la5137-pkgs/la5137-bi.sh

2. The script installs the software in the following directory by default (or in the installation directory

specified by you):

1-2 LA-51XX Compact Flash Adapter Linux Driver User’s Guide

/opt/symbol/linux-driver/

3. The complete installation log (la5137-install.log) file is available under the /tmp directory

4. Once the installation is complete, restart the machine.

1.4.1 Manual Install

Ensure you have the following installed before installing the driver manually:

• openssl-0.9.7j

• wireless_tools version 28

1. Get the LA-51XX Linux driver sources from the CD-ROM

cp -r /mnt/cdrom/la5137-pkgs/software/linux-driver /opt/symbol

2. Get the wpa-supplicant sources from the CD-ROM

tar xvfz /mnt/cdrom/la5137-pkgs/shared/wpa-supplicant-0.4.9.tar.gz /opt/symbol/

NOTE: The wpa-supplicant and the linux-driver should be at the same directory level.

1.5 Building Linux driver

If you used the installation script, these steps have already been performed. You do not need to build the

driver.

1. Change directory to the directory where you installed the linux-driver.

cd /opt/symbol/linux-driver

2. make clean

3. make all

This generates:

driver/sm_drv_pc16.o

applications/getoid/getoid

applications/setoid/setoid

4. make install

Installs the driver in /lib/modules/2.4.31/kernel/drivers/net

Installs the applications getoid, setoid in /usr/bin/

1.6 Configuring the Linux system for LA-51XX

This is done on the Linux system. Use the following Steps to add Conexant PCCARD Info into CardManager

Config File. These steps must be executed for the device to get identified.

1. Edit /etc/pcmcia/config

2. Add the information:

device “sm_drv_pc16”

class “network” module “sm_drv_pc16”

wpa_supplicant 1-3

Under Device Driver Definitions Caption. Make sure the above information is not commented out

(comments start with #).

3. Add the information:

card “Conexant PC16”

manfid 0x0013, 0xc684

bind “sm_drv_pc16”

Under Wireless Network Adapters Caption. Make sure the above information is not commented

out (comments start with #).

4. manfid values are specific to Card. If there is any change in manfid, plug in the device and issue the

command

cardctl ident

5. Service pcmcia restart.

6. Plug-in the card.

7. Check if a new interface is created for the LA-51XX client card.

ifconfig -a

1.7 wpa_supplicant

The installation script installs the wpa_supplicant in the following directory by default (or in the installation

directory you specified)

/opt/symbol/wpa-supplicant.

The following two applications are installed.

• /usr/local/sbin/wpa_supplicant

• /usr/local/sbin/wpa_cli

You can get more information about the wpa_supplicant in the README in the wpa-supplicant directory or

from its website: http://hostap.epitest.fi/wpa_supplicant/

1.8 Wireless configuration tools

1.8.1 Wireless tools

The following tools are supported, which can be used for configuration of the wireless cards. You can use

linux man pages for more details on these utilities. These utilities use the standard “Wireless Extensions”

interface.

• iwconfig

•iwlist

•iwevent

1-4 LA-51XX Compact Flash Adapter Linux Driver User’s Guide

1.8.2 getoid/setoid

The getoid, setoid applications are released along with the LA-51XX package. These can be used for some

basic configuration of the cards. These commands internally use the API interface as described in the

LA-51XX API Programmer’s Reference Guide.

1.9 Initial configuration

This section gives the basic configuration you need to start using the card.

1.9.1 Enabling the interface

1. Use the script below to check the status of the wireless interface.

$> ifconfig -a

eth1 Link encap:Ethernet HWaddr 00:30:B4:00:00:18

inet addr:5.5.5.8 Bcast:5.255.255.255 Mask:255.0.0.0

BROADCAST RUNNING MULTICAST MTU:1500 Metric:1

RX packets:351 errors:0 dropped:0 overruns:0 frame:0

TX packets:6 errors:0 dropped:0 overruns:0 carrier:0

collisions:0 txqueuelen:1000

RX bytes:556686 (543.6 Kb) TX bytes:1752 (1.7 Kb)

Interrupt:3 Base address:0x100

2. Enable the interface. Follow the script below to enable the interface.

$> ifconfig eth1 up

$> ifconfig -a

eth1 Link encap:Ethernet HWaddr 00:30:B4:00:00:18

inet addr:5.5.5.8 Bcast:5.255.255.255 Mask:255.0.0.0

UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1

RX packets:351 errors:0 dropped:0 overruns:0 frame:0

TX packets:6 errors:0 dropped:0 overruns:0 carrier:0

collisions:0 txqueuelen:1000

RX bytes:556686 (543.6 Kb) TX bytes:1752 (1.7 Kb)

Interrupt:3 Base address:0x100

1.9.2 Finding WLAN

To list the available networks in the vicinity, use:

$> iwlist scan

1.9.3 Setting network/essid

To configure the card to associate to a non-secure network, use:

$> iwconfig ethX essid “symbol”

Initial configuration 1-5

This will initiate an association to the network “symbol”. Ensure the network is not configured for security.

1.9.4 Checking status/iwconfig

You can confirm that the client card is associated by running the iwconfig command:

$> iwconfig

eth1 IEEE 802.11DS ESSID:"symbol"

Mode:Managed Frequency:2.412 GHz Access Point:

00:A0:F8:B5:7A:D0

Bit Rate:11 Mb/s Tx-Power=18 dBm Sensitivity=0/0

Retry limit:7 RTS thr:2347 B Fragment thr:2346 B

Encryption key:off

1.9.5 Getting an IP Address

To get an IP Address, use:

$> dhclient eth1

If an IP Address is successfully received, you are ready to use the card.

1.9.6 Configuring WEP

Follow the steps below to configure 64-byte WEP encryption. You can get more details on these steps from

the LA-51XX API Programmer’s Reference Guide.

# set the authentication to OPEN

setoid eth1 0x12000000 long 1

# set the privacy mechanism to WEP64

# DOT11_OID_PRIVACYINVOKED

setoid eth1 0x12000001 long 1

# use 4 for wep128

# set EXUNENCRYPTED to true.

# This will prevent any cleartext communication.

setoid eth1 0x12000002 long 1

# set DEFKEYID to 0.

# This will set the default key index to "key 1".

setoid eth1 0x12000003 long 0

# set the default key 1

eth1 0x12000004 key 0 0xabcdeabcde

# set the essid.

setoid eth1 0x10000002 ssid wep64

Check the association status using the command iwconfig.

You can also use wpa-supplicant to configure WEP 64 and WEP 128.

1-6 LA-51XX Compact Flash Adapter Linux Driver User’s Guide

1.9.7 Configuring WPA-PSK, WPA2-PSK

You can use wpa-supplicant for configuring WPA-PSK, WPA2-PSK encryptions. You can get more information

about the wpa_supplicant in the README in the wpa-supplicant directory or from the website:

http://hostap.epitest.fi/wpa_supplicant/

1.10 Troubleshooting

1) Problem After installation, I restarted the system but there is no response if I plug-in the card.

Solution Please restart the

cardmgr service with the card inserted. This issue is being

looked into. To restart the service, use

service pcmcia restart

2) Problem When I load the driver, i don't get any messages?

Solution Check the log messages from the

dmesg command.

3) Problem How do I enable Debug Messages in the driver?

Solution Edit Makefile under driver Directory and

add switch -DDEBUG_ON to CFLAGS.

To disable add switch -DDEBUG_OFF.

4) Problem How do I install firmware?

Solution The firmware file 53821ahif_sh.wrm should be copied to

/usr/lib/hotplug/firmware/ directory.

When you install the driver (ie run make install in the linux-driver directory), the

firmware is copied from the

linux-driver/firmware/bigmac/AHIF/53821ahif_sh.wrm

/usr/lib/hotplug/firmware/

5) Problem How do I confirm/know whether the firmware has downloaded or not?

Solution The message –”FIRMWARE DOWNLOADED SUCCESSFULLY” should appear on

the screen.

dmesg command also show the same message after few seconds of plugging in the

device.

6) Problem How do I know whether the device is up or firmware is initialized properly?

Troubleshooting 1-7

Solution Use ifconfig -a.This provides the ethX information

7) Problem How to I unload the Driver?

Solution There are 2 ways to unload the driver:

rmmod sm_drv_pc16

Just unplug the device, it automatically unloads the driver

In both cases, “<< Conexant STUN : PC16 >>... Unloaded (2.0.0.0-0xxLD” message is

displayed.

8) Problem When I issue make command, it throws me message

“ CardManager Configuration file doesn't have information about the Conexant Stun

PCCARD Device; Please go thru the README file for steps to add information into /

etc/pcmcia/config" ?

Solution This message comes when you have not configured the below file properly.

/etc/pcmcia/config

Please refer steps to add cardmgr config in Configuring the Linux system for LA-51XX.

9) Problem What is the use of setoid and getoid commands?

Solution They are used to set/get Symbol specific OIDs to/from the device respectively. For a

complete list of OIDs, refer the LA-51XX API Programmer’s Reference Guide.

10) Problem When I try to load the driver, it says Unresolved symbols

register_pccard_driver,unregister_pccard etc. and fails to load?

Solution This happens when pcmcia hotplug support is not enabled in the kernel. You can verify

the same by running

service pcmcia restart

If it fails, then you need to recompile the kernel with HotPLUG (CONFIG_HOTPLUG=y)

support.

1-8 LA-51XX Compact Flash Adapter Linux Driver User’s Guide

Technical Specifications

A.1 Patching the Linux kernel

Patching the Linux kernel needs to be done only once for every kernel, before the LA-51XX driver can be built.

1. Get the Linux 2.4.31 sources from the http://kernel.org, or from the CD.

The linux-2.4.31.tar.gz in the CD has got the patched kernel, as also, a modified la5137.config file.

cp /mnt/cdrom/la5137-pkgs/shared/la5137-linux-2.4.31.tar.gz .

2. Untar the sources

cd /usr/src/

tar -xzvf la5137-linux-2.4.31.tar.gz

3. Make sure the following are present in the /usr/src/linux-2.4.31/.config

CONFIG_PCMCIA=m

CONFIG_HOTPLUG=y

CONFIG_HOTPLUG_PCI=y

CONFIG_FW_LOADER=y

CONFIG_EXPERIMENTAL=y

4. Rebuild the linux kernel : linux-2.4.31

Untar the Linux 2.4.31 sources into a directory, and cd to that

Motorola LA-5137 User manual

Motorola LA-5137 User manual

Motorola LA-5137 User manual

Related papers

Other documents