mac_general.c

zigbee location examples

/*******************************************************************************************************
 *                                                                                                     *
 *        **********                                                                                   *
 *       ************                                                                                  *
 *      ***        ***                                                                                 *
 *      ***   +++   ***                                                                                *
 *      ***   + +   ***                                                                                *
 *      ***   +                         CHIPCON CC2430 INTEGRATED 802.15.4 MAC AND PHY                 *
 *      ***   + +   ***                       General MAC Constants, Types, etc.                       *
 *      ***   +++   ***                                                                                *
 *      ***        ***                                                                                 *
 *       ************                                                                                  *
 *        **********                                                                                   *
 *                                                                                                     *
 *******************************************************************************************************
 * CONFIDENTIAL                                                                                        *
 * The use of this file is restricted by the signed MAC software license agreement.                    *
 *                                                                                                     *
 * Copyright Chipcon AS, 2005                                                                          *
 *******************************************************************************************************
 * This module contains general types, constants, macros and functions used by many other MAC modules. *
 *******************************************************************************************************/
#include <mac_headers.h>



//-------------------------------------------------------------------------------------------------------
// PIBs and related data structures
MAC_PIB mpib;
PHY_PIB ppib;
//-------------------------------------------------------------------------------------------------------

//-------------------------------------------------------------------------------------------------------
// MAC Internal data
MAC_INFO macInfo;
BYTE     intMacFlags;
//-------------------------------------------------------------------------------------------------------




//-------------------------------------------------------------------------------------------------------
//  BOOL macSetState(MAC_STATE_TYPE newState)
//
//  DESCRIPTION:
//      Changes the internal MAC state, which is used to control polling and scanning. Only specific
//      sequences of transitions are allowed.
//
//  ARGUMENTS:
//      MAC_STATE_TYPE newState
//          The new MAC state
//
//  RETURN VALUE:
//      BOOL
//          TRUE if successful (legal transition to newState)
//          FALSE otherwise (the state was not changed)
//-------------------------------------------------------------------------------------------------------
ROOT BOOL macSetState(MAC_STATE_TYPE newState) {
    BOOL result;

    DISABLE_GLOBAL_INT();
    switch (newState) {

    // Association
    case MAC_STATE_TX_ASSOC_REQUEST:         result = (BYTE)((macInfo.state == MAC_STATE_DEFAULT)); break;
    case MAC_STATE_ASSOC_REQUEST_SENT:       result = (BYTE)((macInfo.state == MAC_STATE_TX_ASSOC_REQUEST)); break;
    case MAC_STATE_TX_ASSOC_DATA_REQUEST:    result = (BYTE)((macInfo.state == MAC_STATE_ASSOC_REQUEST_SENT)); break;
    case MAC_STATE_ASSOC_DATA_REQUEST_SENT:  result = (BYTE)((macInfo.state == MAC_STATE_TX_ASSOC_DATA_REQUEST)); break;

    // Internally generated data request (mpib.macAutoRequest)
    case MAC_STATE_TX_AUTO_DATA_REQUEST:     result = (BYTE)((macInfo.state == MAC_STATE_DEFAULT)); break;
    case MAC_STATE_AUTO_DATA_REQUEST_SENT:   result = (BYTE)((macInfo.state == MAC_STATE_TX_AUTO_DATA_REQUEST)); break;

    // Manually generated data request (mlmePollRequest)
    case MAC_STATE_TX_MANUAL_DATA_REQUEST:   result = (BYTE)((macInfo.state == MAC_STATE_DEFAULT)); break;
    case MAC_STATE_MANUAL_DATA_REQUEST_SENT: result = (BYTE)((macInfo.state == MAC_STATE_TX_MANUAL_DATA_REQUEST)); break;

    // Channel scanning
    case MAC_STATE_ENERGY_SCAN:              result = (BYTE)((macInfo.state == MAC_STATE_DEFAULT)); break;
    case MAC_STATE_ACTIVE_OR_PASSIVE_SCAN:   result = (BYTE)((macInfo.state == MAC_STATE_DEFAULT)); break;
    case MAC_STATE_SCAN_RESULT_BUFFER_FULL:  result = (BYTE)((macInfo.state == MAC_STATE_ACTIVE_OR_PASSIVE_SCAN)); break;
    case MAC_STATE_ORPHAN_SCAN:              result = (BYTE)((macInfo.state == MAC_STATE_DEFAULT)); break;
    case MAC_STATE_ORPHAN_REALIGNED:         result = (BYTE)((macInfo.state == MAC_STATE_ORPHAN_SCAN)); break;

    // Always possible to return to the default state
    case MAC_STATE_DEFAULT:                  result = TRUE; break;
    default:                                 result = FALSE; break;
    }
    if (result) macInfo.state = newState;
    ENABLE_GLOBAL_INT();
    return result;

} // macSetState