{"id":20201030,"url":"https://github.com/kimocoder/rtw88-usb","last_synced_at":"2025-08-23T05:05:43.417Z","repository":{"id":45083376,"uuid":"325615723","full_name":"kimocoder/rtw88-usb","owner":"kimocoder","description":"8723d 8821c 8822bu 8812bu 8822cu 8812cu linux mac80211 driver","archived":false,"fork":false,"pushed_at":"2024-04-01T14:57:34.000Z","size":1760,"stargazers_count":48,"open_issues_count":6,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-08-23T05:04:32.890Z","etag":null,"topics":["driver","kernel","linux-kernel","realtek","wifi"],"latest_commit_sha":null,"homepage":"http://www.aircrack-ng.org","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kimocoder.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-30T18:01:10.000Z","updated_at":"2025-08-09T01:49:25.000Z","dependencies_parsed_at":"2025-04-10T11:40:26.632Z","dependency_job_id":null,"html_url":"https://github.com/kimocoder/rtw88-usb","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/kimocoder/rtw88-usb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimocoder%2Frtw88-usb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimocoder%2Frtw88-usb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimocoder%2Frtw88-usb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimocoder%2Frtw88-usb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kimocoder","download_url":"https://codeload.github.com/kimocoder/rtw88-usb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimocoder%2Frtw88-usb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271745472,"owners_count":24813499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["driver","kernel","linux-kernel","realtek","wifi"],"created_at":"2024-11-14T04:46:32.972Z","updated_at":"2025-08-23T05:05:43.389Z","avatar_url":"https://github.com/kimocoder.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rtw88-usb\n\nIt's under GPL license, and please feel free to use it.\nAlso welcome to upstream to the Linux kernel if you want, and please\nrefer to the branch, for_kernel_upstream, which meets the Linux coding\nstyle, and may be easier to upstream.\n\nThank to many people's kind help on this project. \n\nDriver for 802.11ac USB Adapter with chipset:\n  RTL88x2BU / RTL88x2CU\n\nsupports at least managed (i.e. client) and monitor mode.\n\nThis driver is based on Realtek's [rtw88 driver](https://github.com/torvalds/linux/tree/master/drivers/net/wireless/realtek/rtw88) in Linux main trunk.\n\n\nA few known wireless cards that use this driver include \n* [ASUS AC-53 NANO](https://www.asus.com/Networking/USB-AC53-Nano/)\n* [ASUS AC-55 (B1) AC1300](https://www.asus.com/Networking/USB-AC55-B1/)\n* [Edimax EW-7822ULC](http://us.edimax.com/edimax/merchandise/merchandise_detail/data/edimax/us/wireless_adapters_ac1200_dual-band/ew-7822ulc/)\n* [Netgear AC6150](http:/netgear.com/support/product/A6150.aspx)\n* [TPLink Archer T4U v3](https://www.tp-link.com/tw/support/download/archer-t4u/)\n\n\n## Build\n\n```console\n$ make clean\n$ make\n```\n\n## Installation\n\nLoad driver for test:\n```console\n$ sudo mkdir -p /lib/firmware/rtw88\n$ sudo cp fw/rtw8822* /lib/firmware/rtw88/\n$ sudo insmod rtw88.ko\n$ sudo insmod rtwusb.ko\n```\nLoad driver at boot:\n```console\n$ sudo mkdir -p /lib/firmware/rtw88\n$ sudo cp fw/rtw8822* /lib/firmware/rtw88/\n$ sudo mkdir /lib/modules/`uname -r`/kernel/drivers/net/wireless/realtek/rtw88\n$ sudo cp rtw88.ko /lib/modules/`uname -r`/kernel/drivers/net/wireless/realtek/rtw88\n$ sudo cp rtwusb.ko /lib/modules/`uname -r`/kernel/drivers/net/wireless/realtek/rtw88\n$ sudo depmod -a\n$ sudo echo -e \"rtw88\\nrtwusb\" \u003e /etc/modules-load.d/rtwusb.conf\n$ sudo systemctl start systemd-modules-load\n```\n\n## General Commands\n\nScan:\n```console\n$ sudo iw wlanX scan\n```\nConnect to the AP without security:\n```console\n$ sudo iw wlanX connect \u003cAP name\u003e\n```\n## Wifi Sniffer - monitor mode\n```console\n$ sudo ip link set wlanX down\n$ sudo iw dev wlanX set type monitor\n$ sudo rfkill unblock all\n$ sudo ip link set wlanX up\n```\n\nThen you can use \"iw \u003cdevice\u003e info\" to check if the wireless mode is correct.\n```console\ne.g.\n    wlan1    IEEE 802.11  Mode:Monitor ... \n```\n\nAnd you can use the program like wireshark to sniffer wifi packets.\n1. set up the sniffer channel\n```console\n$ sudo iw dev wlanX set channel xxx\n```\n\n2. run the program\n```console\n$ sudo wireshark\n```\n\n## Test\ntest ok with general commands with the latest kernel\nubuntu 18 + kernel v5.3 test with Network Manager ok. \n\n## Known Issues\n\n* None atm. Need to checkpatch and clean some code only.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimocoder%2Frtw88-usb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkimocoder%2Frtw88-usb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimocoder%2Frtw88-usb/lists"}