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).
libs/spirit1/SPIRIT1_Library/Inc/SPIRIT_Qi.h@0:4fb29d9ee571, 2016-10-13 (annotated)
- Committer:
- Wolfgang Betz
- Date:
- Thu Oct 13 15:41:39 2016 +0200
- Revision:
- 0:4fb29d9ee571
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_Qi.h |
| 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 QI. |
| Wolfgang Betz |
0:4fb29d9ee571 | 8 | * @details |
| Wolfgang Betz |
0:4fb29d9ee571 | 9 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 10 | * This module can be used to configure and read some quality indicators |
| Wolfgang Betz |
0:4fb29d9ee571 | 11 | * used by Spirit. |
| Wolfgang Betz |
0:4fb29d9ee571 | 12 | * API to set thresholds and to read values in raw mode or in dBm are |
| Wolfgang Betz |
0:4fb29d9ee571 | 13 | * provided. |
| Wolfgang Betz |
0:4fb29d9ee571 | 14 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 15 | * <b>Example:</b> |
| Wolfgang Betz |
0:4fb29d9ee571 | 16 | * @code |
| Wolfgang Betz |
0:4fb29d9ee571 | 17 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 18 | * float rssiValuedBm; |
| Wolfgang Betz |
0:4fb29d9ee571 | 19 | * uint8_t pqiValue, sqiValue; |
| Wolfgang Betz |
0:4fb29d9ee571 | 20 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 21 | * SpiritQiPqiCheck(S_ENABLE); |
| Wolfgang Betz |
0:4fb29d9ee571 | 22 | * SpiritQiSqiCheck(S_ENABLE); |
| Wolfgang Betz |
0:4fb29d9ee571 | 23 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 24 | * ... |
| Wolfgang Betz |
0:4fb29d9ee571 | 25 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 26 | * rssiValueDbm = SpiritQiGetRssidBm(); |
| Wolfgang Betz |
0:4fb29d9ee571 | 27 | * pqiValue = SpiritQiGetPqi(); |
| Wolfgang Betz |
0:4fb29d9ee571 | 28 | * sqiValue = SpiritQiGetSqi(); |
| Wolfgang Betz |
0:4fb29d9ee571 | 29 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 30 | * ... |
| Wolfgang Betz |
0:4fb29d9ee571 | 31 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 32 | * @endcode |
| Wolfgang Betz |
0:4fb29d9ee571 | 33 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 34 | * @attention |
| Wolfgang Betz |
0:4fb29d9ee571 | 35 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 36 | * <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2> |
| Wolfgang Betz |
0:4fb29d9ee571 | 37 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 38 | * Redistribution and use in source and binary forms, with or without modification, |
| Wolfgang Betz |
0:4fb29d9ee571 | 39 | * are permitted provided that the following conditions are met: |
| Wolfgang Betz |
0:4fb29d9ee571 | 40 | * 1. Redistributions of source code must retain the above copyright notice, |
| Wolfgang Betz |
0:4fb29d9ee571 | 41 | * this list of conditions and the following disclaimer. |
| Wolfgang Betz |
0:4fb29d9ee571 | 42 | * 2. Redistributions in binary form must reproduce the above copyright notice, |
| Wolfgang Betz |
0:4fb29d9ee571 | 43 | * this list of conditions and the following disclaimer in the documentation |
| Wolfgang Betz |
0:4fb29d9ee571 | 44 | * and/or other materials provided with the distribution. |
| Wolfgang Betz |
0:4fb29d9ee571 | 45 | * 3. Neither the name of STMicroelectronics nor the names of its contributors |
| Wolfgang Betz |
0:4fb29d9ee571 | 46 | * may be used to endorse or promote products derived from this software |
| Wolfgang Betz |
0:4fb29d9ee571 | 47 | * without specific prior written permission. |
| Wolfgang Betz |
0:4fb29d9ee571 | 48 | * |
| Wolfgang Betz |
0:4fb29d9ee571 | 49 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
| Wolfgang Betz |
0:4fb29d9ee571 | 50 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| Wolfgang Betz |
0:4fb29d9ee571 | 51 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
| Wolfgang Betz |
0:4fb29d9ee571 | 52 | * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE |
| Wolfgang Betz |
0:4fb29d9ee571 | 53 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
| Wolfgang Betz |
0:4fb29d9ee571 | 54 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
| Wolfgang Betz |
0:4fb29d9ee571 | 55 | * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
| Wolfgang Betz |
0:4fb29d9ee571 | 56 | * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| Wolfgang Betz |
0:4fb29d9ee571 | 57 | * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| Wolfgang Betz |
0:4fb29d9ee571 | 58 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 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 | /* Define to prevent recursive inclusion -------------------------------------*/ |
| Wolfgang Betz |
0:4fb29d9ee571 | 64 | #ifndef __SPIRIT_QI_H |
| Wolfgang Betz |
0:4fb29d9ee571 | 65 | #define __SPIRIT_QI_H |
| Wolfgang Betz |
0:4fb29d9ee571 | 66 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 67 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 68 | /* Includes ------------------------------------------------------------------*/ |
| Wolfgang Betz |
0:4fb29d9ee571 | 69 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 70 | #include "SPIRIT_Regs.h" |
| Wolfgang Betz |
0:4fb29d9ee571 | 71 | #include "SPIRIT_Types.h" |
| Wolfgang Betz |
0:4fb29d9ee571 | 72 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 73 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 74 | #ifdef __cplusplus |
| Wolfgang Betz |
0:4fb29d9ee571 | 75 | extern "C" { |
| Wolfgang Betz |
0:4fb29d9ee571 | 76 | #endif |
| Wolfgang Betz |
0:4fb29d9ee571 | 77 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 78 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 79 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 80 | * @addtogroup SPIRIT_Libraries |
| 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 | * @defgroup SPIRIT_Qi QI |
| Wolfgang Betz |
0:4fb29d9ee571 | 87 | * @brief Configuration and management of SPIRIT QI. |
| Wolfgang Betz |
0:4fb29d9ee571 | 88 | * @details See the file <i>@ref SPIRIT_Qi.h</i> for more details. |
| 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 | * @defgroup Qi_Exported_Types QI Exported Types |
| 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 | * @brief PQI threshold value enumeration. |
| Wolfgang Betz |
0:4fb29d9ee571 | 100 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 101 | typedef enum |
| Wolfgang Betz |
0:4fb29d9ee571 | 102 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 103 | PQI_TH_0=0x00, |
| Wolfgang Betz |
0:4fb29d9ee571 | 104 | PQI_TH_1=0x04, |
| Wolfgang Betz |
0:4fb29d9ee571 | 105 | PQI_TH_2=0x08, |
| Wolfgang Betz |
0:4fb29d9ee571 | 106 | PQI_TH_3=0x0C, |
| Wolfgang Betz |
0:4fb29d9ee571 | 107 | PQI_TH_4=0x10, |
| Wolfgang Betz |
0:4fb29d9ee571 | 108 | PQI_TH_5=0x14, |
| Wolfgang Betz |
0:4fb29d9ee571 | 109 | PQI_TH_6=0x18, |
| Wolfgang Betz |
0:4fb29d9ee571 | 110 | PQI_TH_7=0x1C, |
| Wolfgang Betz |
0:4fb29d9ee571 | 111 | PQI_TH_8=0x20, |
| Wolfgang Betz |
0:4fb29d9ee571 | 112 | PQI_TH_9=0x24, |
| Wolfgang Betz |
0:4fb29d9ee571 | 113 | PQI_TH_10=0x28, |
| Wolfgang Betz |
0:4fb29d9ee571 | 114 | PQI_TH_11=0x2C, |
| Wolfgang Betz |
0:4fb29d9ee571 | 115 | PQI_TH_12=0x30, |
| Wolfgang Betz |
0:4fb29d9ee571 | 116 | PQI_TH_13=0x34, |
| Wolfgang Betz |
0:4fb29d9ee571 | 117 | PQI_TH_14=0x38, |
| Wolfgang Betz |
0:4fb29d9ee571 | 118 | PQI_TH_15=0x3C |
| Wolfgang Betz |
0:4fb29d9ee571 | 119 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 120 | } PqiThreshold; |
| Wolfgang Betz |
0:4fb29d9ee571 | 121 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 122 | #define IS_PQI_THR(VALUE) (VALUE==PQI_TH_0 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 123 | VALUE==PQI_TH_1 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 124 | VALUE==PQI_TH_2 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 125 | VALUE==PQI_TH_3 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 126 | VALUE==PQI_TH_4 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 127 | VALUE==PQI_TH_5 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 128 | VALUE==PQI_TH_6 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 129 | VALUE==PQI_TH_7 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 130 | VALUE==PQI_TH_8 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 131 | VALUE==PQI_TH_9 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 132 | VALUE==PQI_TH_10 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 133 | VALUE==PQI_TH_11 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 134 | VALUE==PQI_TH_12 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 135 | VALUE==PQI_TH_13 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 136 | VALUE==PQI_TH_14 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 137 | VALUE==PQI_TH_15) |
| Wolfgang Betz |
0:4fb29d9ee571 | 138 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 139 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 140 | * @brief SQI threshold value enumeration. |
| Wolfgang Betz |
0:4fb29d9ee571 | 141 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 142 | typedef enum |
| Wolfgang Betz |
0:4fb29d9ee571 | 143 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 144 | SQI_TH_0=0x00, |
| Wolfgang Betz |
0:4fb29d9ee571 | 145 | SQI_TH_1=0x40, |
| Wolfgang Betz |
0:4fb29d9ee571 | 146 | SQI_TH_2=0x80, |
| Wolfgang Betz |
0:4fb29d9ee571 | 147 | SQI_TH_3=0xC0 |
| Wolfgang Betz |
0:4fb29d9ee571 | 148 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 149 | } SqiThreshold; |
| Wolfgang Betz |
0:4fb29d9ee571 | 150 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 151 | #define IS_SQI_THR(VALUE) (VALUE==SQI_TH_0 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 152 | VALUE==SQI_TH_1 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 153 | VALUE==SQI_TH_2 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 154 | VALUE==SQI_TH_3) |
| Wolfgang Betz |
0:4fb29d9ee571 | 155 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 156 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 157 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 158 | * @brief RSSI filter gain value enumeration. |
| Wolfgang Betz |
0:4fb29d9ee571 | 159 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 160 | typedef enum |
| Wolfgang Betz |
0:4fb29d9ee571 | 161 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 162 | RSSI_FG_0=0x00, |
| Wolfgang Betz |
0:4fb29d9ee571 | 163 | RSSI_FG_1=0x10, |
| Wolfgang Betz |
0:4fb29d9ee571 | 164 | RSSI_FG_2=0x20, |
| Wolfgang Betz |
0:4fb29d9ee571 | 165 | RSSI_FG_3=0x30, |
| Wolfgang Betz |
0:4fb29d9ee571 | 166 | RSSI_FG_4=0x40, |
| Wolfgang Betz |
0:4fb29d9ee571 | 167 | RSSI_FG_5=0x50, |
| Wolfgang Betz |
0:4fb29d9ee571 | 168 | RSSI_FG_6=0x60, |
| Wolfgang Betz |
0:4fb29d9ee571 | 169 | RSSI_FG_7=0x70, |
| Wolfgang Betz |
0:4fb29d9ee571 | 170 | RSSI_FG_8=0x80, |
| Wolfgang Betz |
0:4fb29d9ee571 | 171 | RSSI_FG_9=0x90, |
| Wolfgang Betz |
0:4fb29d9ee571 | 172 | RSSI_FG_10=0xA0, |
| Wolfgang Betz |
0:4fb29d9ee571 | 173 | RSSI_FG_11=0xB0, |
| Wolfgang Betz |
0:4fb29d9ee571 | 174 | RSSI_FG_12=0xC0, |
| Wolfgang Betz |
0:4fb29d9ee571 | 175 | RSSI_FG_13=0xD0, |
| Wolfgang Betz |
0:4fb29d9ee571 | 176 | RSSI_FG_14=0xE0, /*<! recommended value */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 177 | RSSI_FG_15=0xF0 |
| Wolfgang Betz |
0:4fb29d9ee571 | 178 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 179 | } RssiFilterGain; |
| Wolfgang Betz |
0:4fb29d9ee571 | 180 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 181 | #define IS_RSSI_FILTER_GAIN(VALUE) (VALUE==RSSI_FG_0 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 182 | VALUE==RSSI_FG_1 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 183 | VALUE==RSSI_FG_2 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 184 | VALUE==RSSI_FG_3 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 185 | VALUE==RSSI_FG_4 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 186 | VALUE==RSSI_FG_5 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 187 | VALUE==RSSI_FG_6 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 188 | VALUE==RSSI_FG_7 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 189 | VALUE==RSSI_FG_8 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 190 | VALUE==RSSI_FG_9 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 191 | VALUE==RSSI_FG_10 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 192 | VALUE==RSSI_FG_11 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 193 | VALUE==RSSI_FG_12 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 194 | VALUE==RSSI_FG_13 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 195 | VALUE==RSSI_FG_14 ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 196 | VALUE==RSSI_FG_15) |
| Wolfgang Betz |
0:4fb29d9ee571 | 197 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 198 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 199 | * @brief CS mode enumeration. |
| Wolfgang Betz |
0:4fb29d9ee571 | 200 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 201 | typedef enum |
| Wolfgang Betz |
0:4fb29d9ee571 | 202 | { |
| Wolfgang Betz |
0:4fb29d9ee571 | 203 | CS_MODE_STATIC_3DB=0x00, |
| Wolfgang Betz |
0:4fb29d9ee571 | 204 | CS_MODE_DYNAMIC_6DB=0x04, |
| Wolfgang Betz |
0:4fb29d9ee571 | 205 | CS_MODE_DYNAMIC_12DB=0x08, |
| Wolfgang Betz |
0:4fb29d9ee571 | 206 | CS_MODE_DYNAMIC_18DB=0x0C |
| Wolfgang Betz |
0:4fb29d9ee571 | 207 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 208 | } CSMode; |
| Wolfgang Betz |
0:4fb29d9ee571 | 209 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 210 | #define IS_CS_MODE(MODE) (MODE==CS_MODE_STATIC_3DB ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 211 | MODE==CS_MODE_DYNAMIC_6DB ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 212 | MODE==CS_MODE_DYNAMIC_12DB ||\ |
| Wolfgang Betz |
0:4fb29d9ee571 | 213 | MODE==CS_MODE_DYNAMIC_18DB) |
| Wolfgang Betz |
0:4fb29d9ee571 | 214 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 215 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 216 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 217 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 218 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 219 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 220 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 221 | * @defgroup Qi_Exported_Constants QI Exported Constants |
| Wolfgang Betz |
0:4fb29d9ee571 | 222 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 223 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 224 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 225 | /* range for the RSSI Threshold in dBm */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 226 | #define IS_RSSI_THR_DBM(VALUE) (VALUE>=-130 && VALUE<=-2) |
| Wolfgang Betz |
0:4fb29d9ee571 | 227 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 228 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 229 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 230 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 231 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 232 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 233 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 234 | * @defgroup Qi_Exported_Macros QI Exported Macros |
| Wolfgang Betz |
0:4fb29d9ee571 | 235 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 236 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 237 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 238 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 239 | * @brief Macro to obtain the RSSI value in dBm |
| Wolfgang Betz |
0:4fb29d9ee571 | 240 | * @param None. |
| Wolfgang Betz |
0:4fb29d9ee571 | 241 | * @retval RSSI in dBm. |
| Wolfgang Betz |
0:4fb29d9ee571 | 242 | * This parameter is a float. |
| Wolfgang Betz |
0:4fb29d9ee571 | 243 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 244 | #define SpiritQiGetRssidBm() (-120.0+((float)(SpiritQiGetRssi()-20))/2) |
| 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 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 251 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 252 | * @defgroup Qi_Exported_Functions QI Exported Functions |
| Wolfgang Betz |
0:4fb29d9ee571 | 253 | * @{ |
| Wolfgang Betz |
0:4fb29d9ee571 | 254 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 255 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 256 | void SpiritQiPqiCheck(SpiritFunctionalState xNewState); |
| Wolfgang Betz |
0:4fb29d9ee571 | 257 | void SpiritQiSqiCheck(SpiritFunctionalState xNewState); |
| Wolfgang Betz |
0:4fb29d9ee571 | 258 | void SpiritQiSetPqiThreshold(PqiThreshold xPqiThr); |
| Wolfgang Betz |
0:4fb29d9ee571 | 259 | PqiThreshold SpiritQiGetPqiThreshold(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 260 | void SpiritQiSetSqiThreshold(SqiThreshold xSqiThr); |
| Wolfgang Betz |
0:4fb29d9ee571 | 261 | SqiThreshold SpiritQiGetSqiThreshold(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 262 | void SpiritQiSetRssiThreshold(uint8_t cRssiThr); |
| Wolfgang Betz |
0:4fb29d9ee571 | 263 | uint8_t SpiritQiGetRssiThreshold(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 264 | uint8_t SpiritQiComputeRssiThreshold(int cDbmValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 265 | void SpiritQiSetRssiThresholddBm(int nDbmValue); |
| Wolfgang Betz |
0:4fb29d9ee571 | 266 | uint8_t SpiritQiGetPqi(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 267 | uint8_t SpiritQiGetSqi(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 268 | uint8_t SpiritQiGetLqi(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 269 | SpiritFlagStatus SpiritQiGetCs(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 270 | uint8_t SpiritQiGetRssi(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 271 | void SpiritQiSetRssiFilterGain(RssiFilterGain xRssiFg); |
| Wolfgang Betz |
0:4fb29d9ee571 | 272 | RssiFilterGain SpiritQiGetRssiFilterGain(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 273 | void SpiritQiSetCsMode(CSMode xCsMode); |
| Wolfgang Betz |
0:4fb29d9ee571 | 274 | CSMode SpiritQiGetCsMode(void); |
| Wolfgang Betz |
0:4fb29d9ee571 | 275 | void SpiritQiCsTimeoutMask(SpiritFunctionalState xNewState); |
| Wolfgang Betz |
0:4fb29d9ee571 | 276 | void SpiritQiPqiTimeoutMask(SpiritFunctionalState xNewState); |
| Wolfgang Betz |
0:4fb29d9ee571 | 277 | void SpiritQiSqiTimeoutMask(SpiritFunctionalState xNewState); |
| 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 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 284 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 285 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 286 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 287 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 288 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 289 | /** |
| Wolfgang Betz |
0:4fb29d9ee571 | 290 | *@} |
| Wolfgang Betz |
0:4fb29d9ee571 | 291 | */ |
| Wolfgang Betz |
0:4fb29d9ee571 | 292 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 293 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 294 | #ifdef __cplusplus |
| Wolfgang Betz |
0:4fb29d9ee571 | 295 | } |
| Wolfgang Betz |
0:4fb29d9ee571 | 296 | #endif |
| Wolfgang Betz |
0:4fb29d9ee571 | 297 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 298 | #endif |
| Wolfgang Betz |
0:4fb29d9ee571 | 299 | |
| Wolfgang Betz |
0:4fb29d9ee571 | 300 | /******************* (C) COPYRIGHT 2015 STMicroelectronics *****END OF FILE****/ |
X-NUCLEO-IDS01A4 Sub-1GHz RF Expansion Board