s0me1newithhand7s/ProjectPortableRouter
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Compare commits

base: s0me1newithhand7s:5c31743981ca3385037b0ad0e824b65b1af1222d
Branches Tags
s0me1newithhand7s:master
...
compare: s0me1newithhand7s:0ec36cbfedb19287dd1dcc99ac297c8f3bac0b07
Branches Tags
s0me1newithhand7s:master

5 commits
5c31743981 ... 0ec36cbfed

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
Download patch file Download diff file Expand all files Collapse all files

14
README.md
View file

@ -54,9 +54,12 @@ optionally, you can have:
<h2 align="center"> Current Tested Devices </h2> <h2 align="center"> Current Tested Devices </h2>
| Image | Status | Link | Author | | 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/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/cudy/TR3000.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> <h2 align="center"> Contribution </h2>
@ -64,10 +67,13 @@ to expand list above you need to:
1. create an issue with "add router" template 1. create an issue with "add router" template
2. go trough testings (with help from community ofc) 2. go trough testings (with help from community ofc)
3. fork **this** repo with branch's name of your router, e.g. `xiaomi_ax3200` 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` 5. add your router to [this](./doc/content.md) `.md`
6. open a PR! 6. open a PR!
p.s.
you can init a modem with you router btw
<h2 align="center"> But.. Why? </h2> <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. this is a healthy question considering whole idea, but you might misunderstood why i've started this in a first place.

19
doc/content.md
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 | | 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/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](./cudy/TR3000.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 |

79
doc/cudy/TR1200.md
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)
---

81
doc/cudy/TR3000.md
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.

44
doc/routers/cudy/TR1200.md Normal file
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
---

49
doc/routers/cudy/TR3000.md Normal file
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