ST
/
stm-spirit1-rf-driver
Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
Prototype RF Driver for STM Sub-1 GHz RF Expansion Boards based on the SPSGRF-868 and SPSGRF-915 Modules for STM32 Nucleo
Currently supported boards:
Note, in order to use expansion board X-NUCLEO-IDS01A4 in mbed you need to perform the following HW modifications on the board:
- Unmount resistor
R4 - Mount resistor
R7
Furthermore, on some Nucleo development boards (e.g. the NUCLEO_F429ZI), in order to be able to use Ethernet together with these Sub-1 GHz RF expansion boards, you need to compile this driver with macro SPIRIT1_SPI_MOSI=PB_5 defined, while the development board typically requires some HW modification as e.g. described here!
This driver can be used together with the 6LoWPAN stack (a.k.a. Nanostack).
libs/spirit1/SPIRIT1_Library/Src/SPIRIT_Irq.c@0:4fb29d9ee571, 2016-10-13 (annotated)
- Committer:
- Wolfgang Betz
- Date:
- Thu Oct 13 15:41:39 2016 +0200
- Revision:
- 0:4fb29d9ee571
- Child:
- 14:898a9d48dd03
First compiling version (without warnings)
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| Wolfgang Betz |
0:4fb29d9ee571 | 1 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 2 | ****************************************************************************** |
| Wolfgang Betz |
0:4fb29d9ee571 | 3 | * @file SPIRIT_Irq.c |
| Wolfgang Betz |
0:4fb29d9ee571 | 4 | * @author VMA division - AMS |
| Wolfgang Betz |
0:4fb29d9ee571 | 5 | * @version 3.2.2 |
| Wolfgang Betz |
0:4fb29d9ee571 | 6 | * @date 08-July-2015 |
| Wolfgang Betz |
0:4fb29d9ee571 | 7 | * @brief Configuration and management of SPIRIT IRQs. |
| Wolfgang Betz |
0:4fb29d9ee571 | 8 | * @details |
| Wolfgang Betz |
0:4fb29d9ee571 | 9 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 10 | * @attention |
| Wolfgang Betz |
0:4fb29d9ee571 | 11 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 12 | * <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2> |
| Wolfgang Betz |
0:4fb29d9ee571 | 13 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 14 | * Redistribution and use in source and binary forms, with or without modification, |
| Wolfgang Betz |
0:4fb29d9ee571 | 15 | * are permitted provided that the following conditions are met: |
| Wolfgang Betz |
0:4fb29d9ee571 | 16 | * 1. Redistributions of source code must retain the above copyright notice, |
| Wolfgang Betz |
0:4fb29d9ee571 | 17 | * this list of conditions and the following disclaimer. |
| Wolfgang Betz |
0:4fb29d9ee571 | 18 | * 2. Redistributions in binary form must reproduce the above copyright notice, |
| Wolfgang Betz |
0:4fb29d9ee571 | 19 | * this list of conditions and the following disclaimer in the documentation |
| Wolfgang Betz |
0:4fb29d9ee571 | 20 | * and/or other materials provided with the distribution. |
| Wolfgang Betz |
0:4fb29d9ee571 | 21 | * 3. Neither the name of STMicroelectronics nor the names of its contributors |
| Wolfgang Betz |
0:4fb29d9ee571 | 22 | * may be used to endorse or promote products derived from this software |
| Wolfgang Betz |
0:4fb29d9ee571 | 23 | * without specific prior written permission. |
| Wolfgang Betz |
0:4fb29d9ee571 | 24 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 25 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
| Wolfgang Betz |
0:4fb29d9ee571 | 26 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| Wolfgang Betz |
0:4fb29d9ee571 | 27 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
| Wolfgang Betz |
0:4fb29d9ee571 | 28 | * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE |
| Wolfgang Betz |
0:4fb29d9ee571 | 29 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
| Wolfgang Betz |
0:4fb29d9ee571 | 30 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
| Wolfgang Betz |
0:4fb29d9ee571 | 31 | * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
| Wolfgang Betz |
0:4fb29d9ee571 | 32 | * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| Wolfgang Betz |
0:4fb29d9ee571 | 33 | * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| Wolfgang Betz |
0:4fb29d9ee571 | 34 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| Wolfgang Betz |
0:4fb29d9ee571 | 35 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 36 | ****************************************************************************** |
| Wolfgang Betz |
0:4fb29d9ee571 | 37 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 38 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 39 | /* Includes ------------------------------------------------------------------*/ |
| Wolfgang Betz |
0:4fb29d9ee571 | 40 | #include "SPIRIT_Irq.h" |
| Wolfgang Betz |
0:4fb29d9ee571 | 41 | #include "MCU_Interface.h" |
| Wolfgang Betz |
0:4fb29d9ee571 | 42 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 43 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 44 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 45 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 46 | * @addtogroup SPIRIT_Libraries |
| Wolfgang Betz |
0:4fb29d9ee571 | 47 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 48 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 49 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 50 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 51 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 52 | * @addtogroup SPIRIT_Irq |
| Wolfgang Betz |
0:4fb29d9ee571 | 53 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 54 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 55 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 56 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 57 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 58 | * @defgroup Irq_Private_TypesDefinitions IRQ Private Types Definitions |
| Wolfgang Betz |
0:4fb29d9ee571 | 59 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 60 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 61 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 62 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 63 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 64 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 65 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 66 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 67 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 68 | * @defgroup Irq_Private_Defines IRQ Private Defines |
| Wolfgang Betz |
0:4fb29d9ee571 | 69 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 70 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 71 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 72 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 73 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 74 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 75 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 76 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 77 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 78 | * @defgroup Irq_Private_Macros IRQ Private Macros |
| Wolfgang Betz |
0:4fb29d9ee571 | 79 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 80 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 81 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 82 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 83 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 84 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 85 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 86 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 87 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 88 | * @defgroup Irq_Private_Variables IRQ Private Variables |
| Wolfgang Betz |
0:4fb29d9ee571 | 89 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 90 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 91 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 92 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 93 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 94 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 95 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 96 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 97 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 98 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 99 | * @defgroup Irq_Private_FunctionPrototypes IRQ Private Function Prototypes |
| Wolfgang Betz |
0:4fb29d9ee571 | 100 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 101 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 102 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 103 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 104 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 105 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 106 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 107 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 108 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 109 | * @defgroup Irq_Private_Functions IRQ Private Functions |
| Wolfgang Betz |
0:4fb29d9ee571 | 110 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 111 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 112 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 113 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 114 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 115 | * @brief De initializate the SpiritIrqs structure setting all the bitfield to 0. |
| Wolfgang Betz |
0:4fb29d9ee571 | 116 | * Moreover, it sets the IRQ mask registers to 0x00000000, disabling all IRQs. |
| Wolfgang Betz |
0:4fb29d9ee571 | 117 | * @param pxIrqInit pointer to a variable of type @ref SpiritIrqs, in which all the |
| Wolfgang Betz |
0:4fb29d9ee571 | 118 | * bitfields will be settled to zero. |
| Wolfgang Betz |
0:4fb29d9ee571 | 119 | * @retval None. |
| Wolfgang Betz |
0:4fb29d9ee571 | 120 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 121 | void SpiritIrqDeInit(SpiritIrqs* pxIrqInit) |
| Wolfgang Betz |
0:4fb29d9ee571 | 122 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 123 | uint8_t tempRegValue[4]={0x00,0x00,0x00,0x00}; |
| Wolfgang Betz |
0:4fb29d9ee571 | 124 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 125 | if(pxIrqInit!=NULL) |
| Wolfgang Betz |
0:4fb29d9ee571 | 126 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 127 | /* Sets the bitfields of passed structure to one */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 128 | *(uint32_t*)pxIrqInit = 0x0; |
| Wolfgang Betz |
0:4fb29d9ee571 | 129 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 130 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 131 | /* Writes the IRQ_MASK registers */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 132 | g_xStatus = SpiritSpiWriteRegisters(IRQ_MASK3_BASE, 4, tempRegValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 133 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 134 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 135 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 136 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 137 | * @brief Enables all the IRQs according to the user defined pxIrqInit structure. |
| Wolfgang Betz |
0:4fb29d9ee571 | 138 | * @param pxIrqInit pointer to a variable of type @ref SpiritIrqs, through which the |
| Wolfgang Betz |
0:4fb29d9ee571 | 139 | * user enable specific IRQs. This parameter is a pointer to a SpiritIrqs. |
| Wolfgang Betz |
0:4fb29d9ee571 | 140 | * For example suppose to enable only the two IRQ Low Battery Level and Tx Data Sent: |
| Wolfgang Betz |
0:4fb29d9ee571 | 141 | * @code |
| Wolfgang Betz |
0:4fb29d9ee571 | 142 | * SpiritIrqs myIrqInit = {0}; |
| Wolfgang Betz |
0:4fb29d9ee571 | 143 | * myIrqInit.IRQ_LOW_BATT_LVL = 1; |
| Wolfgang Betz |
0:4fb29d9ee571 | 144 | * myIrqInit.IRQ_TX_DATA_SENT = 1; |
| Wolfgang Betz |
0:4fb29d9ee571 | 145 | * SpiritIrqInit(&myIrqInit); |
| Wolfgang Betz |
0:4fb29d9ee571 | 146 | * @endcode |
| Wolfgang Betz |
0:4fb29d9ee571 | 147 | * @retval None. |
| Wolfgang Betz |
0:4fb29d9ee571 | 148 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 149 | void SpiritIrqInit(SpiritIrqs* pxIrqInit) |
| Wolfgang Betz |
0:4fb29d9ee571 | 150 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 151 | uint8_t tempRegValue[4]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 152 | uint8_t* tmpPoint; |
| Wolfgang Betz |
0:4fb29d9ee571 | 153 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 154 | /* Cast the bitfields structure in an array of char using */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 155 | tmpPoint = (uint8_t*)(pxIrqInit); |
| Wolfgang Betz |
0:4fb29d9ee571 | 156 | for(uint8_t i=0; i<4; i++) |
| Wolfgang Betz |
0:4fb29d9ee571 | 157 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 158 | tempRegValue[3-i]= tmpPoint[i]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 159 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 160 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 161 | /* Writes the IRQ_MASK registers */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 162 | g_xStatus = SpiritSpiWriteRegisters(IRQ_MASK3_BASE, 4, tempRegValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 163 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 164 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 165 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 166 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 167 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 168 | * @brief Enables or disables a specific IRQ. |
| Wolfgang Betz |
0:4fb29d9ee571 | 169 | * @param xIrq IRQ to enable or disable. |
| Wolfgang Betz |
0:4fb29d9ee571 | 170 | * This parameter can be any value of @ref IrqList. |
| Wolfgang Betz |
0:4fb29d9ee571 | 171 | * @param xNewState new state for the IRQ. |
| Wolfgang Betz |
0:4fb29d9ee571 | 172 | * This parameter can be: S_ENABLE or S_DISABLE. |
| Wolfgang Betz |
0:4fb29d9ee571 | 173 | * @retval None. |
| Wolfgang Betz |
0:4fb29d9ee571 | 174 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 175 | void SpiritIrq(IrqList xIrq, SpiritFunctionalState xNewState) |
| Wolfgang Betz |
0:4fb29d9ee571 | 176 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 177 | uint8_t tempRegValue[4]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 178 | uint32_t tempValue = 0; |
| Wolfgang Betz |
0:4fb29d9ee571 | 179 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 180 | /* Check the parameters */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 181 | s_assert_param(IS_SPIRIT_IRQ_LIST(xIrq)); |
| Wolfgang Betz |
0:4fb29d9ee571 | 182 | s_assert_param(IS_SPIRIT_FUNCTIONAL_STATE(xNewState)); |
| Wolfgang Betz |
0:4fb29d9ee571 | 183 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 184 | /* Reads the IRQ_MASK registers */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 185 | g_xStatus = SpiritSpiReadRegisters(IRQ_MASK3_BASE, 4, tempRegValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 186 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 187 | /* Build the IRQ mask word */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 188 | for(uint8_t i=0; i<4; i++) |
| Wolfgang Betz |
0:4fb29d9ee571 | 189 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 190 | tempValue += ((uint32_t)tempRegValue[i])<<(8*(3-i)); |
| Wolfgang Betz |
0:4fb29d9ee571 | 191 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 192 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 193 | /* Rebuild the new mask according to user request */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 194 | if(xNewState == S_DISABLE) |
| Wolfgang Betz |
0:4fb29d9ee571 | 195 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 196 | tempValue &= (~xIrq); |
| Wolfgang Betz |
0:4fb29d9ee571 | 197 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 198 | else |
| Wolfgang Betz |
0:4fb29d9ee571 | 199 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 200 | tempValue |= (xIrq); |
| Wolfgang Betz |
0:4fb29d9ee571 | 201 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 202 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 203 | /* Build the array of bytes to write in the IRQ_MASK registers */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 204 | for(uint8_t j=0; j<4; j++) |
| Wolfgang Betz |
0:4fb29d9ee571 | 205 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 206 | tempRegValue[j] = (uint8_t)(tempValue>>(8*(3-j))); |
| Wolfgang Betz |
0:4fb29d9ee571 | 207 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 208 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 209 | /* Writes the new IRQ mask in the corresponding registers */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 210 | g_xStatus = SpiritSpiWriteRegisters(IRQ_MASK3_BASE, 4, tempRegValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 211 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 212 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 213 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 214 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 215 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 216 | * @brief Fills a pointer to a structure of SpiritIrqs type reading the IRQ_MASK registers. |
| Wolfgang Betz |
0:4fb29d9ee571 | 217 | * @param pxIrqMask pointer to a variable of type @ref SpiritIrqs, through which the |
| Wolfgang Betz |
0:4fb29d9ee571 | 218 | * user can read which IRQs are enabled. All the bitfields equals to zero correspond |
| Wolfgang Betz |
0:4fb29d9ee571 | 219 | * to enabled IRQs, while all the bitfields equals to one correspond to disabled IRQs. |
| Wolfgang Betz |
0:4fb29d9ee571 | 220 | * This parameter is a pointer to a SpiritIrqs. |
| Wolfgang Betz |
0:4fb29d9ee571 | 221 | * For example suppose that the Power On Reset and RX Data ready are the only enabled IRQs. |
| Wolfgang Betz |
0:4fb29d9ee571 | 222 | * @code |
| Wolfgang Betz |
0:4fb29d9ee571 | 223 | * SpiritIrqs myIrqMask; |
| Wolfgang Betz |
0:4fb29d9ee571 | 224 | * SpiritIrqGetStatus(&myIrqMask); |
| Wolfgang Betz |
0:4fb29d9ee571 | 225 | * @endcode |
| Wolfgang Betz |
0:4fb29d9ee571 | 226 | * Then |
| Wolfgang Betz |
0:4fb29d9ee571 | 227 | * myIrqMask.IRQ_POR and myIrqMask.IRQ_RX_DATA_READY are equal to 0 |
| Wolfgang Betz |
0:4fb29d9ee571 | 228 | * while all the other bitfields are equal to one. |
| Wolfgang Betz |
0:4fb29d9ee571 | 229 | * @retval None. |
| Wolfgang Betz |
0:4fb29d9ee571 | 230 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 231 | void SpiritIrqGetMask(SpiritIrqs* pxIrqMask) |
| Wolfgang Betz |
0:4fb29d9ee571 | 232 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 233 | uint8_t tempRegValue[4]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 234 | uint8_t* pIrqPointer = (uint8_t*)pxIrqMask; |
| Wolfgang Betz |
0:4fb29d9ee571 | 235 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 236 | /* Reads IRQ_MASK registers */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 237 | g_xStatus = SpiritSpiReadRegisters(IRQ_MASK3_BASE, 4, tempRegValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 238 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 239 | /* Build the IRQ mask word */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 240 | for(char i=0; i<4; i++) |
| Wolfgang Betz |
0:4fb29d9ee571 | 241 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 242 | *pIrqPointer = tempRegValue[3-i]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 243 | pIrqPointer++; |
| Wolfgang Betz |
0:4fb29d9ee571 | 244 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 245 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 246 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 247 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 248 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 249 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 250 | * @brief Filla a pointer to a structure of SpiritIrqs type reading the IRQ_STATUS registers. |
| Wolfgang Betz |
0:4fb29d9ee571 | 251 | * @param pxIrqStatus pointer to a variable of type @ref SpiritIrqs, through which the |
| Wolfgang Betz |
0:4fb29d9ee571 | 252 | * user can read the status of all the IRQs. All the bitfields equals to one correspond |
| Wolfgang Betz |
0:4fb29d9ee571 | 253 | * to the raised interrupts. This parameter is a pointer to a SpiritIrqs. |
| Wolfgang Betz |
0:4fb29d9ee571 | 254 | * For example suppose that the XO settling timeout is raised as well as the Sync word |
| Wolfgang Betz |
0:4fb29d9ee571 | 255 | * detection. |
| Wolfgang Betz |
0:4fb29d9ee571 | 256 | * @code |
| Wolfgang Betz |
0:4fb29d9ee571 | 257 | * SpiritIrqs myIrqStatus; |
| Wolfgang Betz |
0:4fb29d9ee571 | 258 | * SpiritIrqGetStatus(&myIrqStatus); |
| Wolfgang Betz |
0:4fb29d9ee571 | 259 | * @endcode |
| Wolfgang Betz |
0:4fb29d9ee571 | 260 | * Then |
| Wolfgang Betz |
0:4fb29d9ee571 | 261 | * myIrqStatus.IRQ_XO_COUNT_EXPIRED and myIrqStatus.IRQ_VALID_SYNC are equals to 1 |
| Wolfgang Betz |
0:4fb29d9ee571 | 262 | * while all the other bitfields are equals to zero. |
| Wolfgang Betz |
0:4fb29d9ee571 | 263 | * @retval None. |
| Wolfgang Betz |
0:4fb29d9ee571 | 264 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 265 | void SpiritIrqGetStatus(SpiritIrqs* pxIrqStatus) |
| Wolfgang Betz |
0:4fb29d9ee571 | 266 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 267 | uint8_t tempRegValue[4]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 268 | uint8_t* pIrqPointer = (uint8_t*)pxIrqStatus; |
| Wolfgang Betz |
0:4fb29d9ee571 | 269 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 270 | /* Reads IRQ_STATUS registers */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 271 | g_xStatus = SpiritSpiReadRegisters(IRQ_STATUS3_BASE, 4, tempRegValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 272 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 273 | /* Build the IRQ Status word */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 274 | for(uint8_t i=0; i<4; i++) |
| Wolfgang Betz |
0:4fb29d9ee571 | 275 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 276 | *pIrqPointer = tempRegValue[3-i]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 277 | pIrqPointer++; |
| Wolfgang Betz |
0:4fb29d9ee571 | 278 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 279 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 280 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 281 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 282 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 283 | * @brief Clear the IRQ status registers. |
| Wolfgang Betz |
0:4fb29d9ee571 | 284 | * @param None. |
| Wolfgang Betz |
0:4fb29d9ee571 | 285 | * @retval None. |
| Wolfgang Betz |
0:4fb29d9ee571 | 286 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 287 | void SpiritIrqClearStatus(void) |
| Wolfgang Betz |
0:4fb29d9ee571 | 288 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 289 | uint8_t tempRegValue[4]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 290 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 291 | /* Reads the IRQ_STATUS registers clearing all the flags */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 292 | g_xStatus = SpiritSpiReadRegisters(IRQ_STATUS3_BASE, 4, tempRegValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 293 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 294 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 295 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 296 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 297 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 298 | * @brief Verifies if a specific IRQ has been generated. |
| Wolfgang Betz |
0:4fb29d9ee571 | 299 | * The call resets all the IRQ status, so it can't be used in case of multiple raising interrupts. |
| Wolfgang Betz |
0:4fb29d9ee571 | 300 | * @param xFlag IRQ flag to be checked. |
| Wolfgang Betz |
0:4fb29d9ee571 | 301 | * This parameter can be any value of @ref IrqList. |
| Wolfgang Betz |
0:4fb29d9ee571 | 302 | * @retval SpiritBool S_TRUE or S_FALSE. |
| Wolfgang Betz |
0:4fb29d9ee571 | 303 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 304 | SpiritBool SpiritIrqCheckFlag(IrqList xFlag) |
| Wolfgang Betz |
0:4fb29d9ee571 | 305 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 306 | uint8_t tempRegValue[4]; |
| Wolfgang Betz |
0:4fb29d9ee571 | 307 | uint32_t tempValue = 0; |
| Wolfgang Betz |
0:4fb29d9ee571 | 308 | SpiritBool flag; |
| Wolfgang Betz |
0:4fb29d9ee571 | 309 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 310 | /* Check the parameters */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 311 | s_assert_param(IS_SPIRIT_IRQ_LIST(xFlag)); |
| Wolfgang Betz |
0:4fb29d9ee571 | 312 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 313 | /* Reads registers and build the status word */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 314 | g_xStatus = SpiritSpiReadRegisters(IRQ_STATUS3_BASE, 4, tempRegValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 315 | for(uint8_t i=0; i<4; i++) |
| Wolfgang Betz |
0:4fb29d9ee571 | 316 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 317 | tempValue += ((uint32_t)tempRegValue[i])<<(8*(3-i)); |
| Wolfgang Betz |
0:4fb29d9ee571 | 318 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 319 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 320 | if(tempValue & xFlag) |
| Wolfgang Betz |
0:4fb29d9ee571 | 321 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 322 | flag = S_TRUE; |
| Wolfgang Betz |
0:4fb29d9ee571 | 323 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 324 | else |
| Wolfgang Betz |
0:4fb29d9ee571 | 325 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 326 | flag = S_FALSE; |
| Wolfgang Betz |
0:4fb29d9ee571 | 327 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 328 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 329 | return flag; |
| Wolfgang Betz |
0:4fb29d9ee571 | 330 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 331 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 332 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 333 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 334 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 335 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 336 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 337 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 338 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 339 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 340 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 341 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 342 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 343 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 344 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 345 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 346 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 347 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 348 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 349 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 350 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 351 | /******************* (C) COPYRIGHT 2015 STMicroelectronics *****END OF FILE****/ |
Repository toolbox
Repository details
| Type: | Library |
|---|---|
| Created: | 05 Jul 2017 |
| Imports: | 273 |
| Forks: | 2 |
| Commits: | 83 |
| Dependents: | 0 |
| Dependencies: | 0 |
| Followers: | 412 |
The code in this repository is Apache licensed.
Components
X-NUCLEO-IDS01A4 Sub-1GHz RF Expansion Board