mirror of
https://github.com/oliverschmidt/contiki.git
synced 2024-12-23 01:29:33 +00:00
added getID() method (mandatory for all motes)
removed the common state notion: these are instead mote specific
This commit is contained in:
parent
eb4698612d
commit
72105a161e
@ -24,23 +24,19 @@
|
|||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
||||||
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
*
|
*
|
||||||
* $Id: Mote.java,v 1.6 2008/12/04 14:03:42 joxe Exp $
|
* $Id: Mote.java,v 1.7 2009/09/17 11:05:09 fros4943 Exp $
|
||||||
*/
|
*/
|
||||||
|
|
||||||
package se.sics.cooja;
|
package se.sics.cooja;
|
||||||
|
|
||||||
import java.util.Collection;
|
import java.util.Collection;
|
||||||
import java.util.Observer;
|
|
||||||
import org.jdom.Element;
|
import org.jdom.Element;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A simulated mote.
|
* A simulated mote.
|
||||||
*
|
*
|
||||||
* A mote is always in some state, describing the status of the CPU etc. Motes
|
* All motes have an interface handler, a mote type and a mote memory.
|
||||||
* in different states may be handled differently by for example the simulation
|
|
||||||
* loop and plugins.
|
|
||||||
*
|
|
||||||
* All motes must also have an interface handler, a mote type and a mote memory.
|
|
||||||
*
|
*
|
||||||
* @see se.sics.cooja.MoteInterfaceHandler
|
* @see se.sics.cooja.MoteInterfaceHandler
|
||||||
* @see se.sics.cooja.MoteMemory
|
* @see se.sics.cooja.MoteMemory
|
||||||
@ -51,49 +47,10 @@ import org.jdom.Element;
|
|||||||
public interface Mote {
|
public interface Mote {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Possible mote states
|
* @return Unique mote ID
|
||||||
*/
|
*/
|
||||||
public static enum State {
|
public int getID();
|
||||||
/* Active state */
|
|
||||||
ACTIVE,
|
|
||||||
/* Low power mode (sleeping) */
|
|
||||||
LPM,
|
|
||||||
/* Dead (for example out of batteries) */
|
|
||||||
DEAD
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Tries to change state to given argument. A dead mote can typically not
|
|
||||||
* change state, while a sleeping or active mote can.
|
|
||||||
*
|
|
||||||
* @param newState
|
|
||||||
* New state of mote.
|
|
||||||
*/
|
|
||||||
public void setState(State newState);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @return Current mote state
|
|
||||||
*/
|
|
||||||
public State getState();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Adds new state observer. This observer is notified if mote changes state.
|
|
||||||
*
|
|
||||||
* @see #deleteStateObserver(Observer)
|
|
||||||
* @param newObserver
|
|
||||||
* New observer
|
|
||||||
*/
|
|
||||||
public void addStateObserver(Observer newObserver);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete existing state observer.
|
|
||||||
*
|
|
||||||
* @see #addStateObserver(Observer)
|
|
||||||
* @param newObserver
|
|
||||||
* Registered state observer
|
|
||||||
*/
|
|
||||||
public void deleteStateObserver(Observer newObserver);
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Returns the interface handler of this mote.
|
* Returns the interface handler of this mote.
|
||||||
*
|
*
|
||||||
@ -168,8 +125,7 @@ public interface Mote {
|
|||||||
* Each mote implementation may handle calls to this method differently, but
|
* Each mote implementation may handle calls to this method differently, but
|
||||||
* typically the simulated mote should at least handle one event.
|
* typically the simulated mote should at least handle one event.
|
||||||
*
|
*
|
||||||
* This method is responsible for updating the mote interfaces, the memory and
|
* This method is responsible for updating the mote interfaces.
|
||||||
* the mote state.
|
|
||||||
*
|
*
|
||||||
* A call to this method typically polls all interfaces, activates the memory,
|
* A call to this method typically polls all interfaces, activates the memory,
|
||||||
* lets the underlying mote software handle one event, fetches the updated
|
* lets the underlying mote software handle one event, fetches the updated
|
||||||
@ -185,8 +141,8 @@ public interface Mote {
|
|||||||
* Returns XML elements representing the current config of this mote. This is
|
* Returns XML elements representing the current config of this mote. This is
|
||||||
* fetched by the simulator for example when saving a simulation configuration
|
* fetched by the simulator for example when saving a simulation configuration
|
||||||
* file. For example a mote may return the configs of all its interfaces. This
|
* file. For example a mote may return the configs of all its interfaces. This
|
||||||
* method should however not return state specific information such as the
|
* method should however not return state specific information.
|
||||||
* mote state. (All nodes are restarted when loading a simulation.)
|
* (All nodes are restarted when loading a simulation.)
|
||||||
*
|
*
|
||||||
* @see #setConfigXML(Simulation, Collection, boolean)
|
* @see #setConfigXML(Simulation, Collection, boolean)
|
||||||
* @return XML elements representing the current mote config
|
* @return XML elements representing the current mote config
|
||||||
|
Loading…
Reference in New Issue
Block a user