zhao/QModem
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update readme

Browse Source
This commit is contained in:
fujr 2025-04-24 21:35:31 +08:00
parent c4ebb71bc7
commit fca06a247b
2 changed files with 67 additions and 56 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
README.en.md
View File

@ -1,10 +1,14 @@
# QModem # QModem
[![Auto compile with OpenWrt SDK](https://github.com/FUjr/modem_feeds/actions/workflows/main.yml/badge.svg)](https://github.com/FUjr/modem_feeds/actions/workflows/main.yml)
QModem is a module management plugin compatible with OpenWRT version 21 and later. Developed in Lua, it is compatible with QWRT/LEDE/Immortalwrt/OpenWRT. QModem is a module management plugin compatible with OpenWRT version 21 and later. Developed in Lua, it is compatible with QWRT/LEDE/Immortalwrt/OpenWRT.
(For js luci, please add the luci-compat package.) (For js luci, please add the luci-compat package.)
[TOC] [Support List](./docs/support_list.md)
[toc]
# Quick Start # Quick Start
@ -14,15 +18,15 @@ To use QModem, you first need to add a feed source in OpenWRT:
```shell ```shell
echo >> feeds.conf.default echo >> feeds.conf.default
echo 'src-git modem https://github.com/FUjr/modem_feeds.git;main' >> feeds.conf.default echo 'src-git modem https://github.com/FUjr/QModem.git;main' >> feeds.conf.default
./scripts/feeds update modem ./scripts/feeds update qmodem
./scripts/feeds install -a -p modem ./scripts/feeds install -a -p qmodem
``` ```
Force update library drivers (use this library's drivers): Force update library drivers (use this library's drivers):
```shell ```shell
./scripts/feeds install -a -f -p modem ./scripts/feeds install -a -f -p qmodem
``` ```
## Integrate Packages ## Integrate Packages
@ -37,8 +41,9 @@ make menuconfig
In the configuration menu, you can select the following packages (all under Luci/Application): In the configuration menu, you can select the following packages (all under Luci/Application):
| Package Name | Functionality | | Package Name | Functionality |
| ------------------------------------- | :---------------------------------------: | | ------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| **luci-app-qmodem** | Provides module info, dialing settings, and advanced settings. Other features depend on this main program (backend included here). | | **luci-app-qmodem** | Provides module info, dialing settings, and advanced settings. Other features depend on this main program (backend included here). |
| **Add Lua Luci Homepage** | Adds Lua Luci homepage. If using luci2 (Js Luci) and selected, there will be two homepages. | | **Add Lua Luci Homepage** | Adds Lua Luci homepage. If using luci2 (Js Luci) and selected, there will be two homepages. |
| **QMI Driver Selection** | Choose between Generic QMI driver or Vendor QMI driver. | | **QMI Driver Selection** | Choose between Generic QMI driver or Vendor QMI driver. |
@ -103,19 +108,21 @@ Provides global configuration options for unified module settings.
This page is the **MWAN Configuration** interface, helping users manage multiple WAN connections by monitoring specific IPs to ensure network stability and reliability. Users can customize connection priorities and interfaces for load balancing or failover. This page is the **MWAN Configuration** interface, helping users manage multiple WAN connections by monitoring specific IPs to ensure network stability and reliability. Users can customize connection priorities and interfaces for load balancing or failover.
| Feature | Description | | Feature | Description |
|---------------------|--------------------------------------------------------------------| | ---------------------- | ----------------------------------------------------------------------------- |
| **Enable MWAN** | | | **Enable MWAN** | |
| Same Source Address | Ensures traffic from the same source uses the same WAN port for a set time. | | Same Source Address | Ensures traffic from the same source uses the same WAN port for a set time. |
| **IPv4 Configuration** | | | **IPv4 Configuration** | |
| Interface | Select WAN interfaces (e.g., `wan`, `usb0`) for different network connections. | | Interface | Select WAN interfaces (e.g.,`wan`, `usb0`) for different network connections. |
| Tracking IP | Enter specific IP addresses or domain names to monitor. | | Tracking IP | Enter specific IP addresses or domain names to monitor. |
| Priority | Set connection priority (1 to 255); lower values mean higher priority. | | Priority | Set connection priority (1 to 255); lower values mean higher priority. |
## QModem Settings ## QModem Settings
| Configuration | Description | | Configuration | Description |
|------------------------------|--------------------------------------------------------------------| | --------------------------------- | -------------------------------------------------- |
| **Disable Auto-Load/Remove** | Disables all features below. | | **Disable Auto-Load/Remove** | Disables all features below. |
| **Enable PCIe Module Scan** | Scans PCIe interfaces at startup (time-consuming). | | **Enable PCIe Module Scan** | Scans PCIe interfaces at startup (time-consuming). |
| **Enable USB Module Scan** | Scans USB interfaces at startup (time-consuming). | | **Enable USB Module Scan** | Scans USB interfaces at startup (time-consuming). |
@ -126,10 +133,11 @@ This page is the **MWAN Configuration** interface, helping users manage multiple
This page allows users to configure each slot. This page allows users to configure each slot.
| Configuration | Description | | Configuration | Description |
|-------------------------------|--------------------------------------------------------------------| | ------------------------- | ------------------------------------------------------------------------------- |
| **Slot Type** | Choose the slot type (PCIe/USB) for device identification. | | **Slot Type** | Choose the slot type (PCIe/USB) for device identification. |
| **Slot ID** | Enter the device's unique identifier (e.g., `0001:11:00.0[pcie]`). | | **Slot ID** | Enter the device's unique identifier (e.g.,`0001:11:00.0[pcie]`). |
| **SIM Card Indicator** | Bind slot to corresponding indicator light for SIM card status. | | **SIM Card Indicator** | Bind slot to corresponding indicator light for SIM card status. |
| **Network Indicator** | Bind slot to network status indicator for monitoring connection status. | | **Network Indicator** | Bind slot to network status indicator for monitoring connection status. |
| **Enable 5G to Ethernet** | Enables communication via network interface for supported modules. | | **Enable 5G to Ethernet** | Enables communication via network interface for supported modules. |
@ -142,8 +150,9 @@ The configuration introduces `post_init` and `pre_dial` options, allowing users
## Development Plan ## Development Plan
| Plan | Progress | | Plan | Progress |
|-------------------------------------------|----------------------| | ------------------------------------------- | -------- |
| Separate backend from luci-app completely | 0% | | Separate backend from luci-app completely | 0% |
| Switch to js luci | 5% | | Switch to js luci | 5% |
| Support more modules | 0% | | Support more modules | 0% |
@ -157,8 +166,9 @@ The configuration introduces `post_init` and `pre_dial` options, allowing users
During the development of the module management plugin, the following repositories were referenced: During the development of the module management plugin, the following repositories were referenced:
| Project | Reference Content | | Project | Reference Content |
|--------------------------------------------|-----------------------------------------| | -------------------------------------------- | --------------------------------------- |
| https://github.com/Siriling/5G-Modem-Support | Module list and some AT implementations | | https://github.com/Siriling/5G-Modem-Support | Module list and some AT implementations |
| https://github.com/fujr/luci-app-4gmodem | Adopted many ideas from this project | | https://github.com/fujr/luci-app-4gmodem | Adopted many ideas from this project |
| https://github.com/obsy/sms_tool | AT command sending tool | | https://github.com/obsy/sms_tool | AT command sending tool |

9
README.md
View File

@ -1,5 +1,6 @@
# QModem # QModem
[![Auto compile with OpenWrt SDK](https://github.com/FUjr/modem_feeds/actions/workflows/main.yml/badge.svg)](https://github.com/FUjr/modem_feeds/actions/workflows/main.yml) [![Auto compile with OpenWrt SDK](https://github.com/FUjr/modem_feeds/actions/workflows/main.yml/badge.svg)](https://github.com/FUjr/modem_feeds/actions/workflows/main.yml)
以前我在github上抄代码，作者跟我说点个star，我都会说好好好，但是编译完了刷机后也没想起来点star，其实这样挺不好的。 以前我在github上抄代码，作者跟我说点个star，我都会说好好好，但是编译完了刷机后也没想起来点star，其实这样挺不好的。
现在作者跟我说点个star，除非代码真的很好到我想打好评的程度，否则我就会在issue直接说，抱歉我不想star，然后直接抄。作为一个有讨好倾向的人，这就是我锻炼真诚和勇气的方式 现在作者跟我说点个star，除非代码真的很好到我想打好评的程度，否则我就会在issue直接说，抱歉我不想star，然后直接抄。作为一个有讨好倾向的人，这就是我锻炼真诚和勇气的方式
@ -21,15 +22,15 @@
```shell ```shell
echo >> feeds.conf.default echo >> feeds.conf.default
echo 'src-git modem https://github.com/FUjr/modem_feeds.git;main' >> feeds.conf.default echo 'src-git modem https://github.com/FUjr/QModem.git;main' >> feeds.conf.default
./scripts/feeds update modem ./scripts/feeds update qmodem
./scripts/feeds install -a -p modem ./scripts/feeds install -a -p qmodem
``` ```
强制更新库驱动 (使用本库驱动): 强制更新库驱动 (使用本库驱动):
```shell ```shell
./scripts/feeds install -a -f -p modem ./scripts/feeds install -a -f -p qmodem
``` ```
## 集成软件包 ## 集成软件包