Those who wish to use a pure JS Luci (test version):
Due to popular demand, QModem has introduced a pure JS Luci frontend, which eliminates the dependency on luci-compat and reduces many compatibility issues after Luci 21.
- Update feeds and install the newly added packages.
- Navigate to Luci -> Application -> luci-app-qmodem.
- Remove luci-app-qmodem and luci-app-qmodem-sms/mwam/ttl, etc.
- Select luci-app-qmodem-next.
- Optimized the dial-up configuration interface, redesigned the display logic for dial-up logs and status.
- Improved SMS functionality, currently not split into a separate feature. SMS is presented in a dialog box, automatically exported to the router's file system, and supports recording sent messages.
- Enhanced the AT debugging and advanced module functionality interface.
- Improved all settings interfaces.
- Used scripts + AI to extract translatable strings, significantly improving translation coverage.
- SMS forwarding: Read messages are also forwarded.
- Feature removal: MWAN and TTL features are indefinitely removed in this version.
- SMS stability: To save development time, the current SMS backend implementation is relatively simple, using JSON as the database.
- SMS management: Does not support setting SMS storage location or deleting SMS in the UI. Only automatic deletion is available.
- SMS display: Known issue: SMS concatenation is based on timestamp + reference ID, but due to unreliable timestamps provided by some operators and modules, long messages cannot be concatenated correctly.
The ATD (AT Daemon) on the modem side is a legacy design with inconsistent implementations across different vendors, resulting in poor compatibility, concurrency issues, incomplete responses, and unstable service behavior. When using WebUI and QModem (or multiple modem management plugins) simultaneously, concurrent AT command execution can lead to incomplete information, ATD service crashes (typically due to vendor implementation issues), garbled output, AT command timeouts, and modem disconnections.
For Users: Choose one modem management solution and avoid using multiple plugins simultaneously.
For WebUI Developers: Consider using the ubus ATD plugin instead of relying on the modem's built-in ATD service. Reference Documentation
中文 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.
Looking to monitor your OpenWrt router and QModem status from Home Assistant? Check out our companion project:
A custom Home Assistant integration that connects to OpenWrt routers via the ubus interface, providing:
- 📱 Device Tracking: Monitor wireless devices and DHCP clients in real-time
- 📊 System Monitoring: Track uptime, load averages, memory usage
- 📡 QModem Support: Monitor 4G/LTE modem status, signal strength, and connection details
- 📶 Wireless Stations: Track station associations and signal information
- 🔧 Easy Setup: Simple configuration through Home Assistant UI
Perfect for integrating your QModem-powered OpenWrt router into your smart home ecosystem!
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: