/** * This file is part of license combination gpl version 3 license and eCos. * The corresponding license terms are below. * * gpl version 3 Licence: * * The file were developed during the student thesis "Datensammlung in Wireless * Sensor Networks fuer Autonomic Home NetworkingÒ of Thomas Kothmayr and is * included in the dissertation "Secure Data Transmission in Wireless * Sensor Networks" by Corinna Schmitt during employment at the Technische * UniversitŠt MŸnchen, Department Computer Science, Chair Network * Architectures and Services (Germany). * Copyright (C) 2013 * Authors: Thomas Kothmayr and Corinna Schmitt (schmitt[at]net.in.tum.de) * * This program 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, version 3 of the License * * This program 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 this program. If not, see . * * * eCos Licence: (http://ecos.sourceware.org) * * This file is part of eCos, the Embedded Configurable Operating System. * Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, * 2007, 2008, 2009 Free Software Foundation, Inc. * * eCos 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 any later version. * * eCos 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 eCos; if not, write to the Free Software Foundation, Inc., 51 * Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * * As a special exception, if other files instantiate templates or use * macros or inline functions from this file, or you compile this file and * link it with other works to produce a work based on this file, this file * does not by itself cause the resulting work to be covered by the GNU * General Public License. However the source code for this file must still * be made available in accordance with section (3) of the GNU General * Public License v2. * * This exception does not invalidate any other reasons why a work based on * this file might be covered by the GNU General Public License. * */ Interface: tos.chips.rf230.SoftwareAckConfig

Interface: tos.chips.rf230.SoftwareAckConfig

interface SoftwareAckConfig

Commands
command void createAckPacket(message_t *data, message_t *ack) Creates an acknowledgement packet for the given data packet.
command uint16_t getAckTimeout() Returns the acknowledgement timeout (in the radio clock units), in which a sent packet must be acknowledged.
command bool isAckPacket(message_t *msg) Returns TRUE if the received packet is an acknowledgement packet.
command void reportChannelError() This command is called when a sent packet did not receive an acknowledgement.
command bool requiresAckReply(message_t *msg) Returns TRUE if the received packet needs software acknowledgements to be sent back to the sender.
command bool requiresAckWait(message_t *msg) Returns TRUE if the layer should wait for a software acknowledgement to be received after this packet was transmitted.
command void setAckReceived(message_t *msg, bool acked) Sets for the transmitted message whether it was acknowledged or not.
command bool verifyAckPacket(message_t *data, message_t *ack) Returns TRUE if the acknowledgement packet corresponds to the data packet.

Commands - Details

createAckPacket

command void createAckPacket(message_t *data, message_t *ack)

Creates an acknowledgement packet for the given data packet.

getAckTimeout

command uint16_t getAckTimeout()

Returns the acknowledgement timeout (in the radio clock units), in which a sent packet must be acknowledged.

isAckPacket

command bool isAckPacket(message_t *msg)

Returns TRUE if the received packet is an acknowledgement packet. The AckedSend layer will filter out all received acknowledgement packets and uses only the matching one for the acknowledgement.

reportChannelError

command void reportChannelError()

This command is called when a sent packet did not receive an acknowledgement.

requiresAckReply

command bool requiresAckReply(message_t *msg)

Returns TRUE if the received packet needs software acknowledgements to be sent back to the sender.

requiresAckWait

command bool requiresAckWait(message_t *msg)

Returns TRUE if the layer should wait for a software acknowledgement to be received after this packet was transmitted.

setAckReceived

command void setAckReceived(message_t *msg, bool acked)

Sets for the transmitted message whether it was acknowledged or not.

verifyAckPacket

command bool verifyAckPacket(message_t *data, message_t *ack)

Returns TRUE if the acknowledgement packet corresponds to the data packet. The acknowledgement packect was already verified to be a valid acknowledgement packet via the isAckPacket command.