NXP / fsl_phy_mcr20a

A library implementing IEEE 802.15.4 PHY functionality for the MCR20A transceiver. The PHY sublayer provides two services: the PHY data service and the PHY management service interfacing to the PHY sublayer management entity (PLME) service access point (SAP) (known as PLME-SAP). The PHY data service enables the transmission and reception of PHY protocol data units (PSDUs) over the media (radio).

Fork of fsl_phy_mcr20a by Freescale

The Freescale PHY Layer deals with the physical burst which is to be sent and/or received. It performs modulation and demodulation, transmitter and receiver switching, fragmentation, scrambling, interleaving, and error correction coding. The communication to the upper protocol layers is carried out through the Layer 1 Interface.

The PHY Layer is capable of executing the following sequences:

  • I (Idle)
  • R (Receive Sequence conditionally followed by a TxAck)
  • T (Transmit Sequence)
  • C (Standalone CCA)
  • CCCA (Continuous CCA)
  • TR (Transmit/Receive Sequence - transmit unconditionally followed by either an R or RxAck)

In addition to these sequences the PHY Layer also integrates a packet processor which determines whether the packet is MAC-compliant, and if it is, whether it is addressed to the end device. Another feature of the packet processor is Source Address Matching which can be viewed as an extension of packet filtering; however its function is very specific to its intended application (data-polling and indirect queue management by a PAN Coordinator).

Documentation

MCR20A PHY Reference Manual

PHY/PhyDebug.c

Committer:
andreikovacs
Date:
2015-08-18
Revision:
0:764779eedf2d

File content as of revision 0:764779eedf2d:

/*!
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* All rights reserved.
*
* \file PhyDebug.c
* MCR20: PHY debug and logging functions
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* o Redistributions of source code must retain the above copyright notice, this list
*   of conditions and the following disclaimer.
*
* o Redistributions in binary form must reproduce the above copyright notice, this
*   list of conditions and the following disclaimer in the documentation and/or
*   other materials provided with the distribution.
*
* o Neither the name of Freescale Semiconductor, Inc. nor the names of its
*   contributors may be used to endorse or promote products derived from this
*   software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/


/************************************************************************************
*************************************************************************************
* Includes
*************************************************************************************
************************************************************************************/

#include "EmbeddedTypes.h"
//#include "PortConfig.h"
#include "MCR20Drv.h"
#include "MCR20Reg.h"
#include "Phy.h"
#include "PhyDebug.h"


#ifdef MAC_PHY_DEBUG


/************************************************************************************
*************************************************************************************
* Private memory declarations
*************************************************************************************
************************************************************************************/

uint16_t nDebugIndex = 0, nDebugSize = DEBUG_LOG_ENTRIES * 4;
uint8_t  nDebugStorage[DEBUG_LOG_ENTRIES * 4];


/************************************************************************************
*************************************************************************************
* Public functions
*************************************************************************************
************************************************************************************/

void PhyDebugLogTime(uint8_t item)
{
  uint32_t time;
  nDebugStorage[nDebugIndex + 0] = item;
  MCR20Drv_DirectAccessSPIMultiByteRead( (uint8_t) EVENT_TMR_LSB, (uint8_t *) &time, 3);
  
  nDebugStorage[nDebugIndex + 3] = (uint8_t) (time >> 0);
  nDebugStorage[nDebugIndex + 2] = (uint8_t) (time >> 8);
  nDebugStorage[nDebugIndex + 1] = (uint8_t) (time >> 16);
  
  nDebugIndex += 4;
  if(nDebugIndex >= nDebugSize)
  {
    nDebugIndex = 0;
  }
}

/***********************************************************************************/

void PhyDebugLogParam1(uint8_t item, uint8_t param1)
{
  nDebugStorage[nDebugIndex + 0] = item;
  nDebugStorage[nDebugIndex + 1] = param1;
  nDebugStorage[nDebugIndex + 2] = 0;
  nDebugStorage[nDebugIndex + 3] = 0;

  nDebugIndex += 4;
  if(nDebugIndex >= nDebugSize)
  {
    nDebugIndex = 0;
  }
}

/***********************************************************************************/

void PhyDebugLogParam2(uint8_t item, uint8_t param1, uint8_t param2)
{
  nDebugStorage[nDebugIndex + 0] = item;
  nDebugStorage[nDebugIndex + 1] = param1;
  nDebugStorage[nDebugIndex + 2] = param2;
  nDebugStorage[nDebugIndex + 3] = 0;

  nDebugIndex += 4;
  if(nDebugIndex >= nDebugSize)
  {
    nDebugIndex = 0;
  }
}

/***********************************************************************************/

void PhyDebugLogParam3(uint8_t item, uint8_t param1, uint8_t param2, uint8_t param3)
{
  nDebugStorage[nDebugIndex + 0] = item;
  nDebugStorage[nDebugIndex + 1] = param1;
  nDebugStorage[nDebugIndex + 2] = param2;
  nDebugStorage[nDebugIndex + 3] = param3;

  nDebugIndex += 4;
  if(nDebugIndex >= nDebugSize)
  {
    nDebugIndex = 0;
  }
}

/***********************************************************************************/

#endif /* MAC_PHY_DEBUG */