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

Utils/GenericList/GenericList.h@0:764779eedf2d, 2015-08-18 (annotated)

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 GenericList.h
andreikovacs 0:764779eedf2d 6 * This is the header file for the linked lists part of the Utils package.
andreikovacs 0:764779eedf2d 7 *
andreikovacs 0:764779eedf2d 8 * Redistribution and use in source and binary forms, with or without modification,
andreikovacs 0:764779eedf2d 9 * are permitted provided that the following conditions are met:
andreikovacs 0:764779eedf2d 10 *
andreikovacs 0:764779eedf2d 11 * o Redistributions of source code must retain the above copyright notice, this list
andreikovacs 0:764779eedf2d 12 * of conditions and the following disclaimer.
andreikovacs 0:764779eedf2d 13 *
andreikovacs 0:764779eedf2d 14 * o Redistributions in binary form must reproduce the above copyright notice, this
andreikovacs 0:764779eedf2d 15 * list of conditions and the following disclaimer in the documentation and/or
andreikovacs 0:764779eedf2d 16 * other materials provided with the distribution.
andreikovacs 0:764779eedf2d 17 *
andreikovacs 0:764779eedf2d 18 * o Neither the name of Freescale Semiconductor, Inc. nor the names of its
andreikovacs 0:764779eedf2d 19 * contributors may be used to endorse or promote products derived from this
andreikovacs 0:764779eedf2d 20 * software without specific prior written permission.
andreikovacs 0:764779eedf2d 21 *
andreikovacs 0:764779eedf2d 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
andreikovacs 0:764779eedf2d 23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
andreikovacs 0:764779eedf2d 24 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
andreikovacs 0:764779eedf2d 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
andreikovacs 0:764779eedf2d 26 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
andreikovacs 0:764779eedf2d 27 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
andreikovacs 0:764779eedf2d 28 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
andreikovacs 0:764779eedf2d 29 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
andreikovacs 0:764779eedf2d 30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
andreikovacs 0:764779eedf2d 31 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
andreikovacs 0:764779eedf2d 32 */
andreikovacs 0:764779eedf2d 33
andreikovacs 0:764779eedf2d 34 #ifndef _GENERIC_LIST_H_
andreikovacs 0:764779eedf2d 35 #define _GENERIC_LIST_H_
andreikovacs 0:764779eedf2d 36
andreikovacs 0:764779eedf2d 37
andreikovacs 0:764779eedf2d 38 /*! *********************************************************************************
andreikovacs 0:764779eedf2d 39 *************************************************************************************
andreikovacs 0:764779eedf2d 40 * Include
andreikovacs 0:764779eedf2d 41 *************************************************************************************
andreikovacs 0:764779eedf2d 42 ********************************************************************************** */
andreikovacs 0:764779eedf2d 43
andreikovacs 0:764779eedf2d 44 #include "EmbeddedTypes.h"
andreikovacs 0:764779eedf2d 45
andreikovacs 0:764779eedf2d 46 /*! *********************************************************************************
andreikovacs 0:764779eedf2d 47 *************************************************************************************
andreikovacs 0:764779eedf2d 48 * Public macro definitions
andreikovacs 0:764779eedf2d 49 *************************************************************************************
andreikovacs 0:764779eedf2d 50 ********************************************************************************** */
andreikovacs 0:764779eedf2d 51
andreikovacs 0:764779eedf2d 52 /*! *********************************************************************************
andreikovacs 0:764779eedf2d 53 *************************************************************************************
andreikovacs 0:764779eedf2d 54 * Public type definitions
andreikovacs 0:764779eedf2d 55 *************************************************************************************
andreikovacs 0:764779eedf2d 56 ********************************************************************************** */
andreikovacs 0:764779eedf2d 57 typedef enum
andreikovacs 0:764779eedf2d 58 {
andreikovacs 0:764779eedf2d 59 gListOk_c = 0,
andreikovacs 0:764779eedf2d 60 gListFull_c,
andreikovacs 0:764779eedf2d 61 gListEmpty_c,
andreikovacs 0:764779eedf2d 62 gOrphanElement_c
andreikovacs 0:764779eedf2d 63 }listStatus_t;
andreikovacs 0:764779eedf2d 64
andreikovacs 0:764779eedf2d 65 typedef struct list_tag
andreikovacs 0:764779eedf2d 66 {
andreikovacs 0:764779eedf2d 67 struct listElement_tag *head;
andreikovacs 0:764779eedf2d 68 struct listElement_tag *tail;
andreikovacs 0:764779eedf2d 69 uint16_t size;
andreikovacs 0:764779eedf2d 70 uint16_t max;
andreikovacs 0:764779eedf2d 71 }list_t, *listHandle_t;
andreikovacs 0:764779eedf2d 72
andreikovacs 0:764779eedf2d 73 typedef struct listElement_tag
andreikovacs 0:764779eedf2d 74 {
andreikovacs 0:764779eedf2d 75 struct listElement_tag *next;
andreikovacs 0:764779eedf2d 76 struct listElement_tag *prev;
andreikovacs 0:764779eedf2d 77 struct list_tag *list;
andreikovacs 0:764779eedf2d 78 }listElement_t, *listElementHandle_t;
andreikovacs 0:764779eedf2d 79
andreikovacs 0:764779eedf2d 80 /*! *********************************************************************************
andreikovacs 0:764779eedf2d 81 *************************************************************************************
andreikovacs 0:764779eedf2d 82 * Public prototypes
andreikovacs 0:764779eedf2d 83 *************************************************************************************
andreikovacs 0:764779eedf2d 84 ********************************************************************************** */
andreikovacs 0:764779eedf2d 85 void ListInit(listHandle_t list, uint32_t max);
andreikovacs 0:764779eedf2d 86 listHandle_t ListGetList(listElementHandle_t element);
andreikovacs 0:764779eedf2d 87 listStatus_t ListAddHead(listHandle_t list, listElementHandle_t element);
andreikovacs 0:764779eedf2d 88 listStatus_t ListAddTail(listHandle_t list, listElementHandle_t element);
andreikovacs 0:764779eedf2d 89 listElementHandle_t ListRemoveHead(listHandle_t list);
andreikovacs 0:764779eedf2d 90 listElementHandle_t ListGetHead(listHandle_t list);
andreikovacs 0:764779eedf2d 91 listElementHandle_t ListGetNext(listElementHandle_t element);
andreikovacs 0:764779eedf2d 92 listElementHandle_t ListGetPrev(listElementHandle_t element);
andreikovacs 0:764779eedf2d 93 listStatus_t ListRemoveElement(listElementHandle_t element);
andreikovacs 0:764779eedf2d 94 listStatus_t ListAddPrevElement(listElementHandle_t element, listElementHandle_t newElement);
andreikovacs 0:764779eedf2d 95 uint32_t ListGetSize(listHandle_t list);
andreikovacs 0:764779eedf2d 96 uint32_t ListGetAvailable(listHandle_t list);
andreikovacs 0:764779eedf2d 97 listStatus_t ListTest(void);
andreikovacs 0:764779eedf2d 98
andreikovacs 0:764779eedf2d 99 /*! *********************************************************************************
andreikovacs 0:764779eedf2d 100 *************************************************************************************
andreikovacs 0:764779eedf2d 101 * Private macros
andreikovacs 0:764779eedf2d 102 *************************************************************************************
andreikovacs 0:764779eedf2d 103 ********************************************************************************** */
andreikovacs 0:764779eedf2d 104 #ifdef DEBUG_ASSERT
andreikovacs 0:764779eedf2d 105 #define LIST_ASSERT(condition) if(!(condition))while(1);
andreikovacs 0:764779eedf2d 106 #else
andreikovacs 0:764779eedf2d 107 #define LIST_ASSERT(condition) (void)(condition);
andreikovacs 0:764779eedf2d 108 #endif
andreikovacs 0:764779eedf2d 109
andreikovacs 0:764779eedf2d 110 #endif /*_GENERIC_LIST_H_*/