Files
RTLPlayground/doc/supported_devices.md
T
Victor 389dc2af76 machine: add the 2G5F4_10G2_V1.01 (HYWS-SGT0204S) target
The hongyavision HYWS-SGT0204S is sold as an unmanaged 4x2.5G + 2x10G SFP+
switch and carries the 2G5F4_10G2_V1.01 marking on the PCB. It is a sibling of
the KP-9000-6XH-X2 (2M-PCB43-V1.1), so machine/2G5F4_10G2_V1_01.c is that board
definition with these changes:

- The two SFP+ cages (physical ports 5 and 6) are wired the other way round:
  physical 5 is on SDS1 with GPIO30/GPIO37, physical 6 on SDS0 with
  GPIO50/GPIO10. Copper ports 1-4 match the KP-9000 layout.
- No reset button is fitted and the case has no opening for one, so reset_pin
  is GPIO_NA. GPIO54, the reset pin on the KP-9000 layout, reads as permanently
  pressed here.
- The board definition sets flash_sio, so the flash is read with single-IO: the
  fitted 512 KB Bright Moon T25S40 cannot be read in DIO mode on this board, an
  image that leaves DIO enabled does not come up at all, while the same image
  with single-IO boots and runs normally (two units).
- The board is added to the machine_custom_init() group that sets
  LED_GLB_IO_EN bit 6, otherwise the RTL837x "solid" conditions (LINK/speed)
  never drive the LEDs and the 2.5G LED glows faintly at 100M/1000M.

flash_sio is a new field of struct machine that rtlplayground.c hands to
flash_init(); only this board sets it, every other machine keeps DIO. It costs
management-plane speed only, the ASIC keeps forwarding in hardware.

The stock firmware runs a factory test console on the serial header at 9600
baud, whose silkscreen labels are shifted by one pin.

Verified: warning-free build, `make machine_check` passes for every target, the
host tests pass, and a control build of this target without the LED hook differs
from the KP-9000-6XH_X2_V1_1 image in 44 bytes: all inside the machine
description (including flash_sio) and the image CRC16, nothing else in the
firmware moved. On the board the single-IO image boots and runs on two units;
port order, SFP cages and LED behaviour come from the machine definition
verified on this board earlier.
2026-10-18 10:12:22 +08:00

7.1 KiB

Supported Hardware

The following devices have been tested and are fully working:

Brand Type Managed PCB Flash Ports
Ampcom WAM902-SWTG018AS No SWTG018AS-A V2.0 8 + 1
Davuaz Da-K6501W No PCB-K0501W-V2.0 5 + 1
FOXNEO FNS-1200P No PCB-K0402W-U13-V2.0 2M 4 + 2
Goalake IG108 No PB-2132 4M 8 + 1
GoodTop GT-ST018M Yes SWTG018AS-A V2.0 ? 8 + 1
GoodTop GT-ST024M Yes SWTG024AS-A V2.0.1 2M 4 + 2
Hasivo S1100WP_8GT_1SX_SE Yes S1100WP_8GT_1SX_SE-V1.05 2M 8 + 1
Hisource Hi-K0402WS No PCB-K0402WS-V3.0 4 + 2
Hisource Hi-K0402WS No PCB-K0402WS-V2.0 2M 4 + 2
Hisource Hi-K0801WS No PCB-KO801W-V2.0 8 + 1
hongyavision HYWS-SGT0204S No 2G5F4_10G2_V1.01 0.5M 4 + 2
hongyavision LG-SG5T1 No PCB-SWTG024AS-V2.0_16895 0.5M 5 + 1
Horaco HC-SWTGW215AS Yes SWTG024AS-A-V2.0.1_19650 5C 1SFP ? 5 + 1
Horaco HC-SWTGW218AS Yes SWTG018AS-A V2.0 8 + 1
Horaco ZX310S-4T2XH Yes PCB-SL310S-4T1T1X-V1.0.1-24107 2M 5 + 1
Horaco ZX310S-4T2XT Yes PCB-SL310S-4T2XT-V1.0.0-22273 2M 6
Horaco ZX-SG4T2 No SWTG024AS-A-V2.0.1_19650_4C_2SFP 0.5M 4 + 2
Horaco ZX-SWTG124AS Yes SWTG024AS-v2.0 4 + 2
Keeplink KP-9000-6XH-X2 / KP-9000-6XHML-X2 No/Yes 2M-PCB43-V1.2 / V2.1 4 + 2
keepLINK KP-9000-9XHML-X Yes 2M-PCB23-V2.2 2M 8 + 1
keepLINK KP-9000-9XHML-X Yes 2M-PCB23-V3.1 2M 8 + 1
keepLINK KP-9000-9XHML-X Yes 2M-PCB23-V3.2 2M 8 + 1
LIANGUO SWTG024AS No SWTG024AS-v2.0-17452 0.5M 4 + 2
Lianguo ZX-SWTGW215AS Yes PCB-SWTG115AS-V2.0 / PCB-SWTG115AS-V2.1 2M 5 + 1
Lianguo HYWS-SGT0108S No 2G5F_20G_V1.01 0.5M 8 + 1
Mokerlink 2G040210GSM Yes 2M-PCB43-V1.1 4 + 2
Mokerlink ZX-SWTGW218AS Yes SWTG118AS-V2.0-16029 2M 8 + 1
MokerLink POE-2G080110GS No 2M-PCB51-ML-V1.1 4M 8 + 1
Binardat 2G06-04210GSM No PCB-SWTG024AS-A-2.0.1 0.5M 4 + 2
ONT ONT-S207CW-62TS-SE No PCB-SWTG024AS-A-2.0.1 0.5M 4 + 2
Netcore GS9 No PB-2132 4M 8 + 1
Ruiying RY-4GT-2SX No FG-4GT-2SX_V2.0 4M 4 + 2
Ruiying RY-8GT-1SX No FG-8GT-1SX 1M 8 + 1
SiscoLink SL-G0402F No PCB-K0402WS-V3.0 4 + 2
Sodola SL-SWTG124AS-D Yes SWTG024AS-v2.0-17452 2M 4 + 2
Steamemo IG204-V1 No PB-2131 4 + 2
TrendNet TEG-S562 No TEG-S563/EU H/W: V1.0R 2M 4 + 2
Xikestore SKS3200M-4GPY2XF Yes SWTG024AS-v1.0 4 + 2
XikeStor SKS3200-8E1X Yes SWTG118AS-V2.1-17462 2M 8 + 1
Ztyuav Z-QWYT0402 No PCB-K0402WS-V3.0 4 + 2
Guangnianwei 7018-2.5G No F7008-2.5GPOE-V1.2 8M 8 + 1

For KP-9000-6XH-X2 / KP-9000-6XHML-X2 / Mokerlink 2G040210GSM devices, select the machine target by PCB revision. The ML/non-ML or managed/unmanaged label alone does not identify the wiring.

Other device based on RTL8272/3 that may work are described here: Up-N-Atoms 2.5 GBit RTL Switch hacking guide

Many of the RTL8272/3 devices come in versions with PoE support. The RTLPlayground usually also works on these, however, no support for configuring PoE is provided, simply because these devices usually just provide PoE on all ports without further configuration possibilitites.

The following forum also discusses this type of switches: ServeTheHome

There are also 16-port unmanaged devices with RTL8272 SoCs, however these devices do not have serial consoles and use 4 independent RTL8272 SoCs. No central control is provided by RTLPlayground, even if it has been successfully demonstrated to install RTLPlayground to individual SoCs.