NIJIKA Firmware

Five years of NIJIKA

NIJIKA started as a few edited files in the root filesystem of a GPON stick. It is now the firmware on more than a thousand of them. This is how it got there, one login screen at a time.

What NIJIKA is

A GPON SFP stick is a whole ONT folded into a module: a Realtek SoC, a laser and a small Linux. The vendor firmware works, but it hides what the OLT is doing, speaks to few OLTs, and leaves you guessing when the line is up and the traffic is not.

NIJIKA is that firmware opened up. The classic line lives in the Firmware_Mod folder of RTL960x: an overlay of the stick's root filesystem, one folder per model, with the web pages, boot scripts and OMCI settings I changed. You unpack the stock image, lay the overlay on top and rebuild it.

NIJIKA-Luna, in 2026, goes further: the vendor's userland is gone, and the stick runs an open base from the bootloader up.

Firmware_Mod on GitHub The NIJIKA family

Nijika, an anime girl with long yellow hair in a side ponytail and a school uniform

History

From classic firmware to NIJIKA-Luna

The first thing anyone sees is the login screen, and the second is the status page. Here are both, from every era. Select a screenshot to open it at full size.

  1. 2021

    Classic

    RTL9601CI VSOL V2801F · TWC TWCGPON657

    Where it began: a modded root filesystem for the RTL9601CI sticks. A plain login box, then a Bootstrap status page with Status, Advanced, System and Admin menus, showing the system and LAN at a glance.

    A small white login box with username and password fields on a dark purple background, signed
    Login
    A Device Status page for a TWCGPON657 stick listing device name, uptime, firmware version, CPU and memory usage, and the LAN address, over a purple background with pink bubbles.
    Status
  2. 2022

    RTL9601D

    RTL9601D ODI DFP-34X-2C2

    The move to the RTL9601D sticks. A proper "Authentication Required" card, and a status page that now reports the release, the system on chip and the host interface speed: 2500 Mbps over HiSGMII.

    An
    Login
    A Device Status page listing device name, uptime, firmware version, release, system on chip, CPU and memory usage, LAN address and an interface speed of 2500 Mbps HiSGMII.
    Status
  3. 2023

    Dark

    RTL9601D ODI DFP-34X-2C2

    A dark theme by imoize, and the first time Nijika herself shows up: waving beside the login, with the firmware's shell banner glowing in the background. The status page adds the vendor ID and the active firmware partition.

    Theme by imoize

    A dark login page with an anime girl with yellow hair waving beside the login card, and a green terminal banner reading
    Login
    A dark Device Status page in tables, with vendor ID, package release, active partition, system on chip, uptime, CPU and memory usage, and the LAN configuration.
    Status
  4. 2024

    Current

    RTL9601D ODI DFP-34X-2C2

    The classic firmware as most sticks in the field run it. A NIJIKA menu bar with Status, Network, GPON, System and Admin, CPU and memory as bars, the Tx L1 rate profile, and a WAN table showing which VLANs the OLT is carrying.

    A light login page with the same waving girl and a shell banner reading
    Login
    A light status page with a NIJIKA menu bar, CPU and memory usage bars, a 2500 Mbps HiSGMII interface, and a WAN table with VLANs 400 and 500 bridged.
    Status
  5. 2026

    NIJIKA-Luna In development

    RTL9601D ODI DFP-34X-2C2 · HSGQ

    A new base. Luna runs on Andre Ziviani's ODI OSS and Linux 6.18, with open switch, GPON and OMCI drivers in place of the vendor's. Nijika UI draws the line itself: PON state, light in and out against the limits, temperature, traffic and the VLANs, with the OLT's VEIP and PPTP ports marked on each.

    A dark, minimal NIJIKA-Luna login card asking for a username and password, crediting the Open PON Foundation and Peter-Pon.
    Login
    The NIJIKA-Luna Device page: SFP and ONT panels, then a PON panel showing state O5 in service, light in at minus 10.7 dBm on a scale, laser out at 2.7 dBm, temperature and live traffic.
    Status

Under the hood

How the classic firmware is made

Each folder in Firmware_Mod mirrors the root filesystem of one stick: etc/ for the boot and OMCI settings, home/httpd/ for the web server and its pages. To mod an image, run qemu-test.sh, copy in what you need, and exit; the firmware images are rebuilt on the way out.

To change one file on a live stick there is no need to reflash. Listen with nc -l -p 12345 > file on the stick, send it with nc 192.168.1.1 12345 < file from a PC, then press Ctrl+C in the stick's telnet session, since its nc does not exit by itself.

Sticks it covers

VendorModelSoCInterchangeable with
ODIDFP-34X-2C2RTL9601D—
TWCTWCGPON657RTL9601CIV2801F
VSOLV2801FRTL9601CITWCGPON657

What the mod changes

  1. OLT info against Fake O5

    A stick can report O5 to the OLT and still carry no traffic. The OLT Info page shows OMCI managed entities 84 and 171, the VLAN filtering and the extended VLAN tagging the OLT pushed, so you can see where it stops.

  2. Forward Operation hacks

    Some OLTs ask for a VLAN forward operation the vendor firmware will not bridge. The mod rewrites it so the traffic reaches your router.

  3. Fixes in the boot scripts

    Scripts under /etc/scripts that run at boot to correct the reported software version, the link speed and VLAN tagging.

NIJIKA-Luna

A new base, the same Nijika

The classic firmware could only ever be as open as the vendor userland under it. Luna replaces that userland with ODI OSS: Linux 6.18 and open switch, GPON and OMCI drivers. Then it puts the Nijika parts back on top.

Nijika UI on GitHub

The NIJIKA-Luna OMCI topology page, drawing the managed entities the OLT created as a connected diagram
Nijika UI drawing the OMCI topology the OLT built on the stick.

Credits

Many hands

Illustration of Nijika: pixiv 108259505. Screenshots from RTL960x and rtl9601-nijika-ui. Read the safety notice before you put any stick on a live PON.