Skip to content
/ shiranekowrt Public
forked from qosmio/openwrt-ipq

ShiranekoWrt 3.1.0

Choose a tag to compare

View all tags
@cjayacopra cjayacopra released this 08 Jul 04:59
v3.1.0
2a9a392

ShiranekoWrt 3.1.0 — Initial Public Release

ShiranekoWrt is a custom OpenWrt firmware built for the Arcadyan AW1000, leveraging Qualcomm's NSS (Network SubSystem) hardware offloading and RMNET for high-throughput cellular networking. It ships with a Aurora-themed LuCI interface, transparent proxying via Xray, full QModem cellular support, NAS/storage services, and a tailored front-panel LED status scheme.

Version: 3.1.0 (code RMNET-NSS) · based on OpenWrt 24.10-SNAPSHOT

Highlights

  • Wire-speed everything. Qualcomm NSS hardware offload plus RMNET keeps the AW1000's CPU nearly idle while it pushes full line-rate — NAT, routing, and cellular tunneling all happen in silicon, not on the cores.
  • Cellular that just works. QModem auto-dials your Quectel modem over NSS-accelerated QMI, with PCIe scan, signal/modemdata status, time sync, and live monitoring ready out of the box.
  • Transparent proxy, zero fuss. Xray runs a full VLESS transparent proxy with CN geo-routing, ad-blocking, and least-ping load balancing — driven entirely from LuCI via luci-app-xray.
  • A UI you'll actually want to look at. A rebranded Aurora theme (custom logo, wallpaper, and palette) makes LuCI feel native to the device.
  • Flip it into a NAS. Samba4 + MiniDLNA with drive idle/spin-down, plus btrfs / ext4 / f2fs / ntfs3 support and disk-management tools.
  • One tap to update. ghfu pulls the newest build straight from GitHub.
  • Everyday extras. Guest Wi-Fi, Wi-Fi scheduling, and live system stats round out the kit.

Default configuration

Setting Value
Hostname ShiranekoWrt
Root password admin@aw1000
Timezone Asia/Manila (PST-8)
LAN IPv6 Disabled
QModem Auto-dial enabled, PCIe scan enabled
LED indicators Documented in "LED indicators" below

Default wireless credentials

Band SSID Password Encryption Channel / Width
5 GHz ShiranekoWrt 5G wireless123@ShiranekoWrt WPA2 (psk2) 36 / HE160
2.4 GHz ShiranekoWrt wireless123@ShiranekoWrt WPA/WPA2 mixed (psk-mixed) 1 / HE20

Both radios use country code PH and are enabled by default. Change the Wi-Fi pasShiranekoWrt v3.1.0sword after first boot.

LED indicators

The front-panel LEDs reflect modem, signal, and connectivity state (RSRP re-sampled every 5s):

Network type (5g LED)

LED Lights when
green:5g Connected via 5G — NR-SA / NR-NSA
blue:5g Connected via 4G — LTE
red:5g Connected via 3G — WCDMA/UMTS/HSPA or GSM/GPRS/EDGE

Signal strength (signal LED)

LED RSRP
green:signal ≥ -95 dBm (good)
blue:signal -110 to -95 dBm (medium)
red:signal < -110 dBm (poor) / no signal

Status LEDs

  • green:internet — on when an internet connectivity probe succeeds.
  • green:wifi — on when any Wi-Fi AP interface is up.
  • SIM absent — all type/signal LEDs off except red:signal + red:5g.

⚠️ Hardware requirement — Expanded MTD Layout

This firmware has only been tested with the Expanded MTD Layout described here:
https://github.com/ChamodyaChiran/AW1000-NSS-Build-Public/blob/main/Expanded%20MTD%20layout.md

Flashing this firmware without first applying the expanded MTD layout may brick your device. Do not flash unless your AW1000 is already running the expanded layout.

Disclaimer

This firmware is provided as-is, without any warranty of any kind, express or implied. Use it at your own risk. The authors are not responsible for any damage, data loss, or bricked devices resulting from its use.

Upgrade

Use ghfu (LuCI → System → Firmware Update) pointed at cjayacopra/shiranekowrt, or flash the *.bin via U-Boot / LuCI. Config is preserved by default (keep_config=1).

Credits

ShiranekoWrt stands on the shoulders of many open-source projects and their authors:

  • qosmio — for the NSS packages and patches that make hardware offloading on the IPQ807x possible.
  • FUjr — for QModem (luci-app-qmodem) and the cellular/Quectel tooling.
  • OpenWrt Project — the base firmware, build system, and package ecosystem.
  • LuCI Team — the web UI framework.
  • Xray-core / XTLS — the VLESS proxy core and transparent proxying.
  • yichya — luci-app-xray, the LuCI management UI that drives Xray on this firmware. Xray would not be usable here without it.
  • Samba Team — Samba4 file sharing.
  • MiniDLNA (readyMedia) authors — the DLNA media server.
  • smallprogram — luci-app-ghfu (GitHub Firmware Update).
  • eamonxg — luci-theme-aurora and luci-app-aurora-config.
  • Quectel & the OpenWrt community — the customized Quectel CM and modem drivers.
  • Every upstream package maintainer and contributor.

Bundled custom packages

These packages are vendored under package/custom:

Package Author / Source
luci-theme-aurora eamonxg (forked by cjayacopra)
luci-app-aurora-config eamonxg
luci-app-guest-wifi binsee
luci-app-bandix / openwrt-bandix timsaya
luci-app-cpu-status gSpotx2f
luci-app-disks-info gSpotx2f
luci-app-netstat nooblk-98 (original; JS-modernized fork by cjayacopra)
quectel-timesync sevvian

This list is not exhaustive — thanks to the entire open-source community whose work this firmware builds upon.

Support

If ShiranekoWrt is useful to you, consider supporting the project — donations help cover build infrastructure and device costs.

Assets 4
Loading