mch/DeviceManager.h

   1 #ifndef REMOTE_MCH_DEVICEMANAGER_H
   2 #define REMOTE_MCH_DEVICEMANAGER_H
   3
   4 #include "remote.h"
   5 #include "mch/Mote.h"
   6
   7 namespace remote { namespace mch {
   8
   9 typedef std::map<std::string, Mote *> motemap_t;
  10
  11 /** MCH Mote device manager.
  12  *
  13  * The device manager maintains a database of known motes and their
  14  * status. The database consists of three mote maps: one containing
  15  * newly discovered motes, one with motes that are no longer available,
  16  * and a map containing all currently valid and operational motes.
  17  * The database can be updated using #refresh().
  18  */
  19 class DeviceManager
  20 {
  21 public:
  22         motemap_t motes;        /**< The current valid motes. */
  23         motemap_t newMotes;     /**< Motes that were just attached. */
  24         motemap_t lostMotes;    /**< Motes that were just detached. */
  25
  26         /** Refresh the mote device database.
  27          *
  28          * Update the registered devices to match the existing system using a
  29          * "mark and sweep" approach. First all motes are marked invalid
  30          * after which the mote device hierarchy is iterated to revalidate all
  31          * available mote. Finally, motes that are still invalid are moved to
  32          * the #lostMotes.
  33          *
  34          * @param devicePath    The path to the mote devices.
  35          */
  36         void refresh(std::string devicePath);
  37
  38 private:
  39         /** Traverse and update all available motes.
  40          *
  41          * Traverses all mote device directories under the given
  42          * device path and updates the mote.
  43          *
  44          * @param devicePath    The path to the mote devices.
  45          */
  46         void readMoteDevices(std::string devicePath);
  47
  48         /** Update mote information.
  49          *
  50          * If the mote already exists it is validated using
  51          * #mch::Mote::validate else a new mote is created
  52          * and placed in both #motes and #newMotes.
  53          *
  54          * @param mac           The MAC address of the mote.
  55          * @param directory     The device directory of the mote.
  56          */
  57         void updateMote(std::string mac, std::string directory);
  58 };
  59
  60 }}
  61
  62 #endif