/rtl88x2cu

Primary LanguageCGNU General Public License v3.0GPL-3.0

REALTEK RTL88x2C USB Linux Driver

Current Driver Version: 5.12.1
Supported Kernels: 2.3-6.8

Table of Contents

  1. Introduction
  2. Features
  3. Requirements
  4. Installation
  5. Usage
  6. Troubleshooting
  7. Contributing
  8. License
  9. Acknowledgements

Introduction

This repository contains the Linux driver for the Realtek RTL88x2CU chipset, with Injection and Monitor Mode support. It's ported to the latest kernel's and will be maintained by OpenHD.

Features

  • Compatibility: TBD

Requirements

  • Linux Kernel: >2.3
  • Build Tools: make, gcc, and other standard build tools.

Installation

To install the driver, follow these steps:

  1. Clone the Repository:

    git clone https://github.com/openhd/rtl88x2cu
cd rtl88x2cu

  2. Build and Install the Driver:

    make
sudo make install
sudo modprobe 88x2cu_ohd

Usage

Once the driver is installed, plug in your Realtek RTL88x2CU USB wireless adapter. The system should recognize the device, and you can manage wireless connections through your network manager.

Troubleshooting

  • Device Not Recognized: Ensure the driver is correctly installed and loaded: 
    sudo modprobe 88x2cu_ohd
dmesg | grep 88x2cu_ohd
  • Build Errors: Verify that all build dependencies are installed and that your kernel headers match your running kernel.

Contributing

Contributions are welcome! To contribute:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature-branch).
  3. Make your changes and commit them (git commit -m 'Add new feature').
  4. Push to the branch (git push origin feature-branch).
  5. Open a Pull Request.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

Acknowledgements

Special thanks to Realtek for providing the original driver source. This project builds upon their efforts to improve compatibility and performance for Linux users.