/** * Copyright (c) 2017 - 2020, Nordic Semiconductor ASA * * All rights reserved. * * 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, except as embedded into a Nordic * Semiconductor ASA integrated circuit in a product or a software update for * such product, 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 Nordic Semiconductor ASA nor the names of its * contributors may be used to endorse or promote products derived from this * software without specific prior written permission. * * 4. This software, with or without modification, must only be used with a * Nordic Semiconductor ASA integrated circuit. * * 5. Any software provided in binary form under this license must not be reverse * engineered, decompiled, modified and/or disassembled. * * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA 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. * */ #include "sdk_common.h" #if NRF_MODULE_ENABLED(POWER) #include "nrf_drv_power.h" #include #ifdef SOFTDEVICE_PRESENT #include "nrf_sdh.h" #include "nrf_sdh_soc.h" #endif #include // The structure with default configuration data. static const nrfx_power_config_t m_drv_power_config_default = { .dcdcen = NRFX_POWER_CONFIG_DEFAULT_DCDCEN, #if NRF_POWER_HAS_VDDH .dcdcenhv = NRFX_POWER_CONFIG_DEFAULT_DCDCENHV, #endif }; static bool m_initialized; bool nrf_drv_power_init_check(void) { return m_initialized; } ret_code_t nrf_drv_power_init(nrf_drv_power_config_t const * p_config) { if (m_initialized) { return NRF_ERROR_MODULE_ALREADY_INITIALIZED; } #ifdef SOFTDEVICE_PRESENT if (nrf_sdh_is_enabled()) { return NRF_ERROR_INVALID_STATE; } #endif if (p_config == NULL) { p_config = &m_drv_power_config_default; } ret_code_t err_code = nrfx_power_init(p_config); if (err_code == NRFX_SUCCESS) { m_initialized = true; } return err_code; } void nrf_drv_power_uninit() { nrfx_power_uninit(); nrf_drv_power_pof_uninit(); #if NRF_POWER_HAS_SLEEPEVT nrf_drv_power_sleepevt_uninit(); #endif #if NRF_POWER_HAS_USBREG nrf_drv_power_usbevt_uninit(); #endif m_initialized = false; } ret_code_t nrf_drv_power_pof_init(nrf_drv_power_pofwarn_config_t const * p_config) { ret_code_t err_code = NRF_SUCCESS; nrfx_power_pof_init(p_config); #ifdef SOFTDEVICE_PRESENT if (nrf_sdh_is_enabled()) { /* Currently when SD is enabled - the configuration can be changed * in very limited range. * It is the SoftDevice limitation. */ #if NRF_POWER_HAS_VDDH if (p_config->thrvddh != nrf_power_pofcon_vddh_get()) { /* Cannot change THRVDDH with current SD API */ return NRF_ERROR_INVALID_STATE; } #endif if (p_config->thr != nrf_power_pofcon_get(NULL)) { /* Only limited number of THR values are supported and * the values taken by SD is different than the one in hardware */ uint8_t thr; switch(p_config->thr) { case NRF_POWER_POFTHR_V21: thr = NRF_POWER_THRESHOLD_V21; break; case NRF_POWER_POFTHR_V23: thr = NRF_POWER_THRESHOLD_V23; break; case NRF_POWER_POFTHR_V25: thr = NRF_POWER_THRESHOLD_V25; break; case NRF_POWER_POFTHR_V27: thr = NRF_POWER_THRESHOLD_V27; break; default: /* Cannot configure */ nrfx_power_pof_uninit(); return NRF_ERROR_INVALID_STATE; } err_code = sd_power_pof_threshold_set(thr); if (err_code != NRF_SUCCESS) { return err_code; } } err_code = sd_power_pof_enable(true); } else #endif /* SOFTDEVICE_PRESENT */ { nrfx_power_pof_enable(p_config); } return err_code; } void nrf_drv_power_pof_uninit() { #ifdef SOFTDEVICE_PRESENT if (nrf_sdh_is_enabled()) { ret_code_t err_code = sd_power_pof_enable(false); ASSERT(err_code == NRF_SUCCESS); UNUSED_VARIABLE(err_code); //handle no-debug case } else #endif { nrfx_power_pof_disable(); } nrfx_power_pof_uninit(); } #if NRF_POWER_HAS_SLEEPEVT ret_code_t nrf_drv_power_sleepevt_init(nrf_drv_power_sleepevt_config_t const * p_config) { if (p_config->handler != NULL) { #ifdef SOFTDEVICE_PRESENT if (nrf_sdh_is_enabled()) { if ((p_config->en_enter) || (p_config->en_exit)) { return NRF_ERROR_INVALID_STATE; } } else #endif { nrfx_power_sleepevt_enable(p_config); } } return NRF_SUCCESS; } void nrf_drv_power_sleepevt_uninit(void) { #ifdef SOFTDEVICE_PRESENT if (nrf_sdh_is_enabled()) { /* Nothing to do */ } else #endif { nrfx_power_sleepevt_disable(); } nrfx_power_sleepevt_uninit(); } #endif /* NRF_POWER_HAS_SLEEPEVT */ #if NRF_POWER_HAS_USBREG #ifdef SOFTDEVICE_PRESENT static ret_code_t nrf_drv_power_sd_usbevt_enable(bool enable) { ret_code_t err_code; err_code = sd_power_usbdetected_enable(enable); ASSERT(err_code == NRF_SUCCESS); if (err_code != NRF_SUCCESS) { return err_code; } err_code = sd_power_usbpwrrdy_enable(enable); ASSERT(err_code == NRF_SUCCESS); if (err_code != NRF_SUCCESS) { return err_code; } err_code = sd_power_usbremoved_enable(enable); ASSERT(err_code == NRF_SUCCESS); return err_code; } #endif // SOFTDEVICE_PRESENT ret_code_t nrf_drv_power_usbevt_init(nrf_drv_power_usbevt_config_t const * p_config) { nrf_drv_power_usbevt_uninit(); nrfx_power_usbevt_init(p_config); #ifdef SOFTDEVICE_PRESENT if (nrf_sdh_is_enabled()) { ret_code_t err_code = nrf_drv_power_sd_usbevt_enable(true); ASSERT(err_code == NRF_SUCCESS); if (err_code != NRF_SUCCESS) { return err_code; } uint32_t regstatus; err_code = sd_power_usbregstatus_get(®status); ASSERT(err_code == NRF_SUCCESS); if (err_code != NRF_SUCCESS) { return err_code; } if (regstatus & POWER_USBREGSTATUS_VBUSDETECT_Msk) { nrfx_power_usb_event_handler_t usbevt_handler = nrfx_power_usb_handler_get(); ASSERT(usbevt_handler != NULL); usbevt_handler(NRFX_POWER_USB_EVT_DETECTED); } } else #endif { nrfx_power_usbevt_enable(); } return NRF_SUCCESS; } void nrf_drv_power_usbevt_uninit(void) { #ifdef SOFTDEVICE_PRESENT CRITICAL_REGION_ENTER(); if (nrf_sdh_is_enabled()) { ret_code_t err_code = nrf_drv_power_sd_usbevt_enable(false); ASSERT(err_code == NRF_SUCCESS); UNUSED_VARIABLE(err_code); } else #endif { nrfx_power_usbevt_disable(); } #ifdef SOFTDEVICE_PRESENT CRITICAL_REGION_EXIT(); #endif nrfx_power_usbevt_uninit(); } #endif /* NRF_POWER_HAS_USBREG */ #ifdef SOFTDEVICE_PRESENT static void nrf_drv_power_sdh_soc_evt_handler(uint32_t evt_id, void * p_context); static void nrf_drv_power_sdh_state_evt_handler(nrf_sdh_state_evt_t state, void * p_context); NRF_SDH_SOC_OBSERVER(m_soc_observer, POWER_CONFIG_SOC_OBSERVER_PRIO, nrf_drv_power_sdh_soc_evt_handler, NULL); NRF_SDH_STATE_OBSERVER(m_sd_observer, POWER_CONFIG_STATE_OBSERVER_PRIO) = { .handler = nrf_drv_power_sdh_state_evt_handler, .p_context = NULL }; static void nrf_drv_power_sdh_soc_evt_handler(uint32_t evt_id, void * p_context) { if (evt_id == NRF_EVT_POWER_FAILURE_WARNING) { nrfx_power_pofwarn_event_handler_t pofwarn_handler = nrfx_power_pof_handler_get(); /* Cannot be null if event is enabled */ ASSERT(pofwarn_handler != NULL); pofwarn_handler(); } #if NRF_POWER_HAS_USBREG nrfx_power_usb_event_handler_t usbevt_handler = nrfx_power_usb_handler_get(); if (usbevt_handler != NULL) { switch (evt_id) { case NRF_EVT_POWER_USB_POWER_READY: usbevt_handler(NRFX_POWER_USB_EVT_READY); break; case NRF_EVT_POWER_USB_DETECTED: usbevt_handler(NRFX_POWER_USB_EVT_DETECTED); break; case NRF_EVT_POWER_USB_REMOVED: usbevt_handler(NRFX_POWER_USB_EVT_REMOVED); break; default: break; } } #endif } static void nrf_drv_power_on_sd_enable(void) { ASSERT(m_initialized); /* This module has to be enabled first */ CRITICAL_REGION_ENTER(); if (nrfx_power_pof_handler_get() != NULL) { ret_code_t err_code = sd_power_pof_enable(true); ASSERT(err_code == NRF_SUCCESS); UNUSED_VARIABLE(err_code); //handle no-debug case } CRITICAL_REGION_EXIT(); #if NRF_POWER_HAS_USBREG if (nrfx_power_usb_handler_get() != NULL) { ret_code_t err_code = nrf_drv_power_sd_usbevt_enable(true); ASSERT(err_code == NRF_SUCCESS); UNUSED_VARIABLE(err_code); //handle no-debug case } #endif } static void nrf_drv_power_on_sd_disable(void) { /* Reinit interrupts */ ASSERT(m_initialized); NRFX_IRQ_PRIORITY_SET(POWER_CLOCK_IRQn, CLOCK_CONFIG_IRQ_PRIORITY); NRFX_IRQ_ENABLE(POWER_CLOCK_IRQn); if (nrfx_power_pof_handler_get() != NULL) { nrf_power_int_enable(NRF_POWER_INT_POFWARN_MASK); } #if NRF_POWER_HAS_USBREG if (nrfx_power_usb_handler_get() != NULL) { nrf_power_int_enable( NRF_POWER_INT_USBDETECTED_MASK | NRF_POWER_INT_USBREMOVED_MASK | NRF_POWER_INT_USBPWRRDY_MASK); } #endif } static void nrf_drv_power_sdh_state_evt_handler(nrf_sdh_state_evt_t state, void * p_context) { switch (state) { case NRF_SDH_EVT_STATE_ENABLED: nrf_drv_power_on_sd_enable(); break; case NRF_SDH_EVT_STATE_DISABLED: nrf_drv_power_on_sd_disable(); break; default: break; } } #endif // SOFTDEVICE_PRESENT #endif //POWER_ENABLED