zyd (4)

Leading comments

$OpenBSD: zyd.4,v 1.22 2007/05/24 02:49:57 cnst Exp $
$NetBSD: zyd.4,v 1.1 2007/06/09 11:20:55 kiyohara Exp $
$FreeBSD: releng/11.0/share/man/man4/zyd.4 267938 2014-06-26 21:46:14Z bapt $

Copyright (c) 1997, 1998, 1999
Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice,...

(The comments found at the beginning of the groff file "man4/zyd.4freebsd".)

NAME

zyd - ZyDAS ZD1211/ZD1211B USB IEEE 802.11b/g wireless network device

SYNOPSIS

To compile this driver into the kernel, place the following lines in your kernel configuration file:

device ehci device uhci device ohci device usb device zyd device wlan device wlan_amrr

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf5:

if_zyd_load="YES"

DESCRIPTION

The ifconfig driver provides support for wireless network adapters based around the ZyDAS ZD1211 and ZD1211B USB chips.

ifconfig supports station and monitor mode operation. Only one virtual interface may be configured at any time. For more information on configuring this device, see ifconfig(8).

HARDWARE

The following devices are known to be supported by the ifconfig driver:

3COM 3CRUSB10075

Acer WLAN-G-US1

Airlink+ AWLL3025

Airlink 101 AWLL3026

AOpen 802.11g WL54

Asus A9T integrated wireless

Asus WL-159g

Belkin F5D7050 v.4000

Billion BiPAC 3011G

Buffalo WLI-U2-KG54L

CC&C WL-2203B

DrayTek Vigor 550

Edimax EW-7317UG

Edimax EW-7317LDG

Fiberline Networks WL-43OU

iNexQ UR055g

Linksys WUSBF54G

Longshine LCS-8131G3

MSI US54SE

MyTek MWU-201 USB adapter

Philips SNU5600

Planet WL-U356

Planex GW-US54GZ

Planex GW-US54GZL

Planex GW-US54Mini

Safecom SWMULZ-5400

Sagem XG 760A

Sagem XG 76NA

Sandberg Wireless G54 USB

Sitecom WL-113

SMC SMCWUSB-G

Sweex wireless USB 54 Mbps

Tekram/Siemens USB adapter

Telegent TG54USB

Trendnet TEW-424UB rev A

Trendnet TEW-429UB

TwinMOS G240

Unicorn WL-54G

US Robotics 5423

X-Micro XWL-11GUZX

Yakumo QuickWLAN USB

Zonet ZEW2501

ZyXEL ZyAIR G-202

ZyXEL ZyAIR G-220

EXAMPLES

The following example configures zyd0 to join any BSS network using WEP key ``0x1deadbeef1'' channel 11:

ifconfig wlan create wlandev zyd0 channel 11 \
    wepmode on wepkey 0x1deadbeef1 weptxkey 1 \
    inet 192.168.1.1 netmask 255.255.255.0

Join an existing BSS network, ``my_net''

ifconfig wlan create wlandev zyd0 192.168.0.2 \
    netmask 0xffffff00 ssid my_net

DIAGNOSTICS

"zyd%d: could not load firmware (error=%d)"

An error occurred while attempting to upload the firmware to the onboard microcontroller unit.

"zyd%d: could not send command (error=%s)"

An attempt to send a command to the firmware failed.

"zyd%d: sorry, radio %s is not supported yet"

Support for the specified radio chip is not yet implemented in the driver. The device will not attach.

"zyd%d: device version mismatch: 0x%x (only >= 43.30 supported)"

Early revisions of the ZD1211 chipset are not supported by this driver. The device will not attach.

"zyd%d: device timeout"

A frame dispatched to the hardware for transmission did not complete in time. The driver will reset the hardware. This should not happen.

SEE ALSO

intro(4), netintro(4), usb(4), wlan(4), wlan_amrr4, wlan_ccmp4, wlan_tkip4, wlan_wep4, ifconfig(8), wpa_supplicant8

AUTHORS

An -nosplit The original ifconfig driver was written by An Florian Stoehr Aq ich@florian-stoehr.de , An Damien Bergamini Aq damien@openbsd.org , and An Jonathan Gray Aq jsg@openbsd.org .

CAVEATS

The ifconfig driver does not support a lot of the functionality available in the hardware. More work is required to properly support the IBSS and power management features.