中文 README | English README
QModem is a comprehensive cellular modem management system for OpenWRT-based routers. It provides a LuCI-based web interface for easy administration and advanced control over various cellular modems.
This project aims to provide a stable, extensible, and user-friendly solution for integrating cellular connectivity into OpenWRT.
- Broad Hardware Support: Manages a wide range of USB and PCIe cellular modems from vendors like Quectel, Fibocom, and more.
- Intuitive Web Interface: A clean LuCI interface for at-a-glance status monitoring and configuration.
- Advanced Modem Control: Fine-tune your connection with features like band locking, cell locking, and network mode selection.
- SMS and Multi-WAN: Includes optional plugins for sending/receiving SMS and configuring multi-WAN failover/load balancing.
- Robust and Stable: Designed for reliability with features like slot-based device binding and optimized AT command handling.
For a complete list of features and capabilities, please see the User Guide.
To install QModem, add the custom feed to your OpenWRT build environment and select the luci-app-qmodem packages in make menuconfig.
For detailed, step-by-step installation instructions, please refer to the Installation Guide.
Once installed, QModem can be configured through the LuCI web interface under the "Network" -> "QModem" menu.
For a complete walkthrough of the web interface and all configuration options, please see the User Guide.
This project maintains comprehensive documentation to help users and developers.
- User Guide: The primary document for users. It covers installation, configuration, and all features of the web interface.
- Developer Guide: For those who want to contribute, adapt a new modem, or understand the inner workings of the project. It details the project structure, core scripts, and adaptation process.
- Supported Hardware List: A list of modems known to be compatible with QModem.
Contributions are welcome! Whether it's adding support for a new modem, fixing a bug, or improving the documentation, your help is appreciated.
Please start by reading the Developer Guide to understand the project's structure and how to get started.
This project is licensed under the Mozilla Public License Version 2.0. Please see the LICENSE file for full details.
Documentation Notice: This documentation is AI-generated. We welcome community contributions to update and improve it based on real-world usage experience.
Note: Commercial use of this software is strictly prohibited without prior permission.
This project builds upon the work of several other open-source projects and communities. We extend our thanks to the developers and contributors of: