+ * TCC Module Event Actions
+ *
+ * | Event action |
+ * Description |
+ * Applied event |
+ *
+ *
+ * | TCC_EVENT_ACTION_OFF |
+ * No action on the event input |
+ * All |
+ *
+ *
+ * | TCC_EVENT_ACTION_RETRIGGER |
+ * Re-trigger Counter on event |
+ * All |
+ *
+ *
+ * | TCC_EVENT_ACTION_NON_RECOVERABLE_FAULT |
+ * Generate Non-Recoverable Fault on event |
+ * All |
+ *
+ *
+ * | TCC_EVENT_ACTION_START |
+ * Counter start on event |
+ * EV0 |
+ *
+ *
+ * | TCC_EVENT_ACTION_DIR_CONTROL |
+ * Counter direction control |
+ * EV0 |
+ *
+ *
+ * | TCC_EVENT_ACTION_DECREMENT |
+ * Counter decrement on event |
+ * EV0 |
+ *
+ *
+ * | TCC_EVENT_ACTION_PERIOD_PULSE_WIDTH_CAPTURE |
+ * Capture pulse period and pulse width |
+ * EV0 |
+ *
+ *
+ * | TCC_EVENT_ACTION_PULSE_WIDTH_PERIOD_CAPTURE |
+ * Capture pulse width and pulse period |
+ * EV0 |
+ *
+ *
+ * | TCC_EVENT_ACTION_STOP |
+ * Counter stop on event |
+ * EV1 |
+ *
+ *
+ * | TCC_EVENT_ACTION_COUNT_EVENT |
+ * Counter count on event |
+ * EV1 |
+ *
+ *
+ * | TCC_EVENT_ACTION_INCREMENT |
+ * Counter increment on event |
+ * EV1 |
+ *
+ *
+ * | TCC_EVENT_ACTION_COUNT_DURING_ACTIVE |
+ * Counter count during active state of asynchronous event |
+ * EV1 |
+ *
+ *
+ *
+ * \subsubsection asfdoc_sam0_tcc_module_overview_tc_reload Timer/Counter Reloading
+ *
+ * The TCC also has a configurable reload action, used when a
+ * re-trigger event occurs. Examples of a re-trigger event could be the counter
+ * reaching the maximum value when counting up, or when an event from the event
+ * system makes the counter to re-trigger. The reload action determines if the
+ * prescaler should be reset, and on which clock. The counter will
+ * always be reloaded with the value it is set to start counting. The user
+ * can choose between three different reload actions, described in
+ * \ref asfdoc_sam0_tcc_module_reload_act "the table below".
+ *
+ * \anchor asfdoc_sam0_tcc_module_reload_act
+ *
+ * TCC Module Recoverable Fault Capture Actions
+ *
+ * | Action |
+ * Description |
+ *
+ *
+ * | TCC_FAULT_CAPTURE_DISABLE |
+ * Capture action is disabled |
+ *
+ *
+ * | TCC_FAULT_CAPTURE_EACH |
+ * Equivalent to standard capture operation, on each fault occurrence
+ * the time stamp is captured |
+ *
+ *
+ * | TCC_FAULT_CAPTURE_MINIMUM |
+ * Get the minimum time stamped value in all time stamps |
+ *
+ *
+ * | TCC_FAULT_CAPTURE_MAXIMUM |
+ * Get the maximum time stamped value in all time stamps |
+ *
+ *
+ * | TCC_FAULT_CAPTURE_SMALLER |
+ * Time stamp the fault input if the value is smaller than last one |
+ *
+ *
+ * | TCC_FAULT_CAPTURE_BIGGER |
+ * Time stamp the fault input if the value is bigger than last one |
+ *
+ *
+ * | TCC_FAULT_CAPTURE_CHANGE |
+ * Time stamp the fault input if the time stamps changes its increment
+ * direction |
+ *
+ *
+ *
+ * In TCC module, only the first two compare channels (CC0 and CC1) can work
+ * with recoverable fault inputs. The corresponding event inputs (TCCx MC0
+ * and TCCx MC1) are then used as fault inputs respectively.
+ * The faults are called Fault A and Fault B.
+ *
+ * The recoverable fault can be filtered or effected by corresponding channel
+ * output. On fault condition there are many other settings that can be chosen.
+ * Refer to data sheet for more details about the recoverable fault
+ * operations.
+ *
+ * \subsubsection asfdoc_sam0_tcc_module_overview_ext_n_fault Non-Recoverable Faults
+ *
+ * The non-recoverable faults force all the TCC output pins to a pre-defined
+ * level (can be forced to 0 or 1). The input control signal of non-recoverable
+ * fault is from timer/counter event (TCCx EV0 and TCCx EV1).
+ * To enable non-recoverable fault,
+ * corresponding TCEx event action must be set to non-recoverable fault action
+ * (\ref TCC_EVENT_ACTION_NON_RECOVERABLE_FAULT).
+ * Refer to \ref asfdoc_sam0_tcc_module_overview_tc_ctrl to see the available
+ * event input action.
+ *
+ * \subsection asfdoc_sam0_tcc_module_overview_buffering Double and Circular Buffering
+ *
+ * The pattern, period, and the compare channels registers are double buffered.
+ * For these options there are effective registers (PATT, PER, and CCx) and
+ * buffer registers (PATTB, PERB, and CCx). When writing to the buffer
+ * registers, the values are buffered and will be committed to effective
+ * registers on UPDATE condition.
+ *
+ * Usually the buffered value is cleared after it is committed, but there is also
+ * an option to circular the register buffers. The period (PER) and four lowest
+ * compare channels register (CCx, x is 0 ~ 3) support this function. When
+ * circular buffer is used, on UPDATE the previous period or compare values are
+ * copied back into the corresponding period buffer and compare buffers.
+ * This way, the register value and its buffer register value is actually
+ * switched on UPDATE condition, and will be switched back on next UPDATE
+ * condition.
+ *
+ * For input capture, the buffer register (CCBx) and the corresponding capture
+ * channel register (CCx) act like a FIFO. When regular register (CCx) is empty
+ * or read, any content in the buffer register is passed to regular one.
+ *
+ * In TCC module driver, when the double buffering write is enabled, any
+ * write through \ref tcc_set_top_value(), \ref tcc_set_compare_value(), and
+ * \ref tcc_set_pattern() will be done to the corresponding buffer register.
+ * Then the value in the buffer register will be transferred to the regular
+ * register on the next UPDATE condition or by a force UPDATE using
+ * \ref tcc_force_double_buffer_update().
+ *
+ * \subsection asfdoc_sam0_tcc_module_overview_sleep Sleep Mode
+ *
+ * TCC modules can be configured to operate in any sleep mode, with its "run
+ * in standby" function enabled. It can wake up the device using interrupts or
+ * perform internal actions with the help of the Event System.
+ *
+ * \section asfdoc_sam0_tcc_special_considerations Special Considerations
+ *
+ * \subsection asfdoc_sam0_tcc_special_considerations_specific_features Driver Feature Macro Definition
+ * \ref asfdoc_sam0_tcc_feature_table "The table below" shows some specific features
+ * of the TCC Module.
+ *
+ * \anchor asfdoc_sam0_tcc_feature_table
+ *