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

Committer:
andreikovacs
Date:
Tue Aug 18 12:41:42 2015 +0000
Revision:
0:764779eedf2d
Initial commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
andreikovacs 0:764779eedf2d 1 /*!
andreikovacs 0:764779eedf2d 2 * Copyright (c) 2015, Freescale Semiconductor, Inc.
andreikovacs 0:764779eedf2d 3 * All rights reserved.
andreikovacs 0:764779eedf2d 4 *
andreikovacs 0:764779eedf2d 5 * \file XcvrSpi.h
andreikovacs 0:764779eedf2d 6 *
andreikovacs 0:764779eedf2d 7 * Redistribution and use in source and binary forms, with or without modification,
andreikovacs 0:764779eedf2d 8 * are permitted provided that the following conditions are met:
andreikovacs 0:764779eedf2d 9 *
andreikovacs 0:764779eedf2d 10 * o Redistributions of source code must retain the above copyright notice, this list
andreikovacs 0:764779eedf2d 11 * of conditions and the following disclaimer.
andreikovacs 0:764779eedf2d 12 *
andreikovacs 0:764779eedf2d 13 * o Redistributions in binary form must reproduce the above copyright notice, this
andreikovacs 0:764779eedf2d 14 * list of conditions and the following disclaimer in the documentation and/or
andreikovacs 0:764779eedf2d 15 * other materials provided with the distribution.
andreikovacs 0:764779eedf2d 16 *
andreikovacs 0:764779eedf2d 17 * o Neither the name of Freescale Semiconductor, Inc. nor the names of its
andreikovacs 0:764779eedf2d 18 * contributors may be used to endorse or promote products derived from this
andreikovacs 0:764779eedf2d 19 * software without specific prior written permission.
andreikovacs 0:764779eedf2d 20 *
andreikovacs 0:764779eedf2d 21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
andreikovacs 0:764779eedf2d 22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
andreikovacs 0:764779eedf2d 23 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
andreikovacs 0:764779eedf2d 24 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
andreikovacs 0:764779eedf2d 25 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
andreikovacs 0:764779eedf2d 26 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
andreikovacs 0:764779eedf2d 27 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
andreikovacs 0:764779eedf2d 28 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
andreikovacs 0:764779eedf2d 29 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
andreikovacs 0:764779eedf2d 30 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
andreikovacs 0:764779eedf2d 31 */
andreikovacs 0:764779eedf2d 32
andreikovacs 0:764779eedf2d 33 #ifndef __XCVR_SPI_H__
andreikovacs 0:764779eedf2d 34 #define __XCVR_SPI_H__
andreikovacs 0:764779eedf2d 35
andreikovacs 0:764779eedf2d 36
andreikovacs 0:764779eedf2d 37 /*****************************************************************************
andreikovacs 0:764779eedf2d 38 * INCLUDED HEADERS *
andreikovacs 0:764779eedf2d 39 *---------------------------------------------------------------------------*
andreikovacs 0:764779eedf2d 40 * Add to this section all the headers that this module needs to include. *
andreikovacs 0:764779eedf2d 41 * Note that it is not a good practice to include header files into header *
andreikovacs 0:764779eedf2d 42 * files, so use this section only if there is no other better solution. *
andreikovacs 0:764779eedf2d 43 *---------------------------------------------------------------------------*
andreikovacs 0:764779eedf2d 44 *****************************************************************************/
andreikovacs 0:764779eedf2d 45
andreikovacs 0:764779eedf2d 46 #include "EmbeddedTypes.h"
andreikovacs 0:764779eedf2d 47 //#include "board.h"
andreikovacs 0:764779eedf2d 48
andreikovacs 0:764779eedf2d 49
andreikovacs 0:764779eedf2d 50 /*****************************************************************************
andreikovacs 0:764779eedf2d 51 * PUBLIC MACROS *
andreikovacs 0:764779eedf2d 52 *---------------------------------------------------------------------------*
andreikovacs 0:764779eedf2d 53 * Add to this section all the access macros, registers mappings, bit access *
andreikovacs 0:764779eedf2d 54 * macros, masks, flags etc ...
andreikovacs 0:764779eedf2d 55 *---------------------------------------------------------------------------*
andreikovacs 0:764779eedf2d 56 *****************************************************************************/
andreikovacs 0:764779eedf2d 57 //#define gXcvrAssertCS_d() GPIO_DRV_ClearPinOutput(kGpioXcvrSpiCsPin)
andreikovacs 0:764779eedf2d 58 //#define gXcvrDeassertCS_d() GPIO_DRV_SetPinOutput(kGpioXcvrSpiCsPin)
andreikovacs 0:764779eedf2d 59
andreikovacs 0:764779eedf2d 60 #define gXcvrSpiInstance_c 0
andreikovacs 0:764779eedf2d 61
andreikovacs 0:764779eedf2d 62 /*****************************************************************************
andreikovacs 0:764779eedf2d 63 * PUBLIC FUNCTIONS *
andreikovacs 0:764779eedf2d 64 *---------------------------------------------------------------------------*
andreikovacs 0:764779eedf2d 65 * Add to this section all the global functions prototype preceded (as a *
andreikovacs 0:764779eedf2d 66 * good practice) by the keyword 'extern' *
andreikovacs 0:764779eedf2d 67 *---------------------------------------------------------------------------*
andreikovacs 0:764779eedf2d 68 *****************************************************************************/
andreikovacs 0:764779eedf2d 69 void RF_RST_Set(int state);
andreikovacs 0:764779eedf2d 70 void RF_SLP_TR_Set(int state);
andreikovacs 0:764779eedf2d 71 void RF_CS_while_active(void);
andreikovacs 0:764779eedf2d 72 void RF_CS_Set(int state);
andreikovacs 0:764779eedf2d 73 void RF_IRQ_Init(void);
andreikovacs 0:764779eedf2d 74 void RF_IRQ_Disable(void);
andreikovacs 0:764779eedf2d 75 void RF_IRQ_Enable(void);
andreikovacs 0:764779eedf2d 76 bool_t RF_isIRQ_Pending(void);
andreikovacs 0:764779eedf2d 77
andreikovacs 0:764779eedf2d 78 void gXcvrAssertCS_d(void);
andreikovacs 0:764779eedf2d 79 void gXcvrDeassertCS_d(void);
andreikovacs 0:764779eedf2d 80
andreikovacs 0:764779eedf2d 81 void spi_master_init(uint32_t instance);
andreikovacs 0:764779eedf2d 82 void spi_master_configure_speed(uint32_t instance, uint32_t freq);
andreikovacs 0:764779eedf2d 83 void spi_master_transfer(uint32_t instance,
andreikovacs 0:764779eedf2d 84 uint8_t * sendBuffer,
andreikovacs 0:764779eedf2d 85 uint8_t * receiveBuffer,
andreikovacs 0:764779eedf2d 86 uint32_t transferByteCount);
andreikovacs 0:764779eedf2d 87
andreikovacs 0:764779eedf2d 88 #endif /* __XCVR_SPI_H__ */