ZYD(4)

👑 ZYD(4) — zyd, the ZyDAS ZD1211/ZD1211B USB IEEE 802.11b/g wireless network driver

okay so this is from the Kernel Interfaces Manual and it's about <pink>zyd</pink>, the driver for those little ZyDAS USB wifi sticks. bestie, it's giving "vintage tech that still slaps" and i'm lowkey obsessed. let me tell you everything 💅

✨ NAME ✨

zyd — the ZyDAS ZD1211/ZD1211B USB IEEE 802.11b/g wireless network driver. that's the whole vibe. it's a wifi driver, it talks to USB, it does 802.11b/g. periodt 🫶

✨ SYNOPSIS ✨

so you wanna bake this driver into your kernel? slay, iconic. drop these lines in your kernel configuration file:

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

or, if compiling the whole kernel isn't your main character energy and you'd rather load it as a module at boot time, put this one line in loader.conf(5):

if_zyd_load="YES"

that's it. one line. so easy. 🎀

✨ DESCRIPTION ✨

the zyd driver gives you support for wireless network adapters built around the ZyDAS ZD1211 and ZD1211B USB chips. no cap, that's the entire chip family situation.

zyd supports station and monitor mode operation. but he's monogamous — only one virtual interface may be configured at any time 🙈. if you need help configuring this device, check out ifconfig(8). she knows everything.

✨ HARDWARE ✨

these are the devices that are known to be supported by the zyd driver. it's a long list. like, a really long list. but every single one matters, so here we go 💖

• 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

that's forty-four devices btw. i counted. 🧚

---

✨ EXAMPLES ✨

🦋 example one: join any BSS with WEP

so this example configures zyd0 to join any BSS network using the WEP key 0x1deadbeef1 on channel 11. look at that key, it's so hexadecimal of her 💀

ifconfig wlan create wlandev zyd0 channel 11 \
    wepmode on wepkey 0x1deadbeef1 weptxkey 1 \
    inet 192.0.2.20/24

🦋 example two: join an existing BSS called my_net

this one joins an existing BSS network named my_net. cute name, no notes 🌸

ifconfig wlan create wlandev zyd0 192.0.2.20/24 \
    ssid my_net

---

✨ DIAGNOSTICS ✨

okay bestie, these are the messages the driver might throw at you. they're not mean, they're just honest 😭

• zyd%d: could not load firmware (error=%d) — an error happened while trying to upload the firmware to the onboard microcontroller unit. the firmware said "not today" basically 💀
• zyd%d: could not send command (error=%s) — an attempt to send a command to the firmware straight up failed.
• zyd%d: sorry, radio %s is not supported yet — support for the specified radio chip is not yet implemented in the driver. literally it apologizes to you, and the device will not attach. so sad 🥲
• 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. (note the >= 43.30, that's the cutoff, don't @ me)
• zyd%d: device timeout — a frame that got dispatched to the hardware for transmission didn't complete in time. the driver will reset the hardware. the manpage says this should not happen — so if it does, that's a whole situation 🔥

also fyi: three of these (the unsupported radio and the version mismatch) mean the device will not attach. no attach, no wifi. that's the whole tea.

✨ SEE ALSO ✨

go read these, they're all bangers, i promise:

intro(4), netintro(4), usb(4), wlan(4), wlan_amrr(4), wlan_ccmp(4), wlan_tkip(4), wlan_wep(4), networking(7), ifconfig(8), wpa_supplicant(8)

✨ AUTHORS ✨

the original zyd driver was written by these three icons, give them their flowers 💐:

• Florian Stoehr <ich@florian-stoehr.de>
• Damien Bergamini <damien@openbsd.org>
• Jonathan Gray <jsg@openbsd.org>

✨ CAVEATS ✨

ngl, this part hurts a little. the zyd driver does not support a lot of the functionality that's actually available in the hardware. like, the hardware has more to give and the driver just isn't there yet 😔. more work is required to properly support the IBSS and power management features. so don't come for her about IBSS, she's trying.

---

ok that's the whole page!! 🌈 lowkey a lot of devices, highkey a lot of love.

this page is from Debian, dated November 10, 2024 — go off, Debian 💜