move components to SDK dir

This commit is contained in:
Shuanglei Tao
2025-03-03 09:06:26 +08:00
parent 20d1297e57
commit f4f4c9e60d
1021 changed files with 58 additions and 35059 deletions

View File

@@ -0,0 +1,232 @@
/**
* Copyright (c) 2015 - 2017, 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(LED_SOFTBLINK)
#include <string.h>
#include "led_softblink.h"
#include "nrf_gpio.h"
#include "app_timer.h"
#include "nrf_assert.h"
#include "low_power_pwm.h"
/* Period for LED softblink PWM. */
#define PWM_PERIOD UINT8_MAX
/**@bref Structure to handle timer time-outs
*
*/
typedef struct
{
bool leds_is_on; /**< Flag for indicating if LEDs are on. */
bool is_counting_up; /**< Flag for indicating if counter is incrementing or decrementing. */
nrf_drv_state_t led_sb_state; /**< Indicates current state of instance. */
uint16_t duty_cycle; /**< Current pulse width. */
uint32_t bit_mask; /**< Mask of used pins. */
led_sb_init_params_t params; /**< Structure holding initialization parameters. */
low_power_pwm_config_t pwm_config; /**< Structure holding parameters for initializing low level layer. */
low_power_pwm_t pwm_instance; /**< Structure holding low-power PWM instance parameters. */
}led_sb_context_t;
static led_sb_context_t m_led_sb = {0};
/**@brief Timer event handler for softblink.
*
* @param[in] p_context General purpose pointer. Will be passed to the time-out handler
* when the timer expires.
*
*/
static void led_softblink_on_timeout(void * p_context)
{
static int32_t pause_ticks;
ASSERT(m_led_sb.led_sb_state != NRF_DRV_STATE_UNINITIALIZED);
ret_code_t err_code;
if (pause_ticks <= 0)
{
if (m_led_sb.is_counting_up)
{
if (m_led_sb.duty_cycle >= (m_led_sb.params.duty_cycle_max - m_led_sb.params.duty_cycle_step))
{
// Max PWM duty cycle is reached, start decrementing.
m_led_sb.is_counting_up = false;
m_led_sb.duty_cycle = m_led_sb.params.duty_cycle_max;
pause_ticks = m_led_sb.params.on_time_ticks ? m_led_sb.params.on_time_ticks + APP_TIMER_MIN_TIMEOUT_TICKS : 0;
}
else
{
m_led_sb.duty_cycle += m_led_sb.params.duty_cycle_step;
}
}
else
{
if (m_led_sb.duty_cycle <= (m_led_sb.params.duty_cycle_min + m_led_sb.params.duty_cycle_step))
{
// Min PWM duty cycle is reached, start incrementing.
m_led_sb.is_counting_up = true;
m_led_sb.duty_cycle = m_led_sb.params.duty_cycle_min;
pause_ticks = m_led_sb.params.off_time_ticks ? m_led_sb.params.off_time_ticks + APP_TIMER_MIN_TIMEOUT_TICKS : 0;
}
else
{
m_led_sb.duty_cycle -= m_led_sb.params.duty_cycle_step;
}
}
}
else
{
pause_ticks -= PWM_PERIOD;
}
err_code = low_power_pwm_duty_set(&m_led_sb.pwm_instance, m_led_sb.duty_cycle);
APP_ERROR_CHECK(err_code);
}
ret_code_t led_softblink_init(led_sb_init_params_t const * p_init_params)
{
ret_code_t err_code;
ASSERT(m_led_sb.led_sb_state == NRF_DRV_STATE_UNINITIALIZED);
ASSERT(p_init_params);
if ( (p_init_params->duty_cycle_max == 0) ||
(p_init_params->duty_cycle_max <= p_init_params->duty_cycle_min) ||
(p_init_params->duty_cycle_step == 0) ||
(p_init_params->leds_pin_bm == 0))
{
return NRF_ERROR_INVALID_PARAM;
}
memset(&m_led_sb, 0, sizeof(led_sb_context_t));
memcpy(&m_led_sb.params, p_init_params, sizeof(led_sb_init_params_t));
m_led_sb.is_counting_up = true;
m_led_sb.duty_cycle = p_init_params->duty_cycle_min + p_init_params->duty_cycle_step;
m_led_sb.leds_is_on = false;
m_led_sb.bit_mask = p_init_params->leds_pin_bm;
APP_TIMER_DEF(led_softblink_timer);
m_led_sb.pwm_config.active_high = m_led_sb.params.active_high;
m_led_sb.pwm_config.bit_mask = p_init_params->leds_pin_bm;
m_led_sb.pwm_config.p_port = p_init_params->p_leds_port;
m_led_sb.pwm_config.period = PWM_PERIOD;
m_led_sb.pwm_config.p_timer_id = &led_softblink_timer;
err_code = low_power_pwm_init( &m_led_sb.pwm_instance, &m_led_sb.pwm_config, led_softblink_on_timeout);
if (err_code == NRF_SUCCESS)
{
m_led_sb.led_sb_state = NRF_DRV_STATE_INITIALIZED;
}
else
{
return err_code;
}
err_code = low_power_pwm_duty_set( &m_led_sb.pwm_instance, p_init_params->duty_cycle_min + p_init_params->duty_cycle_step);
return err_code;
}
ret_code_t led_softblink_start(uint32_t leds_pin_bit_mask)
{
ret_code_t err_code;
ASSERT(m_led_sb.led_sb_state == NRF_DRV_STATE_INITIALIZED);
err_code = low_power_pwm_start(&m_led_sb.pwm_instance, leds_pin_bit_mask);
return err_code;
}
ret_code_t led_softblink_stop(void)
{
ret_code_t err_code;
err_code = low_power_pwm_stop(&m_led_sb.pwm_instance);
return err_code;
}
void led_softblink_off_time_set(uint32_t off_time_ticks)
{
ASSERT(m_led_sb.led_sb_state != NRF_DRV_STATE_UNINITIALIZED);
m_led_sb.params.off_time_ticks = off_time_ticks;
}
void led_softblink_on_time_set(uint32_t on_time_ticks)
{
ASSERT(m_led_sb.led_sb_state != NRF_DRV_STATE_UNINITIALIZED);
m_led_sb.params.on_time_ticks = on_time_ticks;
}
ret_code_t led_softblink_uninit(void)
{
ASSERT(m_led_sb.led_sb_state != NRF_DRV_STATE_UNINITIALIZED);
ret_code_t err_code;
err_code = led_softblink_stop();
if (err_code == NRF_SUCCESS)
{
m_led_sb.led_sb_state = NRF_DRV_STATE_UNINITIALIZED;
}
else
{
return err_code;
}
memset(&m_led_sb, 0, sizeof(m_led_sb));
return NRF_SUCCESS;
}
#endif //NRF_MODULE_ENABLED(LED_SOFTBLINK)

View File

@@ -0,0 +1,172 @@
/**
* Copyright (c) 2015 - 2017, 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.
*
*/
/** @file
*
* @defgroup led_softblink LED softblink
* @{
* @ingroup app_common
*
* @brief Module for generating a changing pulse-width modulated output signal that is used to smoothly blink LEDs.
*
* @details This module provides an LED softblink implementation using timers and GPIO.
*
* LED softblink needs one timer. It can use any number of output channels that are available.
*
* Only one instance of LED softblink can run at a time.
*/
#ifndef LED_SOFTBLINK_H__
#define LED_SOFTBLINK_H__
#include <stdbool.h>
#include <stdint.h>
#include "sdk_errors.h"
#include "nrf_gpio.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Structure holding the initialization parameters.
*/
typedef struct
{
bool active_high; /**< Activate negative polarity. */
uint8_t duty_cycle_max; /**< Maximum impulse width. */
uint8_t duty_cycle_min; /**< Minimum impulse width. */
uint8_t duty_cycle_step; /**< Cycle step. */
uint32_t off_time_ticks; /**< Ticks to stay in low impulse state. */
uint32_t on_time_ticks; /**< Ticks to stay in high impulse state. */
uint32_t leds_pin_bm; /**< Mask of used LEDs. */
NRF_GPIO_Type * p_leds_port; /**< Port of used LEDs mask. */
}led_sb_init_params_t;
/**
* @name Default settings
* @brief Default settings for LED softblink.
* @{
*/
#define LED_SB_INIT_PARAMS_ACTIVE_HIGH false
#define LED_SB_INIT_PARAMS_DUTY_CYCLE_MAX 220
#define LED_SB_INIT_PARAMS_DUTY_CYCLE_MIN 0
#define LED_SB_INIT_PARAMS_DUTY_CYCLE_STEP 5
#define LED_SB_INIT_PARAMS_OFF_TIME_TICKS 65536
#define LED_SB_INIT_PARAMS_ON_TIME_TICKS 0
#define LED_SB_INIT_PARAMS_LEDS_PIN_BM(mask) (mask)
#define LED_SB_INIT_PARAMS_LEDS_PORT NRF_GPIO
/** @} */
/**
* @brief LED softblink default configuration.
*/
#define LED_SB_INIT_DEFAULT_PARAMS(mask) \
{ \
.active_high = LED_SB_INIT_PARAMS_ACTIVE_HIGH, \
.duty_cycle_max = LED_SB_INIT_PARAMS_DUTY_CYCLE_MAX, \
.duty_cycle_min = LED_SB_INIT_PARAMS_DUTY_CYCLE_MIN, \
.duty_cycle_step = LED_SB_INIT_PARAMS_DUTY_CYCLE_STEP, \
.off_time_ticks = LED_SB_INIT_PARAMS_OFF_TIME_TICKS, \
.on_time_ticks = LED_SB_INIT_PARAMS_ON_TIME_TICKS, \
.leds_pin_bm = LED_SB_INIT_PARAMS_LEDS_PIN_BM(mask), \
.p_leds_port = LED_SB_INIT_PARAMS_LEDS_PORT \
}
/**
* @brief Function for initializing LED softblink.
*
* @param[in] p_init_params Pointer to the initialization structure.
*
* @return Values returned by @ref app_timer_create.
*/
ret_code_t led_softblink_init(led_sb_init_params_t const * p_init_params);
/**
* @brief Function for starting to blink LEDs.
*
* @param[in] leds_pin_bit_mask Bit mask containing the pins for the LEDs to be blinked.
*
* @return Values returned by @ref app_timer_start.
*/
ret_code_t led_softblink_start(uint32_t leds_pin_bit_mask);
/**
* @brief Function for stopping to blink LEDs.
*
* @return Values returned by @ref app_timer_stop.
*/
ret_code_t led_softblink_stop(void);
/**
* @brief Function for setting the off time.
*
* This function configures the time that the LEDs will be off between each blink.
*
* @param[in] off_time_ticks Off time in ticks.
*
*/
void led_softblink_off_time_set(uint32_t off_time_ticks);
/**
* @brief Function for setting the on time.
*
* This function configures the time that the LEDs will be on between each blink.
*
* @param[in] on_time_ticks On time in ticks.
*
*/
void led_softblink_on_time_set(uint32_t on_time_ticks);
/**
* @brief Function for uninitializing LED softblink.
*
* @retval NRF_SUCCESS If LED softblink was uninitialized successfully.
*/
ret_code_t led_softblink_uninit(void);
#ifdef __cplusplus
}
#endif
#endif // LED_SOFTBLINK_H__
/** @} */