More documentation clean-up.
diff --git a/net/api/src/main/java/org/onlab/onos/net/Device.java b/net/api/src/main/java/org/onlab/onos/net/Device.java
index 8b6368d..700654f 100644
--- a/net/api/src/main/java/org/onlab/onos/net/Device.java
+++ b/net/api/src/main/java/org/onlab/onos/net/Device.java
@@ -3,14 +3,63 @@
import org.onlab.onos.net.provider.Provided;
/**
- * Representation of an network infrastructure device.
+ * Representation of a network infrastructure device.
*/
public interface Device extends Provided {
- // type, e.g. switch, router, firewall, ips, controller
+ /**
+ * Coarse classification of the type of the infrastructure device.
+ */
+ public enum Type {
+ SWITCH, ROUTER, FIREWALL, BALANCER, IPS, IDS, CONTROLLER, OTHER
+ }
- // id (uri within)
+ /**
+ * Returns the device identifier.
+ *
+ * @return device id
+ */
+ DeviceId id();
- // ports
+ /**
+ * Returns the type of the infrastructure device.
+ *
+ * @return type of the device
+ */
+ Type type();
+
+ /**
+ * Returns the device manufacturer name.
+ *
+ * @return manufacturer name
+ */
+ String manufacturer();
+
+ /**
+ * Returns the device hardware version.
+ *
+ * @return hardware version
+ */
+ String hwVersion();
+
+ /**
+ * Returns the device software version.
+ *
+ * @return software version
+ */
+ String swVersion();
+
+ /**
+ * Returns the device serial number.
+ *
+ * @return serial number
+ */
+ String serialNumber();
+
+ // Device realizedBy(); ?
+
+ // ports are not provided directly, but rather via DeviceService.getPorts(Device device);
+
+ // Set<Behavior> behaviours(); // set of supported behaviours
}