Huawei 5680 OLT native vlan configuration method

📅 Published: 🔄 Updated:

Configuring native VLANs on a Huawei OLT is essential for managing untagged traffic properly. This guide covers the two-part process — configuring the ONU port and configuring the OLT uplink port — plus the upstream and downstream packet rules that govern how VLAN tags are added or stripped.

Part 1: Configure Native VLAN on the ONU Port

Command Function

This command configures the default VLAN of the ONT port. When the native VLAN function is enabled, the native VLAN is added to inbound untagged packets. For outbound packets, if the packet VLAN matches the native VLAN, the VLAN tag is stripped.

Command Syntax

ont port native-vlan [frame/slot/port] [ont-id] eth [eth-port] vlan [vlan-id]

Example

Set the native VLAN of ETH port 1 of ONT 0 under GPON port 0/3/1 to 100:

ont port native-vlan 1 0 eth 1 vlan 100

Part 2: Configure Native VLAN on the OLT Uplink Port

Command Function

This command configures the native VLAN of the Ethernet uplink port. When enabled, the OLT determines whether outgoing packets carry VLAN tags by comparing packet VLAN IDs with the port’s native VLAN ID.

  • VLAN ID matches native VLAN — Packet is untagged (no VLAN tag).
  • VLAN ID differs from native VLAN — Packet retains its VLAN tag.

For inbound untagged packets, the native VLAN is added. By default, the native VLAN of an Ethernet port is 1.

Command Syntax

native-vlan [frame/slot] vlan [vlan-id]

Example

Set the native VLAN of Ethernet port 0/19/0 to 2:

native-vlan 0 vlan 2

Upstream Packet Rules on ONU Ports

The upstream rules of ONU ports may have various configurations:

  • PVID — Inbound untagged packets get PVID assigned; outbound packets matching PVID are stripped.
  • Single tag — Single VLAN tag applied.
  • Double tag — QinQ double VLAN tag applied.
  • Untag — No VLAN tag.

Downstream rules are generally processed in the reverse direction of the upstream rules (unless otherwise configured).

Complete Configuration Example

Scenario

  • GPON Port: 0/3/1
  • ONT ID: 0
  • ETH Port: 1
  • ONU Native VLAN: 100
  • OLT Uplink Port: 0/19/0
  • OLT Native VLAN: 2
# Step 1: Configure ONU port native VLAN
ont port native-vlan 1 0 eth 1 vlan 100

# Step 2: Configure OLT uplink port native VLAN
native-vlan 0 vlan 2

# Step 3: Save configuration
save
💡 Practical Tip Always verify VLAN configurations with display vlan all and display ont port state after applying changes.

Verification Commands

CommandPurpose
display vlan allShow all configured VLANs
display ont port state 0 0 eth 1Check ONT ETH port state and VLAN
display port vlan 0/19/0Show VLAN info on uplink port

Practical Technician Tips

  • 🔧 Always run save after configuration — otherwise changes are lost on reboot.
  • 🔧 Default native VLAN is 1 — change it if your upstream network uses a different management VLAN.
  • 🔧 Mismatched native VLANs between ONU and OLT will cause untagged traffic to be dropped.
  • 🔧 Use display ont port state to confirm the ONT’s ETH port actually negotiated link.
  • 🔧 Double-tag (QinQ) requires matching service-port and traffic-table profiles.

Frequently Asked Questions

Q1: What is the default native VLAN on a Huawei OLT?

The default native VLAN on an Ethernet port is 1. You can change it with the native-vlan command.

Q2: What happens to untagged packets arriving at the OLT uplink port?

Untagged inbound packets are assigned the native VLAN configured on that port.

Q3: What happens to tagged packets that match the native VLAN on egress?

The VLAN tag is stripped — the packet leaves the port untagged.

Q4: Does the ONU native VLAN need to match the OLT native VLAN?

Not necessarily. They can differ, but the service-port mapping and traffic profile must be consistent end-to-end to avoid dropped traffic.

Q5: How do I verify the native VLAN on an ONT ETH port?

Run display ont port state [frame/slot/port] [ont-id] eth [eth-port] on the OLT.

Q6: Can I configure multiple native VLANs on one port?

No — only one native VLAN per port is allowed. Use service-ports and VLAN mapping for multiple VLANs.

Q7: Why is my untagged traffic being dropped?

Common causes: native VLAN mismatch between ONU and OLT, missing service-port mapping, or VLAN not created on the OLT. Verify with display vlan all.

Q8: Do I need to create the VLAN before configuring native VLAN?

Yes. The VLAN must exist in the OLT’s VLAN table. Create it with vlan [id] smart or vlan [id] common first.

Related Articles

Disclaimer: This guide is for educational purposes. VLAN and native VLAN configuration depends on your specific network topology, firmware version, and service-port mappings. Always test in a lab environment first and verify against your OLT’s official Huawei documentation before applying to production.

Sources / References: Huawei MA5680T / MA5800 CLI Reference Manual • Huawei GPON Configuration Guide • IEEE 802.1Q (VLAN Tagging Standard)