// $Id: beta.CC2420Radio.ieee.802.15.4.MLME.MLME_DISASSOCIATE.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 MLME-SAP dissassociation primitives define * how a device can disassociate with a PAN. * * @author Joe Polastre */ interface MLME_DISASSOCIATE { /** * Request to disassociate with a PAN. * See page 71 of the IEEE 802.15.4 specification. * * @param DeviceAddress 64-bit address of the device to which to send the * disassociation notification command * @param DisassociateReason Reason the node is disassociating * @param SecurityEnable TRUE if security is enabled for this transfer */ command void request ( uint64_t DeviceAddress, IEEE_status DisassociateReason, bool SecurityEnable ); /** * Provide notification that a device has requested to associate with * a PAN identifier. * * @param DeviceAddress the 64-bit address of the requesting device * @param DisassociateReason Reason the node is disassociating * @param SecurityUse TRUE if security was enabled for the request * @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 ( uint64_t DeviceAddress, IEEE_status DisassociateReason, bool SecurityUse, uint8_t ACLEntry ); /** * Confirmation of the disassociation attempt * * @param status The status of the disassociation attempt */ event void confirm ( IEEE_status status ); }
