Update readme.

master
Fomalhaut Weisszwerg 2017-11-18 01:54:18 +09:00
parent 7ca91baad5
commit 249c3416f8
2 changed files with 50 additions and 23 deletions

View File

@ -1,45 +1,72 @@
<u>**8822BU for Linux**</u>
# Reaktek 8822BU driver for Linux
Driver for 802.11ac USB Adapter with
RTL8822BU chipset
Only STA/Monitor Mode is supported, no AP.
Driver for 802.11ac USB Adapter with RTL8822BU chipset.
Currently, only STA/Monitor Mode is supported, no AP.
A few known wireless cards that use this driver include
* [Edimax EW-7822ULC](http://us.edimax.com/edimax/merchandise/merchandise_detail/data/edimax/us/wireless_adapters_ac1200_dual-band/ew-7822ulc/)
* [ASUS AC-53 NANO](https://www.asus.com/Networking/USB-AC53-Nano/)
> NOTE: At least v4.7 is needed to compile this module
> sorry people with older kernels, the code is removed.
> Upon request I can work towards making it backwards compatible.
## Prerequisite
On Debian and Ubuntu, install packages via apt:
```
$ sudo apt install dpkg-dev
$ sudo apt install build-essential libc6-dev linux-headers-`dpkg-architecture -qDEB_HOST_ARCH`
```
If you use the other distros, consult your distro how to install the kernel sources and build an <u>external</u> module. And it would be appriciated if you would tell me the way.
## Build and install.
Currently tested with Linux kernel 4.13.10 on X86_64 platform **only**.
For compiling type
`make`
in source dir
To do complete build, you have to retrieve source and run `make`.
If via Git, do following:
To install the firmware files
`sudo make install`
```sh
$ git clone https://github.com/FomalhautWeisszwerg/rtl8822bu.git
$ cd rtl8822bu
$ make
$ sudo make
```
Or via tarball, do:
```sh
$ curl -LO https://github.com/FomalhautWeisszwerg/rtl8822bu/archive/release-for-linux-4.13.tar.gz
$ tar -xf release-for-linux-4.13.tar.gz
$ cd rtl8822bu-release-for-linux-4.13/
$ make
$ sudo make install
```
To Unload driver you may need to disconnect the device.
To Unload driver you may need to disconnect the device
### NOTES
If the driver fails building consult your distro how to
install the kernel sources and build an <u>external</u> module.
**NOTES**
This driver allows use of wpa_supplicant by using the nl80211 driver
`wpa_supplicant -Dnl80211`
`wpa_supplicant -Dnl80211`. If you use "Wicd Network Manager", you can use this driver with the following screenshot settings.
<img src="./image/wicd_networkmanager_setting.png" height="317" width="425">
If installing on Rasberry Pi or other "armv71" devices, edit the Makefile and set `CONFIG_PLATFORM_ARM_RPI = y` and `CONFIG_PLATFORM_I386_PC = n`
**STATUS**
## Status
Driver basically works.
Most of the work is done is cleaning the driver and make this mess **readable** for conversion.
Updates for wireless-ext/cfg80211 are not accepted.
**BUGS**
## Bugs
If you find something, please report on [GitHub issue](https://github.com/FomalhautWeisszwerg/rtl8822bu/issues).
Also Pull Requests are wellcome :-)

Binary file not shown.

After

Width:  |  Height:  |  Size: 86 KiB