summaryrefslogtreecommitdiff
path: root/src/components/policy/doc/doxygen/components/TransportManager/Client Specification/DeviceManagement.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/components/policy/doc/doxygen/components/TransportManager/Client Specification/DeviceManagement.txt')
m---------src/components/policy0
-rw-r--r--src/components/policy/doc/doxygen/components/TransportManager/Client Specification/DeviceManagement.txt14
2 files changed, 14 insertions, 0 deletions
diff --git a/src/components/policy b/src/components/policy
deleted file mode 160000
-Subproject 721df989143d9c1c886f9fa5c1007d04cd5baae
diff --git a/src/components/policy/doc/doxygen/components/TransportManager/Client Specification/DeviceManagement.txt b/src/components/policy/doc/doxygen/components/TransportManager/Client Specification/DeviceManagement.txt
new file mode 100644
index 000000000..eb5f3e477
--- /dev/null
+++ b/src/components/policy/doc/doxygen/components/TransportManager/Client Specification/DeviceManagement.txt
@@ -0,0 +1,14 @@
+/** @page components_transportmanager_client_device_management Device Management
+ *
+ * As all requests to TransportManager are asynchronous, client must implement NsSmartDeviceLink::NsTransportManager::ITransportManagerDeviceListener
+ * interface and add itself as a device listener with NsSmartDeviceLink::NsTransportManager::ITransportManager::addDeviceListener()
+ * in order to receive notifications.
+ * Client of TransportManager may use NsSmartDeviceLink::NsTransportManager::ITransportManager::scanForNewDevices()
+ * to initiate device scan on all device adapters that support this feature. In order to get list of available
+ * devices client must override NsSmartDeviceLink::NsTransportManager::ITransportManagerDeviceListener::onDeviceListUpdated().
+ * Each device adapter will perform scan independently from other device adapters and device list might be updated
+ * several times (after each adapter that supports scanning finishes scanning operation). Device list might also be
+ * updated without device scan request, e.g. if new client connects via TCP this device will be added to device list
+ * and update notification will be sent to client. In any of these cases client will be provided with the full
+ * device list from all device adapters in every notification.
+ */