| /* |
| * Copyright (c) 2015, Freescale Semiconductor, Inc. |
| * Copyright 2016-2017 NXP |
| * All rights reserved. |
| * |
| * SPDX-License-Identifier: BSD-3-Clause |
| */ |
| |
| #ifndef _FSL_SIM_H_ |
| #define _FSL_SIM_H_ |
| |
| #include "fsl_common.h" |
| |
| /*! @addtogroup sim */ |
| /*! @{*/ |
| |
| /******************************************************************************* |
| * Definitions |
| *******************************************************************************/ |
| |
| /*! @name Driver version */ |
| /*@{*/ |
| #define FSL_SIM_DRIVER_VERSION (MAKE_VERSION(2, 0, 0)) /*!< Driver version 2.0.0 */ |
| /*@}*/ |
| |
| #if (defined(FSL_FEATURE_SIM_OPT_HAS_USB_VOLTAGE_REGULATOR) && FSL_FEATURE_SIM_OPT_HAS_USB_VOLTAGE_REGULATOR) |
| /*!@brief USB voltage regulator enable setting. */ |
| enum _sim_usb_volt_reg_enable_mode |
| { |
| kSIM_UsbVoltRegEnable = SIM_SOPT1_USBREGEN_MASK, /*!< Enable voltage regulator. */ |
| kSIM_UsbVoltRegEnableInLowPower = SIM_SOPT1_USBVSTBY_MASK, /*!< Enable voltage regulator in VLPR/VLPW modes. */ |
| kSIM_UsbVoltRegEnableInStop = SIM_SOPT1_USBSSTBY_MASK, /*!< Enable voltage regulator in STOP/VLPS/LLS/VLLS modes. */ |
| kSIM_UsbVoltRegEnableInAllModes = SIM_SOPT1_USBREGEN_MASK | SIM_SOPT1_USBSSTBY_MASK | |
| SIM_SOPT1_USBVSTBY_MASK /*!< Enable voltage regulator in all power modes. */ |
| }; |
| #endif /* (defined(FSL_FEATURE_SIM_OPT_HAS_USB_VOLTAGE_REGULATOR) && FSL_FEATURE_SIM_OPT_HAS_USB_VOLTAGE_REGULATOR) */ |
| |
| /*!@brief Unique ID. */ |
| typedef struct _sim_uid |
| { |
| #if defined(SIM_UIDH) |
| uint32_t H; /*!< UIDH. */ |
| #endif |
| |
| #if (defined(FSL_FEATURE_SIM_HAS_UIDM) && FSL_FEATURE_SIM_HAS_UIDM) |
| uint32_t M; /*!< SIM_UIDM. */ |
| #else |
| uint32_t MH; /*!< UIDMH. */ |
| uint32_t ML; /*!< UIDML. */ |
| #endif /* FSL_FEATURE_SIM_HAS_UIDM */ |
| uint32_t L; /*!< UIDL. */ |
| } sim_uid_t; |
| |
| #if (defined(FSL_FEATURE_SIM_HAS_RF_MAC_ADDR) && FSL_FEATURE_SIM_HAS_RF_MAC_ADDR) |
| /*! @brief RF Mac Address.*/ |
| typedef struct _sim_rf_addr |
| { |
| uint32_t rfAddrL; /*!< RFADDRL. */ |
| uint32_t rfAddrH; /*!< RFADDRH. */ |
| } sim_rf_addr_t; |
| #endif /* FSL_FEATURE_SIM_HAS_RF_MAC_ADDR */ |
| |
| /*!@brief Flash enable mode. */ |
| enum _sim_flash_mode |
| { |
| kSIM_FlashDisableInWait = SIM_FCFG1_FLASHDOZE_MASK, /*!< Disable flash in wait mode. */ |
| kSIM_FlashDisable = SIM_FCFG1_FLASHDIS_MASK /*!< Disable flash in normal mode. */ |
| }; |
| |
| /******************************************************************************* |
| * API |
| ******************************************************************************/ |
| |
| #if defined(__cplusplus) |
| extern "C" { |
| #endif /* __cplusplus*/ |
| |
| #if (defined(FSL_FEATURE_SIM_OPT_HAS_USB_VOLTAGE_REGULATOR) && FSL_FEATURE_SIM_OPT_HAS_USB_VOLTAGE_REGULATOR) |
| /*! |
| * @brief Sets the USB voltage regulator setting. |
| * |
| * This function configures whether the USB voltage regulator is enabled in |
| * normal RUN mode, STOP/VLPS/LLS/VLLS modes, and VLPR/VLPW modes. The configurations |
| * are passed in as mask value of \ref _sim_usb_volt_reg_enable_mode. For example, to enable |
| * USB voltage regulator in RUN/VLPR/VLPW modes and disable in STOP/VLPS/LLS/VLLS mode, |
| * use: |
| * |
| * SIM_SetUsbVoltRegulatorEnableMode(kSIM_UsbVoltRegEnable | kSIM_UsbVoltRegEnableInLowPower); |
| * |
| * @param mask USB voltage regulator enable setting. |
| */ |
| void SIM_SetUsbVoltRegulatorEnableMode(uint32_t mask); |
| #endif /* FSL_FEATURE_SIM_OPT_HAS_USB_VOLTAGE_REGULATOR */ |
| |
| /*! |
| * @brief Gets the unique identification register value. |
| * |
| * @param uid Pointer to the structure to save the UID value. |
| */ |
| void SIM_GetUniqueId(sim_uid_t *uid); |
| |
| /*! |
| * @brief Sets the flash enable mode. |
| * |
| * @param mode The mode to set; see \ref _sim_flash_mode for mode details. |
| */ |
| static inline void SIM_SetFlashMode(uint8_t mode) |
| { |
| SIM->FCFG1 = mode; |
| } |
| |
| #if (defined(FSL_FEATURE_SIM_HAS_RF_MAC_ADDR) && FSL_FEATURE_SIM_HAS_RF_MAC_ADDR) |
| /*! |
| * @brief Gets the RF address register value. |
| * |
| * @param info Pointer to the structure to save the RF address value. |
| */ |
| void SIM_GetRfAddr(sim_rf_addr_t *info); |
| #endif /* FSL_FEATURE_SIM_HAS_RF_MAC_ADDR */ |
| |
| #if (defined(FSL_FEATURE_SIM_MISC2_HAS_SYSTICK_CLK_EN) && FSL_FEATURE_SIM_MISC2_HAS_SYSTICK_CLK_EN) |
| |
| /*! |
| * @brief Enable the Systick clock or not. |
| * |
| * The Systick clock is enabled by default. |
| * |
| * @param enable The switcher for Systick clock. |
| */ |
| static inline void SIM_EnableSystickClock(bool enable) |
| { |
| if (enable) |
| { |
| SIM->MISC2 &= ~SIM_MISC2_SYSTICK_CLK_EN_MASK; /* Clear to enable. */ |
| } |
| else |
| { |
| SIM->MISC2 |= SIM_MISC2_SYSTICK_CLK_EN_MASK; /* Set to disable. */ |
| } |
| } |
| |
| #endif /* FSL_FEATURE_SIM_MISC2_HAS_SYSTICK_CLK_EN */ |
| |
| #if defined(__cplusplus) |
| } |
| #endif /* __cplusplus*/ |
| |
| /*! @}*/ |
| |
| #endif /* _FSL_SIM_H_ */ |