ST / stm-spirit1-rf-driver

Prototype RF driver for STM Sub-1 GHz RF expansion board based on the SPSGRF-868 module for STM32 Nucleo.

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).

source/libs/spirit1/SPIRIT1_Library/Src/SPIRIT_Csma.c@34:edda6a7238ec, 2016-11-22 (annotated)

Committer:
Wolfgang Betz
Date:
Tue Nov 22 11:40:10 2016 +0100
Revision:
34:edda6a7238ec
Child:
67:93bec0baf1de
Perform re-naming

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Wolfgang Betz 34:edda6a7238ec 1 /**
Wolfgang Betz 34:edda6a7238ec 2 ******************************************************************************
Wolfgang Betz 34:edda6a7238ec 3 * @file SPIRIT_Csma.c
Wolfgang Betz 34:edda6a7238ec 4 * @author VMA division - AMS
Wolfgang Betz 34:edda6a7238ec 5 * @version 3.2.2
Wolfgang Betz 34:edda6a7238ec 6 * @date 08-July-2015
Wolfgang Betz 34:edda6a7238ec 7 * @brief Configuration and management of SPIRIT CSMA.
Wolfgang Betz 34:edda6a7238ec 8 * @details
Wolfgang Betz 34:edda6a7238ec 9 * @attention
Wolfgang Betz 34:edda6a7238ec 10 *
Wolfgang Betz 34:edda6a7238ec 11 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
Wolfgang Betz 34:edda6a7238ec 12 *
Wolfgang Betz 34:edda6a7238ec 13 * Redistribution and use in source and binary forms, with or without modification,
Wolfgang Betz 34:edda6a7238ec 14 * are permitted provided that the following conditions are met:
Wolfgang Betz 34:edda6a7238ec 15 * 1. Redistributions of source code must retain the above copyright notice,
Wolfgang Betz 34:edda6a7238ec 16 * this list of conditions and the following disclaimer.
Wolfgang Betz 34:edda6a7238ec 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
Wolfgang Betz 34:edda6a7238ec 18 * this list of conditions and the following disclaimer in the documentation
Wolfgang Betz 34:edda6a7238ec 19 * and/or other materials provided with the distribution.
Wolfgang Betz 34:edda6a7238ec 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
Wolfgang Betz 34:edda6a7238ec 21 * may be used to endorse or promote products derived from this software
Wolfgang Betz 34:edda6a7238ec 22 * without specific prior written permission.
Wolfgang Betz 34:edda6a7238ec 23 *
Wolfgang Betz 34:edda6a7238ec 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Wolfgang Betz 34:edda6a7238ec 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Wolfgang Betz 34:edda6a7238ec 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Wolfgang Betz 34:edda6a7238ec 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Wolfgang Betz 34:edda6a7238ec 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Wolfgang Betz 34:edda6a7238ec 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Wolfgang Betz 34:edda6a7238ec 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Wolfgang Betz 34:edda6a7238ec 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Wolfgang Betz 34:edda6a7238ec 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Wolfgang Betz 34:edda6a7238ec 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Wolfgang Betz 34:edda6a7238ec 34 *
Wolfgang Betz 34:edda6a7238ec 35 ******************************************************************************
Wolfgang Betz 34:edda6a7238ec 36 */
Wolfgang Betz 34:edda6a7238ec 37
Wolfgang Betz 34:edda6a7238ec 38 /* Includes ------------------------------------------------------------------*/
Wolfgang Betz 34:edda6a7238ec 39 #include "SPIRIT_Csma.h"
Wolfgang Betz 34:edda6a7238ec 40 #include "MCU_Interface.h"
Wolfgang Betz 34:edda6a7238ec 41
Wolfgang Betz 34:edda6a7238ec 42
Wolfgang Betz 34:edda6a7238ec 43 /**
Wolfgang Betz 34:edda6a7238ec 44 * @addtogroup SPIRIT_Libraries
Wolfgang Betz 34:edda6a7238ec 45 * @{
Wolfgang Betz 34:edda6a7238ec 46 */
Wolfgang Betz 34:edda6a7238ec 47
Wolfgang Betz 34:edda6a7238ec 48
Wolfgang Betz 34:edda6a7238ec 49 /**
Wolfgang Betz 34:edda6a7238ec 50 * @addtogroup SPIRIT_Csma
Wolfgang Betz 34:edda6a7238ec 51 * @{
Wolfgang Betz 34:edda6a7238ec 52 */
Wolfgang Betz 34:edda6a7238ec 53
Wolfgang Betz 34:edda6a7238ec 54
Wolfgang Betz 34:edda6a7238ec 55 /**
Wolfgang Betz 34:edda6a7238ec 56 * @defgroup Csma_Private_TypesDefinitions CSMA Private TypesDefinitions
Wolfgang Betz 34:edda6a7238ec 57 * @{
Wolfgang Betz 34:edda6a7238ec 58 */
Wolfgang Betz 34:edda6a7238ec 59
Wolfgang Betz 34:edda6a7238ec 60
Wolfgang Betz 34:edda6a7238ec 61 /**
Wolfgang Betz 34:edda6a7238ec 62 *@}
Wolfgang Betz 34:edda6a7238ec 63 */
Wolfgang Betz 34:edda6a7238ec 64
Wolfgang Betz 34:edda6a7238ec 65
Wolfgang Betz 34:edda6a7238ec 66 /**
Wolfgang Betz 34:edda6a7238ec 67 * @defgroup Csma_Private_Defines CSMA Private Defines
Wolfgang Betz 34:edda6a7238ec 68 * @{
Wolfgang Betz 34:edda6a7238ec 69 */
Wolfgang Betz 34:edda6a7238ec 70
Wolfgang Betz 34:edda6a7238ec 71 /**
Wolfgang Betz 34:edda6a7238ec 72 *@}
Wolfgang Betz 34:edda6a7238ec 73 */
Wolfgang Betz 34:edda6a7238ec 74
Wolfgang Betz 34:edda6a7238ec 75
Wolfgang Betz 34:edda6a7238ec 76 /**
Wolfgang Betz 34:edda6a7238ec 77 * @defgroup Csma_Private_Macros CSMA Private Macros
Wolfgang Betz 34:edda6a7238ec 78 * @{
Wolfgang Betz 34:edda6a7238ec 79 */
Wolfgang Betz 34:edda6a7238ec 80
Wolfgang Betz 34:edda6a7238ec 81 /**
Wolfgang Betz 34:edda6a7238ec 82 *@}
Wolfgang Betz 34:edda6a7238ec 83 */
Wolfgang Betz 34:edda6a7238ec 84
Wolfgang Betz 34:edda6a7238ec 85
Wolfgang Betz 34:edda6a7238ec 86 /**
Wolfgang Betz 34:edda6a7238ec 87 * @defgroup Csma_Private_Variables CSMA Private Variables
Wolfgang Betz 34:edda6a7238ec 88 * @{
Wolfgang Betz 34:edda6a7238ec 89 */
Wolfgang Betz 34:edda6a7238ec 90
Wolfgang Betz 34:edda6a7238ec 91 /**
Wolfgang Betz 34:edda6a7238ec 92 *@}
Wolfgang Betz 34:edda6a7238ec 93 */
Wolfgang Betz 34:edda6a7238ec 94
Wolfgang Betz 34:edda6a7238ec 95
Wolfgang Betz 34:edda6a7238ec 96
Wolfgang Betz 34:edda6a7238ec 97 /**
Wolfgang Betz 34:edda6a7238ec 98 * @defgroup Csma_Private_FunctionPrototypes CSMA Private FunctionPrototypes
Wolfgang Betz 34:edda6a7238ec 99 * @{
Wolfgang Betz 34:edda6a7238ec 100 */
Wolfgang Betz 34:edda6a7238ec 101
Wolfgang Betz 34:edda6a7238ec 102 /**
Wolfgang Betz 34:edda6a7238ec 103 *@}
Wolfgang Betz 34:edda6a7238ec 104 */
Wolfgang Betz 34:edda6a7238ec 105
Wolfgang Betz 34:edda6a7238ec 106
Wolfgang Betz 34:edda6a7238ec 107 /**
Wolfgang Betz 34:edda6a7238ec 108 * @defgroup Csma_Private_Functions CSMA Private Functions
Wolfgang Betz 34:edda6a7238ec 109 * @{
Wolfgang Betz 34:edda6a7238ec 110 */
Wolfgang Betz 34:edda6a7238ec 111
Wolfgang Betz 34:edda6a7238ec 112
Wolfgang Betz 34:edda6a7238ec 113 /**
Wolfgang Betz 34:edda6a7238ec 114 * @brief Initializes the SPIRIT CSMA according to the specified parameters in the CsmaInit.
Wolfgang Betz 34:edda6a7238ec 115 * @param pxCsmaInit Csma init structure.
Wolfgang Betz 34:edda6a7238ec 116 * This parameter is a pointer to @ref CsmaInit.
Wolfgang Betz 34:edda6a7238ec 117 * @retval None.
Wolfgang Betz 34:edda6a7238ec 118 */
Wolfgang Betz 34:edda6a7238ec 119 void SpiritCsmaInit(CsmaInit* pxCsmaInit)
Wolfgang Betz 34:edda6a7238ec 120 {
Wolfgang Betz 34:edda6a7238ec 121 uint8_t tempRegValue[5];
Wolfgang Betz 34:edda6a7238ec 122
Wolfgang Betz 34:edda6a7238ec 123 /* Check the parameters */
Wolfgang Betz 34:edda6a7238ec 124 s_assert_param(IS_SPIRIT_FUNCTIONAL_STATE(pxCsmaInit->xCsmaPersistentMode));
Wolfgang Betz 34:edda6a7238ec 125 s_assert_param(IS_CCA_PERIOD(pxCsmaInit->xMultiplierTbit));
Wolfgang Betz 34:edda6a7238ec 126 s_assert_param(IS_CSMA_LENGTH(pxCsmaInit->xCcaLength));
Wolfgang Betz 34:edda6a7238ec 127 s_assert_param(IS_BU_COUNTER_SEED(pxCsmaInit->nBuCounterSeed));
Wolfgang Betz 34:edda6a7238ec 128 s_assert_param(IS_BU_PRESCALER(pxCsmaInit->cBuPrescaler));
Wolfgang Betz 34:edda6a7238ec 129 s_assert_param(IS_CMAX_NB(pxCsmaInit->cMaxNb));
Wolfgang Betz 34:edda6a7238ec 130
Wolfgang Betz 34:edda6a7238ec 131 /* CSMA BU counter seed (MSB) config */
Wolfgang Betz 34:edda6a7238ec 132 tempRegValue[0] = (uint8_t)(pxCsmaInit->nBuCounterSeed >> 8);
Wolfgang Betz 34:edda6a7238ec 133
Wolfgang Betz 34:edda6a7238ec 134 /* CSMA BU counter seed (LSB) config */
Wolfgang Betz 34:edda6a7238ec 135 tempRegValue[1] = (uint8_t) pxCsmaInit->nBuCounterSeed;
Wolfgang Betz 34:edda6a7238ec 136
Wolfgang Betz 34:edda6a7238ec 137 /* CSMA BU prescaler config and CCA period config */
Wolfgang Betz 34:edda6a7238ec 138 tempRegValue[2] = (pxCsmaInit->cBuPrescaler << 2) | pxCsmaInit->xMultiplierTbit;
Wolfgang Betz 34:edda6a7238ec 139
Wolfgang Betz 34:edda6a7238ec 140 /* CSMA CCA length config and max number of back-off */
Wolfgang Betz 34:edda6a7238ec 141 tempRegValue[3] = (pxCsmaInit->xCcaLength | pxCsmaInit->cMaxNb);
Wolfgang Betz 34:edda6a7238ec 142
Wolfgang Betz 34:edda6a7238ec 143 /* Reads the PROTOCOL1_BASE register value, to write the SEED_RELOAD and CSMA_PERS_ON fields */
Wolfgang Betz 34:edda6a7238ec 144 g_xStatus = SpiritSpiReadRegisters(PROTOCOL1_BASE, 1, &tempRegValue[4]);
Wolfgang Betz 34:edda6a7238ec 145
Wolfgang Betz 34:edda6a7238ec 146 /* Writes the new value for persistent mode */
Wolfgang Betz 34:edda6a7238ec 147 if(pxCsmaInit->xCsmaPersistentMode==S_ENABLE)
Wolfgang Betz 34:edda6a7238ec 148 {
Wolfgang Betz 34:edda6a7238ec 149 tempRegValue[4] |= PROTOCOL1_CSMA_PERS_ON_MASK;
Wolfgang Betz 34:edda6a7238ec 150 }
Wolfgang Betz 34:edda6a7238ec 151 else
Wolfgang Betz 34:edda6a7238ec 152 {
Wolfgang Betz 34:edda6a7238ec 153 tempRegValue[4] &= ~PROTOCOL1_CSMA_PERS_ON_MASK;
Wolfgang Betz 34:edda6a7238ec 154 }
Wolfgang Betz 34:edda6a7238ec 155
Wolfgang Betz 34:edda6a7238ec 156 /* Writes PROTOCOL1_BASE register */
Wolfgang Betz 34:edda6a7238ec 157 g_xStatus = SpiritSpiWriteRegisters(PROTOCOL1_BASE, 1, &tempRegValue[4]);
Wolfgang Betz 34:edda6a7238ec 158
Wolfgang Betz 34:edda6a7238ec 159 /* Writes CSMA_CONFIGx_BASE registers */
Wolfgang Betz 34:edda6a7238ec 160 g_xStatus = SpiritSpiWriteRegisters(CSMA_CONFIG3_BASE, 4, tempRegValue);
Wolfgang Betz 34:edda6a7238ec 161
Wolfgang Betz 34:edda6a7238ec 162 }
Wolfgang Betz 34:edda6a7238ec 163
Wolfgang Betz 34:edda6a7238ec 164
Wolfgang Betz 34:edda6a7238ec 165 /**
Wolfgang Betz 34:edda6a7238ec 166 * @brief Returns the fitted structure CsmaInit starting from the registers values.
Wolfgang Betz 34:edda6a7238ec 167 * @param pxCsmaInit Csma structure to be fitted.
Wolfgang Betz 34:edda6a7238ec 168 * This parameter is a pointer to @ref CsmaInit.
Wolfgang Betz 34:edda6a7238ec 169 * @retval None.
Wolfgang Betz 34:edda6a7238ec 170 */
Wolfgang Betz 34:edda6a7238ec 171 void SpiritCsmaGetInfo(CsmaInit* pxCsmaInit)
Wolfgang Betz 34:edda6a7238ec 172 {
Wolfgang Betz 34:edda6a7238ec 173 uint8_t tempRegValue[5];
Wolfgang Betz 34:edda6a7238ec 174
Wolfgang Betz 34:edda6a7238ec 175 /* Reads PROTOCOL1_BASE register */
Wolfgang Betz 34:edda6a7238ec 176 g_xStatus = SpiritSpiReadRegisters(PROTOCOL1_BASE, 1, &tempRegValue[4]);
Wolfgang Betz 34:edda6a7238ec 177
Wolfgang Betz 34:edda6a7238ec 178 /* Reads CSMA_CONFIGx_BASE registers */
Wolfgang Betz 34:edda6a7238ec 179 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG3_BASE, 4, tempRegValue);
Wolfgang Betz 34:edda6a7238ec 180
Wolfgang Betz 34:edda6a7238ec 181 /* Reads the bu counter seed */
Wolfgang Betz 34:edda6a7238ec 182 pxCsmaInit->nBuCounterSeed = (uint16_t)tempRegValue[1] | ((uint16_t)(tempRegValue[0] << 8));
Wolfgang Betz 34:edda6a7238ec 183
Wolfgang Betz 34:edda6a7238ec 184 /* Reads the bu prescaler */
Wolfgang Betz 34:edda6a7238ec 185 pxCsmaInit->cBuPrescaler = tempRegValue[2]>>2;
Wolfgang Betz 34:edda6a7238ec 186
Wolfgang Betz 34:edda6a7238ec 187 /* Reads the Cca period */
Wolfgang Betz 34:edda6a7238ec 188 pxCsmaInit->xMultiplierTbit = (CcaPeriod)(tempRegValue[2] & 0x03);
Wolfgang Betz 34:edda6a7238ec 189
Wolfgang Betz 34:edda6a7238ec 190 /* Reads the Cca length */
Wolfgang Betz 34:edda6a7238ec 191 pxCsmaInit->xCcaLength = (CsmaLength)(tempRegValue[3]&0xF0);
Wolfgang Betz 34:edda6a7238ec 192
Wolfgang Betz 34:edda6a7238ec 193 /* Reads the max number of back off */
Wolfgang Betz 34:edda6a7238ec 194 pxCsmaInit->cMaxNb = tempRegValue[3] & 0x07;
Wolfgang Betz 34:edda6a7238ec 195
Wolfgang Betz 34:edda6a7238ec 196 /* Reads the persistent mode enable bit */
Wolfgang Betz 34:edda6a7238ec 197 pxCsmaInit->xCsmaPersistentMode = (SpiritFunctionalState)((tempRegValue[4]>>1) & 0x01);
Wolfgang Betz 34:edda6a7238ec 198
Wolfgang Betz 34:edda6a7238ec 199 }
Wolfgang Betz 34:edda6a7238ec 200
Wolfgang Betz 34:edda6a7238ec 201
Wolfgang Betz 34:edda6a7238ec 202 /**
Wolfgang Betz 34:edda6a7238ec 203 * @brief Enables or Disables the CSMA.
Wolfgang Betz 34:edda6a7238ec 204 * @param xNewState the state of the CSMA mode.
Wolfgang Betz 34:edda6a7238ec 205 * This parameter can be: S_ENABLE or S_DISABLE.
Wolfgang Betz 34:edda6a7238ec 206 * @retval None.
Wolfgang Betz 34:edda6a7238ec 207 */
Wolfgang Betz 34:edda6a7238ec 208 void SpiritCsma(SpiritFunctionalState xNewState)
Wolfgang Betz 34:edda6a7238ec 209 {
Wolfgang Betz 34:edda6a7238ec 210 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 211
Wolfgang Betz 34:edda6a7238ec 212 /* Check the parameters */
Wolfgang Betz 34:edda6a7238ec 213 s_assert_param(IS_SPIRIT_FUNCTIONAL_STATE(xNewState));
Wolfgang Betz 34:edda6a7238ec 214
Wolfgang Betz 34:edda6a7238ec 215 /* Reads the PROTOCOL1 register value */
Wolfgang Betz 34:edda6a7238ec 216 g_xStatus = SpiritSpiReadRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 217
Wolfgang Betz 34:edda6a7238ec 218 /* Sets or resets the CSMA enable bit */
Wolfgang Betz 34:edda6a7238ec 219 if(xNewState==S_ENABLE)
Wolfgang Betz 34:edda6a7238ec 220 {
Wolfgang Betz 34:edda6a7238ec 221 tempRegValue |= PROTOCOL1_CSMA_ON_MASK;
Wolfgang Betz 34:edda6a7238ec 222 }
Wolfgang Betz 34:edda6a7238ec 223 else
Wolfgang Betz 34:edda6a7238ec 224 {
Wolfgang Betz 34:edda6a7238ec 225 tempRegValue &= ~PROTOCOL1_CSMA_ON_MASK;
Wolfgang Betz 34:edda6a7238ec 226 }
Wolfgang Betz 34:edda6a7238ec 227
Wolfgang Betz 34:edda6a7238ec 228 /* Writes the new value on the PROTOCOL1 register */
Wolfgang Betz 34:edda6a7238ec 229 g_xStatus = SpiritSpiWriteRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 230
Wolfgang Betz 34:edda6a7238ec 231 }
Wolfgang Betz 34:edda6a7238ec 232
Wolfgang Betz 34:edda6a7238ec 233 /**
Wolfgang Betz 34:edda6a7238ec 234 * @brief Gets the CSMA mode. Says if it is enabled or disabled.
Wolfgang Betz 34:edda6a7238ec 235 * @param None.
Wolfgang Betz 34:edda6a7238ec 236 * @retval SpiritFunctionalState: CSMA mode.
Wolfgang Betz 34:edda6a7238ec 237 */
Wolfgang Betz 34:edda6a7238ec 238 SpiritFunctionalState SpiritCsmaGetCsma(void)
Wolfgang Betz 34:edda6a7238ec 239 {
Wolfgang Betz 34:edda6a7238ec 240 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 241
Wolfgang Betz 34:edda6a7238ec 242 /* Reads the PROTOCOL1 register value */
Wolfgang Betz 34:edda6a7238ec 243 g_xStatus = SpiritSpiReadRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 244
Wolfgang Betz 34:edda6a7238ec 245 /* Return if set or reset */
Wolfgang Betz 34:edda6a7238ec 246 if(tempRegValue & PROTOCOL1_CSMA_ON_MASK)
Wolfgang Betz 34:edda6a7238ec 247 {
Wolfgang Betz 34:edda6a7238ec 248 return S_ENABLE;
Wolfgang Betz 34:edda6a7238ec 249 }
Wolfgang Betz 34:edda6a7238ec 250 else
Wolfgang Betz 34:edda6a7238ec 251 {
Wolfgang Betz 34:edda6a7238ec 252 return S_DISABLE;
Wolfgang Betz 34:edda6a7238ec 253 }
Wolfgang Betz 34:edda6a7238ec 254
Wolfgang Betz 34:edda6a7238ec 255 }
Wolfgang Betz 34:edda6a7238ec 256
Wolfgang Betz 34:edda6a7238ec 257 /**
Wolfgang Betz 34:edda6a7238ec 258 * @brief Enables or Disables the persistent CSMA mode.
Wolfgang Betz 34:edda6a7238ec 259 * @param xNewState the state of the persistent CSMA mode.
Wolfgang Betz 34:edda6a7238ec 260 * This parameter can be: S_ENABLE or S_DISABLE.
Wolfgang Betz 34:edda6a7238ec 261 * @retval None.
Wolfgang Betz 34:edda6a7238ec 262 */
Wolfgang Betz 34:edda6a7238ec 263 void SpiritCsmaPersistentMode(SpiritFunctionalState xNewState)
Wolfgang Betz 34:edda6a7238ec 264 {
Wolfgang Betz 34:edda6a7238ec 265 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 266
Wolfgang Betz 34:edda6a7238ec 267 /* Check the parameters */
Wolfgang Betz 34:edda6a7238ec 268 s_assert_param(IS_SPIRIT_FUNCTIONAL_STATE(xNewState));
Wolfgang Betz 34:edda6a7238ec 269
Wolfgang Betz 34:edda6a7238ec 270 /* Reads the PROTOCOL1 register value */
Wolfgang Betz 34:edda6a7238ec 271 g_xStatus = SpiritSpiReadRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 272
Wolfgang Betz 34:edda6a7238ec 273 /* Enables/disables the CSMA persistent mode */
Wolfgang Betz 34:edda6a7238ec 274 if(xNewState==S_ENABLE)
Wolfgang Betz 34:edda6a7238ec 275 {
Wolfgang Betz 34:edda6a7238ec 276 tempRegValue |= PROTOCOL1_CSMA_PERS_ON_MASK;
Wolfgang Betz 34:edda6a7238ec 277 }
Wolfgang Betz 34:edda6a7238ec 278 else
Wolfgang Betz 34:edda6a7238ec 279 {
Wolfgang Betz 34:edda6a7238ec 280 tempRegValue &= ~PROTOCOL1_CSMA_PERS_ON_MASK;
Wolfgang Betz 34:edda6a7238ec 281 }
Wolfgang Betz 34:edda6a7238ec 282
Wolfgang Betz 34:edda6a7238ec 283 /* Writes the new vaue on the PROTOCOL1 register */
Wolfgang Betz 34:edda6a7238ec 284 g_xStatus = SpiritSpiWriteRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 285
Wolfgang Betz 34:edda6a7238ec 286 }
Wolfgang Betz 34:edda6a7238ec 287
Wolfgang Betz 34:edda6a7238ec 288
Wolfgang Betz 34:edda6a7238ec 289 /**
Wolfgang Betz 34:edda6a7238ec 290 * @brief Gets the persistent CSMA mode.
Wolfgang Betz 34:edda6a7238ec 291 * @param None.
Wolfgang Betz 34:edda6a7238ec 292 * @retval SpiritFunctionalState: CSMA persistent mode.
Wolfgang Betz 34:edda6a7238ec 293 */
Wolfgang Betz 34:edda6a7238ec 294 SpiritFunctionalState SpiritCsmaGetPersistentMode(void)
Wolfgang Betz 34:edda6a7238ec 295 {
Wolfgang Betz 34:edda6a7238ec 296 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 297
Wolfgang Betz 34:edda6a7238ec 298 /* Reads the PROTOCOL1 register value */
Wolfgang Betz 34:edda6a7238ec 299 g_xStatus = SpiritSpiReadRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 300
Wolfgang Betz 34:edda6a7238ec 301 /* Return if set or reset */
Wolfgang Betz 34:edda6a7238ec 302 if(tempRegValue & PROTOCOL1_CSMA_PERS_ON_MASK)
Wolfgang Betz 34:edda6a7238ec 303 {
Wolfgang Betz 34:edda6a7238ec 304 return S_ENABLE;
Wolfgang Betz 34:edda6a7238ec 305 }
Wolfgang Betz 34:edda6a7238ec 306 else
Wolfgang Betz 34:edda6a7238ec 307 {
Wolfgang Betz 34:edda6a7238ec 308 return S_DISABLE;
Wolfgang Betz 34:edda6a7238ec 309 }
Wolfgang Betz 34:edda6a7238ec 310
Wolfgang Betz 34:edda6a7238ec 311 }
Wolfgang Betz 34:edda6a7238ec 312
Wolfgang Betz 34:edda6a7238ec 313
Wolfgang Betz 34:edda6a7238ec 314 /**
Wolfgang Betz 34:edda6a7238ec 315 * @brief Enables or Disables the seed reload mode (if enabled it reloads the back-off generator seed using the value written in the BU_COUNTER_SEED register).
Wolfgang Betz 34:edda6a7238ec 316 * @param xNewState the state of the seed reload mode.
Wolfgang Betz 34:edda6a7238ec 317 * This parameter can be: S_ENABLE or S_DISABLE.
Wolfgang Betz 34:edda6a7238ec 318 * @retval None.
Wolfgang Betz 34:edda6a7238ec 319 */
Wolfgang Betz 34:edda6a7238ec 320 void SpiritCsmaSeedReloadMode(SpiritFunctionalState xNewState)
Wolfgang Betz 34:edda6a7238ec 321 {
Wolfgang Betz 34:edda6a7238ec 322 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 323
Wolfgang Betz 34:edda6a7238ec 324 /* Check the parameters */
Wolfgang Betz 34:edda6a7238ec 325 s_assert_param(IS_SPIRIT_FUNCTIONAL_STATE(xNewState));
Wolfgang Betz 34:edda6a7238ec 326
Wolfgang Betz 34:edda6a7238ec 327 /* Reads the PROTOCOL1 register value */
Wolfgang Betz 34:edda6a7238ec 328 g_xStatus = SpiritSpiReadRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 329
Wolfgang Betz 34:edda6a7238ec 330 /* Enables/disables the seed reload mode */
Wolfgang Betz 34:edda6a7238ec 331 if(xNewState==S_ENABLE)
Wolfgang Betz 34:edda6a7238ec 332 {
Wolfgang Betz 34:edda6a7238ec 333 tempRegValue |= PROTOCOL1_SEED_RELOAD_MASK;
Wolfgang Betz 34:edda6a7238ec 334 }
Wolfgang Betz 34:edda6a7238ec 335 else
Wolfgang Betz 34:edda6a7238ec 336 {
Wolfgang Betz 34:edda6a7238ec 337 tempRegValue &= ~PROTOCOL1_SEED_RELOAD_MASK;
Wolfgang Betz 34:edda6a7238ec 338 }
Wolfgang Betz 34:edda6a7238ec 339
Wolfgang Betz 34:edda6a7238ec 340 /* Writes the new value on the PROTOCOL1 register */
Wolfgang Betz 34:edda6a7238ec 341 g_xStatus = SpiritSpiWriteRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 342
Wolfgang Betz 34:edda6a7238ec 343 }
Wolfgang Betz 34:edda6a7238ec 344
Wolfgang Betz 34:edda6a7238ec 345
Wolfgang Betz 34:edda6a7238ec 346 /**
Wolfgang Betz 34:edda6a7238ec 347 * @brief Gets the seed reload mode.
Wolfgang Betz 34:edda6a7238ec 348 * @param None.
Wolfgang Betz 34:edda6a7238ec 349 * @retval SpiritFunctionalState: CSMA seed reload mode.
Wolfgang Betz 34:edda6a7238ec 350 */
Wolfgang Betz 34:edda6a7238ec 351 SpiritFunctionalState SpiritCsmaGetSeedReloadMode(void)
Wolfgang Betz 34:edda6a7238ec 352 {
Wolfgang Betz 34:edda6a7238ec 353 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 354
Wolfgang Betz 34:edda6a7238ec 355 /* Reads the PROTOCOL1 register value */
Wolfgang Betz 34:edda6a7238ec 356 g_xStatus = SpiritSpiReadRegisters(PROTOCOL1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 357
Wolfgang Betz 34:edda6a7238ec 358 /* Return if set or reset */
Wolfgang Betz 34:edda6a7238ec 359 if(tempRegValue & PROTOCOL1_SEED_RELOAD_MASK)
Wolfgang Betz 34:edda6a7238ec 360 {
Wolfgang Betz 34:edda6a7238ec 361 return S_ENABLE;
Wolfgang Betz 34:edda6a7238ec 362 }
Wolfgang Betz 34:edda6a7238ec 363 else
Wolfgang Betz 34:edda6a7238ec 364 {
Wolfgang Betz 34:edda6a7238ec 365 return S_DISABLE;
Wolfgang Betz 34:edda6a7238ec 366 }
Wolfgang Betz 34:edda6a7238ec 367 }
Wolfgang Betz 34:edda6a7238ec 368
Wolfgang Betz 34:edda6a7238ec 369
Wolfgang Betz 34:edda6a7238ec 370 /**
Wolfgang Betz 34:edda6a7238ec 371 * @brief Sets the BU counter seed (BU_COUNTER_SEED register). The CSMA back off time is given by the formula: BO = rand(2^NB)*BU.
Wolfgang Betz 34:edda6a7238ec 372 * @param nBuCounterSeed seed of the random number generator used to apply the BBE algorithm.
Wolfgang Betz 34:edda6a7238ec 373 * This parameter is an uint16_t.
Wolfgang Betz 34:edda6a7238ec 374 * @retval None.
Wolfgang Betz 34:edda6a7238ec 375 */
Wolfgang Betz 34:edda6a7238ec 376 void SpiritCsmaSetBuCounterSeed(uint16_t nBuCounterSeed)
Wolfgang Betz 34:edda6a7238ec 377 {
Wolfgang Betz 34:edda6a7238ec 378 uint8_t tempRegValue[2];
Wolfgang Betz 34:edda6a7238ec 379
Wolfgang Betz 34:edda6a7238ec 380 /* Check parameters */
Wolfgang Betz 34:edda6a7238ec 381 s_assert_param(IS_BU_COUNTER_SEED(nBuCounterSeed));
Wolfgang Betz 34:edda6a7238ec 382
Wolfgang Betz 34:edda6a7238ec 383 /* Build value (MSB)*/
Wolfgang Betz 34:edda6a7238ec 384 tempRegValue[0]=(uint8_t)(nBuCounterSeed>>8);
Wolfgang Betz 34:edda6a7238ec 385 /* Build value (LSB) */
Wolfgang Betz 34:edda6a7238ec 386 tempRegValue[1]=(uint8_t)nBuCounterSeed;
Wolfgang Betz 34:edda6a7238ec 387
Wolfgang Betz 34:edda6a7238ec 388 /* Writes the CSMA_CONFIG3 registers */
Wolfgang Betz 34:edda6a7238ec 389 g_xStatus = SpiritSpiWriteRegisters(CSMA_CONFIG3_BASE, 2, tempRegValue);
Wolfgang Betz 34:edda6a7238ec 390
Wolfgang Betz 34:edda6a7238ec 391 }
Wolfgang Betz 34:edda6a7238ec 392
Wolfgang Betz 34:edda6a7238ec 393 /**
Wolfgang Betz 34:edda6a7238ec 394 * @brief Returns the BU counter seed (BU_COUNTER_SEED register).
Wolfgang Betz 34:edda6a7238ec 395 * @param None.
Wolfgang Betz 34:edda6a7238ec 396 * @retval uint16_t Seed of the random number generator used to apply the BBE algorithm.
Wolfgang Betz 34:edda6a7238ec 397 */
Wolfgang Betz 34:edda6a7238ec 398 uint16_t SpiritCsmaGetBuCounterSeed(void)
Wolfgang Betz 34:edda6a7238ec 399 {
Wolfgang Betz 34:edda6a7238ec 400 uint8_t tempRegValue[2];
Wolfgang Betz 34:edda6a7238ec 401
Wolfgang Betz 34:edda6a7238ec 402 /* Reads the CSMA_CONFIGx registers value */
Wolfgang Betz 34:edda6a7238ec 403 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG3_BASE, 2, tempRegValue);
Wolfgang Betz 34:edda6a7238ec 404
Wolfgang Betz 34:edda6a7238ec 405 /* Build the counter seed and return it */
Wolfgang Betz 34:edda6a7238ec 406 return ((uint16_t)tempRegValue[1] + (((uint16_t)tempRegValue[0])<<8));
Wolfgang Betz 34:edda6a7238ec 407
Wolfgang Betz 34:edda6a7238ec 408 }
Wolfgang Betz 34:edda6a7238ec 409
Wolfgang Betz 34:edda6a7238ec 410
Wolfgang Betz 34:edda6a7238ec 411 /**
Wolfgang Betz 34:edda6a7238ec 412 * @brief Sets the BU prescaler. The CSMA back off time is given by the formula: BO = rand(2^NB)*BU.
Wolfgang Betz 34:edda6a7238ec 413 * @param cBuPrescaler used to program the back-off unit BU.
Wolfgang Betz 34:edda6a7238ec 414 * This parameter is an uint8_t.
Wolfgang Betz 34:edda6a7238ec 415 * @retval None.
Wolfgang Betz 34:edda6a7238ec 416 */
Wolfgang Betz 34:edda6a7238ec 417 void SpiritCsmaSetBuPrescaler(uint8_t cBuPrescaler)
Wolfgang Betz 34:edda6a7238ec 418 {
Wolfgang Betz 34:edda6a7238ec 419 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 420
Wolfgang Betz 34:edda6a7238ec 421 /* Check parameters */
Wolfgang Betz 34:edda6a7238ec 422 s_assert_param(IS_BU_PRESCALER(cBuPrescaler));
Wolfgang Betz 34:edda6a7238ec 423
Wolfgang Betz 34:edda6a7238ec 424 /* Reads the CSMA_CONFIG1 register value */
Wolfgang Betz 34:edda6a7238ec 425 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 426
Wolfgang Betz 34:edda6a7238ec 427 /* Build the new value for the BU prescaler */
Wolfgang Betz 34:edda6a7238ec 428 tempRegValue &= 0x03;
Wolfgang Betz 34:edda6a7238ec 429 tempRegValue |= (cBuPrescaler<<2);
Wolfgang Betz 34:edda6a7238ec 430
Wolfgang Betz 34:edda6a7238ec 431 /* Writes the new value on the CSMA_CONFIG1_BASE register */
Wolfgang Betz 34:edda6a7238ec 432 g_xStatus = SpiritSpiWriteRegisters(CSMA_CONFIG1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 433
Wolfgang Betz 34:edda6a7238ec 434 }
Wolfgang Betz 34:edda6a7238ec 435
Wolfgang Betz 34:edda6a7238ec 436
Wolfgang Betz 34:edda6a7238ec 437 /**
Wolfgang Betz 34:edda6a7238ec 438 * @brief Returns the BU prescaler.
Wolfgang Betz 34:edda6a7238ec 439 * @param None.
Wolfgang Betz 34:edda6a7238ec 440 * @retval uint8_t Value back-off unit (BU).
Wolfgang Betz 34:edda6a7238ec 441 */
Wolfgang Betz 34:edda6a7238ec 442 uint8_t SpiritCsmaGetBuPrescaler(void)
Wolfgang Betz 34:edda6a7238ec 443 {
Wolfgang Betz 34:edda6a7238ec 444 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 445
Wolfgang Betz 34:edda6a7238ec 446 /* Reads the CSMA_CONFIG1 register value */
Wolfgang Betz 34:edda6a7238ec 447 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 448
Wolfgang Betz 34:edda6a7238ec 449 /* Build and return the BU prescaler value */
Wolfgang Betz 34:edda6a7238ec 450 return (tempRegValue >> 2);
Wolfgang Betz 34:edda6a7238ec 451
Wolfgang Betz 34:edda6a7238ec 452 }
Wolfgang Betz 34:edda6a7238ec 453
Wolfgang Betz 34:edda6a7238ec 454
Wolfgang Betz 34:edda6a7238ec 455 /**
Wolfgang Betz 34:edda6a7238ec 456 * @brief Sets the CCA period.
Wolfgang Betz 34:edda6a7238ec 457 * @param xMultiplierTbit value of CCA period to store.
Wolfgang Betz 34:edda6a7238ec 458 * This parameter can be a value of @ref CcaPeriod.
Wolfgang Betz 34:edda6a7238ec 459 * @retval None.
Wolfgang Betz 34:edda6a7238ec 460 */
Wolfgang Betz 34:edda6a7238ec 461 void SpiritCsmaSetCcaPeriod(CcaPeriod xMultiplierTbit)
Wolfgang Betz 34:edda6a7238ec 462 {
Wolfgang Betz 34:edda6a7238ec 463 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 464
Wolfgang Betz 34:edda6a7238ec 465 /* Check the parameters */
Wolfgang Betz 34:edda6a7238ec 466 s_assert_param(IS_CCA_PERIOD(xMultiplierTbit));
Wolfgang Betz 34:edda6a7238ec 467
Wolfgang Betz 34:edda6a7238ec 468 /* Reads the CSMA_CONFIG1 register value */
Wolfgang Betz 34:edda6a7238ec 469 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 470
Wolfgang Betz 34:edda6a7238ec 471 /* Build the new value setting the the CCA period */
Wolfgang Betz 34:edda6a7238ec 472 tempRegValue &= 0xFC;
Wolfgang Betz 34:edda6a7238ec 473 tempRegValue |= xMultiplierTbit;
Wolfgang Betz 34:edda6a7238ec 474
Wolfgang Betz 34:edda6a7238ec 475 /* Writes the new value on the CSMA_CONFIG1 register */
Wolfgang Betz 34:edda6a7238ec 476 g_xStatus = SpiritSpiWriteRegisters(CSMA_CONFIG1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 477
Wolfgang Betz 34:edda6a7238ec 478 }
Wolfgang Betz 34:edda6a7238ec 479
Wolfgang Betz 34:edda6a7238ec 480
Wolfgang Betz 34:edda6a7238ec 481 /**
Wolfgang Betz 34:edda6a7238ec 482 * @brief Returns the CCA period.
Wolfgang Betz 34:edda6a7238ec 483 * @param None.
Wolfgang Betz 34:edda6a7238ec 484 * @retval CcaPeriod CCA period.
Wolfgang Betz 34:edda6a7238ec 485 */
Wolfgang Betz 34:edda6a7238ec 486 CcaPeriod SpiritCsmaGetCcaPeriod(void)
Wolfgang Betz 34:edda6a7238ec 487 {
Wolfgang Betz 34:edda6a7238ec 488 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 489
Wolfgang Betz 34:edda6a7238ec 490 /* Reads the CSMA_CONFIG1 register value */
Wolfgang Betz 34:edda6a7238ec 491 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG1_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 492
Wolfgang Betz 34:edda6a7238ec 493 /* Build and return the CCA period value */
Wolfgang Betz 34:edda6a7238ec 494 return (CcaPeriod)(tempRegValue & 0x03);
Wolfgang Betz 34:edda6a7238ec 495
Wolfgang Betz 34:edda6a7238ec 496 }
Wolfgang Betz 34:edda6a7238ec 497
Wolfgang Betz 34:edda6a7238ec 498
Wolfgang Betz 34:edda6a7238ec 499 /**
Wolfgang Betz 34:edda6a7238ec 500 * @brief Sets the CCA length.
Wolfgang Betz 34:edda6a7238ec 501 * @param xCcaLength the CCA length (a value between 1 and 15 that multiplies the CCA period).
Wolfgang Betz 34:edda6a7238ec 502 * This parameter can be any value of @ref CsmaLength.
Wolfgang Betz 34:edda6a7238ec 503 * @retval None.
Wolfgang Betz 34:edda6a7238ec 504 */
Wolfgang Betz 34:edda6a7238ec 505 void SpiritCsmaSetCcaLength(CsmaLength xCcaLength)
Wolfgang Betz 34:edda6a7238ec 506 {
Wolfgang Betz 34:edda6a7238ec 507 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 508
Wolfgang Betz 34:edda6a7238ec 509 /* Check the parameters */
Wolfgang Betz 34:edda6a7238ec 510 s_assert_param(IS_CSMA_LENGTH(xCcaLength));
Wolfgang Betz 34:edda6a7238ec 511
Wolfgang Betz 34:edda6a7238ec 512 /* Reads the CSMA_CONFIG0 register value */
Wolfgang Betz 34:edda6a7238ec 513 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG0_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 514
Wolfgang Betz 34:edda6a7238ec 515 /* Build the value of CCA length to be set */
Wolfgang Betz 34:edda6a7238ec 516 tempRegValue &= 0x0F;
Wolfgang Betz 34:edda6a7238ec 517 tempRegValue |= xCcaLength;
Wolfgang Betz 34:edda6a7238ec 518
Wolfgang Betz 34:edda6a7238ec 519 /* Writes the new value on the CSMA_CONFIG0 register */
Wolfgang Betz 34:edda6a7238ec 520 g_xStatus = SpiritSpiWriteRegisters(CSMA_CONFIG0_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 521
Wolfgang Betz 34:edda6a7238ec 522 }
Wolfgang Betz 34:edda6a7238ec 523
Wolfgang Betz 34:edda6a7238ec 524
Wolfgang Betz 34:edda6a7238ec 525 /**
Wolfgang Betz 34:edda6a7238ec 526 * @brief Returns the CCA length.
Wolfgang Betz 34:edda6a7238ec 527 * @param None.
Wolfgang Betz 34:edda6a7238ec 528 * @retval uint8_t CCA length.
Wolfgang Betz 34:edda6a7238ec 529 */
Wolfgang Betz 34:edda6a7238ec 530 uint8_t SpiritCsmaGetCcaLength(void)
Wolfgang Betz 34:edda6a7238ec 531 {
Wolfgang Betz 34:edda6a7238ec 532 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 533
Wolfgang Betz 34:edda6a7238ec 534 /* Reads the CSMA_CONFIG0 register value */
Wolfgang Betz 34:edda6a7238ec 535 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG0_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 536
Wolfgang Betz 34:edda6a7238ec 537 /* Build and return the CCA length */
Wolfgang Betz 34:edda6a7238ec 538 return tempRegValue >> 4;
Wolfgang Betz 34:edda6a7238ec 539
Wolfgang Betz 34:edda6a7238ec 540 }
Wolfgang Betz 34:edda6a7238ec 541
Wolfgang Betz 34:edda6a7238ec 542
Wolfgang Betz 34:edda6a7238ec 543 /**
Wolfgang Betz 34:edda6a7238ec 544 * @brief Sets the max number of back-off. If reached Spirit stops the transmission.
Wolfgang Betz 34:edda6a7238ec 545 * @param cMaxNb the max number of back-off.
Wolfgang Betz 34:edda6a7238ec 546 * This parameter is an uint8_t.
Wolfgang Betz 34:edda6a7238ec 547 * @retval None.
Wolfgang Betz 34:edda6a7238ec 548 */
Wolfgang Betz 34:edda6a7238ec 549 void SpiritCsmaSetMaxNumberBackoff(uint8_t cMaxNb)
Wolfgang Betz 34:edda6a7238ec 550 {
Wolfgang Betz 34:edda6a7238ec 551 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 552
Wolfgang Betz 34:edda6a7238ec 553 /* Check the parameters */
Wolfgang Betz 34:edda6a7238ec 554 s_assert_param(IS_CMAX_NB(cMaxNb));
Wolfgang Betz 34:edda6a7238ec 555
Wolfgang Betz 34:edda6a7238ec 556 /* Reads the CSMA_CONFIG0 register value */
Wolfgang Betz 34:edda6a7238ec 557 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG0_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 558
Wolfgang Betz 34:edda6a7238ec 559 /* Build the value of max back off to be set */
Wolfgang Betz 34:edda6a7238ec 560 tempRegValue &= 0xF8;
Wolfgang Betz 34:edda6a7238ec 561 tempRegValue |= cMaxNb;
Wolfgang Betz 34:edda6a7238ec 562
Wolfgang Betz 34:edda6a7238ec 563 /* Writes the new value on the CSMA_CONFIG0 register */
Wolfgang Betz 34:edda6a7238ec 564 g_xStatus = SpiritSpiWriteRegisters(CSMA_CONFIG0_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 565 }
Wolfgang Betz 34:edda6a7238ec 566
Wolfgang Betz 34:edda6a7238ec 567 /**
Wolfgang Betz 34:edda6a7238ec 568 * @brief Returns the max number of back-off.
Wolfgang Betz 34:edda6a7238ec 569 * @param None.
Wolfgang Betz 34:edda6a7238ec 570 * @retval uint8_t Max number of back-off.
Wolfgang Betz 34:edda6a7238ec 571 */
Wolfgang Betz 34:edda6a7238ec 572 uint8_t SpiritCsmaGetMaxNumberBackoff(void)
Wolfgang Betz 34:edda6a7238ec 573 {
Wolfgang Betz 34:edda6a7238ec 574 uint8_t tempRegValue;
Wolfgang Betz 34:edda6a7238ec 575
Wolfgang Betz 34:edda6a7238ec 576 /* Reads the CSMA_CONFIG0 register value */
Wolfgang Betz 34:edda6a7238ec 577 g_xStatus = SpiritSpiReadRegisters(CSMA_CONFIG0_BASE, 1, &tempRegValue);
Wolfgang Betz 34:edda6a7238ec 578
Wolfgang Betz 34:edda6a7238ec 579 /* Build and return the max number of back-off */
Wolfgang Betz 34:edda6a7238ec 580 return (tempRegValue & 0x07);
Wolfgang Betz 34:edda6a7238ec 581
Wolfgang Betz 34:edda6a7238ec 582 }
Wolfgang Betz 34:edda6a7238ec 583
Wolfgang Betz 34:edda6a7238ec 584
Wolfgang Betz 34:edda6a7238ec 585 /**
Wolfgang Betz 34:edda6a7238ec 586 *@}
Wolfgang Betz 34:edda6a7238ec 587 */
Wolfgang Betz 34:edda6a7238ec 588
Wolfgang Betz 34:edda6a7238ec 589 /**
Wolfgang Betz 34:edda6a7238ec 590 *@}
Wolfgang Betz 34:edda6a7238ec 591 */
Wolfgang Betz 34:edda6a7238ec 592
Wolfgang Betz 34:edda6a7238ec 593
Wolfgang Betz 34:edda6a7238ec 594 /**
Wolfgang Betz 34:edda6a7238ec 595 *@}
Wolfgang Betz 34:edda6a7238ec 596 */
Wolfgang Betz 34:edda6a7238ec 597
Wolfgang Betz 34:edda6a7238ec 598
Wolfgang Betz 34:edda6a7238ec 599
Wolfgang Betz 34:edda6a7238ec 600 /******************* (C) COPYRIGHT 2015 STMicroelectronics *****END OF FILE****/