Primeros pasos

Esta guía describe cómo integrar OLT Tenda Soft UI con Wispx: acceso remoto, registro en el panel e importación de ONUs.

Si la OLT ya tiene clientes activos, basta con agregarla en Wispx, sincronizar inventario e importar ONUs existentes.

Configuración en MikroTik

Wispx se conecta por SSH o Telnet desde su servidor. El MikroTik debe enrutar ese tráfico hasta la OLT:

• Ruta estática o conectada hacia la subred de gestión de la OLT (ej. 136.1.1.0/24).
• Regla de firewall que permita SSH/Telnet desde la IP del túnel WireGuard de Wispx.
• Si la OLT no tiene IP pública: dst-nat del puerto de gestión hacia la IP privada de la OLT.
• Opcional: interfaz WireGuard hacia Wispx (ej. wispx-vpn) en el MikroTik de borde.

Agregar OLT en Wispx

En el panel de Wispx:

• Red → OLT → Agregar OLT.
• Seleccione el modelo exacto del listado.
• Indique IP de conexión alcanzable desde el servidor Wispx, IP privada de gestión, usuario y contraseña CLI.
• Elija SSH o Telnet según lo que exponga su equipo.
• Asocie el MikroTik de salto si el tráfico pasa por RouterOS.

CLI y web Soft UI

La misma OLT se administra por Telnet ([Admin]#) o por la web Vue (GPON OLT). Wispx usa Telnet; la web confirma el mismo modelo de autorización.

Módulos web útiles: Authentication (modo SN + whitelist), Unauthorized List (Auth ONTs), Authorized List (servicio VLAN del puerto), Service VLAN (VLAN en uplinks 6:1–6:5), SFU Service Template.

• Web Unauthorized List → Auth ONTs envía unauthorizedList.type=authorize con slot, pon, onuType (SG101) y SN.
• Eso equivale en CLI a: sn-whitelist + ont-auth-gpon SG101 <SN> <slot> <pon> <onuIndex>.
• Discovery Soft UI usa a veces ONU-ID temporal 127: no sirve para auth; Wispx remapea a un índice libre (1, 2, …).
• Si el SN ya está en auth-info, Wispx no falla: sincroniza ficha/VLAN (authorize idempotente).

Autorizar ONU desde Wispx

OLT → ONU sin autorizar → Bridge (IP en MikroTik), modelo, VLAN de servicio y plan de velocidad.

ONU C-Data bridge (sin menú VLAN)

Modelos tipo FD511G / CDTC… no tienen VLAN en la caja. El tráfico del PC sale untagged.

En Soft UI el servicio correcto es customer-vlan transparent + translate hacia el CVLAN de servicio. El tag OMCI «tag» suele no aplicar bien en estas SFU.

• CLI: customer-vlan … transparent 0 33024 all + translate-vlan … enable 0 33024 <vlan>.
• Reinicie la ONU tras cambiar el servicio para que OMCI aplique.
• Compruebe MAC en OLT: display ont-mac-table <slot> <pon> <onu> → vid=0 confirma untagged desde el CPE.

ONU Huawei bridge (HG8310M / HWTC)

Soft UI detecta muchas Huawei como HG1002/EG8120L (HGU). Wispx fuerza perfil SFU SG101 con ont-type-custom (HWTC/EG8120L/HG8310M → SG101) y autoriza como la C-Data.

Servicio: ETH 1, transparent + translate al VLAN del plan, perfil v{vlan}tr (ej. v5tr). El PC va untagged; el MikroTik con gateway en la interfaz física si el NNI llega untagged.

Si la ONU está up pero no hay MAC de cliente en Soft UI ni ARP en el MikroTik, revise link del LAN de la Huawei. Soft UI + HG8310M a veces autoriza y no pasa datastream; en esa OLT conviene C-Data/HSGQ.

• ont-type-custom-add HWTC EG8120L HG1002 SG101 (y variantes).
• ont-auth-gpon SG101 <SN> … + customer-vlan … 1 … transparent + translate.
• No usar el perfil vlan5 ID 1 (tagged) para bridges transparent.

ONU HSGQ X100DG / XPON

Soft UI mapea HSGQ X100DG → tipo SG101 (con ont-type-custom si hace falta).

Algunas HSGQ no aplican bien el tag por OMCI: en campo puede usarse VLAN manual en la ONU con el mismo CVLAN que espera la OLT, o el modo tag en Authorized List.

MikroTik y LAN de clientes

Con Bridge (IP en MikroTik), el router debe tener gateway en la subred de clientes y NAT hacia la WAN.

Si el servicio Soft UI es transparent (C-Data típica), el tráfico hacia el MikroTik puede llegar sin tag 802.1Q por el puerto que une OLT↔router. En ese caso el gateway de clientes va en esa interfaz física (o bridge), no en una subinterfaz VLAN que nunca recibe frames.

Si el NNI sí entrega el CVLAN etiquetado, use /interface vlan en el MikroTik con el mismo VLAN ID y ponga ahí el gateway.

• Confirme con ARP: la IP del cliente debe quedar reachable en la interfaz correcta.
• Service VLAN Soft UI: registre el CVLAN tagged (o untagged) en los uplinks 6:1–6:5 según el cableado real.
• Wispx: corte morosos / captive HTTP en el MikroTik vinculado; no mezclar con caminos ZTE.

Checklist si no hay internet

Ordene el diagnóstico L2 → L3 → NAT:

• OLT: ONU up en ont-status y PASS en discovery.
• OLT: display service info → transparent+translate (C-Data) o tag (si la ONU etiqueta).
• MikroTik: ARP del cliente reachable en la interfaz donde realmente llega el tráfico (física o vlan).
• Cliente: IP, máscara, gateway y DNS correctos.
• NAT: masquerade (o src-nat) hacia la WAN para la subred de clientes.

ONUs en Wispx

Desde el detalle de la OLT puede importar ONUs, pre-autorizar nuevas, ver señal RX y asociar clientes.

Use el mapa FTTH y las zonas/NAPs para organizar la planta externa.