Difference between revisions of "Wireless Testing"

From PC-BSD Wiki
Jump to: navigation, search
Line 1: Line 1:
{{NavHome|url=Main Page}}

Revision as of 00:09, 6 November 2013


This area of the wiki is for those who wish to assist by reporting non-working wireless drivers or by testing new drivers. Both reporting and testing provides valuable information to the developers of wireless drivers. It also helps to ensure that PC-BSD® and FreeBSD provide support for the wireless devices used by their users.

This page contains four tables:

  • Table 1: devices in this table do not have a FreeBSD driver yet. If your device requires you to run the ndisgen script to convert a Windows driver to a FreeBSD driver module, it belongs in this table. Such devices use ndis(4) as their driver name. The goal of this table is to determine which devices need a native FreeBSD driver.
  • Table 2: devices in this table already have a FreeBSD driver, but there are problems with the driver e.g. certain features are unavailable or the driver crashes. The goal of this table is to provide information to developers so the driver can be fixed. This means that you should reference any existing PRs or other URLs containing a description of the problem. If a PR does not exist, consider submitting one; information on how to submit a useful PR can be found at Writing FreeBSD Problem Reports[1].
  • Table 3: devices in this table have a working FreeBSD driver, making it a quick reference to determine if a device is supported. If your device works and is not in the table, take a minute to create a wiki login account and add an entry for your device.
  • Table 4: devices in this table have users who desire support but lack a FreeBSD driver.

If your wireless device is not supported and is not listed in Table 1, please create a wiki account and add it. However, please do a little bit of research first:

  • Perform a web search for the name of the device and the word FreeBSD (for example, "freebsd broadcom 5709"). This should give you a good idea if the driver already exists--and if so, the name of the driver--or if other FreeBSD users have had problems getting their device to work.
  • If you are not sure of the name and model of your internal device, try this command: pciconf -lv | grep -i wireless. If the device is USB, try usbconfig dump_all_config_desc.
  • If a FreeBSD driver does not exist, download a Windows driver for the device, run the interactive script ndisgen as the superuser, and see if you can successfully use the generated driver module. Add the results for your architecture (i386 or amd64) to Table 1.
  • NDIS 6.X API is currently not supported. In practical terms, this means that you should only try it on XP and 2003 drivers. Make sure you download and try to convert the correct driver for your architecture (32 or 64 bit). If you would like to help test the most recent version of ndisgen, follow these instructions[2].
  • Report of a faulty situation caused by the ndisgen process.
    Description: Wireless is active, but when trying to connect to the network, the screen goes dark and the system stops responding. The black screen can be removed by restarting, but after reboot PC-BSD® does not enter the boot loader section. The system shows a prompt FreeBSD (Amnesia mode).
    Likely solution: FreeBSD problem report and patch[3] for "Unregistered use of FPU in kernel" panic caused by miniport driver adapted via ndisgen.

Wireless Devices Needing Drivers: Does ndisgen Work for this Device?

Table 1. ndisgen Functionality [tables 1]
Device Name i386 amd64 Comments
BCM4310 NO
BCM4313 YES YES 1. Download the WinXP (BCM43xx[5] driver,
2. add bcmwl5.inf and bcmwl5.sys (bcmwl564.sys if using the amd64 version of FreeBSD) as driver files and both bcm43xx.cat (bcm43xx64.cat for amd64) and bcmwlcoi.dll (bcmwlcoi64.dll for amd64) as firmware files (this is important, if you do not add them through the ndisgen interface you will get a kernel panic as soon as you kldload the bcmwl5_sys.ko or bcmwl564_sys.ko file),
3. move all the generated *.ko files to /boot/modules,
4. add
to your /etc/rc.conf
ifconfig_wlan0="WPA SYNCDHCP"
for amd64 users),

5. add
to your /boot/loader.conf,

6. add your wpa_supplicant.conf file to /etc and finally reboot the PC to get the drivers loaded and interfaces created.
RTL8185 YES YES Try Me driver instead of XP. Use XP driver version 1.10. Should be about 280 KiB in size. Must manually load driver. Placing it in /boot/loader.conf did not initialize device. As far as I have tested it fully works. You may have to manually configure it as well. The graphical network manager did not work for me. (More info in discussion). Just finished setting up amd64 system. XP64 driver version 1.10 does work (using it now). Follow same procedures as i386 driver.
RT3062 YES Not tested Appears to be working, but not fully functional. Have had an issue where sometimes it will not connect on boot and I've had to reboot. Also it has serious issues with uploading. Using this driver[6] Needs updated information/link.
RTL8191SE YES NO driver Vistax64: ndisgen generates rtl8192se_sys.ko . kernel load it , but module isn't used. pciconf -lv output :

none7@pci0:10:0:0:class=0x028000 card=0x818110ec chip=0x817210ec rev=0x10 hdr=0x00
vendor = 'Realtek Semiconductor'
device = 'Realtek RTL8191SE wireless LAN 802.11N PCI-E NIC (RTL8191SE ?)'
class = network

Vista drivers are not XP drivers and will not work.

RTL8187SE YES NO Not kldload if_ndis, says the archive already exists. PC-BSD® (x86) is restarted after kldload rtl8187Se_sys.ko from Windows XP driver. The wireless continue to not function.
RTL8192SE YES YES, in 8.2 use the the Windows XP driver

If a driver exists for your wireless device but the driver does not work well, add a description of the problem to Table 2. Take a minute to query the PR database[7] and add the PR number if one exists.

Wireless Drivers That Need Improvement

Table 2. Faulty Existing Drivers [tables 2]
Driver Name i386 amd64 PR Number Comments
rum X X Some chip revisions have problems with poor signal strength if distance from AP is medium to high.
wpi Known issue in 8.2 (pr#143874[8]). Updating src and rebuilding kernel as per that link or upgrading to 9.0 fixes issue.

Table 3 provides a handy resource for checking to see if your wireless driver is known to work on FreeBSD and PC-BSD®. Devices should be added alphabetically (then numerically). Only add devices that you have successfully used (e.g. do not add devices that "should" work according to the driver man page).

Wireless Devices Known to Work

Table 3. Functional Wireless Devices [tables 3]
Device Name Driver i386 amd64 Comments
AR5001 ath YES
AR9285 ath YES YES works in 9.1
Belkin 54G (F5D7050) rum YES external USB
Broadcom Corporation Dell Wireless 1390 WLAN Mini-PCI Card (BCM4311) bwn YES YES Works in 8.1 or later, only station, adhoc-demo and monitor mode is currently supported. Must install net/bwn-firmware-kmod port. Not the bwi-firmware-kmod. 8.1 users may need to modify /usr/src/sys/kern/subr_firmware.c to read FIRMWARE_MAX 50 and recompile their kernel; this is not necessary in 8.2 or higher.
Broadcom 802.11b/g (BCM4318) bwn YES YES Same as above
Intel 5100AGN iwn Should work in 8.1 or later
Intel 6205a iwn Works in 9.0. Instructions for 8.2 at backporting-intel-prowireless-6205a[9]
Intel Centrino Advanced-N 6230 iwn Should work in 8.3 and later
RLT8187B urtw Should work in 8.0 or later

Devices that need a FreeBSD driver

Table 4. Interfaces Without Drivers [tables 4]
Device Name Driver Sources/Notes
AR9287 committed to HEAD May 26/11
BCM4321 bwn(4) needs support for N PHYs
BCM43224 brcm80211[10]
BCM43225 brcm80211[10]
BCM4313 brcm80211[10]
DW1501 Its actually a BCM4313, PCI Id. 0x4727, thus same driver at brcm80211[10]
RT2760T does not seem to have a blob for Linux yet
RT2860 forum thread 13722[11]
RT5390 Phoronix news item: open sourced in 2/11[12]
RTL8188CE OpenBSD uses urtwn

Additional Information

Mobile Broadband provider info[13]


  1. http://www.freebsd.org/doc/en/articles/problem-reports/article.html
  2. http://blog.pcbsd.org/2010/11/looking-for-ndis-testers-freebsd-and-pc-bsd/
  3. http://www.freebsd.org/cgi/query-pr.cgi?pr=165622&sourceid=opensearch
  4. http://people.freebsd.org/~bschmidt/iwi/
  5. http://dl.dropbox.com/u/1101857/%5Bwikidrivers.com%5D%20Broadcom_BCM43xx_5.100.235.19_win5x.exe
  6. http://zonetusa.net/media/import/ZEW16X2_DRxp.zipL
  7. http://www.freebsd.org/cgi/query-pr-summary.cgi?query
  8. http://www.freebsd.org/cgi/query-pr.cgi?pr=143874
  9. http://blog.cochard.me/2011/08/backporting-intel-prowireless-6205a.html
  10. 10.0 10.1 10.2 10.3 http://wireless.kernel.org/en/users/Drivers/brcm80211
  11. http://forums.pcbsd.org/showthread.php?t=13722&page=2
  12. http://www.phoronix.com/scan.php?page=news_item&px=OTA5MA
  13. http://packages.ubuntu.com/precise/mobile-broadband-provider-info

List of Tables

  1. Table 1. ndisgen Functionality
  2. Table 2. Faulty Existing Drivers
  3. Table 3. Functional Wireless Devices
  4. Table 4. Interfaces Without Drivers