+Device represents a machine with a unique address in the network.
+It can contain as well a name for easier identification.
+A device contains a list of service types.
+
+
+
Attributes
+
+
Address
+
Name (optional)
+
+
+
+
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/discovery.png b/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/discovery.png
new file mode 100644
index 000000000..030ddbe93
Binary files /dev/null and b/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/discovery.png differ
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/discovery_model.gif b/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/discovery_model.gif
new file mode 100644
index 000000000..a3e530651
Binary files /dev/null and b/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/discovery_model.gif differ
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/list.png b/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/list.png
new file mode 100644
index 000000000..e2012531c
Binary files /dev/null and b/discovery/org.eclipse.tm.discovery.doc.isv/guide/images/list.png differ
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/model.html b/discovery/org.eclipse.tm.discovery.doc.isv/guide/model.html
new file mode 100644
index 000000000..1b6f13847
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/guide/model.html
@@ -0,0 +1,27 @@
+
+
+
+
+
+
+
+Model
+
+
+
Model
+
+Service discovery stores the information in a EMF model as following:
+
+
+
+
+
+
+
+
+The service discovery engine will fill this model using the provided protocol and transport implementations, and can be accessed after using the standard EMF methods.
+
+Each service can contain multiple pairs of keys and values to provide extra information about the service.
+
+
+Using service discovery with the Remote System Explorer requires a "tranport" key matching the transport specified in org.eclipse.rse.core.subsystemConfigurations.
+
+
+
+
Attributes
+
+
Key
+
Value
+
+
+
+
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/protocol.html b/discovery/org.eclipse.tm.discovery.doc.isv/guide/protocol.html
new file mode 100644
index 000000000..d4ee7b4a7
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/guide/protocol.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+
+
+Protocol
+
+
+
Protocol
+
+It specifies the protocol that will be used to interact with the remote devices.
+Protocols have to be specified as extensions of org.eclipse.tm.discovery.engine.discoveryProtocol.
+
+
+Examples of discovery protocols are:
+
+
DNS Service Discovery (DNS-SD)
+
Service Location Protocol (SLP, srvloc)
+
Simple Service Discovery Protocol (SSDP)
+
...
+
+
+
+
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/service.html b/discovery/org.eclipse.tm.discovery.doc.isv/guide/service.html
new file mode 100644
index 000000000..0d870ef74
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/guide/service.html
@@ -0,0 +1,23 @@
+
+
+
+
+
+
+
+Service
+
+
+
Service
+
+Service represents a discovered service available in the remote device grouped under a common service type.
+
+
+
Attributes
+
+
Name
+
+
+
+
+
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/servicetype.html b/discovery/org.eclipse.tm.discovery.doc.isv/guide/servicetype.html
new file mode 100644
index 000000000..4ae97d891
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/guide/servicetype.html
@@ -0,0 +1,28 @@
+
+
+
+
+
+
+
+Service Type
+
+
+
Service Type
+
+A service type represents a group of services of the same kind discovered in the parent device.
+Service type names should follow standard service names whenever possible.
+
+
+
+
+
Attributes
+
+
Name
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/transport.html b/discovery/org.eclipse.tm.discovery.doc.isv/guide/transport.html
new file mode 100644
index 000000000..ca9f91ebd
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/guide/transport.html
@@ -0,0 +1,26 @@
+
+
+
+
+
+
+
+Transport
+
+
+
Transport
+
+Transport defines how the remote devices are accessed to be queried for available services.
+Transports have to be specified as extensions of org.eclipse.tm.discovery.engine.discoveryTransport.
+
+
+Examples of transport are:
+
+
UDP
+
TCP
+
serial
+
...
+
+
+
+
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/usage.html b/discovery/org.eclipse.tm.discovery.doc.isv/guide/usage.html
new file mode 100644
index 000000000..ac381cf98
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/guide/usage.html
@@ -0,0 +1,46 @@
+
+
+
+
+
+
+
+Programmatic usage
+
+
+
Programmatic usage
+
+Perform service discovery session:
+
+
+
+int timeout = 500; // milliseconds
+String query = "_services._dns-sd._udp.local."; //DNS-SD query
+
+//instantiate protocol by name attribute
+IProtocol protocol = ProtocolFactory.getProtocol("DNS-SD");
+
+//instantiate transport by name attribute
+ITransport transport = TransportFactory.getTransport("UDP", "224.0.0.251", timeout);
+
+//get engine instance and kick off discovery
+ServiceDiscoveryEngine serviceDiscoveryEngine = ServiceDiscoveryEngine.getInstance();
+serviceDiscoveryEngine.doServiceDiscovery(query, protocol,transport);
+
+
+
+
+
+
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/guide/view.html b/discovery/org.eclipse.tm.discovery.doc.isv/guide/view.html
new file mode 100644
index 000000000..1189ae0be
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/guide/view.html
@@ -0,0 +1,37 @@
+
+
+
+
+
+
+
+Discovery View
+
+
+
Discovery View
+
+The Discovery view can be used to test new extensions and discover available services using the existing protocol and transport implementations.
+It can be accessed through the view "Service Discovery" -> "Service Discovery Properties".
+
+In the view, it's possible launching a wizard to select the protocol and transport to be used:
+
+
+
+
+
+
+
+And inspect the discovered services and their attributes:
+
+
+
+
+
+
+
+Since the same model is used, launching multiple times the wizard adds new discovered services to the same model, even using different protocols and transports.
+
+
+
+
+
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/plugin.properties b/discovery/org.eclipse.tm.discovery.doc.isv/plugin.properties
new file mode 100644
index 000000000..7e69f616f
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/plugin.properties
@@ -0,0 +1,16 @@
+###############################################################################
+# Copyright (c) 2007 Symbian Software Ltd.
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# Contributors:
+# Javier Montalvo Orus - initial API and implementation
+###############################################################################
+
+# NLS_MESSAGEFORMAT_NONE
+# NLS_ENCODING=UTF-8
+
+pluginName=Service Discovery ISV Documentation
+providerName=Eclipse.org
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/plugin.xml b/discovery/org.eclipse.tm.discovery.doc.isv/plugin.xml
new file mode 100644
index 000000000..c98822571
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/plugin.xml
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+
+
+
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/reference/.cvsignore b/discovery/org.eclipse.tm.discovery.doc.isv/reference/.cvsignore
new file mode 100644
index 000000000..9e5bfb42d
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/reference/.cvsignore
@@ -0,0 +1 @@
+api
\ No newline at end of file
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/reference/extension-points/.cvsignore b/discovery/org.eclipse.tm.discovery.doc.isv/reference/extension-points/.cvsignore
new file mode 100644
index 000000000..9c59eabff
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/reference/extension-points/.cvsignore
@@ -0,0 +1 @@
+org_eclipse_*.html
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/schema.css b/discovery/org.eclipse.tm.discovery.doc.isv/schema.css
new file mode 100644
index 000000000..00f9d01bf
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/schema.css
@@ -0,0 +1,66 @@
+H6.CaptionFigColumn#header {
+ font-size:16px;
+ display:inline
+}
+
+P.Note#copyright {
+ font-size: smaller;
+ font-style: normal;
+ color: #336699;
+ display:inline;
+ margin-top: 3.000000pt;
+ margin-bottom: 11.000000pt;
+ margin-right: 0.000000pt;
+ margin-left: 0.000000pt;
+}
+
+P.Code#dtd {
+ color: #800000;
+ margin-top: 0.000000pt;
+ margin-bottom: 0.000000pt;
+ margin-right: 0.000000pt;
+ margin-left: 10.000000pt;
+}
+
+P.Code#dtdAttlist {
+ color: #800000;
+ margin-top: 0.000000pt;
+ margin-bottom: 0.000000pt;
+ margin-right: 0.000000pt;
+ margin-left: 20.000000pt;
+}
+
+P.Code#tag {
+ color: #000080;
+ display:inline;
+ margin-top: 0.000000pt;
+ margin-bottom: 0.000000pt;
+ margin-right: 0.000000pt;
+ margin-left: 0.000000pt;
+}
+
+P.Code#cstring {
+ color: #008000;
+ display:inline;
+ margin-top: 0.000000pt;
+ margin-bottom: 0.000000pt;
+ margin-right: 0.000000pt;
+ margin-left: 0.000000pt;
+}
+
+.ConfigMarkup#elementDesc {
+ color: black;
+ margin-top: 0.000000pt;
+ margin-bottom: 0.000000pt;
+ margin-right: 0.000000pt;
+ margin-left: 10.000000pt;
+}
+
+.ConfigMarkup#attlistDesc {
+ color: black;
+ margin-top: 0.000000pt;
+ margin-bottom: 0.000000pt;
+ margin-right: 0.000000pt;
+ margin-left: 32.000000pt;
+}
+
diff --git a/discovery/org.eclipse.tm.discovery.doc.isv/toc.xml b/discovery/org.eclipse.tm.discovery.doc.isv/toc.xml
new file mode 100644
index 000000000..49c21b1af
--- /dev/null
+++ b/discovery/org.eclipse.tm.discovery.doc.isv/toc.xml
@@ -0,0 +1,27 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
--
cgit v1.2.3
+
+
+