Como provisionar ONU na OLT Huawei: ont add, service-port e VLAN passo a passo

Para provisionar ONU Huawei na OLT MA5800 você precisa de quatro peças no lugar certo: um perfil de banda (DBA), um perfil de linha, um perfil de serviço e um service-port amarrando a ONU à VLAN do seu provedor. Se uma delas estiver errada, a ONU até acende o LED PON, mas o cliente fica sem internet.

Este tutorial mostra como provisionar ONU Huawei do começo ao fim, do display ont autofind ao teste de sinal com display ont optical-info. Todos os comandos estão em blocos prontos para copiar e foram escritos para a linha MA5800 (X2, X7, X15 e X17) com placas GPON como GPHF e GPSF.

No fim você encontra os erros que mais derrubam técnico de provedor: ONT offline, SN duplicado, perfil que não casa com o modelo e VLAN que não passa. Também listo os equipamentos que uso na bancada de testes, com preços conferidos em 01/10/2026 nas lojas.

Onde comprar com o menor preçoPreços conferidos em 01/10/2026

ONU Huawei EchoLife EG8145V5R$ 180EG8145V5 V2 dual bandIr à lojaR$ 178,60EchoLife EG8145V5Ir à loja

ONU Huawei EchoLife HG8310MR$ 82HG8310M bridge 1 GEIr à loja

OLT Huawei SmartAX MA5800-X2R$ 12.999MA5800-X2Ir à loja

Módulo SFP GPON OLT classe C++ compatível HuaweiR$ 299SFP GPON OLT C++ 9 dBmIr à loja

Power Meter Óptico Joinwit JW3208AR$ 136,12power meter ópticoIr à loja

Ver todas as ofertas atualizadas:Mercado LivreAmazon

Resposta rápida: como provisionar ONU Huawei em 10 passos

Se você já sabe provisionar ONU Huawei e só quer o roteiro, é este. Os detalhes de cada passo vêm logo abaixo.

1. Achar a ONU: display ont autofind all mostra o SN de quem está esperando autorização.
2. Criar as VLANs de dados e de gestão e liberar as duas no uplink: vlan 100 smart, vlan 40 smart e port vlan na porta 0/3/0.
3. Criar o DBA de upload do plano: dba-profile add ... type4 max 1048576.
4. Criar a traffic table do plano e da gestão, que limita a banda no service-port: traffic table ip index.
5. Criar o perfil de linha com T-CONT, GEM port por prioridade e TR-069: ont-lineprofile gpon com tr069-management ip-index.
6. Criar o perfil de serviço com as portas do modelo de ONU: ont-srvprofile gpon.
7. Criar os perfis de WAN e de rota (só para ONU roteadora): ont wan-profile e ont policy-route-profile.
8. Adicionar a ONU pelo SN, chamando os perfis pelo nome: ont add ou ont confirm.
9. Configurar a saída da ONU: ont port native-vlan na bridge, ou ont ipconfig e ont wan-config na roteadora.
10. Criar os service-ports e salvar: um para a VLAN 100 na GEM 1, outro para a VLAN 40 na GEM 2, e save.

No fim do passo a passo ficam as consultas de verificação e os erros que mais aparecem em campo.

Equipamentos citados no tutorial:

• ONU Huawei EG8145V5: a ONU roteadora Wi-Fi mais comum nos provedores brasileiros.
• ONU Huawei HG8310M: ONU bridge de uma porta, barata e simples de provisionar.
• OLT Huawei MA5800-X2: a OLT compacta usada nos exemplos.
• Módulo SFP GPON classe C++: o óptico que define o alcance da porta PON.
• Power meter óptico Joinwit JW3208A: para medir o sinal antes de culpar a configuração.

Pré-requisitos antes de configurar a OLT Huawei

Antes de configurar OLT Huawei para clientes, confirme que a base está pronta. Se você ainda não fez a configuração inicial, comece pelo nosso guia de configuração inicial da OLT Huawei, que cobre IP de gerência, usuários, SNMP e NTP.

Checklist:

• Placas confirmadas: display board 0 deve mostrar a placa GPON como Normal. Placa em Auto_find precisa de board confirm 0.
• Uplink definido: anote a porta que sobe para o seu concentrador (BNG, MikroTik ou roteador de borda). Nos exemplos eu uso 0/3/0.
• VLAN do serviço: combine com quem cuida do PPPoE qual VLAN chega no concentrador. Aqui uso VLAN 100 para internet.
• Acesso em modo config: usuário com nível de administrador, via SSH ou console.
• Sinal medido: a ONU precisa receber entre -8 dBm e -27 dBm. Fora disso, nenhum comando resolve.

Para entrar no modo de configuração, o caminho é sempre o mesmo:

MA5800-X2> enable
MA5800-X2# config
MA5800-X2(config)#

Se está começando no CLI, deixe aberta a nossa lista de comandos básicos da OLT Huawei MA5800. A lógica de display, undo e quit é a mesma dos comandos de roteadores e switches Huawei.

Antes do primeiro comando de configuração eu rodo estas consultas. Levam um minuto e evitam descobrir um problema no meio da ativação, com o cliente ao telefone:

display board 0
display vlan 100
display ont-lineprofile gpon all
display ont-srvprofile gpon all
display ont info by-sn 48575443A1B2C3D4

• display board 0: a GPHF tem de aparecer como Normal. Placa em outro estado aceita parte dos comandos e falha no ont add.
• display vlan 100: a VLAN precisa existir antes do service-port. Se não existir, o ont add passa, o service-port falha e a ONU fica registrada na OLT sem serviço nenhum.
• display ont-lineprofile gpon all e display ont-srvprofile gpon all: listam os perfis que já existem. Reaproveito o que está lá e não crio perfil com ID que já está em uso.
• display ont info by-sn: mostra se aquele SN já está cadastrado em outra porta. ONU que voltou de troca ou de cancelamento costuma estar lá ainda.

Quando a ativação é feita por script, e não digitando, mais três linhas entram no começo da sessão:

scroll 512
undo smart
undo interactive

O scroll 512 aumenta a página do terminal e some com o ---- More ---- nas saídas longas. O undo smart e o undo interactive desligam as perguntas que a OLT faz no meio de alguns comandos. Esse smart é do terminal e não tem relação com o tipo de VLAN.

Aprendi isso do jeito ruim. Um display grande parou no More, o espaço da linha seguinte virou “próxima página” e o ont add chegou cortado na OLT. A resposta foi Unknown command e o script seguiu como se nada tivesse acontecido. Antes de provisionar ONU Huawei por script, coloque essas três linhas no topo.

Como a MA5800 organiza o serviço: DBA, T-CONT, GEM port e VLAN

Para provisionar ONU Huawei sem chute, entenda as camadas. Quem vem de switch Ethernet estranha o GPON porque o tráfego passa por três camadas antes de chegar na VLAN. Entender isso evita metade dos erros.

• DBA profile: define quanta banda de upload a ONU pode pedir. É a regra de alocação dinâmica da norma ITU-T G.984.
• T-CONT: é o “contêiner” de upload da ONU. Ele usa um DBA profile.
• GEM port: é o canal lógico dentro do T-CONT. Cada serviço (internet, IPTV, VoIP) costuma ter o seu.
• Mapeamento: diz qual VLAN entra em qual GEM port.
• Service-port: do lado da OLT, liga a GEM port daquela ONU à VLAN que sobe pelo uplink.

Os três perfis têm papéis diferentes, e é por isso que a Huawei separa tudo:

O download do plano costuma ser limitado no concentrador PPPoE. O DBA cuida do upload na árvore PON. Dá para limitar download na OLT com traffic table, mas provedor pequeno raramente faz.

Passo a passo para provisionar ONU Huawei na MA5800

Para provisionar ONU Huawei nos exemplos abaixo, uso a placa GPON no slot 1, porta PON 0, ONU de ID 1, VLAN 100 para dados e VLAN 40 para gestão. Troque esses números pelos da sua rede. Todos os comandos rodam no modo config, salvo quando indico interface gpon.

Passo 1: encontrar a ONU com display ont autofind

Ligue a ONU na fibra e espere o LED PON ficar fixo ou piscando devagar. Depois rode:

display ont autofind all

A saída mostra a porta (F/S/P), o SN, a versão de software e o modelo (Ont EquipmentID). Anote o SN completo, como 48575443A1B2C3D4. O prefixo 48575443 é “HWTC” em hexadecimal, a marca das ONUs Huawei.

Se a lista vier vazia, a porta pode estar com descoberta desligada. Ative assim:

interface gpon 0/1
port 0 ont-auto-find enable
quit

Passo 2: criar as VLANs de dados e de gestão no uplink

Na minha rede cada ONU usa duas VLANs. A 100 leva o PPPoE do cliente até o concentrador. A 40 é a de gestão: por ela a ONU fala com o servidor TR-069 (ACS), que configura Wi-Fi, troca senha e atualiza firmware sem ninguém ir à casa do cliente.

vlan 100 smart
vlan 40 smart
port vlan 100 0/3 0
port vlan 40 0/3 0

O tipo smart isola os assinantes entre si dentro da mesma VLAN, que é o que se quer em acesso residencial. As duas linhas de port vlan liberam as VLANs na porta de uplink 0/3/0. Sem elas o tráfego entra na OLT e não sai para lugar nenhum.

Se a VLAN 40 ficar de fora, a navegação funciona normal, porque o PPPoE vai pela 100. O sintoma aparece depois: a ONU nunca se registra no ACS e o suporte não consegue mexer nela remotamente. Por isso, para provisionar ONU Huawei roteadora, eu crio as duas VLANs juntas, sempre.

Passo 3: criar o dba-profile

dba-profile add profile-id 10 profile-name "DBA_1G" type4 max 1024000

O valor é em kbit/s, então 1024000 equivale a 1 Gbit/s. O type4 é “best effort”: a ONU usa o que sobrar até o máximo. Para clientes empresariais com banda garantida, use type3 assure 102400 max 1024000.

Confira os perfis existentes com display dba-profile all. A OLT traz perfis de fábrica, mas prefiro criar os meus com nome claro.

Na OLT em produção o perfil de 1G é este, e logo abaixo vai a consulta que faço antes de mexer em qualquer DBA:

dba-profile add profile-id 12 profile-name "DBA_1G_PROD" type4 max 1048576
display dba-profile profile-id 2

O 1048576 é 1024 × 1024 kbit/s, ou seja, 1 Gbit/s exato. O 1024000 do exemplo acima fica um pouco abaixo disso. Na prática os dois servem para plano de 1 giga; em produção ficou o 1048576, que fecha 1024 Mbit/s.

O display dba-profile profile-id 2 tem motivo. No line profile de produção, o T-CONT 0 fica com o dba-profile-id 2, perfil que já vem de fábrica e que a convenção reserva para o canal de gerência OMCI. Alterar esse perfil mexe em todas as ONUs cujo line profile usa o DBA 2. Então, antes de provisionar ONU Huawei com esse line profile, eu confiro o que tem nele e não edito.

Passo 4: criar a traffic table ip do plano e da gestão

O DBA e a traffic table parecem fazer a mesma coisa, mas atuam em pontos diferentes. O DBA limita só o upload, dentro da árvore PON, decidindo quanto cada T-CONT pode transmitir. A traffic table é aplicada no service-port e limita a banda nos dois sentidos, upload e download, já do lado da OLT.

traffic table ip index 45 name "GESTAO" cir 9216 cbs 296912 pir 18432 pbs 591824 color-mode color-blind priority 5 priority-policy local-setting
traffic table ip index 46 name "PLANO_1G_UP" cir 1024000 priority 0 priority-policy local-setting
traffic table ip index 47 name "PLANO_1G_DOWN" cir 1024000 priority 0 priority-policy local-setting

A tabela de gestão está na forma completa, igual à de produção. Campo por campo:

Essa priority vale dentro da OLT, no service-port. Ela não muda a GEM que a ONU escolheu: a gestão continua saindo pela GEM 2, porque o ont ipconfig marca priority 2. O 5 só dá à gestão prioridade na fila da OLT e no uplink. Esse par, 2 na ONU e 5 na OLT, é o que uso em produção. Se mudar o 2, mude junto o gem mapping do line profile.

As tabelas do plano de 1G só têm o cir. Sem cbs e pir a própria OLT calcula os valores que faltam. Separei uma tabela para subida e outra para descida, mesmo com valores iguais: quem lê o service-port vê na hora qual sentido cada uma limita, e um plano assimétrico muda só uma delas. Se a sua versão recusar, use a forma completa com cbs, pir e pbs, como na tabela de gestão.

Para conferir uma tabela, ou listar as três a partir do índice 45:

display traffic table ip index 45
display traffic table ip from-index 45

Passo 5: criar o ont-lineprofile com tcont e gemport

ont-lineprofile gpon profile-id 10 profile-name "LINE_VLAN100"
 tcont 1 dba-profile-id 10
 gem add 1 eth tcont 1
 gem mapping 1 0 vlan 100
 commit
 quit

Linha por linha: o T-CONT 1 usa o DBA 10; a GEM port 1 é do tipo Ethernet e fica dentro do T-CONT 1; o mapeamento 0 da GEM 1 aceita a VLAN 100. O commit é obrigatório. Sem ele, o perfil fica salvo pela metade e nenhuma ONU sobe com ele.

Para IPTV ou VoIP em VLAN própria, adicione outra GEM port no mesmo perfil, como gem add 2 eth tcont 1 e gem mapping 2 0 vlan 200.

O perfil acima serve para bancada. O de produção, que uso para todos os clientes, é este. Ele leva três filas na mesma ONU: internet, gestão por TR-069 e uma terceira reservada para voz.

ont-lineprofile gpon profile-id 87 profile-name "LINE_FTTH_PADRAO"
 fec-upstream enable
 tr069-management enable
 tr069-management ip-index 1
 mapping-mode priority
 tcont 0 dba-profile-id 2
 tcont 1 dba-profile-id 12
 tcont 2 dba-profile-id 12
 tcont 3 dba-profile-id 12
 gem add 1 eth tcont 1
 gem add 2 eth tcont 2
 gem add 3 eth tcont 3
 gem mapping 1 1 priority 0
 gem mapping 2 1 priority 2
 gem mapping 3 1 priority 5
 commit
 quit

Linha por linha, com o motivo de cada uma estar ali:

• fec-upstream enable: liga a correção de erros no sentido ONU para OLT. Gasta um pouco de banda, mas segura o link de cliente no fim do splitter, com sinal perto do limite.
• tr069-management enable: libera a gestão remota da ONU pelo servidor ACS. Sem esta linha a ONU nunca procura o ACS, mesmo com a WAN de gestão no ar.
• tr069-management ip-index 1: diz qual WAN da ONU leva o tráfego TR-069. O número tem de ser o mesmo ip-index da WAN de gestão criada com ont ipconfig, que neste exemplo é a 1. Se os números não baterem, a ONU tenta falar com o ACS pela WAN errada.
• mapping-mode priority: a ONU escolhe a GEM port pelo 802.1p do pacote, e não pela VLAN. É isso que deixa o perfil independente da VLAN do cliente.
• tcont 0 dba-profile-id 2: o T-CONT 0 fica com o canal de gerência OMCI, usando o DBA 2 que vem de fábrica. É uma convenção que sigo em todos os perfis, não uma exigência da OLT.
• tcont 1 a tcont 3 com dba-profile-id 12: os três contêineres de upload usam o DBA de 1G criado no Passo 3.
• gem add 1, 2 e 3: cada GEM port fica no seu próprio T-CONT. Assim, uma fila de dados lotada não atrasa a gestão.
• gem mapping 1 1 priority 0, gem mapping 2 1 priority 2 e gem mapping 3 1 priority 5: o segundo número é o índice do mapeamento, e a priority casa com o priority do ont ipconfig. Priority 0 é dados, 2 é gestão e 5 fica para voz.
• commit e quit: gravam o perfil e saem dele, como no perfil de bancada.

A vantagem aparece quando a rede cresce. Com um único line profile por mapeamento de prioridade, o mesmo perfil serve qualquer VLAN de cliente: quem define a VLAN é o ont ipconfig e o service-port. Na OLT que eu administro, esse perfil basta para provisionar ONU Huawei em todos os planos residenciais, e só crio outro quando o mapeamento de prioridade muda.

Passo 6: criar o ont-srvprofile do modelo

ont-srvprofile gpon profile-id 10 profile-name "SRV_EG8145V5"
 ont-port pots adaptive 32 eth adaptive 8
 port vlan eth 1 translation 100 user-vlan 100
 commit
 quit

O adaptive deixa a OLT aceitar a quantidade de portas que a ONU informar, o que evita erro de perfil quando você mistura modelos. Já um perfil com eth 4 pots 2 fixo só casa com ONU que tenha exatamente isso.

Para uma ONU bridge de uma porta, como a HG8310M, crie um perfil só com Ethernet:

ont-srvprofile gpon profile-id 20 profile-name "SRV_BRIDGE_1GE"
 ont-port eth 1
 port vlan eth 1 translation 100 user-vlan 100
 commit
 quit

Passo 7: criar o wan-profile e o policy-route-profile da roteadora

Este passo só vale para quem vai provisionar ONU Huawei em modo roteador. Se a ONU é bridge, siga direto para o Passo 8. Os dois perfis são criados uma vez na OLT e reaproveitados em todas as ativações, do mesmo jeito que o line profile.

ont wan-profile profile-id 1 profile-name "WAN-NAT"
 nat enable
 quit

O ont wan-profile guarda opções de uma WAN da ONU. O de produção só tem nat enable. Sozinho ele não faz nada: passa a valer quando o ont wan-config o aplica a uma WAN da ONU, na hora da ativação. O comando aparece na seção da ONU roteadora, mais abaixo.

ont policy-route-profile profile-id 0 profile-name "ROTA_LAN_WAN"
 policy-route 0 port-based eth 1-4 wlan 1-8 wan 1
 quit

O ont policy-route-profile amarra portas da ONU a uma WAN. A linha policy-route 0 port-based eth 1-4 wlan 1-8 wan 1 liga as LAN 1 a 4 e os SSIDs 1 a 8 a uma WAN da ONT, e é o valor que roda em produção. Alguns guias aplicam esse perfil ONU por ONU com ont policy-route-config. Se for usar, confirme a sintaxe com ? no firmware da sua OLT antes de colocar o comando em script.

Passo 8: adicionar a ONU com ont add ou ont confirm

Entre na interface da placa e adicione a ONU pelo SN que você anotou:

interface gpon 0/1
ont add 0 1 sn-auth "48575443A1B2C3D4" omci ont-lineprofile-id 10 ont-srvprofile-id 10 desc "CLI0001_JOAO_RUA_A_123"

Os números 0 1 são a porta PON e o ID da ONU naquela porta. Cada porta aceita até 128 IDs (0 a 127). O omci diz que a OLT vai gerenciar a ONU pelo canal OMCI, definido na norma ITU-T G.988.

O ont confirm faz a mesma coisa, mas parte da lista do autofind:

ont confirm 0 ontid 1 sn-auth "48575443A1B2C3D4" omci ont-lineprofile-id 10 ont-srvprofile-id 10 desc "CLI0001_JOAO_RUA_A_123"

Depois do comando, a OLT responde com “Number of ONTs that can be added: 1, success: 1”. Se aparecer outra coisa, pule para a seção de erros.

Em produção eu não passo o ONT ID nem o ID dos perfis. O comando fica assim:

interface gpon 0/1
ont add 0 sn-auth "48575443A1B2C3D4" omci ont-lineprofile-name "LINE_FTTH_PADRAO" ont-srvprofile-name "SRV_EG8145V5" desc "CLI0001_JOAO_RUA_A_123"
quit

Sem o ONT ID, a OLT pega o primeiro ID livre da porta PON, e não preciso consultar a porta antes. Os perfis vão pelo nome porque o nome é igual em todas as OLTs da rede, enquanto o ID muda de uma para outra conforme a ordem em que cada perfil foi criado. Um script que usa ID funciona numa OLT e cadastra o perfil errado na vizinha. A OLT responde assim:

  Number of ONTs that can be added: 1, success: 1
  PortID :0, ONTID :1

Leia o ONTID da saída: é ele que entra no ont ipconfig e nos service-ports dos próximos passos. No desc, nem acento nem espaço. O terminal envia ASCII, e um “Condomínio” no meio da linha quebra o script de quem vai provisionar ONU Huawei em lote. Use _ no lugar do espaço, como no exemplo.

Passo 9: ajustar a native-vlan da porta da ONU

Em ONU bridge, a porta LAN entrega tráfego sem tag para o roteador do cliente. A native-vlan diz à ONU qual VLAN aplicar nesse tráfego:

interface gpon 0/1
ont port native-vlan 0 1 eth 1 vlan 100 priority 0
quit

Em ONU roteadora com WAN PPPoE, a própria WAN marca a VLAN 100 e a native-vlan não é necessária. Muita gente configura assim mesmo, para testar a porta 1 em bridge na bancada.

Passo 10: criar os service-ports de dados e de gestão

De volta ao modo config, crio dois service-ports por ONU: um para os dados do cliente e outro para a gestão. Cada um liga uma GEM port da ONU à VLAN que sobe pelo uplink e aplica as traffic tables do Passo 4. O ont 1 é o ONTID que a OLT devolveu no ont add.

service-port vlan 100 gpon 0/1/0 ont 1 gemport 1 multi-service user-vlan 100 tag-transform translate inbound traffic-table name PLANO_1G_UP outbound traffic-table name PLANO_1G_DOWN
service-port vlan 40 gpon 0/1/0 ont 1 gemport 2 multi-service user-vlan 40 tag-transform translate inbound traffic-table name GESTAO outbound traffic-table name GESTAO
save

• vlan 100 com gemport 1: dados do cliente. A GEM 1 recebe a priority 0 no line profile, por isso a VLAN 100 vai nela, limitada por PLANO_1G_UP e PLANO_1G_DOWN.
• vlan 40 com gemport 2: o tráfego TR-069 sai pela GEM 2 (priority 2) e chega à VLAN 40, onde está o ACS. A tabela GESTAO vale nos dois sentidos.
• inbound é o upload, o que entra na OLT vindo da ONU. outbound é o download. Por isso o plano usa duas tabelas, uma para cada sentido.
• ONU bridge precisa só da primeira linha, porque não tem WAN de gestão para falar com o ACS.

A última linha é o save. O que não foi salvo some num reboot. Sem save, as ONUs ativadas no dia não voltam depois de uma queda de energia. Quando vou provisionar ONU Huawei em lote, dou save ao fim de cada bloco, e não só no fim do expediente.

ONU bridge ou roteadora: o que muda no provisionamento

A sequência para provisionar ONU Huawei serve para os dois casos. Muda só quem faz o PPPoE.

• ONU bridge (HG8310M): a ONU só converte luz em Ethernet. O roteador do cliente disca o PPPoE na VLAN que a native-vlan entregou. Provisionar é rápido e o suporte fica no roteador.
• ONU roteadora (EG8145V5): a ONU disca o PPPoE e faz Wi-Fi. A WAN pode ser configurada na interface web da ONU, por TR-069 (ACS) ou pela própria OLT via OMCI.

Para provisionar ONU Huawei em bridge, o trabalho termina no Passo 9 e no primeiro service-port do Passo 10. O PPPoE fica no roteador do cliente, e a OLT só precisa entregar a VLAN 100 sem tag na porta LAN:

interface gpon 0/1
ont port native-vlan 0 1 eth 1 vlan 100 priority 0
quit

Roteadora: PPPoE, gestão TR-069 e rota da LAN

Na ONU roteadora, a OLT configura a WAN PPPoE, a WAN de gestão e o roteamento das portas LAN pelo OMCI. É assim que ativo a EG8145V5 sem abrir a interface web da ONU:

interface gpon 0/1
ont ipconfig 0 1 ip-index 0 pppoe vlan 100 priority 0 user-account username "joao123" password "senha123"
ont ipconfig 0 1 ip-index 1 dhcp vlan 40 priority 2
ont internet-config 0 1 ip-index 0
ont wan-config 0 1 ip-index 1 profile-name "WAN-NAT"
ont port route 0 1 eth 1-4 enable
quit

A ordem importa. O ont ipconfig vem antes do internet-config e do wan-config, porque os dois apontam para um ip-index que precisa existir. Outro detalhe: a senha PPPoE fica gravada na configuração da OLT, então quem lê display current-configuration vê usuário e senha do cliente. Controle quem tem acesso de leitura à OLT.

Os parâmetros do wan-config variam com a versão de firmware da OLT. Se o comando recusar, use ? no fim da linha para ver as opções da sua versão. Se ainda vai escolher o chassi, veja a comparação no post irmão deste tutorial: OLT Huawei MA5800: diferenças entre X2, X7, X15 e X17.

Como verificar se a ONU subiu: display ont info e optical-info

Depois de provisionar ONU Huawei, confira três coisas: estado, sinal e tráfego.

display ont info 0 1 0 1

Os números são frame, slot, porta e ID. Os campos que importam:

• Run state: online. Qualquer outra coisa indica problema.
• Config state: normal. “Failed” significa perfil que não casou com a ONU.
• Match state: match. “Mismatch” aponta diferença entre o srvprofile e as portas reais da ONU.
• Last down cause: LOS (fibra), dying-gasp (energia) ou LOFi (sinal ruim).

Para o sinal óptico, entre na interface:

interface gpon 0/1
display ont optical-info 0 1
quit

A faixa de -8 a -27 dBm segue a classe B+ da norma ITU-T G.984.2. Na prática, eu considero -25 dBm o limite saudável, porque sobra margem para emenda nova e conector sujo.

Para confirmar que o tráfego está passando, veja se a OLT aprendeu MACs no service-port:

display service-port port 0/1/0 ont 1
display mac-address port 0/1/0

Procure na lista a linha com o ID da ONU. Se aparece o MAC do roteador do cliente ou da WAN da ONU, a camada 2 está fechada. O resto é PPPoE no concentrador.

Consultas que uso depois de cada ativação

O display ont info olha uma ONU por vez. Aqui, antes de liberar o técnico eu rodo esta sequência, que fecha o ciclo de provisionar ONU Huawei em modo roteadora: estado da porta PON inteira, WAN da ONU e portas LAN.

display ont info summary 0/1/0
display ont wan-info 0/1 0 1
interface gpon 0/1
display ont port state 0 1 eth-port all
quit

O summary mostra uma linha por ONU da porta, com estado, motivo da última queda e descrição. Serve para ver se a ONU nova subiu sem derrubar nenhuma vizinha. O wan-info roda fora da interface, no modo de configuração global; o port state precisa estar dentro de interface gpon 0/1, por isso o quit no fim.

No display ont wan-info aparecem as duas WANs criadas pelo ont ipconfig. A de ip-index 0 é o PPPoE e precisa mostrar o IP entregue pelo concentrador e o status Connected. A de ip-index 1 é a gestão e deve ter um IP do pool da VLAN 40. Se a gestão pega IP e o PPPoE não conecta, a OLT está certa e quase sempre o erro é usuário, senha ou concentrador.

O display ont port state confirma link e velocidade de cada porta LAN. Cliente de plano de 1 Giga com a porta em 100 Mbit/s não é problema de OLT: quase sempre é cabo de rede com par rompido ou placa de rede antiga no computador. Mostrar isso para o técnico na hora economiza uma visita.

Por último confiro se a ONU ficou com os perfis certos e com os dois service-ports:

display ont-lineprofile gpon profile-id 87
display ont-srvprofile gpon profile-id 10
display service-port port 0/1/0 ont 1

No line profile eu olho o tr069-management ip-index e o mapeamento de prioridade; no srvprofile, a quantidade de portas do modelo. No display service-port têm de aparecer duas linhas para a ONU 1, uma na VLAN 100 e outra na VLAN 40, ambas com estado up. Se só aparece uma, a ativação ficou pela metade.

Erros comuns ao provisionar ONU Huawei e como resolver

Estes são os quatro problemas que mais travam quem vai provisionar ONU Huawei, com a causa e o comando que confirma.

ONT offline ou não aparece no autofind

• Sem luz: display ont optical-info sem leitura ou Last down cause LOS. Meça a fibra.
• Já cadastrada: ONU que já tem ID não aparece no autofind. Procure com display ont info by-sn 48575443A1B2C3D4.
• Autofind desligado: rode port 0 ont-auto-find enable na interface gpon.
• Porta desligada: display port state 0 na interface. Se estiver deactivated, use undo shutdown 0.
• ONU de outra marca: sem compatibilidade OMCI, ela pode aparecer e não subir. A Semeo Consultoria explica o desbloqueio para ONUs de terceiros neste guia sobre a MA5800.

SN duplicado: “The SN already exists”

A OLT não aceita o mesmo SN duas vezes. Acontece quando o técnico troca a ONU de porta ou reaproveita um aparelho de cliente cancelado. Ache o cadastro antigo e apague, sempre removendo o service-port primeiro:

display ont info by-sn 48575443A1B2C3D4
display service-port port 0/1/2 ont 5
undo service-port 1001
interface gpon 0/1
ont delete 2 5
quit

Se tentar apagar a ONU com service-port ativo, a OLT recusa. Essa ordem vale para qualquer remoção.

Perfil errado: Config state failed ou Match state mismatch

É o clássico srvprofile com pots 2 numa HG8310M, que não tem porta de telefone. Ou um line profile sem commit. Para trocar o perfil sem apagar a ONU:

interface gpon 0/1
ont modify 0 1 ont-srvprofile-id 20
ont reset 0 1
quit

Confira o conteúdo dos perfis com display ont-srvprofile gpon profile-id 20 e display ont-lineprofile gpon profile-id 10. Perfil em uso por ONUs não pode ser apagado, só editado.

VLAN não passa: ONU online e cliente sem internet

ONU online com cliente sem PPPoE é quase sempre VLAN. Siga esta ordem:

1. A VLAN existe e está no uplink? display vlan 100 deve listar a porta 0/3/0.
2. O line profile leva o tráfego para a GEM certa? No perfil por VLAN, confira o gem mapping; no perfil por prioridade (mapping-mode priority), confira se a priority do ont ipconfig bate com o gem mapping.
3. O service-port usa user-vlan igual ao mapeamento e a GEM port certa?
4. Em bridge, a native-vlan da porta eth está na VLAN 100?
5. No concentrador, a interface PPPoE escuta na VLAN 100?

Se a OLT mostra MAC aprendido no service-port e o PPPoE não fecha, o problema já saiu da OLT.

ont add passou e o service-port falhou

É o erro mais traiçoeiro de quem vai provisionar ONU Huawei por script. O ont add não depende da VLAN, então a ONU entra, fica online e aparece normal no display ont info. O service-port, que vem depois, é recusado porque a VLAN não existe na OLT. O resultado é uma ONU registrada e sem serviço nenhum.

Não apague a ONU. Recadastrar pode trocar o ONT ID se outra ativação pegou o número livre nesse meio-tempo, e o técnico perde a referência. Confira o que já existe e crie a VLAN no uplink:

display service-port port 0/1/0 ont 1
vlan 100 smart
port vlan 100 0/3 0
display vlan 100

O primeiro display mostra quais service-ports já existem para a ONU, assim você não duplica o que passou. O último confirma que a VLAN 100 ficou com a porta 0/3/0. Com a VLAN no lugar, rode de novo só as linhas de service-port do Passo 10 e termine com save.

Unknown command no meio do script

Quando um script de ativação devolve Unknown command numa linha que está certa, o comando chegou cortado ou chegou na hora errada. Na minha experiência são três causas: a paginação do terminal, uma pergunta interativa da OLT esperando resposta e caractere acentuado no desc.

A correção é a mesma da seção de pré-requisitos: scroll 512, undo smart e undo interactive no começo de toda sessão, e desc só com letras sem acento, números e _. Para achar a linha que quebrou, leia o eco do terminal logo antes do erro: a linha anterior costuma ser um display longo ou um comando que pediu confirmação.

Não rode o script inteiro de novo. Se o ont add já passou, repetir dá SN duplicado. Continue a partir da linha que falhou.

Boas práticas para configurar OLT Huawei em provedor

Provisionar ONU Huawei uma vez é fácil. Fazer isso 3 mil vezes sem bagunça pede regras simples desde o primeiro cliente.

• Padrão no desc: código do cliente, nome curto e endereço, sem acento e sem espaço. Facilita a busca com display ont info by-desc.
• Poucos perfis: um line profile por mapeamento (por VLAN ou por prioridade) e um srvprofile por modelo. Perfil por cliente vira caos.
• Índices previsíveis: se usar índice manual no service-port, siga uma lógica, como slot, porta e ID.
• Sinal registrado: salve o Rx da ativação no sistema do provedor. Quando o cliente reclamar, você compara.
• Backup diário: automatize a cópia da configuração. Mostramos como em script de backup automático da OLT Huawei.
• Save sempre: termine toda janela de manutenção com save.
• Integração com ERP: sistemas como IXC, SGP e Voalle fazem o ont add e o service-port via Telnet ou SSH. Crie os perfis com os mesmos nomes e IDs em todas as OLTs, iguais aos que o ERP espera.

A documentação oficial da linha está no portal de suporte da Huawei para a SmartAX MA5800, com os guias de configuração por versão de firmware.

Comparativo dos equipamentos para provisionar e testar

Estes são os equipamentos usados nos exemplos. A OLT você provavelmente já tem; as ONUs e as ferramentas de medição valem para qualquer bancada de provedor.

Deslize a tabela para o lado para ver todas as colunas.

ONU Huawei EG8145V5: a roteadora padrão dos provedores

ONU Huawei EchoLife EG8145V5

ONU GPON roteadora com Wi-Fi 5 dual band, 4 portas Gigabit e telefone, provisionada direto pela OLT Huawei.

a partir de R$ 178,60

EG8145V5 V2 dual bandR$ 180Ir à loja

EG8145V5-V2 pretaR$ 249Ir à loja

EchoLife EG8145V5 · AmazonR$ 178,60Ir à loja

A EG8145V5 virou o modelo de referência porque junta Wi-Fi 5 dual band, 4 portas Gigabit e uma porta de telefone num aparelho que a MA5800 provisiona sem ajuste. Ela aparece no autofind com EquipmentID “EG8145V5”.

• Prós: compatibilidade total com OLT Huawei, WAN configurável por OMCI ou TR-069, Wi-Fi suficiente para apartamento.
• Contras: Wi-Fi 5 já mostra a idade em casa grande; unidades usadas podem vir travadas com firmware de operadora.
• Para quem é: provedor que entrega Wi-Fi gerenciado e quer reduzir chamado de roteador de terceiros.

Nos anúncios, a dúvida comum é se a unidade vem “desbloqueada”. Em OLT Huawei isso pouco importa; exija acesso à interface web.

ONU Huawei HG8310M: bridge simples de uma porta

ONU Huawei EchoLife HG8310M

ONU GPON bridge com 1 porta Gigabit, sem Wi-Fi, ideal para cliente com roteador próprio e bancada de testes.

a partir de R$ 82

HG8310M bridge 1 GE · catálogoR$ 82Ir à loja

A HG8310M é a ONU mais simples da Huawei: uma porta Gigabit, sem Wi-Fi e sem telefone. É ideal para treinar como provisionar ONU Huawei, porque o srvprofile fica com uma linha só (ont-port eth 1).

• Prós: barata, consome pouco, configuração mínima, fácil de achar usada.
• Contras: depende de roteador do cliente; modelo antigo, com estoque cada vez mais de usados.
• Para quem é: clientes que já têm roteador mesh, empresas com firewall próprio e bancada de testes.

OLT Huawei MA5800-X2: a OLT dos exemplos

OLT Huawei SmartAX MA5800-X2

OLT GPON compacta de 2U com 2 slots, até 32 portas GPON e os mesmos comandos de provisionamento da X7 e X17.

a partir de R$ 12.999

MA5800-X2 · catálogoR$ 12.999Ir à loja

A MA5800-X2 tem 2U, 2 slots de serviço e até 32 portas GPON com placas de 16 portas. É a porta de entrada da linha e roda exatamente os mesmos comandos de provisionamento da X7 e da X17.

• Prós: compacta, fonte CA ou CC, até 2.048 ONUs com splitter 1:64.
• Contras: sem redundância de controladora; preço alto para quem está começando.
• Para quem é: provedor de 300 a 2.000 clientes ou POP de bairro.

Módulo SFP GPON classe C++: o alcance da porta PON

Módulo SFP GPON OLT classe C++ compatível Huawei

Óptico de porta PON com +6 a +10 dBm e 20 km, para placas GPHF e GPSF quando a ONU chega no limite de sinal.

a partir de R$ 299

SFP GPON OLT C++ 9 dBmR$ 299Ir à loja

O SFP da OLT define quanta perda a rede aguenta. O classe C++ transmite de +6 a +10 dBm e cobre 20 km com splitters em cascata, contra +3 a +7 dBm do C+. Se a ONU está no limite de -27 dBm, trocar um C+ por C++ costuma salvar a porta inteira.

• Prós: mais margem óptica, mesmos comandos, troca a quente.
• Contras: em rede curta pode saturar ONUs perto da OLT; compatíveis variam de qualidade.
• Para quem é: redes rurais, árvores com splitter 1:64 e portas com clientes longe.

Power meter óptico Joinwit JW3208A: meça antes de mexer na OLT

Power Meter Óptico Joinwit JW3208A

Medidor de potência óptica de -70 a +10 dBm em 1310, 1490 e 1550 nm, para conferir o sinal antes de provisionar.

a partir de R$ 136,12

power meter óptico · AmazonR$ 136,12Ir à loja

mini medidor de potência ópticaR$ 138,21Ir à loja

Antes de provisionar ONU Huawei, meça: metade dos chamados de “ONU não sobe” é sinal. O JW3208A mede de -70 a +10 dBm em 850, 1300, 1310, 1490, 1550 e 1625 nm, com conector universal de 2,5 mm. Em GPON, meça em 1490 nm no ponto do cliente.

• Prós: barato, pilhas AA, leitura direta em dBm.
• Contras: não separa comprimentos de onda com a ONU ligada, como faz um PON power meter.
• Para quem é: todo técnico de campo e toda bancada de ativação.

Quanto custa montar a bancada para provisionar ONU Huawei

Preços conferidos em 01/10/2026 nas lojas, em faixas, porque variam com estado (novo ou usado) e vendedor:

• ONU EG8145V5: de R$ 145 a R$ 300.
• ONU HG8310M: de cerca de R$ 60 a R$ 130.
• OLT MA5800-X2: a partir de cerca de R$ 13.000 só com chassi e controladora; completa, até R$ 27.200.
• SFP GPON C++: de R$ 280 a R$ 570.
• Power meter JW3208A: de cerca de R$ 80 a R$ 200.

Uma bancada de testes com duas ONUs, um power meter, cordões SC/APC e um atenuador sai por menos de R$ 700, sem contar a OLT. Testar perfil numa porta de laboratório evita derrubar uma árvore inteira em produção.

Perguntas frequentes

Qual a diferença entre ont add e ont confirm na OLT Huawei?

Os dois cadastram a ONU com os mesmos parâmetros: SN, line profile e srvprofile. O ont add funciona mesmo sem a ONU ligada, então serve para pré-cadastro. O ont confirm parte da lista do display ont autofind e exige que a ONU esteja conectada. Exemplo: ont confirm 0 ontid 1 sn-auth seguido do SN e dos IDs dos perfis.

Quantas ONUs cabem numa porta PON da MA5800?

A MA5800 aceita até 128 ONUs por porta GPON, com IDs de 0 a 127. Na prática, provedores usam splitter 1:64 ou menos, porque o orçamento óptico da classe C+ ou C++ não comporta 128 clientes com boa margem. Uma placa GPHF de 16 portas com 1:64 atende 1.024 ONUs.

Por que a ONU fica online mas o cliente não navega?

Em 9 de cada 10 casos é VLAN. Confira se a VLAN 100 está no uplink com display vlan 100, se o gem mapping do line profile usa a mesma VLAN (ou, no perfil por prioridade, a mesma priority do ont ipconfig), se o service-port tem user-vlan igual e se a native-vlan da porta eth está correta em ONU bridge. Se há MAC aprendido no service-port, o problema está no concentrador.

Qual o sinal ideal da ONU no display ont optical-info?

A ONU deve receber entre -8 dBm e -27 dBm, faixa da classe B+ da norma ITU-T G.984.2. Considere -8 a -24 dBm como bom e, na prática, -25 dBm como limite saudável. Acima de -8 dBm a ONU satura e precisa de atenuador; abaixo de -27 dBm limpe conectores e meça a rede com power meter.

Como apagar uma ONU da OLT Huawei?

Primeiro remova os service-ports dela com undo service-port seguido do índice, que você encontra em display service-port port 0/1/0 ont 1. Depois entre em interface gpon 0/1 e rode ont delete 0 1, onde 0 é a porta e 1 o ID. A OLT recusa apagar a ONU enquanto houver service-port ativo.

Posso usar ONU de outra marca na OLT Huawei MA5800?

Pode, desde que a ONU siga o padrão OMCI da ITU-T G.988 e a OLT esteja configurada para aceitar terceiros. Modelos como ZTE F670L e Nokia costumam subir em bridge, mas recursos como Wi-Fi gerenciado e WAN por OMCI podem não funcionar. Teste cada modelo numa porta de bancada antes de levar a campo.

Preciso criar um perfil para cada cliente?

Não. Crie um dba-profile por plano ou um geral, um ont-lineprofile por VLAN e um ont-srvprofile por modelo de ONU. Com três ou quatro perfis você atende milhares de clientes. A diferença entre clientes fica no SN, no desc, no ID da ONU e no service-port, além do login PPPoE no concentrador.

Esqueci de dar save: perco a configuração?

Perde se a OLT reiniciar. A MA5800 guarda as mudanças na memória de execução e só grava na flash com o comando save. Uma queda de energia sem save apaga as ONUs cadastradas desde o último salvamento. Por isso, termine toda janela com save e mantenha um backup automático diário da configuração.

Para que serve o tr069-management ip-index no line profile?

Ele diz à ONU por qual WAN ela fala com o servidor TR-069 (ACS). O número tem de ser o mesmo ip-index da WAN de gestão criada com ont ipconfig. Se apontar para a WAN do PPPoE ou para um índice que não existe, a ONU navega normalmente, mas some do ACS e você perde o acesso remoto ao Wi-Fi e ao firmware. O índice pode ser outro, desde que os dois casem. Na hora de provisionar ONU Huawei roteadora, confira esse par antes do ont add.

Qual a diferença entre dba-profile e traffic table na MA5800?

O dba-profile controla quanto do upstream compartilhado da porta PON cada T-CONT da ONU pode usar, então só atua no upload dentro do PON. A traffic table é aplicada no service-port e limita a banda nos dois sentidos: inbound é o upload e outbound é o download. Quando o plano é limitado na OLT, como neste tutorial, a velocidade sai da traffic table, e o DBA precisa ser igual ou maior que o plano para não virar gargalo.

Conclusão: provisionar ONU Huawei sem errar

A receita tem duas partes. O que você cria uma vez por OLT: VLANs de dados e de gestão no uplink, DBA, traffic tables, line profile com T-CONT, GEM e TR-069, srvprofile do modelo, perfil de WAN e perfil de rota. Por cliente sobra pouco: ont add, ont ipconfig na roteadora ou native-vlan na bridge, os service-ports (dois na roteadora, um na bridge) e o save.

Com os perfis prontos e nomeados igual em todas as OLTs, provisionar ONU Huawei vira um bloco curto que dá para colar sem medo. Quando algo falhar, siga a ordem: sinal no optical-info, perfil no display ont info, VLAN e service-port, e por fim a WAN no wan-info. Cada etapa descarta uma camada antes de passar para a próxima.

Se a sua bancada ainda não tem ONU de teste ou power meter, os cards acima mostram os modelos e as faixas de preço do dia. Confira as ofertas e monte a sua antes da próxima ativação.