''THIS PAGE IS NOT FINISHED, PLEASE CONTRIBUTE''

= Distribution-specific Configuration =

== Debian ==

''zd1211-firmware'' and ''zd1211-source'' packages provide functionality of the driver. On the contrary to the standard driver, a separate firmware package ''zd1211-firmware'' is required by the ''zd1211-source'' package.

=== AP Master mode ===

 * Put this on /etc/network/interfaces with your prefered editor
{{{
auto wlan0
iface wlan0 inet static
        address 192.168.1.1
        netmask 255.255.255.0
        network 192.168.1.0
        broadcast 192.168.1.255
        wireless_essid myessid
        wireless_channel 7
        wireless_mode master
        wireless_rts 512
        wireless_frag 512
        wireless_key secretkey
        pre-up /etc/init.d/dhcp3-server stop
        post-up iwpriv wlan0 set_mac_mode 1
        post-up /etc/init.d/dhcp3-server start
}}}
 * Now do: '''ifconfig wlan0 up'''

== Mandriva ==

=== Mandriva 2006 method 1 ===
 * ensure that there is some startup file ,for.e.g., Mandriva 2006 in /etc/sysconfig/network-scripts/ifcfg-wlan0 with contents such as; 

{{{
  DEVICE=wlan0
  BOOTPROTO=static
  IPADDR=192.168.0.126
  NETMASK=255.255.255.0
  NETWORK=192.168.0.0
  BROADCAST=192.168.0.255
  GATEWAY=192.168.0.1
  TYPE=Wireless

  ONBOOT=yes
  ESSID=WLAN
  MODE=Managed
  Rate=Auto
  CHANNEL=1
  DOMAIN=
  HWADDR=
  DHCP_HOSTNAME=
  USERCTL=yes
  PEERDNS=no
}}}

=== Mandriva 2006 method 2 ===
(this is based in the install instructions)
'''Don't put the USB stick in yet !'''

  Install the Kernel Sources using the menu

  Start -> System -> Configuraton -> Packaging -> Install Software

  A search for 'kernel'  will reveal the right package - you only need to choose the sources
  You must accept the dependencies (gcc etc) if you want to use this driver

  Once this is installed (back to the instructions)
  Mandriva will have installed a kernel with wireless support and iwconfig so...

  Open a konsole and "su -" (you need to root password) then "make && make install"

  modprobe -v zd1211

  lsmod 

  Then put in the USB stick - nearly there...

  Now open 

  Start -> System -> Configuraton -> Configure your Computer

  Use the 'Network & Internet' tab on the left.

  Then 'Setup a new network Interface'

  Choose 'Wireless Connection'

  Choose wlan0  (or however it is named)

  Then fill in boxes for how your local network is configured (DHCP or static) essid etc

 * It suggests logging out to finish the work but I had to reboot with my machine - you may have better luck
   Remember to select 'connect at startup' if that is appropriate


= Manual Configuration =

== Static IP ==

 * iwconfig wlan0 essid youressid
 * ifconfig wlan0 192.168.0.x netmask 255.255.255.0 up (replace ip numbers accordingly)
 * route add default gw 192.168.0.2 (add your gateway ip)




== Open networks script ==
 * A simple script that should get you on an open wireless network, no other config is needed at all, as far as I know. I use it with hawking 54g wireless usb

{{{
#!/bin/sh
/usr/bin/killall -9 dhclient
/sbin/ifconfig wlan0 down
sleep 2
/sbin/rmmod zd1211
/sbin/modprobe zd1211
sleep 3
/sbin/ifconfig wlan0 up
sleep 2
/sbin/dhclient wlan0
}}}