src/components/policy/doc/doxygen/components/TransportManager/Client Specification/DeviceManagement.txt

   1 /** @page components_transportmanager_client_device_management Device Management
   2  *
   3  * As all requests to TransportManager are asynchronous, client must implement NsSmartDeviceLink::NsTransportManager::ITransportManagerDeviceListener
   4  * interface and add itself as a device listener with NsSmartDeviceLink::NsTransportManager::ITransportManager::addDeviceListener()
   5  * in order to receive notifications.
   6  * Client of TransportManager may use NsSmartDeviceLink::NsTransportManager::ITransportManager::scanForNewDevices()
   7  * to initiate device scan on all device adapters that support this feature. In order to get list of available
   8  * devices client must override NsSmartDeviceLink::NsTransportManager::ITransportManagerDeviceListener::onDeviceListUpdated().
   9  * Each device adapter will perform scan independently from other device adapters and device list might be updated
  10  * several times (after each adapter that supports scanning finishes scanning operation). Device list might also be
  11  * updated without device scan request, e.g. if new client connects via TCP this device will be added to device list
  12  * and update notification will be sent to client. In any of these cases client will be provided with the full
  13  * device list from all device adapters in every notification.
  14  */