home | help
ZYD(4)			     Kernel Interfaces Manual			  ZYD(4)

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.conf(5):

	   if_zyd_load="YES"

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

     These are the modes the zyd driver can operate in:

     BSS mode	    Also known as infrastructure mode, this is used when associ-
		    ating with	an  access  point,  through  which  all  traffic
		    passes.  This mode is the default.

     monitor mode   In	this  mode the driver is able to receive packets without
		    associating with an access point.  This disables the  inter-
		    nal  receive  filter and enables the card to capture packets
		    from networks which it wouldn't normally have access to,  or
		    to scan for access points.

     zyd  supports software WEP.  Wired Equivalent Privacy (WEP) is the de facto
     encryption standard for wireless networks.  It can be typically  configured
     in one of three modes: no encryption; 40-bit encryption; or 104-bit encryp-
     tion.   Unfortunately,  due  to  serious  weaknesses  in WEP protocol it is
     strongly recommended that it not be used as the sole  mechanism  to  secure
     wireless communication.  WEP is not enabled by default.

HARDWARE
     The following devices are known to be supported by the zyd 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
	   Trendnet TEW-429UB
	   TwinMOS G240
	   Unicorn WL-54G
	   US Robotics 5423
	   X-Micro XWL-11GUZX
	   Yakumo QuickWLAN USB
	   Zonet ZEW2501
	   ZyXEL ZyAIR G-220

EXAMPLES
     The following example configures zyd0 to join whatever network is available
     on boot, using WEP key "0x1deadbeef1", channel 11:

	   inet 192.168.1.1 netmask 255.255.255.0 wepkey 0x1deadbeef1 channel 11

     Configure zyd0 for WEP, using hex key "0x1deadbeef1":

	   # ifconfig zyd0 wepkey 0x1deadbeef1

     Join an existing BSS network, "my_net":

	   # ifconfig zyd0 192.168.0.2 netmask 0xffffff00 ssid my_net

DIAGNOSTICS
     zyd%d: could not load firmware (error=%d)	An error occurred while attempt-
     ing 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  ra-
     dio 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 revi-
     sions  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
     arp(4), intro(4), netintro(4), usb(4), wlan(4), wlan_amrr(4), ifconfig(8)

AUTHORS
     The  zyd  driver  was  written  by  Florian Stoehr <ich@florian-stoehr.de>,
     Damien Bergamini <damien@openbsd.org>, and Jonathan Gray <jsg@openbsd.org>.

CAVEATS
     The zyd 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.

FreeBSD 7.1			November 1, 2008			  ZYD(4)

home | help