Documenting current limitation in OpenFlowOpticalSwitch.

- Background information can be found in ONOS-3736 and the following thread:
 https://gerrit.onosproject.org/#/c/6945/1

Change-Id: I47644b9045fb5aa6c371a25894fb5bee0121a3ac

@@ -15,9 +15,27 @@
  */
  */
 package org.onosproject.openflow.controller;
 package org.onosproject.openflow.controller;
 
 
+import java.util.List;
+
+import org.projectfloodlight.openflow.protocol.OFPortDesc;
+
+import com.google.common.annotations.Beta;
+
 /**
 /**
  * A marker interface for optical switches, which require the ability to pass
  * A marker interface for optical switches, which require the ability to pass
  * port information to a Device provider.
  * port information to a Device provider.
  */
  */
 public interface OpenFlowOpticalSwitch extends OpenFlowSwitch, WithTypedPorts {
 public interface OpenFlowOpticalSwitch extends OpenFlowSwitch, WithTypedPorts {
+
+    // OpenFlowOpticalSwitch only returns Ethernet ports.
+    // This is a limitation due to issue described in ONOS-3796.
+    // This method should return all port type once the limitation is fixed.
+    /**
+     * Returns a list of standard (Ethernet) ports.
+     *
+     * @return List of standard (Ethernet) ports
+     */
+    @Beta
+    @Override
+    abstract List<OFPortDesc> getPorts();
 }
 }