Skip to content

Conversation

@maurerle
Copy link
Member

@maurerle maurerle commented Jan 22, 2025

  • Must be flashable from vendor firmware
  • Must support upgrade mechanism
    • Must have working sysupgrade
      • Must keep/forget configuration (sysupgrade [-n], firstboot)
    • Gluon profile name matches autoupdater image name
      (lua -e 'print(require("platform_info").get_image_name())') - netgear-wax206
  • Reset/WPS/... button must return device into config mode
  • Primary MAC address should match address on device label (or packaging)
    (https://gluon.readthedocs.io/en/latest/dev/hardware.html#hardware-support-in-packages) see mediatek-mt7622: netgear-wax206 fix wifi leds openwrt/openwrt#17694
    • When re-adding a device that was supported by an earlier version of Gluon, a
      factory reset must be performed before checking the primary MAC address, as
      the setting from the old version is not reset otherwise.
  • Wired network
    • should support all network ports on the device
    • must have correct port assignment (WAN/LAN)
      • if there are multiple ports but no WAN port:
        • the PoE input should be WAN, all other ports LAN
        • otherwise the first port should be declared as WAN, all other ports LAN
  • Wireless network (if applicable)
    • Association with AP must be possible on all radios
    • Association with 802.11s mesh must work on all radios
    • AP+mesh mode must work in parallel on all radios
  • LED mapping
    • Power/system LED
    • Radio LEDs
      • Should map to their respective radio
      • Should show activity
    • Switch port LEDs
      • Should map to their respective port (or switch, if only one led present)
      • Should show link state and activity
  • Outdoor devices only:
    • Added board name to is_outdoor_device function in package/gluon-core/luasrc/usr/lib/lua/gluon/platform.lua
  • Cellular devices only:
    • Added board name to is_cellular_device function in package/gluon-core/luasrc/usr/lib/lua/gluon/platform.lua
    • Added board name with modem setup function setup_ncm_qmi to package/gluon-core/luasrc/lib/gluon/upgrade/250-cellular
  • Docs:
    • Added Device to docs/user/supported_devices.rst

Caveats

@github-actions github-actions bot added 3. topic: docs Topic: Documentation 3. topic: hardware Topic: Hardware Support labels Jan 22, 2025
@rotanid rotanid added the 2. status: blocked Marked as blocked because it's waiting on something label Jan 23, 2025
@Djfe
Copy link
Contributor

Djfe commented Jan 28, 2025

I just looked at the device again. Gluon only defines 112MiB of the 256MiB flash in it's mtd partitions. I feel like we should adjust this now, so everyone can profit from this and so it won't be done later (after we add the device). because adjusting a ubi partition causes trouble and requires a factory install for example with nmrpflash (we need to increase major compat for this).
Gluon doesn't require the rest of the flash to be usable, but OpenWrt users profit.

@blocktrron
Copy link
Member

@Djfe 112M are plenty, so id o not see the need.

@maurerle Is openwrt/openwrt#17694 requiring a backport or is it already being take care of?

Regarding the link flapping - can you check if adding the eee-broken-... properties (https://www.kernel.org/doc/Documentation/devicetree/bindings/net/ethernet-phy.yaml) fixes the initital link state?

@maurerle
Copy link
Member Author

@blocktrron openwrt/openwrt#17694 is already backported.

See openwrt/openwrt@0ba00ec

Regarding eeee-broken, I will try that soon, thanks

@rotanid
Copy link
Member

rotanid commented Nov 4, 2025

@maurerle are you still having the device at hand and considering to rebase/finalize/re-test it?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

2. status: blocked Marked as blocked because it's waiting on something 3. topic: docs Topic: Documentation 3. topic: hardware Topic: Hardware Support

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants