Skip to content
mozzwald edited this page Feb 2, 2017 · 1 revision

Wireless

Wireless setup is not handled in the standard openwrt fashion. It is a combination of shell scripts, shell commands and/or gmenu2x code.

gmenu2x wifi setup

Access points can be configured in the gmenu2x gui by pressing "w" or choosing "WiFi Setup" in the settings menu. If you have already configured your network previously you can choose connect to automatically connect to wifi. TurnOff will disable wifi. AddNetwork will do an access point scan and display the results in a list then you can choose your desired network from the list. The next prompt will request the wireless encryption type (WPA/WPA2, Hex WEP, ASCII WEP, or none/open). Choose the correct encryption type and enter the correct passphrase or key. The information will be saved (to /etc/wpa.conf) and a connection attempt is made. If the connection succeeds, you can view the DHCP acquired settings from Net Status in the settings menu. If the connection fails, you should verify the settings that were saved and edit or remove them (see the manual WiFi setup below). Once a network is configured and working, you can easily connect in gmenu2x after boot up by pressing "w" and choosing connect.

Manual wifi setup

Wireless access points are stored at /etc/wpa.conf and follow the standard wpa_supplicant.conf format. You can use your preferred text editor (nano or vi are pre-installed) to modify /etc/wpa.conf. A typical WPA/WPA2 network with passphrase encryption should look something like this:

ctrl_interface=/var/run/wpa_supplicant

network={
     ssid="MyNetworkSSID"
     key_mgmt=WPA-PSK
     psk="mySecretPassphrase"
}

The first line containing ctrl_interface should always remain. Everything after that line has been configured manually or by gmenu2x. Be sure that your ssid and passphrase are inside double quotes. The config file can contain multiple networks (ie, work and home). Each network must have it's own network{ } section.

MAC Address

The label inside the battery compartment of the Zipit Z2 contains a MAC Address. This MAC is not used and instead we create the MAC based off the Maxim DS28CM00 I2C device id ROM built into the Zipit. This number is unique to each Zipit and this ensures no duplicate MAC's on the same network.

Wifi connection script

The wifi connection script is located at /usr/share/gmenu2x/scripts/wpa-connect. This is run by gmenu2x when you choose connect from the wifi menu. This script can also be run from the command line. The script will set the MAC address, run wpa_supplicant for access point association, attempt to get a DHCP address and set the time with htpdate. If you need to set a static address, you can modify this script to do it for you.

Clone this wiki locally