mch/DeviceManager.h

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