Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
ISO/IEC 29341-26-14: UPnP WANEthernetLinkConfig Service — Ethernet WAN Link Configuration
Technical Reference for Configuring Ethernet-Specific WAN Link Parameters via the UPnP WANEthernetLinkConfig Service
Introduction to WANEthernetLinkConfig
ISO/IEC 29341-26-14 defines the WANEthernetLinkConfig service, a lightweight UPnP service focused specifically on Ethernet-based WAN interfaces. In modern broadband architectures, Ethernet WAN (also known as Ethernet in the First Mile or EFM) is increasingly deployed for fiber-to-the-premises (FTTP) and metro Ethernet services. This service provides a standardized interface for reading and, where supported, configuring Ethernet-specific link parameters on the WAN port.
Unlike WANCommonInterfaceConfig which provides aggregate interface statistics, WANEthernetLinkConfig targets Ethernet-specific parameters such as MAC address, link duplex mode, and auto-negotiation status. It is the Ethernet equivalent of the DSL-specific configuration found in WANDSLLinkConfig.
The service is deliberately minimal by design, containing a small set of state variables and actions compared to other WAN services. This reflects the fact that Ethernet WAN interfaces are typically straightforward — they require less configuration than DSL or PPP links. The core responsibility of this service is to expose the Ethernet MAC address of the WAN interface and to provide link-layer diagnostic capabilities.
Service Architecture and State Variables
The WANEthernetLinkConfig service exposes several key state variables. The EthernetLinkStatus variable reports the current link state — Up, Down, or Unknown. The MACAddress variable provides the WAN Ethernet interface’s MAC address in standard colon-delimited hexadecimal notation (e.g., “00:1A:2B:3C:4D:5E”). This is particularly important for ISP provisioning, where MAC address binding is commonly used for IP address allocation and access control.
The WAN MAC address exposed by WANEthernetLinkConfig may differ from the LAN-side MAC address exposed by the LAN device services. Some gateways implement MAC address translation or use a separate MAC pool for the WAN interface. Always use the WANEthernetLinkConfig source for ISP-facing MAC address queries.
The service optionally supports the GetAdapterType and SetAdapterType actions, enabling the selection of Ethernet adapter mode (e.g., “AutoSense”, “10BaseT”, “100BaseTX”, “1000BaseT”). However, many residential gateways implement these actions as no-ops or return “Unsupported” because the adapter type is determined by the hardware platform and auto-negotiation, not software configuration.
| Action | Arguments | Description |
|---|---|---|
| GetMACAddress | Out: NewMACAddress | Retrieve the WAN Ethernet MAC address |
| GetAdapterType | Out: NewAdapterType | Get current Ethernet adapter mode |
| SetAdapterType | In: NewAdapterType | Set Ethernet adapter mode (if supported) |
| GetLinkStatus | Out: NewEthernetLinkStatus | Get current Ethernet link state |
Practical Engineering Applications
From a network engineering perspective, the WANEthernetLinkConfig service serves three primary use cases. First, MAC address discovery for ISP provisioning — when deploying a new gateway or replacing an existing one, the control point can programmatically retrieve the WAN MAC address and register it with the ISP’s self-provisioning portal. Second, link diagnostics — by monitoring the EthernetLinkStatus variable over time, engineers can detect flapping Ethernet links that may indicate faulty cables or port hardware issues.
For redundant WAN deployments with multiple Ethernet interfaces, the WANEthernetLinkConfig service on each interface enables independent link monitoring. Combined with the WANCommonInterfaceConfig counters, this provides per-interface health assessment essential for load-balancing and failover decisions.
Third, the service supports automated troubleshooting. When EthernetLinkStatus is Down, the control point can check the MACAddress to confirm the correct interface is being monitored, then escalate to checking physical connectivity (cable, SFP module, or ONT power). Some advanced gateways also expose AdapterType to verify that auto-negotiation has completed successfully and that the link is operating at the expected speed and duplex mode.
A common deployment pitfall is MAC address spoofing or cloning. When a gateway is configured to clone a PC’s MAC address for ISP compatibility, the WANEthernetLinkConfig service must report the cloned MAC address, not the hardware MAC. Not all implementations handle this correctly — always verify that the reported MAC address matches what the ISP sees on its DHCP or PPPoE server logs.
The service is particularly relevant in FTTH (Fiber to the Home) deployments where the ONT (Optical Network Terminal) presents an Ethernet handoff to the customer router. In this scenario, the WANEthernetLinkConfig service reports the status of the Ethernet link between the router and the ONT, providing a clear demarcation point for troubleshooting physical connectivity issues.
Frequently Asked Questions
Q: Is WANEthernetLinkConfig always present in UPnP gateways?
A: No. This service is only present when the WAN physical interface is Ethernet-based. DSL gateways typically omit this service in favor of WANDSLLinkConfig. Fiber and cable modem gateways usually include it alongside WANCommonInterfaceConfig.
A: No. This service is only present when the WAN physical interface is Ethernet-based. DSL gateways typically omit this service in favor of WANDSLLinkConfig. Fiber and cable modem gateways usually include it alongside WANCommonInterfaceConfig.
Q: Can I change the WAN MAC address using this service?
A: The standard does not include a SetMACAddress action. MAC address configuration, if supported, is typically done through vendor-specific extensions or the gateway’s web management interface, not through UPnP.
A: The standard does not include a SetMACAddress action. MAC address configuration, if supported, is typically done through vendor-specific extensions or the gateway’s web management interface, not through UPnP.
Q: Does this service report Ethernet error statistics?
A: No, Ethernet-level error statistics (CRC errors, collisions, frame errors) are not exposed by this service. For error statistics, use the WANCommonInterfaceConfig counters (TotalErrorsReceived, TotalErrorsSent).
A: No, Ethernet-level error statistics (CRC errors, collisions, frame errors) are not exposed by this service. For error statistics, use the WANCommonInterfaceConfig counters (TotalErrorsReceived, TotalErrorsSent).
Q: What does “EthernetLinkStatus = Unknown” mean?
A: This status typically indicates that the Ethernet interface driver is initializing or that the interface is in a power-saving state. It should transition to Up or Down within a few seconds. Persistent Unknown status may indicate a driver or hardware fault.
A: This status typically indicates that the Ethernet interface driver is initializing or that the interface is in a power-saving state. It should transition to Up or Down within a few seconds. Persistent Unknown status may indicate a driver or hardware fault.
