Vergil Cola / Mbed OS MQTTGatewayK64

Fork of my MQTTGateway

Dependencies:   mbed-http

easy-connect/stm-spirit1-rf-driver/source/libs/spirit1/SPIRIT1_Library/Inc/SPIRIT_General.h@0:f1d3878b8dd9, 2017-04-08 (annotated)

Committer:
vpcola
Date:
Sat Apr 08 14:45:51 2017 +0000
Revision:
0:f1d3878b8dd9
Initial commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
vpcola 0:f1d3878b8dd9 1 /**
vpcola 0:f1d3878b8dd9 2 ******************************************************************************
vpcola 0:f1d3878b8dd9 3 * @file SPIRIT_General.h
vpcola 0:f1d3878b8dd9 4 * @author VMA division - AMS
vpcola 0:f1d3878b8dd9 5 * @version 3.2.2
vpcola 0:f1d3878b8dd9 6 * @date 08-July-2015
vpcola 0:f1d3878b8dd9 7 * @brief Configuration and management of SPIRIT General functionalities.
vpcola 0:f1d3878b8dd9 8 * @details
vpcola 0:f1d3878b8dd9 9 *
vpcola 0:f1d3878b8dd9 10 * @attention
vpcola 0:f1d3878b8dd9 11 *
vpcola 0:f1d3878b8dd9 12 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
vpcola 0:f1d3878b8dd9 13 *
vpcola 0:f1d3878b8dd9 14 * Redistribution and use in source and binary forms, with or without modification,
vpcola 0:f1d3878b8dd9 15 * are permitted provided that the following conditions are met:
vpcola 0:f1d3878b8dd9 16 * 1. Redistributions of source code must retain the above copyright notice,
vpcola 0:f1d3878b8dd9 17 * this list of conditions and the following disclaimer.
vpcola 0:f1d3878b8dd9 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
vpcola 0:f1d3878b8dd9 19 * this list of conditions and the following disclaimer in the documentation
vpcola 0:f1d3878b8dd9 20 * and/or other materials provided with the distribution.
vpcola 0:f1d3878b8dd9 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
vpcola 0:f1d3878b8dd9 22 * may be used to endorse or promote products derived from this software
vpcola 0:f1d3878b8dd9 23 * without specific prior written permission.
vpcola 0:f1d3878b8dd9 24 *
vpcola 0:f1d3878b8dd9 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
vpcola 0:f1d3878b8dd9 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
vpcola 0:f1d3878b8dd9 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
vpcola 0:f1d3878b8dd9 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
vpcola 0:f1d3878b8dd9 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
vpcola 0:f1d3878b8dd9 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
vpcola 0:f1d3878b8dd9 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
vpcola 0:f1d3878b8dd9 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
vpcola 0:f1d3878b8dd9 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
vpcola 0:f1d3878b8dd9 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
vpcola 0:f1d3878b8dd9 35 *
vpcola 0:f1d3878b8dd9 36 ******************************************************************************
vpcola 0:f1d3878b8dd9 37 */
vpcola 0:f1d3878b8dd9 38
vpcola 0:f1d3878b8dd9 39 /* Define to prevent recursive inclusion -------------------------------------*/
vpcola 0:f1d3878b8dd9 40 #ifndef __SPIRIT_GENERAL_H
vpcola 0:f1d3878b8dd9 41 #define __SPIRIT_GENERAL_H
vpcola 0:f1d3878b8dd9 42
vpcola 0:f1d3878b8dd9 43
vpcola 0:f1d3878b8dd9 44 /* Includes ------------------------------------------------------------------*/
vpcola 0:f1d3878b8dd9 45
vpcola 0:f1d3878b8dd9 46 #include "SPIRIT_Regs.h"
vpcola 0:f1d3878b8dd9 47 #include "SPIRIT_Types.h"
vpcola 0:f1d3878b8dd9 48
vpcola 0:f1d3878b8dd9 49
vpcola 0:f1d3878b8dd9 50 #ifdef __cplusplus
vpcola 0:f1d3878b8dd9 51 extern "C" {
vpcola 0:f1d3878b8dd9 52 #endif
vpcola 0:f1d3878b8dd9 53
vpcola 0:f1d3878b8dd9 54 /**
vpcola 0:f1d3878b8dd9 55 * @addtogroup SPIRIT_Libraries
vpcola 0:f1d3878b8dd9 56 * @{
vpcola 0:f1d3878b8dd9 57 */
vpcola 0:f1d3878b8dd9 58
vpcola 0:f1d3878b8dd9 59
vpcola 0:f1d3878b8dd9 60 /**
vpcola 0:f1d3878b8dd9 61 * @defgroup SPIRIT_General General
vpcola 0:f1d3878b8dd9 62 * @brief Configuration and management of SPIRIT General functionalities.
vpcola 0:f1d3878b8dd9 63 * @details See the file <i>@ref SPIRIT_General.h</i> for more details.
vpcola 0:f1d3878b8dd9 64 * @{
vpcola 0:f1d3878b8dd9 65 */
vpcola 0:f1d3878b8dd9 66
vpcola 0:f1d3878b8dd9 67 /**
vpcola 0:f1d3878b8dd9 68 * @defgroup General_Exported_Types General Exported Types
vpcola 0:f1d3878b8dd9 69 * @{
vpcola 0:f1d3878b8dd9 70 */
vpcola 0:f1d3878b8dd9 71
vpcola 0:f1d3878b8dd9 72
vpcola 0:f1d3878b8dd9 73 /**
vpcola 0:f1d3878b8dd9 74 * @brief SPIRIT ModeExtRef enumeration
vpcola 0:f1d3878b8dd9 75 */
vpcola 0:f1d3878b8dd9 76
vpcola 0:f1d3878b8dd9 77 typedef enum
vpcola 0:f1d3878b8dd9 78 {
vpcola 0:f1d3878b8dd9 79 MODE_EXT_XO = 0,
vpcola 0:f1d3878b8dd9 80 MODE_EXT_XIN = !MODE_EXT_XO
vpcola 0:f1d3878b8dd9 81 } ModeExtRef;
vpcola 0:f1d3878b8dd9 82
vpcola 0:f1d3878b8dd9 83 #define IS_MODE_EXT(MODE) (MODE == MODE_EXT_XO || \
vpcola 0:f1d3878b8dd9 84 MODE == MODE_EXT_XIN)
vpcola 0:f1d3878b8dd9 85
vpcola 0:f1d3878b8dd9 86
vpcola 0:f1d3878b8dd9 87 /**
vpcola 0:f1d3878b8dd9 88 * @brief SPIRIT BatteryLevel enumeration
vpcola 0:f1d3878b8dd9 89 */
vpcola 0:f1d3878b8dd9 90
vpcola 0:f1d3878b8dd9 91 typedef enum
vpcola 0:f1d3878b8dd9 92 {
vpcola 0:f1d3878b8dd9 93 BLD_LVL_2_7_V = 0,
vpcola 0:f1d3878b8dd9 94 BLD_LVL_2_5_V = 1,
vpcola 0:f1d3878b8dd9 95 BLD_LVL_2_3_V = 2,
vpcola 0:f1d3878b8dd9 96 BLD_LVL_2_1_V = 3
vpcola 0:f1d3878b8dd9 97 } BatteryLevel;
vpcola 0:f1d3878b8dd9 98
vpcola 0:f1d3878b8dd9 99 #define IS_BLD_LVL(MODE) (MODE == BLD_LVL_2_7_V || \
vpcola 0:f1d3878b8dd9 100 MODE == BLD_LVL_2_5_V || \
vpcola 0:f1d3878b8dd9 101 MODE == BLD_LVL_2_3_V || \
vpcola 0:f1d3878b8dd9 102 MODE == BLD_LVL_2_1_V)
vpcola 0:f1d3878b8dd9 103
vpcola 0:f1d3878b8dd9 104
vpcola 0:f1d3878b8dd9 105 /**
vpcola 0:f1d3878b8dd9 106 * @brief SPIRIT GmConf enumeration
vpcola 0:f1d3878b8dd9 107 */
vpcola 0:f1d3878b8dd9 108
vpcola 0:f1d3878b8dd9 109 typedef enum
vpcola 0:f1d3878b8dd9 110 {
vpcola 0:f1d3878b8dd9 111 GM_SU_13_2 = 0,
vpcola 0:f1d3878b8dd9 112 GM_SU_18_2,
vpcola 0:f1d3878b8dd9 113 GM_SU_21_5,
vpcola 0:f1d3878b8dd9 114 GM_SU_25_6,
vpcola 0:f1d3878b8dd9 115 GM_SU_28_8,
vpcola 0:f1d3878b8dd9 116 GM_SU_33_9,
vpcola 0:f1d3878b8dd9 117 GM_SU_38_5,
vpcola 0:f1d3878b8dd9 118 GM_SU_43_0
vpcola 0:f1d3878b8dd9 119 } GmConf;
vpcola 0:f1d3878b8dd9 120
vpcola 0:f1d3878b8dd9 121 #define IS_GM_CONF(MODE) (MODE == GM_SU_13_2 || \
vpcola 0:f1d3878b8dd9 122 MODE == GM_SU_18_2 || \
vpcola 0:f1d3878b8dd9 123 MODE == GM_SU_21_5 || \
vpcola 0:f1d3878b8dd9 124 MODE == GM_SU_25_6 || \
vpcola 0:f1d3878b8dd9 125 MODE == GM_SU_28_8 || \
vpcola 0:f1d3878b8dd9 126 MODE == GM_SU_33_9 || \
vpcola 0:f1d3878b8dd9 127 MODE == GM_SU_38_5 || \
vpcola 0:f1d3878b8dd9 128 MODE == GM_SU_43_0)
vpcola 0:f1d3878b8dd9 129
vpcola 0:f1d3878b8dd9 130
vpcola 0:f1d3878b8dd9 131 /**
vpcola 0:f1d3878b8dd9 132 * @brief SPIRIT packet type enumeration
vpcola 0:f1d3878b8dd9 133 */
vpcola 0:f1d3878b8dd9 134
vpcola 0:f1d3878b8dd9 135 typedef enum
vpcola 0:f1d3878b8dd9 136 {
vpcola 0:f1d3878b8dd9 137 PKT_BASIC = 0x00,
vpcola 0:f1d3878b8dd9 138 PKT_MBUS = 0x02,
vpcola 0:f1d3878b8dd9 139 PKT_STACK
vpcola 0:f1d3878b8dd9 140
vpcola 0:f1d3878b8dd9 141 } PacketType;
vpcola 0:f1d3878b8dd9 142
vpcola 0:f1d3878b8dd9 143 #define IS_PKT_TYPE(TYPE) (TYPE == PKT_BASIC || \
vpcola 0:f1d3878b8dd9 144 TYPE == PKT_MBUS || \
vpcola 0:f1d3878b8dd9 145 TYPE == PKT_STACK || \
vpcola 0:f1d3878b8dd9 146 )
vpcola 0:f1d3878b8dd9 147
vpcola 0:f1d3878b8dd9 148
vpcola 0:f1d3878b8dd9 149 /**
vpcola 0:f1d3878b8dd9 150 * @brief SPIRIT version type enumeration
vpcola 0:f1d3878b8dd9 151 */
vpcola 0:f1d3878b8dd9 152
vpcola 0:f1d3878b8dd9 153 typedef enum
vpcola 0:f1d3878b8dd9 154 {
vpcola 0:f1d3878b8dd9 155 SPIRIT_VERSION_2_1 = 0x01, /* Deprecated */
vpcola 0:f1d3878b8dd9 156 SPIRIT_VERSION_3_0, /* The only version of SPIRIT1 */
vpcola 0:f1d3878b8dd9 157 } SpiritVersion;
vpcola 0:f1d3878b8dd9 158
vpcola 0:f1d3878b8dd9 159
vpcola 0:f1d3878b8dd9 160 /**
vpcola 0:f1d3878b8dd9 161 * @}
vpcola 0:f1d3878b8dd9 162 */
vpcola 0:f1d3878b8dd9 163
vpcola 0:f1d3878b8dd9 164
vpcola 0:f1d3878b8dd9 165 /**
vpcola 0:f1d3878b8dd9 166 * @defgroup General_Exported_Constants General Exported Constants
vpcola 0:f1d3878b8dd9 167 * @{
vpcola 0:f1d3878b8dd9 168 */
vpcola 0:f1d3878b8dd9 169
vpcola 0:f1d3878b8dd9 170
vpcola 0:f1d3878b8dd9 171 /**
vpcola 0:f1d3878b8dd9 172 * @}
vpcola 0:f1d3878b8dd9 173 */
vpcola 0:f1d3878b8dd9 174
vpcola 0:f1d3878b8dd9 175
vpcola 0:f1d3878b8dd9 176 /**
vpcola 0:f1d3878b8dd9 177 * @defgroup General_Exported_Macros General Exported Macros
vpcola 0:f1d3878b8dd9 178 * @{
vpcola 0:f1d3878b8dd9 179 */
vpcola 0:f1d3878b8dd9 180 #define SpiritGeneralLibraryVersion() "Spirit1_Libraries_v.3.2.0"
vpcola 0:f1d3878b8dd9 181
vpcola 0:f1d3878b8dd9 182
vpcola 0:f1d3878b8dd9 183 /**
vpcola 0:f1d3878b8dd9 184 * @}
vpcola 0:f1d3878b8dd9 185 */
vpcola 0:f1d3878b8dd9 186
vpcola 0:f1d3878b8dd9 187
vpcola 0:f1d3878b8dd9 188 /**
vpcola 0:f1d3878b8dd9 189 * @defgroup General_Exported_Functions General Exported Functions
vpcola 0:f1d3878b8dd9 190 * @{
vpcola 0:f1d3878b8dd9 191 */
vpcola 0:f1d3878b8dd9 192
vpcola 0:f1d3878b8dd9 193
vpcola 0:f1d3878b8dd9 194 void SpiritGeneralBatteryLevel(SpiritFunctionalState xNewState);
vpcola 0:f1d3878b8dd9 195 void SpiritGeneralSetBatteryLevel(BatteryLevel xBatteryLevel);
vpcola 0:f1d3878b8dd9 196 BatteryLevel SpiritGeneralGetBatteryLevel(void);
vpcola 0:f1d3878b8dd9 197 void SpiritGeneralBrownOut(SpiritFunctionalState xNewState);
vpcola 0:f1d3878b8dd9 198 void SpiritGeneralHighPwr(SpiritFunctionalState xNewState);
vpcola 0:f1d3878b8dd9 199 void SpiritGeneralSetExtRef(ModeExtRef xExtMode);
vpcola 0:f1d3878b8dd9 200 ModeExtRef SpiritGeneralGetExtRef(void);
vpcola 0:f1d3878b8dd9 201 void SpiritGeneralSetXoGm(GmConf xGm);
vpcola 0:f1d3878b8dd9 202 GmConf SpiritGeneralGetXoGm(void);
vpcola 0:f1d3878b8dd9 203 PacketType SpiritGeneralGetPktType(void);
vpcola 0:f1d3878b8dd9 204 uint16_t SpiritGeneralGetDevicePartNumber(void);
vpcola 0:f1d3878b8dd9 205 uint8_t SpiritGeneralGetSpiritVersion(void);
vpcola 0:f1d3878b8dd9 206
vpcola 0:f1d3878b8dd9 207 /**
vpcola 0:f1d3878b8dd9 208 * @}
vpcola 0:f1d3878b8dd9 209 */
vpcola 0:f1d3878b8dd9 210
vpcola 0:f1d3878b8dd9 211 /**
vpcola 0:f1d3878b8dd9 212 * @}
vpcola 0:f1d3878b8dd9 213 */
vpcola 0:f1d3878b8dd9 214
vpcola 0:f1d3878b8dd9 215
vpcola 0:f1d3878b8dd9 216 /**
vpcola 0:f1d3878b8dd9 217 * @}
vpcola 0:f1d3878b8dd9 218 */
vpcola 0:f1d3878b8dd9 219
vpcola 0:f1d3878b8dd9 220
vpcola 0:f1d3878b8dd9 221 #ifdef __cplusplus
vpcola 0:f1d3878b8dd9 222 }
vpcola 0:f1d3878b8dd9 223 #endif
vpcola 0:f1d3878b8dd9 224
vpcola 0:f1d3878b8dd9 225 #endif
vpcola 0:f1d3878b8dd9 226
vpcola 0:f1d3878b8dd9 227 /******************* (C) COPYRIGHT 2015 STMicroelectronics *****END OF FILE****/