mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_prs.c@161:2cc1468da177, 2017-03-30 (annotated)

Committer:
<>
Date:
Thu Mar 30 13:45:57 2017 +0100
Revision:
161:2cc1468da177
Parent:
150:02e0a0aed4ec
Child:
179:b0033dcd6934
This updates the lib to the mbed lib v139

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 2 * @file em_prs.c
<> 144:ef7eb2e8f9f7 3 * @brief Peripheral Reflex System (PRS) Peripheral API
<> 161:2cc1468da177 4 * @version 5.1.2
<> 144:ef7eb2e8f9f7 5 *******************************************************************************
<> 144:ef7eb2e8f9f7 6 * @section License
<> 150:02e0a0aed4ec 7 * <b>Copyright 2016 Silicon Laboratories, Inc. http://www.silabs.com</b>
<> 144:ef7eb2e8f9f7 8 *******************************************************************************
<> 144:ef7eb2e8f9f7 9 *
<> 144:ef7eb2e8f9f7 10 * Permission is granted to anyone to use this software for any purpose,
<> 144:ef7eb2e8f9f7 11 * including commercial applications, and to alter it and redistribute it
<> 144:ef7eb2e8f9f7 12 * freely, subject to the following restrictions:
<> 144:ef7eb2e8f9f7 13 *
<> 144:ef7eb2e8f9f7 14 * 1. The origin of this software must not be misrepresented; you must not
<> 144:ef7eb2e8f9f7 15 * claim that you wrote the original software.
<> 144:ef7eb2e8f9f7 16 * 2. Altered source versions must be plainly marked as such, and must not be
<> 144:ef7eb2e8f9f7 17 * misrepresented as being the original software.
<> 144:ef7eb2e8f9f7 18 * 3. This notice may not be removed or altered from any source distribution.
<> 144:ef7eb2e8f9f7 19 *
<> 144:ef7eb2e8f9f7 20 * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no
<> 144:ef7eb2e8f9f7 21 * obligation to support this Software. Silicon Labs is providing the
<> 144:ef7eb2e8f9f7 22 * Software "AS IS", with no express or implied warranties of any kind,
<> 144:ef7eb2e8f9f7 23 * including, but not limited to, any implied warranties of merchantability
<> 144:ef7eb2e8f9f7 24 * or fitness for any particular purpose or warranties against infringement
<> 144:ef7eb2e8f9f7 25 * of any proprietary rights of a third party.
<> 144:ef7eb2e8f9f7 26 *
<> 144:ef7eb2e8f9f7 27 * Silicon Labs will not be liable for any consequential, incidental, or
<> 144:ef7eb2e8f9f7 28 * special damages, or any other relief, or for any claim by any third party,
<> 144:ef7eb2e8f9f7 29 * arising from your use of this Software.
<> 144:ef7eb2e8f9f7 30 *
<> 144:ef7eb2e8f9f7 31 ******************************************************************************/
<> 144:ef7eb2e8f9f7 32
<> 144:ef7eb2e8f9f7 33 #include "em_prs.h"
<> 144:ef7eb2e8f9f7 34 #if defined(PRS_COUNT) && (PRS_COUNT > 0)
<> 144:ef7eb2e8f9f7 35
<> 144:ef7eb2e8f9f7 36 #include "em_assert.h"
<> 144:ef7eb2e8f9f7 37
<> 144:ef7eb2e8f9f7 38 /***************************************************************************//**
<> 150:02e0a0aed4ec 39 * @addtogroup emlib
<> 144:ef7eb2e8f9f7 40 * @{
<> 144:ef7eb2e8f9f7 41 ******************************************************************************/
<> 144:ef7eb2e8f9f7 42
<> 144:ef7eb2e8f9f7 43 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 44 * @addtogroup PRS
<> 144:ef7eb2e8f9f7 45 * @brief Peripheral Reflex System (PRS) Peripheral API
<> 150:02e0a0aed4ec 46 * @details
<> 150:02e0a0aed4ec 47 * This module contains functions to control the PRS peripheral of Silicon
<> 150:02e0a0aed4ec 48 * Labs 32-bit MCUs and SoCs. The PRS allows configurable, fast and autonomous
<> 150:02e0a0aed4ec 49 * communication between peripherals on the MCU or SoC.
<> 144:ef7eb2e8f9f7 50 * @{
<> 144:ef7eb2e8f9f7 51 ******************************************************************************/
<> 144:ef7eb2e8f9f7 52
<> 144:ef7eb2e8f9f7 53 /*******************************************************************************
<> 144:ef7eb2e8f9f7 54 ************************** GLOBAL FUNCTIONS *******************************
<> 144:ef7eb2e8f9f7 55 ******************************************************************************/
<> 144:ef7eb2e8f9f7 56
<> 144:ef7eb2e8f9f7 57 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 58 * @brief
<> 144:ef7eb2e8f9f7 59 * Set source and signal to be used for a channel.
<> 144:ef7eb2e8f9f7 60 *
<> 144:ef7eb2e8f9f7 61 * @param[in] ch
<> 144:ef7eb2e8f9f7 62 * Channel to define signal and source for.
<> 144:ef7eb2e8f9f7 63 *
<> 144:ef7eb2e8f9f7 64 * @param[in] source
<> 144:ef7eb2e8f9f7 65 * Source to select for channel. Use one of PRS_CH_CTRL_SOURCESEL_x defines.
<> 144:ef7eb2e8f9f7 66 *
<> 144:ef7eb2e8f9f7 67 * @param[in] signal
<> 144:ef7eb2e8f9f7 68 * Signal (for selected @p source) to use. Use one of PRS_CH_CTRL_SIGSEL_x
<> 144:ef7eb2e8f9f7 69 * defines.
<> 144:ef7eb2e8f9f7 70 *
<> 144:ef7eb2e8f9f7 71 * @param[in] edge
<> 144:ef7eb2e8f9f7 72 * Edge (for selected source/signal) to generate pulse for.
<> 144:ef7eb2e8f9f7 73 ******************************************************************************/
<> 144:ef7eb2e8f9f7 74 void PRS_SourceSignalSet(unsigned int ch,
<> 144:ef7eb2e8f9f7 75 uint32_t source,
<> 144:ef7eb2e8f9f7 76 uint32_t signal,
<> 144:ef7eb2e8f9f7 77 PRS_Edge_TypeDef edge)
<> 144:ef7eb2e8f9f7 78 {
<> 144:ef7eb2e8f9f7 79 EFM_ASSERT(ch < PRS_CHAN_COUNT);
<> 144:ef7eb2e8f9f7 80
<> 144:ef7eb2e8f9f7 81 PRS->CH[ch].CTRL = (source & _PRS_CH_CTRL_SOURCESEL_MASK)
<> 144:ef7eb2e8f9f7 82 | (signal & _PRS_CH_CTRL_SIGSEL_MASK)
<> 144:ef7eb2e8f9f7 83 | (uint32_t)edge;
<> 144:ef7eb2e8f9f7 84 }
<> 144:ef7eb2e8f9f7 85
<> 144:ef7eb2e8f9f7 86 #if defined( PRS_CH_CTRL_ASYNC )
<> 144:ef7eb2e8f9f7 87 /***************************************************************************//**
<> 144:ef7eb2e8f9f7 88 * @brief
<> 144:ef7eb2e8f9f7 89 * Set source and asynchronous signal to be used for a channel.
<> 144:ef7eb2e8f9f7 90 *
<> 144:ef7eb2e8f9f7 91 * @details
<> 144:ef7eb2e8f9f7 92 * Asynchronous reflexes are not clocked on HFPERCLK, and can be used even in
<> 144:ef7eb2e8f9f7 93 * EM2/EM3.
<> 144:ef7eb2e8f9f7 94 * There is a limitation to reflexes operating in asynchronous mode: they can
<> 144:ef7eb2e8f9f7 95 * only be used by a subset of the reflex consumers. Please refer to PRS
<> 144:ef7eb2e8f9f7 96 * chapter in the reference manual for the complete list of supported
<> 144:ef7eb2e8f9f7 97 * asynchronous signals and consumers.
<> 144:ef7eb2e8f9f7 98 *
<> 144:ef7eb2e8f9f7 99 * @note
<> 144:ef7eb2e8f9f7 100 * This function is not supported on EFM32GxxxFyyy parts.
<> 144:ef7eb2e8f9f7 101 * In asynchronous mode, the edge detector only works in EM0, hence it shall
<> 144:ef7eb2e8f9f7 102 * not be used. The EDSEL parameter in PRS_CHx_CTRL register is set to 0 (OFF)
<> 144:ef7eb2e8f9f7 103 * by default.
<> 144:ef7eb2e8f9f7 104 *
<> 144:ef7eb2e8f9f7 105 * @param[in] ch
<> 144:ef7eb2e8f9f7 106 * Channel to define source and asynchronous signal for.
<> 144:ef7eb2e8f9f7 107 *
<> 144:ef7eb2e8f9f7 108 * @param[in] source
<> 144:ef7eb2e8f9f7 109 * Source to select for channel. Use one of PRS_CH_CTRL_SOURCESEL_x defines.
<> 144:ef7eb2e8f9f7 110 *
<> 144:ef7eb2e8f9f7 111 * @param[in] signal
<> 144:ef7eb2e8f9f7 112 * Asynchronous signal (for selected @p source) to use. Use one of the
<> 144:ef7eb2e8f9f7 113 * PRS_CH_CTRL_SIGSEL_x defines that support asynchronous operation.
<> 144:ef7eb2e8f9f7 114 ******************************************************************************/
<> 144:ef7eb2e8f9f7 115 void PRS_SourceAsyncSignalSet(unsigned int ch,
<> 144:ef7eb2e8f9f7 116 uint32_t source,
<> 144:ef7eb2e8f9f7 117 uint32_t signal)
<> 144:ef7eb2e8f9f7 118 {
<> 144:ef7eb2e8f9f7 119 EFM_ASSERT(ch < PRS_CHAN_COUNT);
<> 144:ef7eb2e8f9f7 120
<> 144:ef7eb2e8f9f7 121 PRS->CH[ch].CTRL = PRS_CH_CTRL_ASYNC
<> 144:ef7eb2e8f9f7 122 | (source & _PRS_CH_CTRL_SOURCESEL_MASK)
<> 144:ef7eb2e8f9f7 123 | (signal & _PRS_CH_CTRL_SIGSEL_MASK)
<> 144:ef7eb2e8f9f7 124 | PRS_CH_CTRL_EDSEL_OFF;
<> 144:ef7eb2e8f9f7 125 }
<> 144:ef7eb2e8f9f7 126 #endif
<> 144:ef7eb2e8f9f7 127
<> 144:ef7eb2e8f9f7 128 /** @} (end addtogroup PRS) */
<> 150:02e0a0aed4ec 129 /** @} (end addtogroup emlib) */
<> 144:ef7eb2e8f9f7 130 #endif /* defined(PRS_COUNT) && (PRS_COUNT > 0) */