a9eecb03df
added method for removing mote types from a simulation + added cleanup-methods for simulation/motes/mote interfaces: void removed();
977 lines
26 KiB
Java
977 lines
26 KiB
Java
/*
|
|
* Copyright (c) 2009, Swedish Institute of Computer Science. All rights
|
|
* reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer. 2. Redistributions in
|
|
* binary form must reproduce the above copyright notice, this list of
|
|
* conditions and the following disclaimer in the documentation and/or other
|
|
* materials provided with the distribution. 3. Neither the name of the
|
|
* Institute nor the names of its contributors may be used to endorse or promote
|
|
* products derived from this software without specific prior written
|
|
* permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND ANY
|
|
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE FOR ANY
|
|
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* $Id: Simulation.java,v 1.54 2009/11/13 08:37:36 fros4943 Exp $
|
|
*/
|
|
|
|
package se.sics.cooja;
|
|
|
|
import java.util.ArrayDeque;
|
|
import java.util.ArrayList;
|
|
import java.util.Collection;
|
|
import java.util.Observable;
|
|
import java.util.Observer;
|
|
import java.util.Random;
|
|
import java.util.Vector;
|
|
|
|
import org.apache.log4j.Logger;
|
|
import org.jdom.Element;
|
|
|
|
import se.sics.cooja.dialogs.CreateSimDialog;
|
|
|
|
/**
|
|
* A simulation consists of a number of motes and mote types.
|
|
*
|
|
* A simulation is observable:
|
|
* changed simulation state, added or deleted motes etc are observed.
|
|
* To track mote changes, observe the mote (interfaces) itself.
|
|
*
|
|
* @author Fredrik Osterlind
|
|
*/
|
|
public class Simulation extends Observable implements Runnable {
|
|
public static final long MICROSECOND = 1L;
|
|
public static final long MILLISECOND = 1000*MICROSECOND;
|
|
|
|
/*private static long EVENT_COUNTER = 0;*/
|
|
|
|
private Vector<Mote> motes = new Vector<Mote>();
|
|
|
|
private Vector<MoteType> moteTypes = new Vector<MoteType>();
|
|
|
|
private int delayTime=0, delayPeriod=1;
|
|
private long delayLastSim;
|
|
|
|
private long currentSimulationTime = 0;
|
|
|
|
private String title = null;
|
|
|
|
private RadioMedium currentRadioMedium = null;
|
|
|
|
private static Logger logger = Logger.getLogger(Simulation.class);
|
|
|
|
private boolean isRunning = false;
|
|
|
|
private boolean stopSimulation = false;
|
|
|
|
private Thread simulationThread = null;
|
|
|
|
private GUI myGUI = null;
|
|
|
|
private long randomSeed = 123456;
|
|
|
|
private boolean randomSeedGenerated = false;
|
|
|
|
private long maxMoteStartupDelay = 1000*MILLISECOND;
|
|
|
|
private Random randomGenerator = new Random();
|
|
|
|
private boolean hasMillisecondObservers = false;
|
|
private MillisecondObservable millisecondObservable = new MillisecondObservable();
|
|
private class MillisecondObservable extends Observable {
|
|
private void newMillisecond(long time) {
|
|
setChanged();
|
|
notifyObservers(time);
|
|
}
|
|
}
|
|
|
|
/* Event queue */
|
|
private EventQueue eventQueue = new EventQueue();
|
|
|
|
/* Poll requests */
|
|
private boolean hasPollRequests = false;
|
|
private ArrayDeque<Runnable> pollRequests = new ArrayDeque<Runnable>();
|
|
|
|
|
|
/**
|
|
* Request poll from simulation thread.
|
|
* Poll requests are prioritized over simulation events, and are
|
|
* executed between each simulation event.
|
|
*
|
|
* @param r Simulation thread action
|
|
*/
|
|
public void invokeSimulationThread(Runnable r) {
|
|
synchronized (pollRequests) {
|
|
pollRequests.addLast(r);
|
|
hasPollRequests = true;
|
|
}
|
|
}
|
|
|
|
private Runnable popSimulationInvokes() {
|
|
Runnable r;
|
|
synchronized (pollRequests) {
|
|
r = pollRequests.pop();
|
|
hasPollRequests = !pollRequests.isEmpty();
|
|
}
|
|
return r;
|
|
}
|
|
|
|
/**
|
|
* Add millisecond observer.
|
|
* This observer is notified once every simulated millisecond.
|
|
*
|
|
* @see #deleteMillisecondObserver(Observer)
|
|
* @param newObserver Observer
|
|
*/
|
|
public void addMillisecondObserver(Observer newObserver) {
|
|
millisecondObservable.addObserver(newObserver);
|
|
hasMillisecondObservers = true;
|
|
|
|
invokeSimulationThread(new Runnable() {
|
|
public void run() {
|
|
if (!millisecondEvent.isScheduled()) {
|
|
scheduleEvent(
|
|
millisecondEvent,
|
|
currentSimulationTime - (currentSimulationTime % MILLISECOND) + MILLISECOND);
|
|
}
|
|
}
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Delete millisecond observer.
|
|
*
|
|
* @see #addMillisecondObserver(Observer)
|
|
* @param observer Observer to delete
|
|
*/
|
|
public void deleteMillisecondObserver(Observer observer) {
|
|
millisecondObservable.deleteObserver(observer);
|
|
hasMillisecondObservers = millisecondObservable.countObservers() > 0;
|
|
}
|
|
|
|
/**
|
|
* @return True iff current thread is the simulation thread
|
|
*/
|
|
public boolean isSimulationThread() {
|
|
return simulationThread == Thread.currentThread();
|
|
}
|
|
|
|
/**
|
|
* Schedule simulation event for given time.
|
|
* Already scheduled events must be removed before they are rescheduled.
|
|
*
|
|
* If the simulation is running, this method may only be called from the simulation thread.
|
|
*
|
|
* @see #invokeSimulationThread(Runnable)
|
|
*
|
|
* @param e Event
|
|
* @param time Execution time
|
|
*/
|
|
public void scheduleEvent(final TimeEvent e, final long time) {
|
|
/* TODO Strict scheduling from simulation thread */
|
|
if (e.isScheduled()) {
|
|
throw new IllegalStateException("Event already scheduled: " + e);
|
|
}
|
|
if (isRunning && !isSimulationThread()) {
|
|
throw new IllegalStateException("Scheduling event from non-simulation thread: " + e);
|
|
}
|
|
eventQueue.addEvent(e, time);
|
|
}
|
|
|
|
private TimeEvent delayEvent = new TimeEvent(0) {
|
|
public void execute(long t) {
|
|
/* As fast as possible: no need to reschedule delay event */
|
|
if (delayTime == 0) {
|
|
return;
|
|
}
|
|
|
|
/* Special case: real time */
|
|
if (delayPeriod == Integer.MIN_VALUE) {
|
|
delayLastSim++;
|
|
long tmp = System.currentTimeMillis();
|
|
if (delayLastSim > tmp) {
|
|
try {
|
|
Thread.sleep(delayLastSim-tmp);
|
|
} catch (InterruptedException e) {
|
|
}
|
|
}
|
|
|
|
/* Reschedule us next millisecond */
|
|
scheduleEvent(this, t+MILLISECOND);
|
|
return;
|
|
}
|
|
|
|
/* Normal operation */
|
|
try {
|
|
Thread.sleep(delayTime);
|
|
} catch (InterruptedException e) {
|
|
}
|
|
|
|
/* Reschedule us next period */
|
|
scheduleEvent(this, t+delayPeriod*MILLISECOND);
|
|
}
|
|
public String toString() {
|
|
return "DELAY";
|
|
}
|
|
};
|
|
|
|
private TimeEvent millisecondEvent = new TimeEvent(0) {
|
|
public void execute(long t) {
|
|
if (!hasMillisecondObservers) {
|
|
return;
|
|
}
|
|
|
|
millisecondObservable.newMillisecond(getSimulationTime());
|
|
scheduleEvent(this, t+MILLISECOND);
|
|
}
|
|
public String toString() {
|
|
return "MILLISECOND: " + millisecondObservable.countObservers();
|
|
}
|
|
};
|
|
|
|
public void run() {
|
|
long lastStartTime = System.currentTimeMillis();
|
|
logger.info("Simulation main loop started, system time: " + lastStartTime);
|
|
isRunning = true;
|
|
delayLastSim = System.currentTimeMillis();
|
|
|
|
/* Simulation starting */
|
|
this.setChanged();
|
|
this.notifyObservers(this);
|
|
|
|
try {
|
|
TimeEvent nextEvent;
|
|
while (isRunning) {
|
|
|
|
/* Handle all poll requests */
|
|
while (hasPollRequests) {
|
|
popSimulationInvokes().run();
|
|
}
|
|
|
|
/* Handle one simulation event, and update simulation time */
|
|
nextEvent = eventQueue.popFirst();
|
|
if (nextEvent == null) {
|
|
throw new RuntimeException("No more events");
|
|
}
|
|
if (nextEvent.time < currentSimulationTime) {
|
|
throw new RuntimeException("Next event is in the past: " + nextEvent.time + " < " + currentSimulationTime + ": " + nextEvent);
|
|
}
|
|
currentSimulationTime = nextEvent.time;
|
|
/*logger.info("Executing event #" + EVENT_COUNTER++ + " @ " + currentSimulationTime + ": " + nextEvent);*/
|
|
nextEvent.execute(currentSimulationTime);
|
|
|
|
if (stopSimulation) {
|
|
isRunning = false;
|
|
}
|
|
}
|
|
} catch (RuntimeException e) {
|
|
logger.fatal("Simulation stopped due to error: " + e.getMessage(), e);
|
|
|
|
if (!GUI.isVisualized()) {
|
|
/* Quit simulator if in test mode */
|
|
System.exit(1);
|
|
}
|
|
}
|
|
isRunning = false;
|
|
simulationThread = null;
|
|
stopSimulation = false;
|
|
|
|
this.setChanged();
|
|
this.notifyObservers(this);
|
|
logger.info("Simulation main loop stopped, system time: " + System.currentTimeMillis() +
|
|
"\tDuration: " + (System.currentTimeMillis() - lastStartTime) + " ms");
|
|
}
|
|
|
|
/**
|
|
* Creates a new simulation
|
|
*/
|
|
public Simulation(GUI gui) {
|
|
myGUI = gui;
|
|
}
|
|
|
|
/**
|
|
* Starts this simulation (notifies observers).
|
|
*/
|
|
public void startSimulation() {
|
|
if (!isRunning()) {
|
|
isRunning = true;
|
|
simulationThread = new Thread(this);
|
|
simulationThread.start();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Stops this simulation (notifies observers).
|
|
*/
|
|
public void stopSimulation() {
|
|
if (isRunning()) {
|
|
stopSimulation = true;
|
|
|
|
/* Wait until simulation stops */
|
|
if (Thread.currentThread() != simulationThread) {
|
|
try {
|
|
Thread simThread = simulationThread;
|
|
if (simThread != null) {
|
|
simThread.join();
|
|
}
|
|
} catch (InterruptedException e) {
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Starts simulation if stopped, executes one millisecond, and finally stops
|
|
* simulation again.
|
|
*/
|
|
public void stepMillisecondSimulation() {
|
|
if (isRunning()) {
|
|
return;
|
|
}
|
|
TimeEvent stopEvent = new TimeEvent(0) {
|
|
public void execute(long t) {
|
|
/* Stop simulation */
|
|
stopSimulation();
|
|
}
|
|
};
|
|
scheduleEvent(stopEvent, getSimulationTime()+Simulation.MILLISECOND);
|
|
startSimulation();
|
|
}
|
|
|
|
/**
|
|
* @return GUI holding this simulation
|
|
*/
|
|
public GUI getGUI() {
|
|
return myGUI;
|
|
}
|
|
|
|
/**
|
|
* @return Random seed
|
|
*/
|
|
public long getRandomSeed() {
|
|
return randomSeed;
|
|
}
|
|
|
|
/**
|
|
* @return Random seed (converted to a string)
|
|
*/
|
|
public String getRandomSeedString() {
|
|
return Long.toString(randomSeed);
|
|
}
|
|
|
|
/**
|
|
* @param randomSeed Random seed
|
|
*/
|
|
public void setRandomSeed(long randomSeed) {
|
|
this.randomSeed = randomSeed;
|
|
randomGenerator.setSeed(randomSeed);
|
|
logger.info("Simulation random seed: " + randomSeed);
|
|
}
|
|
|
|
/**
|
|
* @param generated Autogenerated random seed at simulation load
|
|
*/
|
|
public void setRandomSeedGenerated(boolean generated) {
|
|
this.randomSeedGenerated = generated;
|
|
}
|
|
|
|
/**
|
|
* @return Autogenerated random seed at simulation load
|
|
*/
|
|
public boolean getRandomSeedGenerated() {
|
|
return randomSeedGenerated;
|
|
}
|
|
|
|
public Random getRandomGenerator() {
|
|
return randomGenerator;
|
|
}
|
|
|
|
/**
|
|
* @return Maximum mote startup delay
|
|
*/
|
|
public long getDelayedMoteStartupTime() {
|
|
return maxMoteStartupDelay;
|
|
}
|
|
|
|
/**
|
|
* @param maxMoteStartupDelay Maximum mote startup delay
|
|
*/
|
|
public void setDelayedMoteStartupTime(long maxMoteStartupDelay) {
|
|
this.maxMoteStartupDelay = Math.max(0, maxMoteStartupDelay);
|
|
}
|
|
|
|
private SimEventCentral eventCentral = new SimEventCentral(this);
|
|
public SimEventCentral getEventCentral() {
|
|
return eventCentral;
|
|
}
|
|
|
|
/**
|
|
* Returns the current simulation config represented by XML elements. This
|
|
* config also includes the current radio medium, all mote types and motes.
|
|
*
|
|
* @return Current simulation config
|
|
*/
|
|
public Collection<Element> getConfigXML() {
|
|
ArrayList<Element> config = new ArrayList<Element>();
|
|
|
|
Element element;
|
|
|
|
// Title
|
|
element = new Element("title");
|
|
element.setText(title);
|
|
config.add(element);
|
|
|
|
// Delay time
|
|
element = new Element("delaytime");
|
|
element.setText("" + getDelayTime());
|
|
config.add(element);
|
|
|
|
// Random seed
|
|
element = new Element("randomseed");
|
|
if (randomSeedGenerated) {
|
|
element.setText("generated");
|
|
} else {
|
|
element.setText(Long.toString(getRandomSeed()));
|
|
}
|
|
config.add(element);
|
|
|
|
// Max mote startup delay
|
|
element = new Element("motedelay_us");
|
|
element.setText(Long.toString(maxMoteStartupDelay));
|
|
config.add(element);
|
|
|
|
// Radio Medium
|
|
element = new Element("radiomedium");
|
|
element.setText(currentRadioMedium.getClass().getName());
|
|
|
|
Collection<Element> radioMediumXML = currentRadioMedium.getConfigXML();
|
|
if (radioMediumXML != null) {
|
|
element.addContent(radioMediumXML);
|
|
}
|
|
config.add(element);
|
|
|
|
/* Event central */
|
|
element = new Element("events");
|
|
element.addContent(eventCentral.getConfigXML());
|
|
config.add(element);
|
|
|
|
// Mote types
|
|
for (MoteType moteType : getMoteTypes()) {
|
|
element = new Element("motetype");
|
|
element.setText(moteType.getClass().getName());
|
|
|
|
Collection<Element> moteTypeXML = moteType.getConfigXML();
|
|
if (moteTypeXML != null) {
|
|
element.addContent(moteTypeXML);
|
|
}
|
|
config.add(element);
|
|
}
|
|
|
|
// Motes
|
|
for (Mote mote : motes) {
|
|
element = new Element("mote");
|
|
element.setText(mote.getClass().getName());
|
|
|
|
Collection<Element> moteXML = mote.getConfigXML();
|
|
if (moteXML != null) {
|
|
element.addContent(moteXML);
|
|
}
|
|
config.add(element);
|
|
}
|
|
|
|
return config;
|
|
}
|
|
|
|
/**
|
|
* Sets the current simulation config depending on the given configuration.
|
|
*
|
|
* @param configXML Simulation configuration
|
|
* @param visAvailable True if simulation is allowed to show visualizers
|
|
* @param manualRandomSeed Simulation random seed. May be null, in which case the configuration is used
|
|
* @return True if simulation was configured successfully
|
|
* @throws Exception If configuration could not be loaded
|
|
*/
|
|
public boolean setConfigXML(Collection<Element> configXML,
|
|
boolean visAvailable, Long manualRandomSeed) throws Exception {
|
|
|
|
// Parse elements
|
|
for (Element element : configXML) {
|
|
|
|
// Title
|
|
if (element.getName().equals("title")) {
|
|
title = element.getText();
|
|
}
|
|
|
|
// Delay time
|
|
if (element.getName().equals("delaytime")) {
|
|
setDelayTime(Integer.parseInt(element.getText()));
|
|
}
|
|
|
|
// Random seed
|
|
if (element.getName().equals("randomseed")) {
|
|
if (manualRandomSeed != null) {
|
|
setRandomSeed(manualRandomSeed);
|
|
} else if (element.getText().equals("generated")) {
|
|
randomSeedGenerated = true;
|
|
setRandomSeed(new Random().nextLong());
|
|
} else {
|
|
setRandomSeed(Long.parseLong(element.getText()));
|
|
}
|
|
}
|
|
|
|
// Max mote startup delay
|
|
if (element.getName().equals("motedelay")) {
|
|
maxMoteStartupDelay = Integer.parseInt(element.getText())*MILLISECOND;
|
|
}
|
|
if (element.getName().equals("motedelay_us")) {
|
|
maxMoteStartupDelay = Integer.parseInt(element.getText());
|
|
}
|
|
|
|
// Radio medium
|
|
if (element.getName().equals("radiomedium")) {
|
|
String radioMediumClassName = element.getText().trim();
|
|
Class<? extends RadioMedium> radioMediumClass = myGUI.tryLoadClass(
|
|
this, RadioMedium.class, radioMediumClassName);
|
|
|
|
if (radioMediumClass != null) {
|
|
// Create radio medium specified in config
|
|
try {
|
|
currentRadioMedium = RadioMedium.generateRadioMedium(radioMediumClass, this);
|
|
} catch (Exception e) {
|
|
currentRadioMedium = null;
|
|
logger.warn("Could not load radio medium class: " + radioMediumClassName);
|
|
}
|
|
}
|
|
|
|
// Show configure simulation dialog
|
|
boolean createdOK = false;
|
|
if (visAvailable) {
|
|
createdOK = CreateSimDialog.showDialog(GUI.getTopParentContainer(), this);
|
|
} else {
|
|
createdOK = true;
|
|
}
|
|
|
|
if (!createdOK) {
|
|
logger.debug("Simulation not created, aborting");
|
|
throw new Exception("Load aborted by user");
|
|
}
|
|
|
|
// Check if radio medium specific config should be applied
|
|
if (radioMediumClassName.equals(currentRadioMedium.getClass().getName())) {
|
|
currentRadioMedium.setConfigXML(element.getChildren(), visAvailable);
|
|
} else {
|
|
logger.info("Radio Medium changed - ignoring radio medium specific config");
|
|
}
|
|
}
|
|
|
|
/* Event central */
|
|
if (element.getName().equals("events")) {
|
|
eventCentral.setConfigXML(this, element.getChildren(), visAvailable);
|
|
}
|
|
|
|
// Mote type
|
|
if (element.getName().equals("motetype")) {
|
|
String moteTypeClassName = element.getText().trim();
|
|
|
|
Class<? extends MoteType> moteTypeClass = myGUI.tryLoadClass(this,
|
|
MoteType.class, moteTypeClassName);
|
|
|
|
if (moteTypeClass == null) {
|
|
logger.fatal("Could not load mote type class: " + moteTypeClassName);
|
|
return false;
|
|
}
|
|
|
|
MoteType moteType = moteTypeClass.getConstructor((Class[]) null).newInstance();
|
|
|
|
boolean createdOK = moteType.setConfigXML(this, element.getChildren(),
|
|
visAvailable);
|
|
if (createdOK) {
|
|
addMoteType(moteType);
|
|
} else {
|
|
logger
|
|
.fatal("Mote type was not created: " + element.getText().trim());
|
|
throw new Exception("All mote types were not recreated");
|
|
}
|
|
}
|
|
|
|
// Mote
|
|
if (element.getName().equals("mote")) {
|
|
Class<? extends Mote> moteClass = myGUI.tryLoadClass(this, Mote.class,
|
|
element.getText().trim());
|
|
|
|
Mote mote = moteClass.getConstructor((Class[]) null).newInstance((Object[]) null);
|
|
if (mote.setConfigXML(this, element.getChildren(), visAvailable)) {
|
|
addMote(mote);
|
|
} else {
|
|
logger.fatal("Mote was not created: " + element.getText().trim());
|
|
throw new Exception("All motes were not recreated");
|
|
}
|
|
}
|
|
}
|
|
|
|
setChanged();
|
|
notifyObservers(this);
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Removes a mote from this simulation
|
|
*
|
|
* @param mote
|
|
* Mote to remove
|
|
*/
|
|
public void removeMote(final Mote mote) {
|
|
|
|
/* Simulation is running, remove mote in simulation loop */
|
|
Runnable removeMote = new Runnable() {
|
|
public void run() {
|
|
motes.remove(mote);
|
|
currentRadioMedium.unregisterMote(mote, Simulation.this);
|
|
|
|
/* Dispose mote interface resources */
|
|
for (MoteInterface i: mote.getInterfaces().getInterfaces()) {
|
|
i.removed();
|
|
}
|
|
|
|
setChanged();
|
|
notifyObservers(mote);
|
|
|
|
/* Loop through all scheduled events.
|
|
* Delete all events associated with deleted mote. */
|
|
TimeEvent ev = eventQueue.peekFirst();
|
|
while (ev != null) {
|
|
if (ev instanceof MoteTimeEvent) {
|
|
if (((MoteTimeEvent)ev).getMote() == mote) {
|
|
ev.remove();
|
|
}
|
|
}
|
|
ev = ev.nextEvent;
|
|
}
|
|
}
|
|
};
|
|
|
|
if (!isRunning()) {
|
|
/* Simulation is stopped, remove mote immediately */
|
|
removeMote.run();
|
|
} else {
|
|
/* Remove mote from simulation thread */
|
|
invokeSimulationThread(removeMote);
|
|
}
|
|
|
|
getGUI().closeMotePlugins(mote);
|
|
}
|
|
|
|
/**
|
|
* Called to free resources used by the simulation.
|
|
* This method is called just before the simulation is removed.
|
|
*/
|
|
public void removed() {
|
|
/* Remove all motes */
|
|
Mote[] motes = getMotes();
|
|
for (Mote m: motes) {
|
|
removeMote(m);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Adds a mote to this simulation
|
|
*
|
|
* @param mote
|
|
* Mote to add
|
|
*/
|
|
public void addMote(final Mote mote) {
|
|
Runnable addMote = new Runnable() {
|
|
public void run() {
|
|
if (mote.getInterfaces().getClock() != null) {
|
|
if (maxMoteStartupDelay > 0) {
|
|
mote.getInterfaces().getClock().setDrift(
|
|
- getSimulationTime()
|
|
- randomGenerator.nextInt((int)maxMoteStartupDelay)
|
|
);
|
|
} else {
|
|
mote.getInterfaces().getClock().setDrift(-getSimulationTime());
|
|
}
|
|
}
|
|
|
|
motes.add(mote);
|
|
currentRadioMedium.registerMote(mote, Simulation.this);
|
|
setChanged();
|
|
notifyObservers(mote);
|
|
}
|
|
};
|
|
|
|
if (!isRunning()) {
|
|
/* Simulation is stopped, add mote immediately */
|
|
addMote.run();
|
|
} else {
|
|
/* Add mote from simulation thread */
|
|
invokeSimulationThread(addMote);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get a mote from this simulation.
|
|
*
|
|
* @param pos
|
|
* Internal list position of mote
|
|
* @return Mote
|
|
*/
|
|
public Mote getMote(int pos) {
|
|
return motes.get(pos);
|
|
}
|
|
|
|
/**
|
|
* Returns number of motes in this simulation.
|
|
*
|
|
* @return Number of motes
|
|
*/
|
|
public int getMotesCount() {
|
|
return motes.size();
|
|
}
|
|
|
|
/**
|
|
* Returns all motes in this simulation.
|
|
*
|
|
* @return Motes
|
|
*/
|
|
public Mote[] getMotes() {
|
|
Mote[] arr = new Mote[motes.size()];
|
|
motes.toArray(arr);
|
|
return arr;
|
|
}
|
|
|
|
/**
|
|
* Returns all mote types in simulation.
|
|
*
|
|
* @return All mote types
|
|
*/
|
|
public MoteType[] getMoteTypes() {
|
|
MoteType[] types = new MoteType[moteTypes.size()];
|
|
moteTypes.toArray(types);
|
|
return types;
|
|
}
|
|
|
|
/**
|
|
* Returns mote type with given identifier.
|
|
*
|
|
* @param identifier
|
|
* Mote type identifier
|
|
* @return Mote type or null if not found
|
|
*/
|
|
public MoteType getMoteType(String identifier) {
|
|
for (MoteType moteType : getMoteTypes()) {
|
|
if (moteType.getIdentifier().equals(identifier)) {
|
|
return moteType;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Adds given mote type to simulation.
|
|
*
|
|
* @param newMoteType Mote type
|
|
*/
|
|
public void addMoteType(MoteType newMoteType) {
|
|
moteTypes.add(newMoteType);
|
|
|
|
this.setChanged();
|
|
this.notifyObservers(this);
|
|
}
|
|
|
|
/**
|
|
* Remove given mote type from simulation.
|
|
*
|
|
* @param type Mote type
|
|
*/
|
|
public void removeMoteType(MoteType type) {
|
|
if (!moteTypes.contains(type)) {
|
|
logger.fatal("Mote type is not registered: " + type);
|
|
return;
|
|
}
|
|
|
|
/* Remove motes */
|
|
for (Mote m: getMotes()) {
|
|
if (m.getType() == type) {
|
|
removeMote(m);
|
|
}
|
|
}
|
|
|
|
moteTypes.remove(type);
|
|
this.setChanged();
|
|
this.notifyObservers(this);
|
|
}
|
|
|
|
/**
|
|
* Set delay time (ms).
|
|
* The simulation loop delays given value every simulated millisecond.
|
|
* If the value is zero there is no delay.
|
|
* If the value is negative, the simulation loop delays 1ms every (-time) simulated milliseconds.
|
|
*
|
|
* Examples:
|
|
* time=0: no sleeping (simulation runs as fast as possible).
|
|
* time=10: simulation delays 10ms every simulated millisecond.
|
|
* time=-5: simulation delays 1ms every 5 simulated milliseconds.
|
|
*
|
|
* Special case:
|
|
* time=Integer.MIN_VALUE: simulation tries to execute at real time.
|
|
*
|
|
* @param time New delay time value
|
|
*/
|
|
public void setDelayTime(int time) {
|
|
if (time == Integer.MIN_VALUE) {
|
|
/* Special case: real time */
|
|
delayTime = Integer.MIN_VALUE;
|
|
delayPeriod = Integer.MIN_VALUE;
|
|
delayLastSim = System.currentTimeMillis();
|
|
} else if (time < 0) {
|
|
delayTime = 1;
|
|
delayPeriod = -time;
|
|
} else {
|
|
delayTime = time;
|
|
delayPeriod = 1; /* minimum */
|
|
}
|
|
|
|
invokeSimulationThread(new Runnable() {
|
|
public void run() {
|
|
if (!delayEvent.isScheduled()) {
|
|
scheduleEvent(
|
|
delayEvent,
|
|
currentSimulationTime - (currentSimulationTime % MILLISECOND) + MILLISECOND);
|
|
}
|
|
Simulation.this.setChanged();
|
|
Simulation.this.notifyObservers(this);
|
|
}
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Returns current delay time value.
|
|
* Note that this value can be negative.
|
|
*
|
|
* @see #setDelayTime(int)
|
|
* @return Delay time value. May be negative, see {@link #setDelayTime(int)}
|
|
*/
|
|
public int getDelayTime() {
|
|
/* Special case: real time */
|
|
if (delayPeriod == Integer.MIN_VALUE) {
|
|
return Integer.MIN_VALUE;
|
|
}
|
|
|
|
if (delayPeriod > 1) {
|
|
return -delayPeriod;
|
|
}
|
|
|
|
return delayTime;
|
|
}
|
|
|
|
/**
|
|
* Set simulation time to simulationTime.
|
|
*
|
|
* @param simulationTime
|
|
* New simulation time (ms)
|
|
*/
|
|
public void setSimulationTime(int simulationTime) {
|
|
currentSimulationTime = simulationTime;
|
|
|
|
this.setChanged();
|
|
this.notifyObservers(this);
|
|
}
|
|
|
|
/**
|
|
* Returns current simulation time.
|
|
*
|
|
* @return Simulation time (microseconds)
|
|
*/
|
|
public long getSimulationTime() {
|
|
return currentSimulationTime;
|
|
}
|
|
|
|
/**
|
|
* Returns current simulation time rounded to milliseconds.
|
|
*
|
|
* @see #getSimulationTime()
|
|
* @return
|
|
*/
|
|
public long getSimulationTimeMillis() {
|
|
return currentSimulationTime / MILLISECOND;
|
|
}
|
|
|
|
/**
|
|
* Changes radio medium of this simulation to the given.
|
|
*
|
|
* @param radioMedium
|
|
* New radio medium
|
|
*/
|
|
public void setRadioMedium(RadioMedium radioMedium) {
|
|
// Remove current radio medium from observing motes
|
|
if (currentRadioMedium != null) {
|
|
for (int i = 0; i < motes.size(); i++) {
|
|
currentRadioMedium.unregisterMote(motes.get(i), this);
|
|
}
|
|
}
|
|
|
|
// Change current radio medium to new one
|
|
if (radioMedium == null) {
|
|
logger.fatal("Radio medium could not be created!");
|
|
return;
|
|
}
|
|
this.currentRadioMedium = radioMedium;
|
|
|
|
// Add all current motes to the new radio medium
|
|
for (int i = 0; i < motes.size(); i++) {
|
|
currentRadioMedium.registerMote(motes.get(i), this);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get currently used radio medium.
|
|
*
|
|
* @return Currently used radio medium
|
|
*/
|
|
public RadioMedium getRadioMedium() {
|
|
return currentRadioMedium;
|
|
}
|
|
|
|
/**
|
|
* Return true is simulation is running.
|
|
*
|
|
* @return True if simulation is running
|
|
*/
|
|
public boolean isRunning() {
|
|
return isRunning && simulationThread != null;
|
|
}
|
|
|
|
/**
|
|
* Get current simulation title (short description).
|
|
*
|
|
* @return Title
|
|
*/
|
|
public String getTitle() {
|
|
return title;
|
|
}
|
|
|
|
/**
|
|
* Set simulation title.
|
|
*
|
|
* @param title
|
|
* New title
|
|
*/
|
|
public void setTitle(String title) {
|
|
this.title = title;
|
|
}
|
|
|
|
}
|