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).
source/libs/spirit1/SPIRIT1_Library/Src/SPIRIT_DirectRF.c
- Committer:
- Wolfgang Betz
- Date:
- 2016-11-22
- Revision:
- 34:edda6a7238ec
- Child:
- 67:93bec0baf1de
File content as of revision 34:edda6a7238ec:
/** ****************************************************************************** * @file SPIRIT_DirectRF.c * @author VMA division - AMS * @version 3.2.2 * @date 08-July-2015 * @brief Configuration and management of SPIRIT direct transmission / receive modes. * @details * @attention * * <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2> * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * 1. Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * 3. Neither the name of STMicroelectronics nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************** */ /* Includes ------------------------------------------------------------------*/ #include "SPIRIT_DirectRF.h" #include "MCU_Interface.h" /** * @addtogroup SPIRIT_Libraries * @{ */ /** * @addtogroup SPIRIT_DirectRf * @{ */ /** * @defgroup DirectRf_Private_TypesDefinitions Direct RF Private Types Definitions * @{ */ /** *@} */ /** * @defgroup DirectRf_Private_Defines Direct RF Private Defines * @{ */ /** *@} */ /** * @defgroup DirectRf_Private_Macros Direct RF Private Macros * @{ */ /** *@} */ /** * @defgroup DirectRf_Private_Variables Direct RF Private Variables * @{ */ /** *@} */ /** * @defgroup DirectRf_Private_FunctionPrototypes Direct RF Private Function Prototypes * @{ */ /** *@} */ /** * @defgroup DirectRf_Private_Functions Direct RF Private Functions * @{ */ /** * @brief Sets the DirectRF RX mode of SPIRIT. * @param xDirectRx code of the desired mode. * This parameter can be any value of @ref DirectRx. * @retval None. */ void SpiritDirectRfSetRxMode(DirectRx xDirectRx) { uint8_t tempRegValue; /* Check the parameters */ s_assert_param(IS_DIRECT_RX(xDirectRx)); /* Reads the register value */ SpiritSpiReadRegisters(PCKTCTRL3_BASE, 1, &tempRegValue); /* Build the value to be stored */ tempRegValue &= ~PCKTCTRL3_RX_MODE_MASK; tempRegValue |= (uint8_t)xDirectRx; /* Writes value on register */ g_xStatus = SpiritSpiWriteRegisters(PCKTCTRL3_BASE, 1, &tempRegValue); } /** * @brief Returns the DirectRF RX mode of SPIRIT. * @param None. * @retval DirectRx Direct Rx mode. */ DirectRx SpiritDirectRfGetRxMode(void) { uint8_t tempRegValue; /* Reads the register value and mask the RX_Mode field */ g_xStatus = SpiritSpiReadRegisters(PCKTCTRL3_BASE, 1, &tempRegValue); /* Rebuild and return value */ return (DirectRx)(tempRegValue & 0x30); } /** * @brief Sets the TX mode of SPIRIT. * @param xDirectTx code of the desired source. * This parameter can be any value of @ref DirectTx. * @retval None. */ void SpiritDirectRfSetTxMode(DirectTx xDirectTx) { uint8_t tempRegValue; /* Check the parameters */ s_assert_param(IS_DIRECT_TX(xDirectTx)); /* Reads the register value */ SpiritSpiReadRegisters(PCKTCTRL1_BASE, 1, &tempRegValue); /* Build the value to be stored */ tempRegValue &= ~PCKTCTRL1_TX_SOURCE_MASK; tempRegValue |= (uint8_t)xDirectTx; /* Writes value on register */ g_xStatus = SpiritSpiWriteRegisters(PCKTCTRL1_BASE, 1, &tempRegValue); } /** * @brief Returns the DirectRF TX mode of SPIRIT. * @param None. * @retval DirectTx Direct Tx mode. */ DirectTx SpiritDirectRfGetTxMode(void) { uint8_t tempRegValue; /* Reads the register value and mask the RX_Mode field */ g_xStatus = SpiritSpiReadRegisters(PCKTCTRL1_BASE, 1, &tempRegValue); /* Returns value */ return (DirectTx)(tempRegValue & 0x0C); } /** *@} */ /** *@} */ /** *@} */ /******************* (C) COPYRIGHT 2015 STMicroelectronics *****END OF FILE****/