added documentation

This commit is contained in:
fros4943 2009-11-25 16:05:47 +00:00
parent ff93ba8e0f
commit 7d6ee814da

View file

@ -24,12 +24,15 @@
* (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: Radio.java,v 1.10 2009/04/16 14:26:36 fros4943 Exp $ * $Id: Radio.java,v 1.11 2009/11/25 16:05:47 fros4943 Exp $
*/ */
package se.sics.cooja.interfaces; package se.sics.cooja.interfaces;
import se.sics.cooja.*; import se.sics.cooja.ClassDescription;
import se.sics.cooja.Mote;
import se.sics.cooja.MoteInterface;
import se.sics.cooja.RadioPacket;
/** /**
* A Radio represents a mote radio transceiver. * A Radio represents a mote radio transceiver.
@ -80,7 +83,7 @@ public abstract class Radio extends MoteInterface {
/** /**
* Signal that the current reception was ended. This method should normally be * Signal that the current reception was ended. This method should normally be
* called from the radio medium. * called from the radio medium on both destination and interfered radios.
* *
* @see #signalReceptionStart() * @see #signalReceptionStart()
*/ */
@ -119,12 +122,20 @@ public abstract class Radio extends MoteInterface {
*/ */
public abstract boolean isInterfered(); public abstract boolean isInterfered();
/**
* @return True if the simulated radio receiver is turned on
*/
public abstract boolean isReceiverOn(); public abstract boolean isReceiverOn();
/** /**
* Interferes with any current reception. If this method is called, the packet * Interferes with any current reception. If this method is called, the packet
* will be dropped. This method can be used to simulate radio interference * will be dropped. This method can be used to simulate radio interference
* such as high background noise. * such as high background noise or radio packet collisions.
*
* When the radio is no longer interfered, the {@link #signalReceptionEnd()}
* method must be called.
*
* @see #signalReceptionEnd()
*/ */
public abstract void interfereAnyReception(); public abstract void interfereAnyReception();