Table of Contents
A No-nonsense, foolproof way to wifi
All you need to connect to a WiFi hotspot is wpa_supplicant, its dependencies, and a DHCP client (udhcpc is included with BusyBox and is therefore already present in the base system).
Just follow 3 easy steps:
- If you have access to a wired connection on your TCL machine:
- Boot your TCL machine and establish a wired connection
- Download the wpa_supplicant extension (on x86_64 it's called wpa_supplicant-dbus) and all its dependencies: tce-load -w wpa_supplicant-dbus
- Load the wpa_supplicant extension and its dependencies: tce-load -i wpa_supplicant-dbus
(to load automatically at every boot, just add wpa_supplicant-dbus.tcz to tce/onboot.lst)
- If you do NOT have access to a wired connection on your TCL machine:
- Using a different machine, establish an internet connection then manually download the wpa_supplicant extension (on x86_64 it's called wpa_supplicant-dbus) and all its dependencies from the repository that corresponds to your TCL version and architecture (e.g., 11.x, x86_64). See NOTES below.
- Boot your TCL machine and manually copy the downloaded files to tce/optional/
- Load the wpa_supplicant extension and its dependencies: tce-load -i wpa_supplicant-dbus
(to load automatically at every boot, just add wpa_supplicant-dbus.tcz to tce/onboot.lst)
Now you are ready to connect to any WiFi hotspot. You can do so manually or use a shell script to help you (e.g., https://github.com/bdantas/autowifi/)
NOTES
- For each extension, download the .tcz file (which is the actual extension), .tcz.md5.txt file, and (if it exists for that extension) the .tcz.dep file.
- Tiny Core Linux mirrors are listed here: http://wiki.tinycorelinux.net/wiki:mirrors
- Take a peek at wpa_supplicant.tcz.tree or wpa_supplicant-dbus.tcz.tree (e.g., ftp://distro.ibiblio.org/tinycorelinux/11.x/x86_64/tcz/wpa_supplicant-dbus.tcz.tree) to help you figure out what files you need to download. On TCL 11.x x86_64, it turns out to be 14 .tcz extensions (for a grand total of 37 files including .tcz, .tcz.md5.txt, and .tcz.dep files).
- Despite its name, wpa_supplicant-dbus.tcz does not actually require dbus to be running in order to use wireless.
- These instructions assume you have a wireless card whose firmware is included in the linux kernel or modules (e.g., ath9k). If this is not the case, you also need to download the appropriate firmware extension.
Another easy way: wpa_gui
Note: As of Tiny Core Linux 4.x you can probably just use the wpa_gui extension from the appbrowser and start the application from wbar. It will automatically start wpa_supplicant and udhcpc for all found wireless devices.
You should configure your network and choose File → Save Configuration. If you want to automatically restart the WPA wireless connection after reboot, put “/usr/local/etc/init.d/wpa_gui start” to your /opt/bootlocal.sh and put /etc/wpa_gui.conf to your backup. This way it will start wpa_supplicant and udhcpc for your wireless devices with the configured networks. The wpa_gui service can also be en-/disabled from Panel/Services.
Another way to set up a wireless connection is to use wpa_supplicant with it's associated GUI interface. wpa_supplicant is the IEEE 802.1X/WPA component that is used in the client stations. It implements key negotiation with a WPA Authenticator and it controls the roaming and IEEE 802.11 authentication/association of the wlan driver.
wpa_supplicant is designed to be a daemon program that runs in the background and acts as the backend component controlling the wireless connection. wpa_supplicant supports a text-based frontend (wpa_cli) and a GUI (wpa_gui). See http://hostap.epitest.fi/wpa_supplicant/ for more information.
Install wpa_supplicant and wpa_gui. Then configure wpa_supplicant for remote control by creating a configuration file (this has to be done only once):
Create a configuration file /opt/wpa.cfg with the following content:
ctrl_interface=/var/run/wpa_supplicant ctrl_interface_group=staff update_config=1
It's recommended to add this file to your backup, or use a persistent opt.
After creating the configuration file start the wpa_supplicant daemon using the following command and to have wpa_supplicant start every boot, add this to /opt/bootlocal.sh:
wpa_supplicant -Dwext -iwlan0 -c/opt/wpa.cfg -B
Replace wlan0 with the name of your wireless card.
Afterwards, all you need to do to connect to various networks is to run wpa_gui from the menu.
More Advanced Setup : Using wireless tools
Prerequisites
- You have a working tinycore system with some support for persistence (ie: A tce directory and either a backup/restore point or a persistent /opt directory) ← add link to appropriate howtos.
- Your wireless hardware is supported by a driver available in the repo.
- You want to connect to an open access point, WEP or WPA-PSK secured AP (you do care about security don't you?)
Initial Preparation
1. Boot tinycore and install the needed wireless packages if you haven't already (if you have an Intel wireless card, you need to install firmware-intel.tcz first, and iwlwifi.tcz if it doesn't install it as a dependency).
| wireless_tools.tcz | gives you iwconfig and other tools | | wireless-`uname -r`-tinycore.tcz | in-kernel wifi drivers | | wpa-supplicant.tcz | wpa_supplicant tool for negotiating secured access points |
If you will be installing to a system that depends on wifi access you may find it easier to pre-download these files and copy them to your tinycore tce directory so that they are installed at boot time (or use tce-load to install them after boot).
2. Check whether you can see your wireless hardware. in the console run: iwconfig
You should see a list of interfaces with some status info. your wireless interface may show up as wlan0 (but maybe ath0 or eth0?). You need to remember the name of this interface as it will be used later
If you don't see a connection, you may need to load or install drivers. The wireless-`uname -r`-tinycore contains all in-kernel wifi drivers. You can verify the drivers are present using something like (assuming Atheros card): modprobe -l | grep ath you should see the ath9k.ko.gz and ath5k.ko.gz device driver files
Verify they are loaded using: lsmod | grep ath
You can use modprobe to temporarily load and unload drivers as needed. For instructions on setting up alternative Atheros drivers, see Network Setup - Atheros Wireless Cards
Connecting to an open access point
- To connect to a particular access point, all you need to do is type in the console: iwconfig *interface* essid *network-id* to search for access points, use the command: iwlist scanning to connect to the nearest access point, just use: iwconfig *interface* essid any
- To finalize the connection (getting IP address etc), go to control panel, open the netcardconfig tool. switch eth0 to the name of your interface (e.g. wlan0). Change Use DHCP Broadcast? to yes, leave Save Configuration as yes. Hit apply. This will save and run a script /opt/*interface*.sh. In addition, the /opt/bootlocal.sh (the script run at boot) will now include /opt/*interface*.sh. If your /opt directory is not persistent, make sure you do a backup when you boot or you will need to rerun this tool each time you boot.
Alternately, instead of running netcardconfig you could just issue the udhcpc command, e.g., udhcpc -i *interface* - At this point you should have a working network connection. If it doesn't work you might need to play around with the udhcpc commandline (the gui in step 2 makes a udhcpc call, but there are additional options that may be needed)
- If you don't want to have to run step 1 and 2 every time you boot, you can add the command to your /opt/bootlocal.sh file before the line that calls /opt/*interface*.sh script (make sure you backup!)
Connecting to a WPA-PSK secured access point
Before you start, you need to look up your access point id (ssid) and passphrase (a string).
- At the command line, run wpa_passphrase *essid* *passphrase*
For example: wpa_passphrase mynetwork mypassphrase network={ssid=“mynetwork”,psk=f242925f83787084d58101d5eb52485989e2a553983bfe6fc5b8d27fdfa063bd} - Now create a file in your favorite editor replacing the ssid and psk values below with result from step 1: ctrl_interface=/var/run/wpa_supplicant
network={ ssid=mynetwork proto=WPA key_mgmt=WPA-PSK pairwise=TKIP group=TKIP psk=f242925f83787084d58101d5eb52485989e2a553983bfe6fc5b8d27fdfa063bd }
Note: This assumes a fairly conventional WPA-PSK setup. If you need to use other security (e.g. WEP) or are connecting to a more sophisticated network you may have to tweak this file. See the wpa_supplicant manual for more info. (What if you connect to more than one WPA-PSK network? You can add as many network sections to the conf file as needed.) save it as /opt/wpa_configure.conf (then to ensure it is persistent in the system, add the line opt/wpa_configure.conf to /opt/.filetool.lst)
- to connect to the access point, run in the console: wpa_supplicant -i*interface* -c/opt/wpa_configure.conf &
For diagnostic run this command with debugging option -d
sudo wpa_supplicant -i*interface* -c/opt/wpa_configure.conf -d (Close debugging mode with Ctrl+c)
You can verify the connection with iwconfig. After successful association you get all connection data in command output: AP BSSID, Bit Rate, Link Quality etc. Another simple method is watching card LINK diode. Diode shines with constant light, when Adapter is connected to AP. - now to finalize the connection (getting IP address etc), go to control panel, open the netcardconfig tool. switch eth0 to the name of your interface (e.g. wlan0). Change Use DHCP Broadcast? to yes, leave Save Configuration as yes. Hit apply. This will save and run a script /opt/*interface*.sh. In addition, the /opt/bootlocal.sh (the script run at boot) will now include /opt/*interface*.sh. If your /opt directory is not persistent, make sure you do a backup when you boot or you will need to rerun this tool each time you boot.
Alternately, instead of running netcardconfig you could just issue the udhcpc command, e.g.: udhcpc -i *interface*
- At this point you should have a working network connection. If it doesn't work you might need to tweak the wpa_supplicant configuration or the udhcpc command line.
- If you don't want to have to run step 3 and 4 every time you boot, you can add the wpa_supplicant command in line 3 to your /opt/bootlocal.sh file before the line that calls /opt/*interface*.sh script (make sure you backup!)
Simple scripts to auto connect to specific networks
Connect to non-secured access point. (Script that displays local Access Points to connect to. Only works with unsecured APs.)
- Connect to either non-secure or WEP protected access point
NOTE: requires editing of shell script to set ESSID (network name) and wep key (set to blank if network is unsecured).
NOTE: to set your WEP key using a plain text string (i.e.: not HEX) then put an s: in front of the key iwconfig wlan0 key s:BlahBlahBlah
#!/bin/sh - Example usage: - - sudo sh mywifi.sh - - Can automate this stuff by putting into /opt/bootlocal.sh (without the need for sudo) - using cpanel, network autocreates /opt/my* - Determine device name (assume one wifi device; use head, etc. to restrict to first, last...) |wlan=`iwconfig 2>/dev/null |grep IEEE |awk '{print $1}' `| echo $wlan essid=myessid - set wepkey to hex digits, leave blank if no wep-security is used wepkey=deadbeafdeadbeaf echo SID ${essid} if [[ -n "${wep}" ]] then echo WEPKEY $wepkey fi iwconfig ${wlan} iwconfig ${wlan} essid ${essid} if [[ -n "${wep}" ]] then iwconfig ${wlan} enc ${wepkey} iwconfig ${wlan} key ${wepkey} fi iwconfig ${wlan} commit - now setup IP address, route, gateway, etc. - Use DHCP - after netcardconfig and save settings - TC@BOX:~$ cat /opt/eth1.sh - !/bin/sh pkill udhcpc udhcpc -H box -b -i ${wlan}