An opensource OpenWrt variant for mainland China users.

Go to file

Furong Xu c3caa26a8e rockchip: fix eth1 irq affinity NanoPi R2S and some other RK3328 boards use RTL8152 as eth1, which is connected to xhci-hcd:usb1 but not xhci-hcd:usb3 \|:~# cat /proc/interrupts \| CPU0 CPU1 CPU2 CPU3 \| 11: 53449 171813 129595 87823 GICv2 30 Level arch_timer \| 18: 0 0 0 0 GICv2 94 Level rockchip_usb2phy \| 19: 0 0 0 0 GICv2 32 Level ff1f0000.dma-controller \| 20: 0 0 0 0 GICv2 33 Level ff1f0000.dma-controller \| 21: 4 0 0 0 GICv2 89 Level ttyS2 \| 22: 0 0 0 0 GICv2 43 Level ff350800.iommu \| 23: 0 0 0 0 GICv2 106 Level ff360480.iommu \| 24: 0 1417932 0 0 GICv2 56 Level eth0 \| 25: 334 0 0 4422194 GICv2 99 Level xhci-hcd:usb1 \| 26: 0 0 0 0 GICv2 48 Level ehci_hcd:usb3 \| 27: 0 0 0 0 GICv2 49 Level ohci_hcd:usb2 \| 28: 3285 0 0 0 GICv2 69 Level ff160000.i2c \| 29: 0 0 0 0 rockchip_gpio_irq 24 Level rk805 \| 30: 0 0 0 0 rk805 0 Edge rk805_pwrkey_fall \| 35: 0 0 0 0 rk805 5 Edge RTC alarm \| 37: 0 0 0 0 rk805 7 Edge rk805_pwrkey_rise \| 38: 0 0 0 0 GICv2 90 Level rockchip_thermal \| 39: 0 0 0 0 GICv2 72 Edge ff1a0000.watchdog \| 40: 2601 0 0 0 GICv2 44 Level dw-mci \| 41: 0 0 0 0 rockchip_gpio_irq 0 Edge keys \|IPI0: 1559 1208 893 1131 Rescheduling interrupts \|[...] Fix 40-net-smp-affinity to match the correct device irq name. Signed-off-by: Furong Xu <xfr@outlook.com> (cherry picked from commit `1438bc583c`)		2023-12-17 12:55:17 +08:00
.github/ISSUE_TEMPLATE	ci: add workflow for automated GitHub release	2023-11-02 14:44:49 +00:00
config	Merge Official Source	2023-11-04 12:58:38 +08:00
include	Merge Official Source	2023-11-27 22:45:01 +08:00
LICENSES	LICENSES: sync with upstream OpenWrt	2023-01-10 15:46:44 +08:00
package	Merge Official Source	2023-12-17 10:41:53 +08:00
scripts	Merge Official Source	2023-11-27 22:45:01 +08:00
target	rockchip: fix eth1 irq affinity	2023-12-17 12:55:17 +08:00
toolchain	toolchain: glibc: Update glibc 2.37 to recent HEAD	2023-10-08 14:14:50 +02:00
tools	Merge Official Source	2023-09-28 11:01:47 +08:00
.gitattributes	add .gitattributes to prevent the git autocrlf option from messing with CRLF/LF in files	2012-05-08 13:30:49 +00:00
.gitignore	.gitgnore: add llvm-bpf	2021-11-21 18:18:01 +01:00
BSDmakefile	build: use SPDX license tags	2021-02-05 14:54:47 +01:00
Config.in	Merge Official Source	2023-10-29 22:51:49 +08:00
COPYING	license: re-license Project ImmortalWrt under GPL-2.0-only	2022-12-24 10:42:24 +08:00
feeds.conf.default	ImmortalWrt v23.05.1: revert to branch defaults	2023-11-20 01:04:32 +08:00
Makefile	build: fix pkg-config detection when inside of a nix-shell	2023-11-02 22:40:40 +01:00
README.md	README: update acknowledgements	2023-08-14 16:04:53 +08:00
rules.mk	treewide: add ORIG_PATH variable	2023-06-12 22:10:20 +02:00

README.md

Project ImmortalWrt

ImmortalWrt is a fork of OpenWrt, with more packages ported, more devices supported, better performance, and special optimizations for mainland China users.
Compared the official one, we allow to use hacks or non-upstreamable patches / modifications to achieve our purpose. Source from anywhere.

Default login address: http://192.168.1.1 or http://immortalwrt.lan, username: root, password: none.

Download

Built firmware images are available for many architectures and come with a package selection to be used as WiFi home router. To quickly find a factory image usable to migrate from a vendor stock firmware to ImmortalWrt, try the Firmware Selector.

ImmortalWrt Firmware Selector

If your device is supported, please follow the Info link to see install instructions or consult the support resources listed below.

Development

To build your own firmware you need a GNU/Linux, BSD or MacOSX system (case sensitive filesystem required). Cygwin is unsupported because of the lack of a case sensitive file system.

Requirements

To build with this project, Ubuntu 20.04 LTS is preferred. And you need use the CPU based on AMD64 architecture, with at least 4GB RAM and 25 GB available disk space. Make sure the Internet is accessible.

The following tools are needed to compile ImmortalWrt, the package names vary between distributions.

Here is an example for Ubuntu users:

Method 1:

Setup dependencies via APT

sudo apt update -y
sudo apt full-upgrade -y
sudo apt install -y ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
  bzip2 ccache clang cmake cpio curl device-tree-compiler ecj fastjar flex gawk gettext gcc-multilib \
  g++-multilib git gnutls-dev gperf haveged help2man intltool lib32gcc-s1 libc6-dev-i386 libelf-dev \
  libglib2.0-dev libgmp3-dev libltdl-dev libmpc-dev libmpfr-dev libncurses5-dev libncursesw5 \
  libncursesw5-dev libpython3-dev libreadline-dev libssl-dev libtool lld llvm lrzsz mkisofs msmtp \
  nano ninja-build p7zip p7zip-full patch pkgconf python2.7 python3 python3-pip python3-ply \
  python-docutils python3-pyelftools qemu-utils re2c rsync scons squashfs-tools subversion swig \
  texinfo uglifyjs upx-ucl unzip vim wget xmlto xxd zlib1g-dev

Method 2:

sudo bash -c 'bash <(curl -s https://build-scripts.immortalwrt.eu.org/init_build_environment.sh)'

Note:

Do everything as an unprivileged user, not root, without sudo.
Using CPUs based on other architectures should be fine to compile ImmortalWrt, but more hacks are needed - No warranty at all.
You must not have spaces or non-ascii characters in PATH or in the work folders on the drive.
If you're using Windows Subsystem for Linux (or WSL), removing Windows folders from PATH is required, please see Build system setup WSL documentation.
Using macOS as the host build OS is not recommended. No warranty at all. You can get tips from Build system setup macOS documentation.
For more details, please see Build system setup documentation.

Quickstart

Run git clone -b <branch> --single-branch --filter=blob:none https://github.com/immortalwrt/immortalwrt to clone the source code.
Run cd immortalwrt to enter source directory.
Run ./scripts/feeds update -a to obtain all the latest package definitions defined in feeds.conf / feeds.conf.default
Run ./scripts/feeds install -a to install symlinks for all obtained packages into package/feeds/
Run make menuconfig to select your preferred configuration for the toolchain, target system & firmware packages.
Run make to build your firmware. This will download all sources, build the cross-compile toolchain and then cross-compile the GNU/Linux kernel & all chosen applications for your target system.

The main repository uses multiple sub-repositories to manage packages of different categories. All packages are installed via the OpenWrt package manager called opkg. If you're looking to develop the web interface or port packages to ImmortalWrt, please find the fitting repository below.

LuCI Web Interface: Modern and modular interface to control the device via a web browser.
ImmortalWrt Packages: Community repository of ported packages.
OpenWrt Routing: Packages specifically focused on (mesh) routing.
OpenWrt Video: Packages specifically focused on display servers and clients (Xorg and Wayland).

Support Information

For a list of supported devices see the OpenWrt Hardware Database

Documentation

Support Community

Support Chat: group @ctcgfw_openwrt_discuss on Telegram.
Support Chat: group #immortalwrt on Matrix.

License

ImmortalWrt is licensed under GPL-2.0-only.

Acknowledgements