Fibra / GPON — Aprovisionamiento de la Red Óptica — Cómo Quaza gestiona OLTs, cajas, ONUs y la cadena hasta el cliente final
Esta wiki explica el módulo Fibra — el sistema que conecta la red óptica (OLT/splitter/ONU) al cadastro del cliente, automatizando la provisión.
Pantalla "ONU" — gestión central
Visión general — la red GPON
El módulo Fibra de Quaza gestiona toda la cadena óptica: desde la OLT (Transmisor) en el POP, pasando por las Cajas de Atención (splitters), hasta las ONUs en casa del cliente.
┌─────────────┐ fibra ┌──────────────┐ fibra ┌──────────────┐
│ OLT │──────▶│ CAJA DE │──────▶│ ONU │
│ (Transmisor) │ 1:N │ ATENCIÓN │ 1:N │ (cliente) │
│ POP │ │ (splitter) │ │ MAC + LOID │
└─────────────┘ └──────────────┘ └──────────────┘
│ │
▼ ▼
┌──────────┐ ┌──────────────┐
│ PERFIL │ ◀──── aplicado a la ONU ───── │ ContratoLogin│
│ (QoS) │ │ (cliente) │
└──────────┘ └──────────────┘
Cuando una nueva ONU es descubierta por la OLT, queda en "No Autorizada" hasta que un técnico la vincule con un cliente (ContratoLogin), defina perfil QoS y caja física.
Glosario — vocabulario óptico
| Término |
Significa |
| ONU |
Optical Network Unit — equipo en casa del cliente. Identificada por MAC o LOID. |
| OLT |
Optical Line Terminal — concentrador en el POP. Sirve hasta 32-64 ONUs por puerto PON. |
| Transmisor / Punto Transmisor |
OLT física + ubicación (POP). |
| Caja de Atención |
Caja con splitter óptico (1:8, 1:16, 1:32, 1:64). Distribuye la fibra a las casas. |
| Perfil |
Script de configuración GPON aplicado a la ONU (varía por fabricante). |
| FlowProfile |
Perfil QoS — tasa de download/upload por servicio. |
| LOID |
Identificador lógico de ONU (alternativa al MAC, usado por algunos fabricantes). |
| Señal RX/TX |
Potencia óptica recibida (RX) y transmitida (TX), medida en dBm. Valores típicos: -8 a -28 dBm. |
| Rede Neutra |
Otro ISP usa nuestra infraestructura de fibra — Quaza factura por puerto al socio. |
| ONU No Autorizada |
ONU detectada por la OLT pero aún sin vinculación a cliente. |
Pantallas y sus propósitos
| Pantalla |
Para qué sirve |
| ONU |
Gestión central de ONUs activas — buscar, editar, ver historial de señales, autorizar/eliminar. |
| ONU No Autorizada |
Triaje de ONUs descubiertas por la OLT. Aquí vinculas a cliente, perfil y caja. |
| Perfil |
Scripts GPON por transmisor + fabricante. Cada marca tiene su sintaxis. |
| Punto Transmisor / OLT |
Cadastro de OLTs (IP gerencia, FTP backup, EMS, versión firmware). |
| Caja de Atención |
Splitters con capacidad, georeferencia, señal disponible. |
| ONU Histórico |
Serie temporal de señales (TX/RX/temperatura/voltagem) para diagnóstico. |
| ONU Modelo |
Catálogo de modelos de ONU (marca, série, características). |
| Rede Neutra Parceiro |
Vincular contrato/cliente al parceiro que usa nuestra infraestructura. |
Flujo de aprovisionamiento de una ONU
1 Descubierta: OLT enxerga ONU nueva (MAC), Quaza registra en fibraOnuNaoAutorizada con slotno/ponno.
2 Triaje "No Autorizada": Admin abre la pantalla, vincula:
-
idLogin → ContratoLogin (cliente)
-
idPerfil → script GPON
-
idCaixa → caja física
- FlowProfile (QoS), CoS
3 Autorización: Botón "Autorizar" dispara Service\Fibra\Onu::autorizar() → tarefa CRON aplica configuración.
4 Aplicación: Service\Fibra\Fibra::aplicar() → factory por fabricante (Fiberhome/Huawei/ZTE/...) → envía comandos vía TELNET/API/SSH.
5 Activación: ONU pasa a fibraOnu con status=ATIVA. Remueve MAC reservado. Contrato pasa de PRECADASTRO a ACTIVO.
Integraciones con otros módulos
-
Cliente / Contrato: ONU.idLogin → ContratoLogin → Cliente. Sin contrato, sin ONU activa.
-
RADIUS / Concentrador (Challenger): ONU puede ser provisionada vía RADIUS (PPPoE) o IPoE — depende del modo.
-
Rede: ONU usa Grupo de rede (banda) para FlowProfile.
-
Tarefa CRON: tareas
fibraonuverificar, fibraaplicar, fibraonuprecadastrar automatizan polling/aplicación.
-
Importación CSV/FTP:
fibraonuimportar.php permite carga en masa de ONUs nuevas.
Trampas frecuentes
Trampa 1 — Modelo de ONU es obligatorio: Si el modelo cambia entre marcas, el script de configuración (Perfil) también cambia. Una ONU Huawei con script Fiberhome no se aprovisiona — falla silenciosa.
Trampa 2 — ONU "Concluida" en triaje: El campo concluida marca que el aprovisionamiento terminó. Si está en false, la ONU sigue "incompleta" aunque parezca activa.
Trampa 3 — Histórico ≠ Histórico de Alteraciones: OnuHistorico guarda señales (TX/RX) — es time-series. OnuHistoricoAlteracao guarda quién/cuándo cambió qué — es auditoría. No confundir.
Trampa 4 — Señal RX baja = problema en el cliente: Si RX en la ONU es muy bajo (ej. -28 dBm), el cliente verá inestabilidad. Usar ONU Qualidade para alertar automáticamente cuando salir de los límites.
Trampa 5 — Rede Neutra factura aparte: ONUs vinculadas a RedeNeutraParceiro tienen faturamento separado (por puerto). No mezcla con factura del cliente final.
Galería de pantallas
Fibra onu
Fibra onunaoautorizada
Fibra perfil
Fibra pontotransmissor
Fibra caixaatendimento
Fibra onuhistorico
Fibra onumodelo
Fibra redeneutra
Preguntas frecuentes
¿Cómo empezar a usar este módulo?
Configure los pre-requisitos listados arriba, haga un teste en ambiente seguro (o con pocos registros), valide con el equipo, y solo después active en producción.
¿Necesito permiso especial para acceder?
Sí. Cada rol (operador/supervisor/admin) tiene permisos distintos. Confirme con el administrador del Quaza.
¿Puedo integrar con sistemas externos?
Vía API REST del Quaza. Webhooks notifican eventos importantes. Consulte el equipo técnico para credenciales.
¿Qué pasa si hay error?
Los logs quedan en el panel de tareas/auditoría. Configure alertas (email/Slack) para fallas críticas — no confíe en nadie mirando log manualmente.
¿Cómo acompañar cambios?
Cada registro tiene histórico (timestamp, usuario, acción). Use el filtro de auditoría para rastrear modificaciones sospechosas.
¿El módulo funciona multi-filial?
Sí — vía centro de costo (filial) atribuido al asiento. Reportes filtran por filial.
Documentos relacionados
Preguntas frecuentes
¿La ONU se autoriza sola?
Depende de OnuConfiguracao. Si AUTORIZACAO_AUTOMATICA, sí — sino, admin debe abrir "No Autorizada".
¿Qué hago si la OLT no descubre ONU nueva?
1) Verificar fibra y splitter; 2) Comprobar tarefa CRON fibraonuverificar activa; 3) Ver log de la OLT.
¿Puedo cambiar el plan del cliente sin reaprovisionar la ONU?
Sí — cambia el FlowProfile vía pantalla ONU. La aplicación re-envía solo el comando QoS.
¿Cuántos fabricantes soporta?
17+ (Fiberhome, Huawei, ZTE, Intelbras, Parks, VSOL, Datacom, Nokia, Cianet, etc.) — cada uno con script propio.