//! [callback_eic] static void eic_callback_to_clear_halt(void) { if (port_pin_get_input_level(CONF_FAULT_EIC_PIN)) { tcc_clear_status(&tcc_instance, TCC_STATUS_RECOVERABLE_FAULT_PRESENT(CONF_PWM_CHANNEL) | TCC_STATUS_RECOVERABLE_FAULT_OCCUR(CONF_PWM_CHANNEL)); } }
/** * \brief Retrieves the current module status. * * Retrieves the status of the module, giving overall state information. * * \param[in] module_inst Pointer to the TCC software instance struct * * \return Bitmask of \c TCC_STATUS_* flags. * * \retval TCC_STATUS_CHANNEL_MATCH_CAPTURE(n) Channel n match/capture has occured * \retval TCC_STATUS_CHANNEL_OUTPUT(n) Channel n match/capture output state * \retval TCC_STATUS_NON_RECOVERABLE_FAULT_OCCUR(x) Non-recoverable fault x has occured * \retval TCC_STATUS_RECOVERABLE_FAULT_OCCUR(n) Recoverable fault n has occured * \retval TCC_STATUS_NON_RECOVERABLE_FAULT_PRESENT(x) Non-recoverable fault x input present * \retval TCC_STATUS_RECOVERABLE_FAULT_PRESENT(n) Recoverable fault n input present * \retval TCC_STATUS_SYNC_READY None of register is syncing * \retval TCC_STATUS_CAPTURE_OVERFLOW Timer capture data has overflowed * \retval TCC_STATUS_COUNTER_EVENT Timer counter event has occurred * \retval TCC_STATUS_COUNT_OVERFLOW Timer count value has overflowed * \retval TCC_STATUS_COUNTER_RETRIGGERED Timer counter has been retriggered * \retval TCC_STATUS_STOP Timer counter has been stopped * \retval TCC_STATUS_RAMP_CYCLE_INDEX Wave ramp index for cycle */ uint32_t tcc_get_status( struct tcc_module *const module_inst) { /* Sanity check arguments */ Assert(module_inst); Assert(module_inst->hw); uint32_t int_flags = module_inst->hw->INTFLAG.reg; uint32_t status_flags = module_inst->hw->STATUS.reg; uint32_t status = 0; int i; /* SYNC */ if (module_inst->hw->SYNCBUSY.reg == 0) { status |= TCC_STATUS_SYNC_READY; } /* Channels */ for (i = 0; i < TCC_NUM_CHANNELS; i++) { if (int_flags & TCC_INTFLAG_MC(i)) { status |= TCC_STATUS_CHANNEL_MATCH_CAPTURE(i); } if (status_flags & TCC_STATUS_CMP(i)) { status |= TCC_STATUS_CHANNEL_OUTPUT(i); } } /* Non-recoverable fault state */ if ((int_flags & TCC_INTFLAG_FAULT1) || (status_flags & TCC_STATUS_FAULT1)) { status |= TCC_STATUS_NON_RECOVERABLE_FAULT_OCCUR(1); } if ((int_flags & TCC_INTFLAG_FAULT0) || (status_flags & TCC_STATUS_FAULT0)) { status |= TCC_STATUS_NON_RECOVERABLE_FAULT_OCCUR(0); } /* Non-recoverable fault inputs */ if (status_flags & TCC_STATUS_FAULT0IN) { status |= TCC_STATUS_NON_RECOVERABLE_FAULT_PRESENT(0); } if (status_flags & TCC_STATUS_FAULT1IN) { status |= TCC_STATUS_NON_RECOVERABLE_FAULT_PRESENT(1); } /* Recoverable fault state */ if ((int_flags & TCC_INTFLAG_FAULTB) || (status_flags & TCC_STATUS_FAULTB)) { status |= TCC_STATUS_RECOVERABLE_FAULT_OCCUR(1); } if ((int_flags & TCC_INTFLAG_FAULTA) || (status_flags & TCC_STATUS_FAULTA)) { status |= TCC_STATUS_RECOVERABLE_FAULT_OCCUR(0); } /* Recoverable fault inputs */ if (status_flags & TCC_STATUS_FAULTAIN) { status |= TCC_STATUS_RECOVERABLE_FAULT_PRESENT(0); } if (status_flags & TCC_STATUS_FAULTBIN) { status |= TCC_STATUS_RECOVERABLE_FAULT_PRESENT(1); } /* Check for TCC capture overflow */ if (int_flags & TCC_INTFLAG_ERR) { status |= TCC_STATUS_CAPTURE_OVERFLOW; } /* Check for TCC count counter */ if (int_flags & TCC_INTFLAG_CNT) { status |= TCC_STATUS_COUNTER_EVENT; } /* Check for TCC count retrigger */ if (int_flags & TCC_INTFLAG_TRG) { status |= TCC_STATUS_COUNTER_RETRIGGERED; } /* Check for TCC count overflow */ if (int_flags & TCC_INTFLAG_OVF) { status |= TCC_STATUS_COUNT_OVERFLOW; } /* Check for TCC count stop */ if (status_flags & TCC_STATUS_STOP) { status |= TCC_STATUS_STOPPED; } return status; }
/** * \internal * \brief Test capture and compare * * This test uses TCC0 as a PWM generator (compare function). TCC1 will be set * to capture the signal from TCC0 to test the capture functionality. * * \param test Current test case. */ static void run_capture_and_compare_test(const struct test_case *test) { test_assert_true(test, tcc_init_success == true, "TCC initialization failed, skipping test"); test_assert_true(test, callback_function_entered == 1, "The callback test has failed, skipping test"); /* Configure TCC module for PWM generation */ tcc_reset(&tcc_test0_module); tcc_get_config_defaults(&tcc_test0_config, CONF_TEST_TCC0); tcc_test0_config.counter.period = 0x03FF; tcc_test0_config.compare.wave_generation = TCC_WAVE_GENERATION_SINGLE_SLOPE_PWM; tcc_test0_config.compare.match[TCC_MATCH_CAPTURE_CHANNEL_0] = 0x01FF; /* Calculate the theoretical PWM frequency & duty */ uint32_t frequency_output, duty_output; frequency_output = system_clock_source_get_hz(SYSTEM_CLOCK_SOURCE_OSC8M) / (0x03FF+1); /* This value is depend on the WaveGeneration Mode */ duty_output = (uint32_t)(tcc_test0_config.compare.match[TCC_MATCH_CAPTURE_CHANNEL_0] * 100) / tcc_test0_config.counter.period; tcc_test0_config.pins.enable_wave_out_pin[TCC_MATCH_CAPTURE_CHANNEL_0] = true; tcc_test0_config.pins.wave_out_pin[TCC_MATCH_CAPTURE_CHANNEL_0] = CONF_TEST_PIN_OUT; tcc_test0_config.pins.wave_out_pin_mux[TCC_MATCH_CAPTURE_CHANNEL_0] = CONF_TEST_PIN_MUX; tcc_init(&tcc_test0_module, CONF_TEST_TCC0, &tcc_test0_config); tcc_register_callback(&tcc_test0_module, tcc_callback_function, TCC_CALLBACK_CHANNEL_0); tcc_enable_callback(&tcc_test0_module, TCC_CALLBACK_CHANNEL_0); /* Configure TCC module for capture */ tcc_reset(&tcc_test1_module); tcc_get_config_defaults(&tcc_test1_config, CONF_TEST_TCC1); tcc_test1_config.counter.period = 0xFFFF; tcc_test1_config.counter.clock_prescaler = TCC_CLOCK_PRESCALER_DIV1; tcc_test1_config.capture.channel_function[CONF_CAPTURE_CHAN_0] = TCC_CHANNEL_FUNCTION_CAPTURE; tcc_test1_config.capture.channel_function[CONF_CAPTURE_CHAN_1] = TCC_CHANNEL_FUNCTION_CAPTURE; tcc_init(&tcc_test1_module, CONF_TEST_TCC1, &tcc_test1_config); struct tcc_events tcc_events = { .on_input_event_perform_action[1] = true, .input_config[1].modify_action = true, .input_config[1].action = TCC_EVENT_ACTION_PERIOD_PULSE_WIDTH_CAPTURE }; tcc_enable_events(&tcc_test1_module, &tcc_events); /* Configure external interrupt controller */ struct extint_chan_conf extint_chan_config; extint_chan_config.gpio_pin = CONF_EIC_PIN; extint_chan_config.gpio_pin_mux = CONF_EIC_MUX; extint_chan_config.gpio_pin_pull = EXTINT_PULL_UP; extint_chan_config.wake_if_sleeping = false; extint_chan_config.filter_input_signal = false; extint_chan_config.detection_criteria = EXTINT_DETECT_HIGH; extint_chan_set_config(CONF_EIC_CHAN, &extint_chan_config); /* Configure external interrupt module to be event generator */ struct extint_events extint_event_conf; extint_event_conf.generate_event_on_detect[CONF_EIC_CHAN] = true; extint_enable_events(&extint_event_conf); /* Configure event system */ struct events_resource event_res; /* Configure channel */ struct events_config config; events_get_config_defaults(&config); config.generator = CONF_EVENT_GENERATOR_ID; config.edge_detect = EVENTS_EDGE_DETECT_NONE; config.path = EVENTS_PATH_ASYNCHRONOUS; events_allocate(&event_res, &config); /* Configure user */ events_attach_user(&event_res, CONF_EVENT_USED_ID); /* Enable TCC modules */ tcc_enable(&tcc_test1_module); tcc_enable(&tcc_test0_module); uint16_t period_after_capture = 0; uint16_t pulse_width_after_capture = 0; uint32_t capture_frequency = 0; uint32_t capture_duty = 0; while (callback_function_entered < 4) { period_after_capture = tcc_get_capture_value(&tcc_test1_module, TCC_MATCH_CAPTURE_CHANNEL_0); pulse_width_after_capture = tcc_get_capture_value(&tcc_test1_module, TCC_MATCH_CAPTURE_CHANNEL_1); } if(period_after_capture != 0) { capture_frequency = system_clock_source_get_hz(SYSTEM_CLOCK_SOURCE_OSC8M) / period_after_capture; capture_duty = (uint32_t)(pulse_width_after_capture) * 100 / period_after_capture; } test_assert_true(test, (capture_frequency <= (frequency_output * (100 + CONF_TEST_TOLERANCE) / 100)) && \ (capture_frequency >= (frequency_output * (100 - CONF_TEST_TOLERANCE) / 100)) && \ (capture_duty <= (duty_output * (100 + CONF_TEST_TOLERANCE) / 100)) && \ (capture_duty >= (duty_output * (100 - CONF_TEST_TOLERANCE) / 100)) \ ,"The result of Capture is wrong, captured frequency: %ldHz, captured duty: %ld%%", capture_frequency, capture_duty ); } /** * \internal * \brief Test Recoverable Fault (FAULTn) * * This test uses TCC0 as a PWM generator (compare function). * EXTINT will be used to route fault input to TCC0. * * \param test Current test case. */ static void run_faultn_test(const struct test_case *test) { test_assert_true(test, tcc_init_success == true, "TCC initialization failed, skipping test"); /* Configure TCC module for PWM generation with fault */ tcc_reset(&tcc_test0_module); tcc_get_config_defaults(&tcc_test0_config, CONF_TEST_TCC0); tcc_test0_config.counter.period = 0x03FF; tcc_test0_config.compare.wave_generation = TCC_WAVE_GENERATION_SINGLE_SLOPE_PWM; tcc_test0_config.compare.match[TCC_MATCH_CAPTURE_CHANNEL_0] = 0x01FF; tcc_test0_config.wave_ext.recoverable_fault[TCC_MATCH_CAPTURE_CHANNEL_0].source = TCC_FAULT_SOURCE_ENABLE; tcc_test0_config.wave_ext.recoverable_fault[TCC_MATCH_CAPTURE_CHANNEL_0].halt_action = TCC_FAULT_HALT_ACTION_SW_HALT; tcc_init(&tcc_test0_module, CONF_TEST_TCC0, &tcc_test0_config); /* Configure TCC events for recoverable fault input */ struct tcc_events tcc_test_events; memset(&tcc_test_events, 0, sizeof(struct tcc_events)); tcc_test_events.on_event_perform_channel_action[TCC_MATCH_CAPTURE_CHANNEL_0] = true; tcc_enable_events(&tcc_test0_module, &tcc_test_events); tcc_enable(&tcc_test0_module); /* Configure IO pin to generate fault */ struct port_config config_pin; port_get_config_defaults(&config_pin); config_pin.direction = PORT_PIN_DIR_OUTPUT; port_pin_set_config(CONF_TEST_PIN_OUT, &config_pin); port_pin_set_output_level(CONF_TEST_PIN_OUT, true); /* Configure EIC to capture fault input */ struct extint_chan_conf config; extint_chan_get_config_defaults(&config); config.filter_input_signal = true; config.detection_criteria = EXTINT_DETECT_BOTH; config.gpio_pin = CONF_EIC_PIN; config.gpio_pin_mux = CONF_EIC_MUX; extint_chan_set_config(CONF_EIC_CHAN, &config); struct extint_events extint_test_events; memset(&extint_test_events, 0, sizeof(struct extint_events)); extint_test_events.generate_event_on_detect[CONF_EIC_CHAN] = true; extint_enable_events(&extint_test_events); /* Configure EVENTs to route fault input */ struct events_resource event_resource; struct events_config event_config; events_get_config_defaults(&event_config); event_config.generator = CONF_EVENT_GENERATOR_ID; event_config.path = EVENTS_PATH_ASYNCHRONOUS; events_allocate(&event_resource, &event_config); events_attach_user(&event_resource, CONF_EVENT_USER_ID_FAULTn); /* Clear halt status */ tcc_clear_status(&tcc_test0_module, TCC_STATUS_RECOVERABLE_FAULT_PRESENT(0) | TCC_STATUS_RECOVERABLE_FAULT_OCCUR(0)); uint32_t test_val1 = tcc_get_count_value(&tcc_test0_module); uint32_t test_val2 = tcc_get_count_value(&tcc_test0_module); /* Check TCC is running */ test_assert_true(test, test_val1 != test_val2, "The counter failed to stop on recoverable fault"); /* Set fault */ port_pin_set_output_level(CONF_TEST_PIN_OUT, false); /* Check fault state */ test_assert_true(test, TCC_STATUS_RECOVERABLE_FAULT_OCCUR(0) & tcc_get_status(&tcc_test0_module), "The counter failed to detect recoverable fault"); /* Check TCC is running */ test_val1 = tcc_get_count_value(&tcc_test0_module); test_val2 = tcc_get_count_value(&tcc_test0_module); test_assert_true(test, test_val1 == test_val2, "The counter failed to stop on recoverable fault"); }