/* * Copyright (c) 2022 - 2024, Nordic Semiconductor ASA * All rights reserved. * * SPDX-License-Identifier: BSD-3-Clause * * 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 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 the copyright holder nor the names of its * contributors may be used to endorse or promote products derived from this * software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER 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 #include #define NRFX_LOG_MODULE EXAMPLE #define NRFX_EXAMPLE_CONFIG_LOG_ENABLED 1 #define NRFX_EXAMPLE_CONFIG_LOG_LEVEL 3 #include /** * @defgroup nrfx_pwm_grouped_example Grouped mode PWM example * @{ * @ingroup nrfx_pwm_examples * * @brief Example showing basic functionality of nrfx_pwm driver for sequences loaded in grouped * mode. * * @details Application initializes nrfx_pmw driver. It starts two-sequence playback on LEDs and * replays this sequence @ref NUM_OF_LOOPS times. The @ref pwm_handler() is executed with * relevant log message after every loop. Additionally, it changes SEQ1 each time it is * called. */ /** @brief Symbol specifying PWM instance to be used. */ #define PWM_INST_IDX 0 /** * @brief Symbol specifying number of times that each duty cycle is to be repeated (after being * played once) and is strictly correlated with the speed of LEDs brightness change. */ #define VALUE_REPEATS 220UL /** * @brief Symbol specifying number of loops to be performed (one loop means to complete * SEQ0 and SEQ1 @ref PLAYBACK_COUNT times). */ #define NUM_OF_LOOPS 6UL /** * @brief Symbol specifying number of playbacks to be performed. In this example couple of * playbacks might be considered as one loop. */ #define PLAYBACK_COUNT 1UL /** * @brief Sequence default configuration in NRF_PWM_LOAD_GROUPED mode. * * This configuration sets up sequence with the following options: * - end delay: 0 PWM periods * - length: actual number of 16-bit values in the array pointed by @p _pwm_val * - repeats: VALUE_REPEATS * * @param[in] _pwm_val pointer to an array with duty cycle values. */ #define SEQ_CONFIG(_pwm_val) \ { \ .values.p_grouped = _pwm_val, \ .length = 2 * NRFX_ARRAY_SIZE(_pwm_val), \ .repeats = VALUE_REPEATS, \ .end_delay = 0 \ } /** @brief Array with duty cycle values that are used to achieve blinking effect on LEDs. */ static nrf_pwm_values_grouped_t pwm_val0[] = { {100, 1000}, {1000, 100}, {100, 1000}, {1000, 100}, {100, 1000}, {1000, 100} }; /** @brief Array with duty cycle values that are used to achieve smooth brightness change effect on LEDs. */ static nrf_pwm_values_grouped_t pwm_val1[] = { {0, 1000}, {100, 900}, {200, 800}, {300, 700}, {400, 600}, {500, 500}, {600, 400}, {700, 300}, {800, 200}, {900, 100}, {1000, 0} }; /** @brief Array with duty cycle values that are used to achieve slight breath effect on LEDs. */ static nrf_pwm_values_grouped_t pwm_val2[] = { {0, 0}, {25, 25}, {50, 50}, {75, 75}, {100, 100}, {125, 125}, {150, 150}, {125, 125}, {100, 100}, {75, 75}, {50, 50}, {25, 25}, {0, 0} }; /** @brief Array containing sequences to be used in this example. */ static nrf_pwm_sequence_t seq[] = { SEQ_CONFIG(pwm_val0), SEQ_CONFIG(pwm_val1), SEQ_CONFIG(pwm_val2) }; /** * @brief Function for handling PWM driver events. * * @param[in] event_type PWM event. * @param[in] p_context General purpose parameter set during initialization of * the timer. This parameter can be used to pass * additional information to the handler function. */ static void pwm_handler(nrfx_pwm_evt_type_t event_type, void * p_context) { nrfx_pwm_t * inst = p_context; static uint32_t m_curr_loop = 1; static bool m_playback_mode = false; m_playback_mode = !m_playback_mode; NRFX_LOG_INFO("Loops: %u / %lu", m_curr_loop, NUM_OF_LOOPS); if (m_playback_mode) { nrfx_pwm_sequence_update(inst, 1, &seq[2]); NRFX_LOG_INFO("SEQ1 changed to sequence number 2 from the seq array"); } else { nrfx_pwm_sequence_update(inst, 1, &seq[1]); NRFX_LOG_INFO("SEQ1 changed to sequence number 1 from the seq array"); } if (m_curr_loop == NUM_OF_LOOPS) { NRFX_LOG_INFO("PWM finished"); nrfx_pwm_uninit(inst); } m_curr_loop++; } /** * @brief Function for application main entry. * * @return Nothing. */ int main(void) { nrfx_err_t status; (void)status; #if defined(__ZEPHYR__) IRQ_CONNECT(NRFX_IRQ_NUMBER_GET(NRF_PWM_INST_GET(PWM_INST_IDX)), IRQ_PRIO_LOWEST, NRFX_PWM_INST_HANDLER_GET(PWM_INST_IDX), 0, 0); #endif NRFX_EXAMPLE_LOG_INIT(); NRFX_LOG_INFO("Starting nrfx_pwm example for sequences loaded in grouped mode."); NRFX_EXAMPLE_LOG_PROCESS(); nrfx_pwm_t pwm_instance = NRFX_PWM_INSTANCE(PWM_INST_IDX); nrfx_pwm_config_t config = NRFX_PWM_DEFAULT_CONFIG(LED1_PIN, LED4_PIN, LED2_PIN, LED3_PIN); config.load_mode = NRF_PWM_LOAD_GROUPED; status = nrfx_pwm_init(&pwm_instance, &config, pwm_handler, &pwm_instance); NRFX_ASSERT(status == NRFX_SUCCESS); nrfx_pwm_complex_playback(&pwm_instance, &seq[0], &seq[1], PLAYBACK_COUNT, NRFX_PWM_FLAG_LOOP); while (1) { NRFX_EXAMPLE_LOG_PROCESS(); } } /** @} */