Compare commits

...

5 commits

Author SHA1 Message Date
s0me1newithhand7s
0ec36cbfed
README.md: small fixes and additions
Signed-off-by: s0me1newithhand7s <117505144+s0me1newithhand7s@users.noreply.github.com>
2025-09-15 15:44:24 +03:00
s0me1newithhand7s
6cdee3500e
doc/content.md: changed accroding to updates in doc/ directory
Signed-off-by: s0me1newithhand7s <117505144+s0me1newithhand7s@users.noreply.github.com>
2025-09-15 15:44:24 +03:00
s0me1newithhand7s
98820aa894
doc/guides/: init
Signed-off-by: s0me1newithhand7s <117505144+s0me1newithhand7s@users.noreply.github.com>
2025-09-15 15:44:24 +03:00
s0me1newithhand7s
44abdef985
doc/modems/: init
Signed-off-by: s0me1newithhand7s <117505144+s0me1newithhand7s@users.noreply.github.com>
2025-09-15 15:44:24 +03:00
s0me1newithhand7s
878051eae0
doc/cudy/ -> doc/routers/cudy/
Signed-off-by: s0me1newithhand7s <117505144+s0me1newithhand7s@users.noreply.github.com>
2025-09-15 15:44:19 +03:00
10 changed files with 259 additions and 167 deletions

View file

@ -54,9 +54,12 @@ optionally, you can have:
<h2 align="center"> Current Tested Devices </h2>
| Image | Status | Link | Author |
| - | - | - | -|
| <img src="https://www.cudy.com/cdn/shop/files/TR1200.png" width="250"> | Working; Small amount of RAM and not so fast CPU, stable branch; | [Here](./doc/cudy/TR1200.md) | hand7s |
| <img src="https://www.cudy.com/cdn/shop/files/TR3000.png" width="250"> | Working; 128mb revision is preferred since it's on a stable branch; | [Here](./doc/cudy/TR3000.md) | hand7s |
| - | - | - | - |
| <img src="https://www.cudy.com/cdn/shop/files/TR1200.png" width="250"> | Working; Small amount of RAM and not so fast CPU, stable branch; | [Here](./doc/routers/cudy/TR1200.md) | hand7s |
| <img src="https://www.cudy.com/cdn/shop/files/TR3000.png" width="250"> | Working; 128mb revision is preferred since it's on a stable branch; | [Here](./doc/routers/cudy/TR3000.md) | hand7s |
| - | - | - | - |
| <img src="https://www.fibocom.com/uploadfiles/2022/04/20220413101231199.png" width="250"> | Requiers workaround; Cat.9, medoicre speed, any SIM / eSIM works fine | [Here](./doc/modems/l850gl.md) | hand7s |
| <img src="https://cdn.techship.com//uploads/images/1698/10919_190425.png" width="250"> | Requiers workaround; Cat.16, good speed, any SIM / eSIM works fine | [Here](./doc/modems/l850gl.md) | hand7s
<h2 align="center"> Contribution </h2>
@ -64,10 +67,13 @@ to expand list above you need to:
1. create an issue with "add router" template
2. go trough testings (with help from community ofc)
3. fork **this** repo with branch's name of your router, e.g. `xiaomi_ax3200`
4. write an `.md` in `doc/` directory in a respected directory, e.g. `doc/cudy/TR3600.md`
4. write an `.md` in `doc/routers/` directory in a respected directory, e.g. `doc/cudy/TR3600.md`
5. add your router to [this](./doc/content.md) `.md`
6. open a PR!
p.s.
you can init a modem with you router btw
<h2 align="center"> But.. Why? </h2>
this is a healthy question considering whole idea, but you might misunderstood why i've started this in a first place.

View file

@ -1,6 +1,19 @@
<h2 align="center"> Current Tested Devices </h2>
<h1 align="center"> table of content </h1>
1. tested outers in [`doc/routers`](./routers/)
2. tested modedms in [`doc/modems`](./modems/)
3. guides for software in [`doc/guides`](./guides/)
<h2 align="center"> routers </h2>
| Image | Status | Link | Author |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------ | ------ |
| <img src="https://www.cudy.com/cdn/shop/files/TR1200.png" width="250"> | Working; Small amount of RAM and not so fast CPU, stable branch; | [Here](./cudy/TR1200.md) | hand7s |
| <img src="https://www.cudy.com/cdn/shop/files/TR3000.png" width="250"> | Working; 128mb revision is preferred since it's on a stable branch; | [Here](./cudy/TR3000.md) | hand7s |
| <img src="https://www.cudy.com/cdn/shop/files/TR1200.png" width="250"> | Working; Small amount of RAM and not so fast CPU, stable branch; | [Here](./routers/cudy/TR1200.md) | hand7s |
| <img src="https://www.cudy.com/cdn/shop/files/TR3000.png" width="250"> | Working; 128mb revision is preferred since it's on a stable branch; | [Here](./routers/cudy/TR3000.md) | hand7s |
<h2 align="center"> modems </h2>
| Image | Status | Link | Author |
| ----- | ------ | ---- | ------ |
| <img src="https://www.fibocom.com/uploadfiles/2022/04/20220413101231199.png" width="250"> | Requiers workaround; Cat.9, medoicre speed, any SIM / eSIM works fine | [Here](./modems/l850gl.md) | hand7s |
| <img src="https://cdn.techship.com//uploads/images/1698/10919_190425.png" width="250"> | Requiers workaround; Cat.16, good speed, any SIM / eSIM works fine | [Here](./modems/l850gl.md) | hand7s |

View file

@ -1,79 +0,0 @@
<h1 align="center"> Cudy TR1200 </h1>
```Sh
.______ __
| |.--.--.-- | |.--.--.
| ---|| | | _ | || | |
|______||_____|______||___ |
. OpenWrt firmwares |_____|
```
[OpenWRT page](https://openwrt.org/toh/cudy/tr1200)
<img src="https://www.cudy.com/cdn/shop/files/TR1200.png" width="500" align="center">
| Name | Spec |
| --------- | ------------------------------------------- |
| CPU | MediaTek MT7628AN x 1 @ 580 Mhz (MIPS) |
| ROM | 16MB SPI NAND |
| RAM | 128MB DDR3 |
| WLAN | MediaTek MT7613BEN (Wi-Fi 5) |
| UBS | + (2.0) |
| Power | PD 10W via USB Type-C |
| LAN | 2x 1Gpbs MT7628AN |
| Dimension | 15 by 15 by 10 cm |
| | |
## Short Description
entry-level thing:
- only Wi-Fi 5 and 1Gbps
- 10 watts is crazy
- USB 2.0 *might* not be enough for chonky modems
- 16MB of ROM is not enough (u-boot layout might help)
- 1 MIPS core is not enough
- yet, RAM is plenty
- small
## How2
1. OpenWRT Transition
1. update [stock firmware](https://www.cudy.com/pages/download-center/tr3000-1-0) to latest version
2. use special [Cudy Intermediary OpenWRT firmware](https://drive.google.com/drive/folders/1BKVarlwlNxf7uJUtRhuMGUqeCa5KpMnj?usp=sharing&pli=1) to sysupgrade to OpenWRT
3. download latest stable build for your OpenWRT of choice (for e.g. https://firmware-selector.openwrt.org/?version=24.10.2&target=mediatek%2Ffilogic&id=cudy_tr3000-v1)
4. do whatever you need to setup OpenWRT for you **before** next step, do **not** forget about backups
2. Fibocom L850 Support
1. ssh to your router
2. you need to update (still a) `opkg` via `opkg update`
3. you need to install `modemmanager` and `luci-proto-modemmanager` via `opkg install modemmanager luci-proto-modemmanager`
4. now reboot
5. after reboot you'll need to execute `AT+GTUSBMODE=7` in a modem shell and then reboot once more
6. and now you can setup connection via `modemmanager` !
3. Fibocom L850 alternative way
1. instead of `modemmanager` we could use `openwrt.132lan.ru`'s packages and script.
2. `opkg update` before everything
3. now `wget -O /tmp/add.sh http://openwrt.132lan.ru/packages/24.10/packages/add.sh` and then `sh /tmp/add.sh`
4. now we need to `opkg update` once more
5. after that `luci-app-modeminfo`, `modeminfo`, `modeminfo-serial-xmm`, `modeminfo-serial-fibocom`, `luci-proto-xmm`, `xmm-modem`, `atinout` and `luci-app-atinout` will be available to install via `opkg install luci-app-modeminfo modeminfo modeminfo-serial-xmm modeminfo-serial-fibocom luci-proto-xmm xmm-modem atinout luci-app-atinout`
6. now reboot
7. after that you'll be able to use `Intel XMM Cellular` as an Interface!
## Optional
> [!WARNING]
> 16MB of ROM
1. WireGuard:
1. `opkg update`
2. for cli-only `opkg install kmod-wireguard wireguard-tools`
3. for luci usage `opkg install kmod-wireguard wireguard-tools luci-proto-wireguard`
4. reboot
5. now you'll be able to use `Wireguard` as an Interface!
## Caveats
- no heatsink
- USB 2.0 is not powerful enough for dual USB setup (USB thumb drive + USB Modem)
- 16MB of ROM (3rd time is a charm)
---

View file

@ -1,81 +0,0 @@
<h1 align="center"> Cudy TR3000 </h1>
```Sh
.______ __
| |.--.--.-- | |.--.--.
| ---|| | | _ | || | |
|______||_____|______||___ |
. OpenWrt firmwares |_____|
```
[OpenWRT page](https://openwrt.org/toh/cudy/tr3000)
<img src="https://www.cudy.com/cdn/shop/files/TR3000.png" width="500" align="center">
## Table of hardware
| Name | Spec |
| --------- | ------------------------------------------- |
| CPU | MediaTek MT7981BA x 2 @ 1.3 GHz (Cortex-A53)|
| ROM | 128MB (or 256MB) SPI NAND |
| RAM | 512MB DDR3 |
| WLAN | MediaTek MT7976CN (up to Wi-Fi 6) |
| UBS | + (3.0) |
| Power | PD 15W via USB Type-C |
| LAN | 1x 2.5Gbps RTL8221B, 1x 1Gpbs MT7981BA |
| Dimension | 15 by 15 by 10 cm |
| | |
## Short Description
little agile monster of networking (imho):
- 2.5gbps is nuts
- Wi-Fi 6 is nuts
- ONLY 15 watts for whole router
- small
- MTK chipset, and even good one
- decent amount of ROM (you can use u-boot layout for more ROM btw)
- and 256MB version, comming soon(tm) on a stable OpenWRT (but you can build your own)
## How2
1. OpenWRT Transition
1. update [stock firmware](https://www.cudy.com/pages/download-center/tr3000-1-0) to latest version
2. use special [Cudy Intermediary OpenWRT firmware](https://drive.google.com/drive/folders/1BKVarlwlNxf7uJUtRhuMGUqeCa5KpMnj?usp=sharing&pli=1) to sysupgrade to OpenWRT
3. download latest stable build for your OpenWRT of choice (for e.g. https://firmware-selector.openwrt.org/?version=24.10.2&target=mediatek%2Ffilogic&id=cudy_tr3000-v1)
4. do whatever you need to setup OpenWRT for you **before** next step, do **not** forget about backups
2. Fibocom L850 Support
1. ssh to your router
2. you need to update (still a) `opkg` via `opkg update`
3. you need to install `modemmanager` and `luci-proto-modemmanager` via `opkg install modemmanager luci-proto-modemmanager`
4. now reboot
5. after reboot you'll need to execute `AT+GTUSBMODE=7` in a modem shell and then reboot once more
6. and now you can setup connection via `modemmanager` !
3. Fibocom L850 alternative way
1. instead of `modemmanager` we could use `openwrt.132lan.ru`'s packages and script.
2. `opkg update` before everything
3. now `wget -O /tmp/add.sh http://openwrt.132lan.ru/packages/24.10/packages/add.sh` and then `sh /tmp/add.sh`
4. now we need to `opkg update` once more
5. after that `luci-app-modeminfo`, `modeminfo`, `modeminfo-serial-xmm`, `modeminfo-serial-fibocom`, `luci-proto-xmm`, `xmm-modem`, `atinout` and `luci-app-atinout` will be available to install via `opkg install luci-app-modeminfo modeminfo modeminfo-serial-xmm modeminfo-serial-fibocom luci-proto-xmm xmm-modem atinout luci-app-atinout`
6. now reboot
7. after that you'll be able to use `Intel XMM Cellular` as an Interface!
## Optional
1. WireGuard:
1. `opkg update`
2. for cli-only `opkg install kmod-wireguard wireguard-tools`
3. for luci usage `opkg install kmod-wireguard wireguard-tools luci-proto-wireguard`
4. reboot
5. now you'll be able to use `Wireguard` as an Interface!
2. OpenVPN:
1. not recommended since no official kmod for OVPN (yet)
## Caveats
none
---
p.s.
my current setup lmfao

25
doc/guides/podkop.md Normal file
View file

@ -0,0 +1,25 @@
<h1 align="center"> guide/Podkop </h1>
`sing-box` / `xray` core utilising front-end with LuCI integration.
> [!WARNING]
> podkop is heavy package due of `sing-box` usage. around 20MB to be exact, be sure to have free space!
```Sh
# ssh to your router:
$ ssh root@192.168.1.1 -p 22
# inside your router's shell:
opkg update
# now we need to install podkop via wget from github
wget -O https://github.com/itdoginfo/podkop/releases/download/v0.4.11/podkop_v0.4.11-r1_all.ipk /tmp/podkop.ipk
wget -O https://github.com/itdoginfo/podkop/releases/download/v0.4.11/luci-app-podkop_v0.4.11-r1_all.ipk /tmp/luci-app-podkop.ipk
# fianlly, installing
opkg install /tmp/podkop.ipk # REQUIERED TO BE FIRST
opkg install /tmp/luci-app-podkop.ipk
```
> [!WARNING]
> before ANY openwrt update you need to `service podkop stop` or OpenWRT will break!

21
doc/guides/wireguard.md Normal file
View file

@ -0,0 +1,21 @@
<h1 align="center"> guide/Wireguard </h1>
to be complietly fair - this is really easy, and "guide" but
```Sh
# ssh to your router:
$ ssh root@192.168.1.1 -p 22
# inside router's shel:
opkg update
opkg install kmod-wireguard \
wireguard-tools luci-proto-wireguard
reboot -f
```
now inside LuCI you can manage `Wireguard` as Interface. or with `wg` command in router's shell.
there also packages like:
`prometheus-node-exporter-ucode-wireguard, rpcd-mod-wireguard, wg-installer-client, wg-installer-server, wg-installer-server-hotplug-babeld, wg-installer-server-hotplug-olsrd, wgsd-client, wgsd-coredns`
but for general WG usage `wireguard-tools` and `luci-proto-wireguard` are enough.

30
doc/guides/zapret.md Normal file
View file

@ -0,0 +1,30 @@
<h1 align="center"> guide/Zapret </h1>
> [!NOTE]
> this guide is more useful for CIS citizens
> [!WARNING]
> zapret is heavy! be sure to have enough ROM for this!
```Sh
# ssh to your router:
$ ssh root@192.168.1.1 -p 22
# inside your router's shell:
mkdir /opt
cd /opt
# now inside /opt
mkdir zapret # to create symlinks and to update easily
wget -O https://github.com/bol-van/zapret/releases/download/v71.4/zapret-v71.4-openwrt-embedded.tar.gz
tar -xf zapret-v71.4-openwrt-embedded.tar.gz
# this ^^^ downloads and unpacks zapret inside /opt but
mv -f zapret-v71.4/* zapret/
rm -rf zapret-v71.4-openwrt-embedded.tar.gz zapret-v71.4/
# this moves zapret inside /opt/zapret
./install_bin.sh && ./install_easy.sh
# installs zapret itself
```
there is a cool script called `blockcheck.sh` that allows you to create list of suitable strategies.

64
doc/modems/l850gl.md Normal file
View file

@ -0,0 +1,64 @@
<h1 align="center"> Fibocom L850-GL / L860-GL </h1>
```Sh
=============
=====-
===
===============
===============
===
=== ibocom
```
<img src="https://www.fibocom.com/uploadfiles/2022/04/20220413101231199.png" width="500" align="center">
## About
L850-GL and L860-GL both a Fibocom 4G WWAN modules on a PCI-E m.2 interface. they are quite bit (30mm x 42mm x 2.3mm) and requires external antenas. coming at low price they seems to be great begger-friendly option for an aggregation setup. but they requires some workaround to work properly on any OS.
L850-GL is a Cat.9 4G WWAN. L860-GL is a Cat.16 4G WWAN. they are sharing drivers (more in a workaround chapter), and it seems like besides aggregation type there are no differences between them.
## 1st method
"official" method:
```Sh
# ssh to your router:
$ ssh root@192.168.1.1 -p 22
# insisde your router's shell:
opkg update # updates packages
opkg install modemmanager # modemmanager and required software
opkg install luci-proto-modemmanager # LuCI module for modemmanager
reboot -f # reboot router
```
after that you'll need to execute `AT+GTUSBMODE=7` in **MODEM**'s shell and use `modemmanager` to create connection.
but i (hand7s) haven't tried this method since
## 2nd method aka Workround
not-so-"official" method
i've seen this method on https://openwrt.132lan.ru's forum and just executed it. with this method we can **execute AT?** commands in modem's shell (with `atinout`), use GUI (LuCI) for connection managment (with `luci-proto-xmm`). and yes, i use this one.
```Sh
# ssh to your router:
$ ssh root@192.168.1.1 -p 22
# inside you router's shell:
wget -O /tmp/add.sh http://openwrt.132lan.ru/packages/24.10/packages/add.sh
sh /tmp/add.sh
# we've just added openwrt.132lan.ru's repositories via this script
# now we need to install packages for modem
opkg update
opkg install luci-app-modeminfo modeminfo \
modeminfo-serial-xmm modeminfo-serial-fibocom \
luci-proto-xmm xmm-modem atinout luci-app-atinout
# and then
reboot -f
```
after that in Interfaces you'll be able to choose `Intel XMM Cellular`.
also with `luci-app-atinout` and `luci-app-modeminfo` you'll be able to check modem's info, use `AT?` commands right inside LuCI.

View file

@ -0,0 +1,44 @@
<h1 align="center"> Cudy TR1200 </h1>
```Sh
.______ __
| |.--.--.-- | |.--.--.
| ---|| | | _ | || | |
|______||_____|______||___ |
. OpenWrt firmwares |_____|
```
[OpenWRT page](https://openwrt.org/toh/cudy/tr1200)
<img src="https://www.cudy.com/cdn/shop/files/TR1200.png" width="500" align="center">
| Name | Spec |
| --------- | ------------------------------------------- |
| CPU | MediaTek MT7628AN x 1 @ 580 Mhz (MIPS) |
| ROM | 16MB SPI NAND |
| RAM | 128MB DDR3 |
| WLAN | MediaTek MT7613BEN (Wi-Fi 5) |
| UBS | + (2.0) |
| Power | PD 10W via USB Type-C |
| LAN | 2x 1Gpbs MT7628AN |
| Dimension | 15 by 15 by 10 cm |
| | |
## Short Description
entry-level thing:
- only Wi-Fi 5 and 1Gbps
- 10 watts is crazy
- USB 2.0 *might* not be enough for chonky modems
- 16MB of ROM is not enough (u-boot layout might help)
- 1 MIPS core is not enough
- yet, RAM is plenty
- small
## OpenWRT Transition
1. update [stock firmware](https://www.cudy.com/pages/download-center/tr1200-1-0) to latest version
2. use special [Cudy Intermediary OpenWRT firmware](https://drive.google.com/drive/folders/1BKVarlwlNxf7uJUtRhuMGUqeCa5KpMnj?usp=sharing&pli=1) to sysupgrade to OpenWRT
3. download latest stable build for your OpenWRT of choice (for e.g. https://firmware-selector.openwrt.org/?version=24.10.2&target=mediatek%2Ffilogic&id=cudy_tr1200-v1)
4. do whatever you need to setup OpenWRT for you **before** next step, do **not** forget about backups
---

View file

@ -0,0 +1,49 @@
<h1 align="center"> Cudy TR3000 </h1>
```Sh
.______ __
| |.--.--.-- | |.--.--.
| ---|| | | _ | || | |
|______||_____|______||___ |
. OpenWrt firmwares |_____|
```
[OpenWRT page](https://openwrt.org/toh/cudy/tr3000)
<img src="https://www.cudy.com/cdn/shop/files/TR3000.png" width="500" align="center">
## Table of hardware
| Name | Spec |
| --------- | ------------------------------------------- |
| CPU | MediaTek MT7981BA x 2 @ 1.3 GHz (Cortex-A53)|
| ROM | 128MB (or 256MB) SPI NAND |
| RAM | 512MB DDR3 |
| WLAN | MediaTek MT7976CN (up to Wi-Fi 6) |
| UBS | + (3.0) |
| Power | PD 15W via USB Type-C |
| LAN | 1x 2.5Gbps RTL8221B, 1x 1Gpbs MT7981BA |
| Dimension | 15 by 15 by 10 cm |
| | |
## Short Description
little agile monster of networking (imho):
- 2.5gbps is nuts
- Wi-Fi 6 is nuts
- ONLY 15 watts for whole router
- small
- MTK chipset, and even good one
- decent amount of ROM (you can use u-boot layout for more ROM btw)
- and 256MB version, comming soon(tm) on a stable OpenWRT (but you can build your own)
## OpenWRT Transition
1. update [stock firmware](https://www.cudy.com/pages/download-center/tr3000-1-0) to latest version
2. use special [Cudy Intermediary OpenWRT firmware](https://drive.google.com/drive/folders/1BKVarlwlNxf7uJUtRhuMGUqeCa5KpMnj?usp=sharing&pli=1) to sysupgrade to OpenWRT
3. download latest stable build for your OpenWRT of choice (for e.g. https://firmware-selector.openwrt.org/?version=24.10.2&target=mediatek%2Ffilogic&id=cudy_tr3000-v1)
4. do whatever you need to setup OpenWRT for you **before** next step, do **not** forget about backups
---
p.s.
my current setup lmfao