// $Id: beta.CC2420Radio.ieee.802.15.4.MCPS.MCPS_DATA.nc.source,v 1.1 2004/03/09 01:13:28 jpolastre Exp $ /* tab:4 * "Copyright (c) 2000-2003 The Regents of the University of California. * All rights reserved. * * Permission to use, copy, modify, and distribute this software and its * documentation for any purpose, without fee, and without written agreement is * hereby granted, provided that the above copyright notice, the following * two paragraphs and the author appear in all copies of this software. * * IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT * OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF * CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY * AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS * ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATION TO * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS." * * Copyright (c) 2002-2003 Intel Corporation * All rights reserved. * * This file is distributed under the terms in the attached INTEL-LICENSE * file. If you do not find these files, copies can be found by writing to * Intel Research Berkeley, 2150 Shattuck Avenue, Suite 1300, Berkeley, CA, * 94704. Attention: Intel License Inquiry. */ /* * Authors: Joe Polastre */ includes IEEE802154; /** * The MCPS-SAP supports the transport of SSCS protocol data units (SPDUs) * between peer SSCS entities. * MCPS_DATA is used to transmit and receive data from the * MAC sublayer. * * @author Joe Polastre */ interface MCPS_DATA { /** * Request a data transfer. * See page 57 of the IEEE 802.15.4 specification. * * @param SrcAddrMode The source addressing mode for this primitive and * subsequent MPDU * @param SrcPANId The 16 bit PAN identifier of the source * @param SrcAddr Individual device address of the source as per * the SrcAddrMode * @param DstAddrMode The destination addressing mode for this primitive * and subsequent MPDU * @param DstPANId The 16 bit PAN identifier of the destination * @param DstAddr Individual device address of the destination as per * the DstAddrMode * @param msduLength Number of octets contained in the msdu * @param msdu Set of octets forming the msdu * @param msduHandle Handle associated with the MSDU to be transmitted * @param TxOptions Bitwised OR transmission options */ command void request ( uint8_t SrcAddrMode, uint16_t SrcPANId, uint8_t* SrcAddr, uint8_t DstAddrMode, uint16_t DstPANId, uint8_t* DstAddr, uint8_t msduLength, uint8_t* msdu, uint8_t msduHandle, uint8_t TxOptions ); /** * Confirm reports the results of a request to transfer a data MSDU. * See page 59 of the IEEE 802.15.4 specification. * * @param msduHandle The handle associated with the MSDU * @param status That status of the last MSDU transmission */ event void confirm ( uint8_t msduHandle, IEEE_status status ); /** * Indicates the transfer of a data unit from the MAC sublayer. * See page 60 of the IEEE 802.15.4 specification. * * @param SrcAddrMode The source addressing mode for this primitive and * subsequent MPDU * @param SrcPANId The 16 bit PAN identifier of the source * @param SrcAddr Individual device address of the source as per * the SrcAddrMode * @param DstAddrMode The destination addressing mode for this primitive * and subsequent MPDU * @param DstPANId The 16 bit PAN identifier of the destination * @param DstAddr Individual device address of the destination as per * the DstAddrMode * @param msduLength Number of octets contained in the msdu * @param msdu Set of octets forming the msdu * @param mpduLinkQuality LQ value measured during reception * @param SecurityUse An indication whether the received data frame is * using security * @param ACLEntry The macSecurityMode parameter value from the ACL entry * associated with the sender of the data frame. This value * is set to 0x08 if the sender of the data frame was not * found in the ACL. */ event void indication ( uint8_t SrcAddrMode, uint16_t SrcPANId, uint8_t* SrcAddr, uint8_t DstAddrMode, uint16_t DstPANId, uint8_t* DstAddr, uint8_t msduLength, uint8_t* msdu, uint8_t mpduLinkQuality, bool SecurityUse, uint8_t ACLEntry ); }
