mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_L486RG/TARGET_STM/TARGET_STM32L4/device/stm32l4xx_hal_usart_ex.h@140:97feb9bacc10, 2017-04-12 (annotated)

Committer:
<>
Date:
Wed Apr 12 16:07:08 2017 +0100
Revision:
140:97feb9bacc10
Parent:
128:9bcdf88f62b0
Child:
145:64910690c574
Release 140 of the mbed library



Ports for Upcoming Targets



3841: Add nRf52840 target https://github.com/ARMmbed/mbed-os/pull/3841

3992: Introducing UBLOX_C030 platform. https://github.com/ARMmbed/mbed-os/pull/3992



Fixes and Changes



3951: [NUCLEO_F303ZE] Correct ARDUINO pin https://github.com/ARMmbed/mbed-os/pull/3951

4021: Fixing a macro to detect when RTOS was in use for the NRF52840_DK https://github.com/ARMmbed/mbed-os/pull/4021

3979: KW24D: Add missing SPI defines and Arduino connector definitions https://github.com/ARMmbed/mbed-os/pull/3979

3990: UBLOX_C027: construct a ticker-based wait, rather than calling wait_ms(), in the  https://github.com/ARMmbed/mbed-os/pull/3990

4003: Fixed OBOE in async serial tx for NRF52 target, fixes #4002 https://github.com/ARMmbed/mbed-os/pull/4003

4012: STM32: Correct I2C master error handling https://github.com/ARMmbed/mbed-os/pull/4012

4020: NUCLEO_L011K4 remove unsupported tool chain files https://github.com/ARMmbed/mbed-os/pull/4020

4065: K66F: Move bss section to m_data_2 Section https://github.com/ARMmbed/mbed-os/pull/4065

4014: Issue 3763: Reduce heap allocation in the GCC linker file https://github.com/ARMmbed/mbed-os/pull/4014

4030: [STM32L0] reduce IAR heap and stack size for small targets https://github.com/ARMmbed/mbed-os/pull/4030

4109: NUCLEO_L476RG : minor serial pin update https://github.com/ARMmbed/mbed-os/pull/4109

3982: Ticker - kl25z bugfix for handling events in the past https://github.com/ARMmbed/mbed-os/pull/3982

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Kojto 122:f9eeca106725 1 /**
Kojto 122:f9eeca106725 2 ******************************************************************************
Kojto 122:f9eeca106725 3 * @file stm32l4xx_hal_usart_ex.h
Kojto 122:f9eeca106725 4 * @author MCD Application Team
Kojto 122:f9eeca106725 5 * @version V1.5.1
Kojto 122:f9eeca106725 6 * @date 31-May-2016
Kojto 122:f9eeca106725 7 * @brief Header file of USART HAL Extended module.
Kojto 122:f9eeca106725 8 ******************************************************************************
Kojto 122:f9eeca106725 9 * @attention
Kojto 122:f9eeca106725 10 *
Kojto 122:f9eeca106725 11 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
Kojto 122:f9eeca106725 12 *
Kojto 122:f9eeca106725 13 * Redistribution and use in source and binary forms, with or without modification,
Kojto 122:f9eeca106725 14 * are permitted provided that the following conditions are met:
Kojto 122:f9eeca106725 15 * 1. Redistributions of source code must retain the above copyright notice,
Kojto 122:f9eeca106725 16 * this list of conditions and the following disclaimer.
Kojto 122:f9eeca106725 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
Kojto 122:f9eeca106725 18 * this list of conditions and the following disclaimer in the documentation
Kojto 122:f9eeca106725 19 * and/or other materials provided with the distribution.
Kojto 122:f9eeca106725 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
Kojto 122:f9eeca106725 21 * may be used to endorse or promote products derived from this software
Kojto 122:f9eeca106725 22 * without specific prior written permission.
Kojto 122:f9eeca106725 23 *
Kojto 122:f9eeca106725 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Kojto 122:f9eeca106725 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Kojto 122:f9eeca106725 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Kojto 122:f9eeca106725 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Kojto 122:f9eeca106725 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Kojto 122:f9eeca106725 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Kojto 122:f9eeca106725 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Kojto 122:f9eeca106725 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Kojto 122:f9eeca106725 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Kojto 122:f9eeca106725 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Kojto 122:f9eeca106725 34 *
Kojto 122:f9eeca106725 35 ******************************************************************************
Kojto 122:f9eeca106725 36 */
Kojto 122:f9eeca106725 37
Kojto 122:f9eeca106725 38 /* Define to prevent recursive inclusion -------------------------------------*/
Kojto 122:f9eeca106725 39 #ifndef __STM32L4xx_HAL_USART_EX_H
Kojto 122:f9eeca106725 40 #define __STM32L4xx_HAL_USART_EX_H
Kojto 122:f9eeca106725 41
Kojto 122:f9eeca106725 42 #ifdef __cplusplus
Kojto 122:f9eeca106725 43 extern "C" {
Kojto 122:f9eeca106725 44 #endif
Kojto 122:f9eeca106725 45
Kojto 122:f9eeca106725 46 /* Includes ------------------------------------------------------------------*/
Kojto 122:f9eeca106725 47 #include "stm32l4xx_hal_def.h"
Kojto 122:f9eeca106725 48
Kojto 122:f9eeca106725 49 /** @addtogroup STM32L4xx_HAL_Driver
Kojto 122:f9eeca106725 50 * @{
Kojto 122:f9eeca106725 51 */
Kojto 122:f9eeca106725 52
Kojto 122:f9eeca106725 53 /** @addtogroup USARTEx
Kojto 122:f9eeca106725 54 * @{
Kojto 122:f9eeca106725 55 */
Kojto 122:f9eeca106725 56
Kojto 122:f9eeca106725 57 /* Exported types ------------------------------------------------------------*/
Kojto 122:f9eeca106725 58 /* Exported constants --------------------------------------------------------*/
Kojto 122:f9eeca106725 59 /** @defgroup USARTEx_Exported_Constants USARTEx Exported Constants
Kojto 122:f9eeca106725 60 * @{
Kojto 122:f9eeca106725 61 */
Kojto 122:f9eeca106725 62
Kojto 122:f9eeca106725 63 /** @defgroup USARTEx_Word_Length USARTEx Word Length
Kojto 122:f9eeca106725 64 * @{
Kojto 122:f9eeca106725 65 */
Kojto 122:f9eeca106725 66 #define USART_WORDLENGTH_7B ((uint32_t)USART_CR1_M1) /*!< 7-bit long USART frame */
Kojto 122:f9eeca106725 67 #define USART_WORDLENGTH_8B ((uint32_t)0x00000000) /*!< 8-bit long USART frame */
Kojto 122:f9eeca106725 68 #define USART_WORDLENGTH_9B ((uint32_t)USART_CR1_M0) /*!< 9-bit long USART frame */
Kojto 122:f9eeca106725 69 /**
Kojto 122:f9eeca106725 70 * @}
Kojto 122:f9eeca106725 71 */
Kojto 122:f9eeca106725 72
Kojto 122:f9eeca106725 73 /**
Kojto 122:f9eeca106725 74 * @}
Kojto 122:f9eeca106725 75 */
Kojto 122:f9eeca106725 76
Kojto 122:f9eeca106725 77 /* Exported functions --------------------------------------------------------*/
Kojto 122:f9eeca106725 78
Kojto 122:f9eeca106725 79 /* Private macros ------------------------------------------------------------*/
Kojto 122:f9eeca106725 80 /** @defgroup USARTEx_Private_Macros USARTEx Private Macros
Kojto 122:f9eeca106725 81 * @{
Kojto 122:f9eeca106725 82 */
Kojto 122:f9eeca106725 83
Kojto 122:f9eeca106725 84 /** @brief Report the USART clock source.
Kojto 122:f9eeca106725 85 * @param __HANDLE__: specifies the USART Handle.
Kojto 122:f9eeca106725 86 * @param __CLOCKSOURCE__: output variable.
Kojto 122:f9eeca106725 87 * @retval the USART clocking source, written in __CLOCKSOURCE__.
Kojto 122:f9eeca106725 88 */
Kojto 122:f9eeca106725 89 #if defined (STM32L432xx) || defined (STM32L442xx)
Kojto 122:f9eeca106725 90 #define USART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
Kojto 122:f9eeca106725 91 do { \
Kojto 122:f9eeca106725 92 if((__HANDLE__)->Instance == USART1) \
Kojto 122:f9eeca106725 93 { \
Kojto 122:f9eeca106725 94 switch(__HAL_RCC_GET_USART1_SOURCE()) \
Kojto 122:f9eeca106725 95 { \
Kojto 122:f9eeca106725 96 case RCC_USART1CLKSOURCE_PCLK2: \
Kojto 122:f9eeca106725 97 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK2; \
Kojto 122:f9eeca106725 98 break; \
Kojto 122:f9eeca106725 99 case RCC_USART1CLKSOURCE_HSI: \
Kojto 122:f9eeca106725 100 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
Kojto 122:f9eeca106725 101 break; \
Kojto 122:f9eeca106725 102 case RCC_USART1CLKSOURCE_SYSCLK: \
Kojto 122:f9eeca106725 103 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
Kojto 122:f9eeca106725 104 break; \
Kojto 122:f9eeca106725 105 case RCC_USART1CLKSOURCE_LSE: \
Kojto 122:f9eeca106725 106 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
Kojto 122:f9eeca106725 107 break; \
Kojto 122:f9eeca106725 108 default: \
Kojto 122:f9eeca106725 109 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
Kojto 122:f9eeca106725 110 break; \
Kojto 122:f9eeca106725 111 } \
Kojto 122:f9eeca106725 112 } \
Kojto 122:f9eeca106725 113 else if((__HANDLE__)->Instance == USART2) \
Kojto 122:f9eeca106725 114 { \
Kojto 122:f9eeca106725 115 switch(__HAL_RCC_GET_USART2_SOURCE()) \
Kojto 122:f9eeca106725 116 { \
Kojto 122:f9eeca106725 117 case RCC_USART2CLKSOURCE_PCLK1: \
Kojto 122:f9eeca106725 118 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1; \
Kojto 122:f9eeca106725 119 break; \
Kojto 122:f9eeca106725 120 case RCC_USART2CLKSOURCE_HSI: \
Kojto 122:f9eeca106725 121 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
Kojto 122:f9eeca106725 122 break; \
Kojto 122:f9eeca106725 123 case RCC_USART2CLKSOURCE_SYSCLK: \
Kojto 122:f9eeca106725 124 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
Kojto 122:f9eeca106725 125 break; \
Kojto 122:f9eeca106725 126 case RCC_USART2CLKSOURCE_LSE: \
Kojto 122:f9eeca106725 127 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
Kojto 122:f9eeca106725 128 break; \
Kojto 122:f9eeca106725 129 default: \
Kojto 122:f9eeca106725 130 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
Kojto 122:f9eeca106725 131 break; \
Kojto 122:f9eeca106725 132 } \
Kojto 122:f9eeca106725 133 } \
Kojto 122:f9eeca106725 134 } while(0)
Kojto 122:f9eeca106725 135 #else
Kojto 122:f9eeca106725 136 #define USART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
Kojto 122:f9eeca106725 137 do { \
Kojto 122:f9eeca106725 138 if((__HANDLE__)->Instance == USART1) \
Kojto 122:f9eeca106725 139 { \
Kojto 122:f9eeca106725 140 switch(__HAL_RCC_GET_USART1_SOURCE()) \
Kojto 122:f9eeca106725 141 { \
Kojto 122:f9eeca106725 142 case RCC_USART1CLKSOURCE_PCLK2: \
Kojto 122:f9eeca106725 143 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK2; \
Kojto 122:f9eeca106725 144 break; \
Kojto 122:f9eeca106725 145 case RCC_USART1CLKSOURCE_HSI: \
Kojto 122:f9eeca106725 146 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
Kojto 122:f9eeca106725 147 break; \
Kojto 122:f9eeca106725 148 case RCC_USART1CLKSOURCE_SYSCLK: \
Kojto 122:f9eeca106725 149 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
Kojto 122:f9eeca106725 150 break; \
Kojto 122:f9eeca106725 151 case RCC_USART1CLKSOURCE_LSE: \
Kojto 122:f9eeca106725 152 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
Kojto 122:f9eeca106725 153 break; \
Kojto 122:f9eeca106725 154 default: \
Kojto 122:f9eeca106725 155 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
Kojto 122:f9eeca106725 156 break; \
Kojto 122:f9eeca106725 157 } \
Kojto 122:f9eeca106725 158 } \
Kojto 122:f9eeca106725 159 else if((__HANDLE__)->Instance == USART2) \
Kojto 122:f9eeca106725 160 { \
Kojto 122:f9eeca106725 161 switch(__HAL_RCC_GET_USART2_SOURCE()) \
Kojto 122:f9eeca106725 162 { \
Kojto 122:f9eeca106725 163 case RCC_USART2CLKSOURCE_PCLK1: \
Kojto 122:f9eeca106725 164 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1; \
Kojto 122:f9eeca106725 165 break; \
Kojto 122:f9eeca106725 166 case RCC_USART2CLKSOURCE_HSI: \
Kojto 122:f9eeca106725 167 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
Kojto 122:f9eeca106725 168 break; \
Kojto 122:f9eeca106725 169 case RCC_USART2CLKSOURCE_SYSCLK: \
Kojto 122:f9eeca106725 170 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
Kojto 122:f9eeca106725 171 break; \
Kojto 122:f9eeca106725 172 case RCC_USART2CLKSOURCE_LSE: \
Kojto 122:f9eeca106725 173 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
Kojto 122:f9eeca106725 174 break; \
Kojto 122:f9eeca106725 175 default: \
Kojto 122:f9eeca106725 176 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
Kojto 122:f9eeca106725 177 break; \
Kojto 122:f9eeca106725 178 } \
Kojto 122:f9eeca106725 179 } \
Kojto 122:f9eeca106725 180 else if((__HANDLE__)->Instance == USART3) \
Kojto 122:f9eeca106725 181 { \
Kojto 122:f9eeca106725 182 switch(__HAL_RCC_GET_USART3_SOURCE()) \
Kojto 122:f9eeca106725 183 { \
Kojto 122:f9eeca106725 184 case RCC_USART3CLKSOURCE_PCLK1: \
Kojto 122:f9eeca106725 185 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1; \
Kojto 122:f9eeca106725 186 break; \
Kojto 122:f9eeca106725 187 case RCC_USART3CLKSOURCE_HSI: \
Kojto 122:f9eeca106725 188 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
Kojto 122:f9eeca106725 189 break; \
Kojto 122:f9eeca106725 190 case RCC_USART3CLKSOURCE_SYSCLK: \
Kojto 122:f9eeca106725 191 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
Kojto 122:f9eeca106725 192 break; \
Kojto 122:f9eeca106725 193 case RCC_USART3CLKSOURCE_LSE: \
Kojto 122:f9eeca106725 194 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
Kojto 122:f9eeca106725 195 break; \
Kojto 122:f9eeca106725 196 default: \
Kojto 122:f9eeca106725 197 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
Kojto 122:f9eeca106725 198 break; \
Kojto 122:f9eeca106725 199 } \
Kojto 122:f9eeca106725 200 } \
Kojto 122:f9eeca106725 201 } while(0)
Kojto 122:f9eeca106725 202 #endif /* STM32L432xx || STM32L442xx */
Kojto 122:f9eeca106725 203
Kojto 122:f9eeca106725 204 /** @brief Compute the USART mask to apply to retrieve the received data
Kojto 122:f9eeca106725 205 * according to the word length and to the parity bits activation.
Kojto 122:f9eeca106725 206 * @note If PCE = 1, the parity bit is not included in the data extracted
Kojto 122:f9eeca106725 207 * by the reception API().
Kojto 122:f9eeca106725 208 * This masking operation is not carried out in the case of
Kojto 122:f9eeca106725 209 * DMA transfers.
Kojto 122:f9eeca106725 210 * @param __HANDLE__: specifies the USART Handle.
Kojto 122:f9eeca106725 211 * @retval None, the mask to apply to USART RDR register is stored in (__HANDLE__)->Mask field.
Kojto 122:f9eeca106725 212 */
Kojto 122:f9eeca106725 213 #define USART_MASK_COMPUTATION(__HANDLE__) \
Kojto 122:f9eeca106725 214 do { \
Kojto 122:f9eeca106725 215 if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_9B) \
Kojto 122:f9eeca106725 216 { \
Kojto 122:f9eeca106725 217 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
Kojto 122:f9eeca106725 218 { \
Kojto 122:f9eeca106725 219 (__HANDLE__)->Mask = 0x01FF ; \
Kojto 122:f9eeca106725 220 } \
Kojto 122:f9eeca106725 221 else \
Kojto 122:f9eeca106725 222 { \
Kojto 122:f9eeca106725 223 (__HANDLE__)->Mask = 0x00FF ; \
Kojto 122:f9eeca106725 224 } \
Kojto 122:f9eeca106725 225 } \
Kojto 122:f9eeca106725 226 else if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_8B) \
Kojto 122:f9eeca106725 227 { \
Kojto 122:f9eeca106725 228 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
Kojto 122:f9eeca106725 229 { \
Kojto 122:f9eeca106725 230 (__HANDLE__)->Mask = 0x00FF ; \
Kojto 122:f9eeca106725 231 } \
Kojto 122:f9eeca106725 232 else \
Kojto 122:f9eeca106725 233 { \
Kojto 122:f9eeca106725 234 (__HANDLE__)->Mask = 0x007F ; \
Kojto 122:f9eeca106725 235 } \
Kojto 122:f9eeca106725 236 } \
Kojto 122:f9eeca106725 237 else if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_7B) \
Kojto 122:f9eeca106725 238 { \
Kojto 122:f9eeca106725 239 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
Kojto 122:f9eeca106725 240 { \
Kojto 122:f9eeca106725 241 (__HANDLE__)->Mask = 0x007F ; \
Kojto 122:f9eeca106725 242 } \
Kojto 122:f9eeca106725 243 else \
Kojto 122:f9eeca106725 244 { \
Kojto 122:f9eeca106725 245 (__HANDLE__)->Mask = 0x003F ; \
Kojto 122:f9eeca106725 246 } \
Kojto 122:f9eeca106725 247 } \
Kojto 122:f9eeca106725 248 } while(0)
Kojto 122:f9eeca106725 249
Kojto 122:f9eeca106725 250
Kojto 122:f9eeca106725 251 /**
Kojto 122:f9eeca106725 252 * @brief Ensure that USART frame length is valid.
Kojto 122:f9eeca106725 253 * @param __LENGTH__: USART frame length.
Kojto 122:f9eeca106725 254 * @retval SET (__LENGTH__ is valid) or RESET (__LENGTH__ is invalid)
Kojto 122:f9eeca106725 255 */
Kojto 122:f9eeca106725 256 #define IS_USART_WORD_LENGTH(__LENGTH__) (((__LENGTH__) == USART_WORDLENGTH_7B) || \
Kojto 122:f9eeca106725 257 ((__LENGTH__) == USART_WORDLENGTH_8B) || \
Kojto 122:f9eeca106725 258 ((__LENGTH__) == USART_WORDLENGTH_9B))
Kojto 122:f9eeca106725 259
Kojto 122:f9eeca106725 260 /**
Kojto 122:f9eeca106725 261 * @}
Kojto 122:f9eeca106725 262 */
Kojto 122:f9eeca106725 263
Kojto 122:f9eeca106725 264 /* Exported functions --------------------------------------------------------*/
Kojto 122:f9eeca106725 265
Kojto 122:f9eeca106725 266 /**
Kojto 122:f9eeca106725 267 * @}
Kojto 122:f9eeca106725 268 */
Kojto 122:f9eeca106725 269
Kojto 122:f9eeca106725 270 /**
Kojto 122:f9eeca106725 271 * @}
Kojto 122:f9eeca106725 272 */
Kojto 122:f9eeca106725 273
Kojto 122:f9eeca106725 274 #ifdef __cplusplus
Kojto 122:f9eeca106725 275 }
Kojto 122:f9eeca106725 276 #endif
Kojto 122:f9eeca106725 277
Kojto 122:f9eeca106725 278 #endif /* __STM32L4xx_HAL_USART_EX_H */
Kojto 122:f9eeca106725 279
Kojto 122:f9eeca106725 280 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/