Difference between revisions of "Wifi"
m (Made various fixes and comments, and marked as Buggy.) |
|||
Line 1: | Line 1: | ||
{{todo|Buggy (10.20.2015-14:23->JJ+);(10.20.2015-13:43->JJ+);(10.23.2015-11:50->MD-);(10.26.2015-16:50->JJ+);(10.27.2015-15:30->JJ+); (10.28.2015-15:05->JJ+);(10.28.2015-16:35->MD-)|Jeffrey Jung| project=OE 5.0,Buggy,JJ,MD }} | {{todo|Buggy (10.20.2015-14:23->JJ+);(10.20.2015-13:43->JJ+);(10.23.2015-11:50->MD-);(10.26.2015-16:50->JJ+);(10.27.2015-15:30->JJ+); (10.28.2015-15:05->JJ+);(10.28.2015-16:35->MD-)|Jeffrey Jung| project=OE 5.0,Buggy,JJ,MD }} | ||
− | {{#seo: | + | {{#seo:wireless, wifi, networking |
|title=Wireless Networking | |title=Wireless Networking | ||
|titlemode=append | |titlemode=append | ||
Line 26: | Line 26: | ||
<!-- Set Up Instructions --> | <!-- Set Up Instructions --> | ||
===Set Up=== | ===Set Up=== | ||
− | Before the device can be connected to the network, some additional software | + | Before the device can be connected to the network, some additional software may need to be installed. Boards with Wi-Fi built in will already have the proper software and drivers to support connecting to a wireless network. If your using a board with built-in Wi-Fi, skip to the [[#Wireless Networking|Wireless Networking]] section. In order to obtain the new packages, connect the system to a physical network. The USB adapter may be plugged in at this time, although it may not have the proper drivers installed to the system yet. |
<br clear=all> | <br clear=all> | ||
Line 95: | Line 95: | ||
: A detailed list of the nearby networks will be printed out to the terminal. To identify the SSIDs and respective signal strengths of the network(s) more easily, pipe the output of the <code>iw scan</code> command through <code>grep</code> to scan for the keywords "SSID" or "signal". The closer the value of the signal strength is to 0, the stronger the connection. | : A detailed list of the nearby networks will be printed out to the terminal. To identify the SSIDs and respective signal strengths of the network(s) more easily, pipe the output of the <code>iw scan</code> command through <code>grep</code> to scan for the keywords "SSID" or "signal". The closer the value of the signal strength is to 0, the stronger the connection. | ||
{{clo|indent=2}} | {{clo|indent=2}} | ||
− | {{clio| iw dev wlan0 scan | + | {{clio| iw dev wlan0 scan {{!}} grep SSID|hostname=ipac9x25}} |
:SSID: EMAC-A | :SSID: EMAC-A | ||
− | {{clio| iw dev wlan0 scan | + | {{clio| iw dev wlan0 scan {{!}} grep signal|hostname=ipac9x25}} |
:signal: -78.00dBm | :signal: -78.00dBm | ||
{{clio||hostname=ipac9x25}} | {{clio||hostname=ipac9x25}} |
Revision as of 12:21, 29 October 2015
WARNING! |
Keywords need to be added to the SEO tag (above) |
This guide will illustrate how to set up and connect to a wireless network using the ThinkPenguin Wireless N USB Adapter for GNU/Linux and the built-in WiFi on the SoM-200GS.
Contents
Background
While many machines from EMAC are not natively designed to connect to wireless networks, most of these systems do have USB ports. Using a USB wireless network adapter, like the one found here at ThinkPenguin, a system can equipped with wireless networking capability.
This page describes the actions needed to connect to a wireless network either using either a wireless network USB adapter, or the built-in Wi-Fi found on EMAC products like the SoM-200GS carrier. We chose to use the ThinkPenguin USB adapter for this page because it is well supported by the Linux kernel.
General Information
Set Up
Before the device can be connected to the network, some additional software may need to be installed. Boards with Wi-Fi built in will already have the proper software and drivers to support connecting to a wireless network. If your using a board with built-in Wi-Fi, skip to the Wireless Networking section. In order to obtain the new packages, connect the system to a physical network. The USB adapter may be plugged in at this time, although it may not have the proper drivers installed to the system yet.
WARNING! |
This step isn't needed on EMAC boards with built in wifi capability. Boards like the SOM-200GS with the wifi option will have this software pre-installed. You can tell them to skip this section for those boards. |
-
This process requires modifying some system files, so start by enabling read and write permissions to the filesystem.
root
@
ipac9x25
:
~
#
mount -o remount,rw /
-
A check for any updates is typically a good practice before installing new software. Use the
opkg
manager to install any updated software from the package list.root
@
ipac9x25
:
~
#
opkg update
-
One of the best tools to establish the connection to wireless networks is the
wpa-supplicant
package. This supplicant will allow the system to make connections to WPA and WPA2 protected networks. Install this package with theopkg manager
.root
@
ipac9x25
:
~
#
opkg install wpa-supplicant
-
If using the USB adapter, the appropriate drivers may need to be installed. The ThinkPenguin USB adapter requires the installment of the
linux-firmware-ath9k
package.root
@
ipac9x25
:
~
#
opkg install linux-firmware-ath9k
WARNING! Don't forget to always use code tags around package names. I added them around linux-firmware-ath9k
for you.
Also, don't forget to capitalize and double check the spelling of company names; I fixed Marvell below; it was "marvel". The package name apparently misspells the company name.
Additionally, the Marvell package won't work for all EMAC products with built in Wifi. I'm currently designing a board which will have a Texas Instruments Wifi module on it rather than the wi2wi module which uses the Marvell driver. But as I mentioned above, the board should have this pre-installed. If it doesn't, please let me know. It's important that this software and the correct drivers are pre-installed on these boards.
Showing example output of the opkg commands, below, will make the procedure more clear.
-
If using built-in Wi-Fi, the Marvell license and
linux-firmware-sd8787
packages will need to be installed.root
@
som9g45
:
~
#
opkg install linux-firmware-marvel-license
root
@
som9g45
:
~
#
opkg install linux-firmware-sd8787
-
Independent of using built-in Wi-Fi or an adapter, the
iw
andwireless-tools
packages will complete the needed software to get a connection started.root
@
ipac9x25
:
~
#
opgk install iw
root
@
ipac9x25
:
~
#
opkg install wireless-tools
-
Upon successful installation of all required packages, the system will need to be rebooted to take advantage of the new packages.
root
@
ipac9x25
:
~
#
reboot
Wireless Networking
Using the packages that have just been installed, the system can be connected to the wireless network.
-
Changes to some configuration files will be necessary, so remount the root filesystem with read and write permissions.
root
@
ipac9x25
:
~
#
mount -o remount,rw /
-
Wireless networks can be found using the scan option of
iw
.root
@
ipac9x25
:
~
#
iw dev wlan0 scan
- A detailed list of the nearby networks will be printed out to the terminal. To identify the SSIDs and respective signal strengths of the network(s) more easily, pipe the output of the
iw scan
command throughgrep
to scan for the keywords "SSID" or "signal". The closer the value of the signal strength is to 0, the stronger the connection.
root
@
ipac9x25
:
~
#
iw dev wlan0 scan | grep SSID
- SSID: EMAC-A
root
@
ipac9x25
:
~
#
iw dev wlan0 scan | grep signal
- signal: -78.00dBm
root
@
ipac9x25
:
~
#
WARNING! Did you forget to add the greps to the above commands? Oh wait, no, you stumbled across a gotcha in the wiki syntax. You can see several examples of how I worked around this by looking at the source, here: http://wikidev.emacinc.com/wiki/Opkg#Finding_Packages_to_Install
The/etc/wpa_supplicant.conf
file will need to be modified to provide the necessary connection information, the details of which depend upon the type of encryption used for the wireless network.
- A detailed list of the nearby networks will be printed out to the terminal. To identify the SSIDs and respective signal strengths of the network(s) more easily, pipe the output of the
-
For an open network, uncomment the following lines in
/etc/wpa_supplicant.conf
and fill in the correct SSID for the network to which the machine should connect.###open network #network={ # ssid="SSID" # scan_ssid=1 # key_mgmt=NONE #}
-
Networks protected by either WEP or WPA2 encryption will need a pre-shared key (PSK), which is generated for the specific network and its password. To get the PSK, use
wpa_passphrase
with the SSID and password for the desired network as arguments and redirect the output to a new file,/etc/wpa_supplicant.conf
. Note: if this file already exists, it will be overwritten by this command; you may want to back it up first.root
@
ipac9x25
:
~
#
wpa_passphrase SSID Password > /etc/wpa_supplicant.conf
root
@
ipac9x25
:
~
#
-
The contents of the
/etc/wpa_supplicant.conf
should now look similar to the following:root
@
ipac9x25
:
~
#
cat /etc/wpa_supplicant.conf
network={
- ssid="SSID"
#psk
="Password"- psk=b99d2c0fb66194f93ad52b71051e1095dc76e12529321334b3feb18332608eb7
}
root
@
ipac9x25
:
~
#
-
The
root
@
som9x25
:
~
#
/etc/init.d/wpa_supplicant start
command will attempt to establish a connection with the network.- As the command is running, watch the terminal output for the status of the connection. A connection has been established when output stops and the last line reads:
IPv6 ADDRCONF(NETDEV_CHANGE):wlan0: link becomes ready
- A connection has failed if output to the terminal continues and the following line is seen repeatedly:
IPv6: ADDRCONF(NETDEV_UP):wlan0: link is not ready
- Successful connection (waiting a full minute to ensure output to the terminal stopped);
root
@
ipac9x25
:
~
#
/etc/init.d/wpa-supplicant start
Successfully initialized wpa_supplicant
rfkill: Cannot open RFKILL control device
root
@
ipac9x25
:
~
#
wlan0: authenticate with 1c:7e:e5:40:10:fd
wlan0: send auth to 1c:7e:e5:40:10:fd (try 1/3)
wlan0: send auth to 1c:7e:e5:40:10:fd (try 2/3)
wlan0: authenticated
wlan0: associating with AP with corrupt beacon
wlan0: associate with 1c:7e:e5:40:10:fd (try 1/3)
wlan0: RX AssocResp from 1c:7e:e5:40:10:fd (capab=0x431 status=0 aid=6)
wlan0: associated
IPv6: ADDRCONF(NETDEV_CHANGE): wlan0: link becomes ready- Failed connection (waiting more than a minute as output continues to print to the terminal). The repeated lines indicate an issue establishing the connection.
root
@
ipac9x25
:
~
#
/etc/init.d/wpa-supplicant start
Successfully initialized wpa_supplicant IPv6: ADDRCONF(NETDEV_UP): wlan0: link is not ready
root
@
ipac9x25
:
~
#
IPv6: ADDRCONF(NETDEV_CHANGE): wlan0: link becomes ready
cfg80211: Calling CRDA to update world regulatory domain
IPv6: ADDRCONF(NETDEV_CHANGE): wlan0: link becomes ready
cfg80211: Calling CRDA to update world regulatory domain
IPv6: ADDRCONF(NETDEV_UP): wlan0: link is not ready
IPv6: ADDRCONF(NETDEV_CHANGE): wlan0: link becomes ready
cfg80211: Calling CRDA to update world regulatory domain
IPv6: ADDRCONF(NETDEV_UP): wlan0: link is not ready
IPv6: ADDRCONF(NETDEV_CHANGE): wlan0: link becomes ready
cfg80211: Calling CRDA to update world regulatory domain
IPv6: ADDRCONF(NETDEV_UP): wlan0: link is not ready
IPv6: ADDRCONF(NETDEV_CHANGE): wlan0: link becomes ready
cfg80211: Calling CRDA to update world regulatory domain
IPv6: ADDRCONF(NETDEV_UP): wlan0: link is not ready
IPv6: ADDRCONF(NETDEV_CHANGE): wlan0: link becomes ready
cfg80211: Calling CRDA to update world regulatory domain
IPv6: ADDRCONF(NETDEV_UP): wlan0: link is not ready
IPv6: ADDRCONF(NETDEV_CHANGE): wlan0: link becomes ready
cfg80211: Calling CRDA to update world regulatory domain
IPv6: ADDRCONF(NETDEV_UP): wlan0: link is not ready
- A failed connection is likely the result of an improper password. Use
wpa_passphrase
to make sure you have the right psk for the password.
-
The
ifconfig
command will be used to determine that the device is wirelessly connected to the network. Look to see thatwlan0
has an IP address.
wlan0 Link encap:Ethernet HWaddr A8:54:B2:42:89:8D
- inet addr:10.0.4.148 Bcast:10.0.255.255 Mask:255.255.0.0
- UP BROADCAST RUNNING MULTICAST MTU:1500 METRIC:1
- RX packets:3395 errors:0 dropped:6 overruns:0 frame:0
- TX packets:60 errors:0 dropped:0 overruns:0 carrier:0
- collisions:0 txqueuelen:1000
- RX bytes:346619 (338.4 KiB) TX bytes:6318 (6.1 Kib)
- inet addr:10.0.4.148 Bcast:10.0.255.255 Mask:255.255.0.0
-
Disconnect any physical connections from the system and ping to www.emacinc.com to verify that the system can wirelessly connect to the Internet.
root
@
ipac9x25
:
~
#
ping -c www.emacinc.com
PING www.emacinc.com (172.16.0.10): 56 data bytes
64 bytes from 172.16.0.10: seq=0 ttl=63 time=1.910 ms
64 bytes from 172.16.0.10: seq=1 ttl=63 time=1.748 ms
64 bytes from 172.16.0.10: seq=2 ttl=63 time=2.061 ms
--- www.emacinc.com ping statistics ---
3 packets transmitted, 3 packets received, 0% packet loss
round-trip min/avg/max = 1.748/1.906/2.061 msroot
@
ipac9x25
:
~
#
WARNING! |
Adding troubleshooting steps, such as checking /etc/resolv.conf to see what DNS server(s) were provided from the DHCP server, and inspecting the routing table, would be beneficial. |
Conclusion
This page walks through the procedure to connect a machine to a wireless network via a USB Wifi adapter or built-in wireless, as well as acquiring the necessary software tools to make the connection for the first time. While there are plenty of USB wireless adapters available for sale, we used an adapter intended for use on Linux machines with a driver supported by the EMAC OE SDK. Other USB wireless adapters may be used to connect EMAC devices to wireless networks, but they will often face issues with driver support or other compatibility issues. We recommend using a USB adapter from ThinkPenguin.
WARNING! |
Should we really recommend buying an adapter from a 3rd party? This is generally not a good business practice. Eric? |
After connecting to a network the first time, the system will be able to connect to the same network when rebooted or powered on. Connecting to a new network will require going through the procedures set out under the Wireless Networking section.
WARNING! |
The moreinfo template section should be filled in with links to other articles we have on networking, since other articles do apply. |