/* * Copyright (c) 2005-2010 KOM – Multimedia Communications Lab * * This file is part of PeerfactSim.KOM. * * PeerfactSim.KOM is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * any later version. * * PeerfactSim.KOM is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with PeerfactSim.KOM. If not, see . * */ package de.tud.kom.p2psim.impl.energy.configs; import de.tud.kom.p2psim.api.common.SimHost; import de.tud.kom.p2psim.api.energy.EnergyCommunicationComponent; import de.tud.kom.p2psim.api.energy.EnergyConfiguration; import de.tud.kom.p2psim.api.linklayer.mac.PhyType; import de.tud.kom.p2psim.impl.energy.components.StatelessCommunicationComponent; /** * This is a Message-Based {@link EnergyCommunicationComponent}-creating * configuration. It will model the behavior that Feeney proposed and that was * implemented in the {@link SimpleEnergyModel}. * * @author Bjoern Richerzhagen * @version 1.0, 27.02.2012 */ public class MessageBased implements EnergyConfiguration { /** * The PHY for which this component is configured */ private PhyType phy; private boolean error = false; private boolean warning = false; private final String help = "This is the MessageBased-Configuration for the EnergyModel. It creates a component for the chosen PHY-Type and each time a message is being sent or received, energy is consumed. The default parameters for the calculation of the energy consumption are taken from Feeneys Paper."; private String errorMessage = ""; private String warningMessage = ""; @Override public StatelessCommunicationComponent getConfiguredEnergyComponent( SimHost host) { return new StatelessCommunicationComponent(phy); } @Override public String getHelp() { if (error) { return errorMessage; } if (warning) { return warningMessage; } return help; } @Override public boolean isWellConfigured() { if (phy == null) { error = true; errorMessage += "\nYou did not specify a PHY-Type for the MessageBased Energy Component. Please set the config-parameter \"phy\" to one of " + PhyType.printTypes(); } if (phy != PhyType.WIFI) { warning = true; warningMessage += "\nThe Feeney-Model is only suitable for WIFI-Simulations. Consider using a state-based model for other types of communication."; } return !error; } /* * Config-Parameters */ /** * Set the PHY-Type. Must be one of {@link PhyType}s enum-values, will be * transformed to uppercase. * * @param phy */ public void setPhy(String phy) { try { this.phy = Enum.valueOf(PhyType.class, phy.toUpperCase()); } catch (IllegalArgumentException e) { error = true; errorMessage += "\nYou did specify an invalid PHY-Type. Allowed types are " + PhyType.printTypes(); } } }