Photonicat 编译 OpenWRT, Debian

From Photonicat Wiki
Jump to navigation Jump to search

Create Debian System Image (Rockchip Official)

Host System Requirements

Debian 11 (bullseye) or Ubuntu 20.04.

Compiling Requirements

On Debian/Ubuntu systems, install the packages:

sudo apt-get install build-essential flex bison genext2fs

Get Repo files by tarball(with .git)


Install live build packages

Install live build packages if not installed yet:

sudo dpkg -i debian/ubuntu-build-service/packages/*.deb
sudo apt-get install -f

Config build target

Run the command below:


Build system image

Run the command below:


The output path is rockdev, system image path is rockdev/pack

Build Debian/Ubuntu system image (mainline u-boot & kernel)

Check README in for building system image.

Build OpenWRT

Photonicat image contains following packages:

  1. OpenWRT (within rk3568-linux-sdk which builds bootloader, uboot, kernel and OpenWRT)
  2. pcat-manager (within rk3568-linux-sdk)
  3. pcat-manager-web (python closed source. install manually: e.g:, we need to change luci listen port to 8080.)
  4. quectel-cm (within rk3568-linux-sdk)

rk3568-linux-sdk will fetch uboot, kernel, openwrt, and copmile them in one build script.

In addition to default packages we have 3 more package for power and modem manager.

  • modem/power_manager (written in c)
  • web interface for displaying mobile modem and battery info. (written in python)
  • c program modem watchdog

Host System Requirements

Debian 11 (bullseye) or Ubuntu 20.04, other distributions may work but not tested.

Compiling Requirements

Please a NORMAL USER, not root

On Debian/Ubuntu systems, install the packages:

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

Get repo files

Get repo files from Github (non-root user):

git clone
cd rockchip_rk3568_openwrt

Config build target

Run the command below:

./scripts/feeds update -a                 
./scripts/feeds install -a                                                                        
cp ./configs/base_defconfig .config

Build system image

Run the command below:


The output path is bin/targets/rockchip/armv8/, system image will be named like photonicatwrt-23.04-rxxxx+xx-xxxxxxxxx-rockchip-armv8-ariaboard_photonicat-squashfs-sysupgrade.img.gz

Edit your menuconfig (Optional)

make menuconfig

save and re-run build process again.

IPKs will be under:


Build your own package, modules on OpenWRT (Optional)


make menuconfig

to select

<M> package_name

for your desired package(s).

If you want to include your own packages to system image, see OpenWRT official documents for help.

Install pcat-manager-web on OpenWRT (Optional)

If you want to use original Web management tool, you should change the port used by luci to 8080, edit /etc/config/uhttpd on device, change

	list listen_http ''
	list listen_http '[::]:80'
	list listen_https ''
	list listen_https '[::]:443'


	list listen_http ''
	list listen_http '[::]:8080'
	list listen_https ''
	list listen_https '[::]:8443'

Then install pcat-manager-web on device:

cd /tmp
opkg install pcat-manager-web_1.0.22-19_aarch64_generic.ipk

Reboot your device to apply changes.

Flash system images to the onboard eMMC

Prepare update tools and files:

git clone
cd rkdeveloptool
sudo apt-get install libudev-dev libusb-1.0-0-dev dh-autoreconf
autoreconf -i
automake --add-missing

Refer: Photonicat_快速上手#4G/5G版本按键功能定义 to enter the firmware update mode, use A-to-A cable to connect USB OTG port to PC, and use the command below:

gunzip photonicatwrt-23.04-rxxxx+xx-xxxxxxxxx-rockchip-armv8-ariaboard_photonicat-squashfs-sysupgrade.img.gz #Replace file name with the one you get indeed.
sudo ./rkdeveloptool db MiniLoaderAll.bin
sudo ./rkdeveloptool wl 0 photonicatwrt-23.04-rxxxx+xx-xxxxxxxxx-rockchip-armv8-ariaboard_photonicat-squashfs-sysupgrade.img
sudo ./rkdeveloptool rd