/** @file exti.h
 * Module handling EXTernal Interrupt lines
 *
 * The module provides functions to configure the exti lines to generate events
 * or interrupts
 */

#ifndef _EXTI_H_
#define _EXTI_H_

//--includes--------------------------------------------------------------------

#include "stdint.h"
#include "stdbool.h"

#include "gpio.h"


//--type definitions------------------------------------------------------------

/**
 * Available exti lines. These lines correspond to gpios
 */
enum ExtiLine {
	EXTI_LINE_0  = (0x1 <<  0),
	EXTI_LINE_1  = (0x1 <<  1),
	EXTI_LINE_2  = (0x1 <<  2),
	EXTI_LINE_3  = (0x1 <<  3),
	EXTI_LINE_4  = (0x1 <<  4),
	EXTI_LINE_5  = (0x1 <<  5),
	EXTI_LINE_6  = (0x1 <<  6),
	EXTI_LINE_7  = (0x1 <<  7),
	EXTI_LINE_8  = (0x1 <<  8),
	EXTI_LINE_9  = (0x1 <<  9),
	EXTI_LINE_10 = (0x1 << 10),
	EXTI_LINE_11 = (0x1 << 11),
	EXTI_LINE_12 = (0x1 << 12),
	EXTI_LINE_13 = (0x1 << 13),
	EXTI_LINE_14 = (0x1 << 14),
	EXTI_LINE_15 = (0x1 << 15),
};

/**
 * Available exti lines. These lines correspond to specific peripherals
 */
enum ExtiLineSpecific {
	EXTI_LINE_PVD = (0x1 << 16),
	EXTI_LINE_RTC = (0x1 << 17),
	EXTI_LINE_USB = (0x1 << 18),
};

/**
 * Available configurations for exti lines. These configurations apply to both
 * regular and specific lines and can be used together on a single line
 */
enum ExtiConfig {
	EXTI_CONFIG_RISING_EDGE  = (0x1 << 0),
	EXTI_CONFIG_FALLING_EDGE = (0x1 << 1),
};

typedef void (*ExtiCallback)(void);


//--functions-------------------------------------------------------------------

/**
 * Configure lines on a single GPIO port. The ExtiLine enum can be used as a
 * mask to configure multiple lines at the same time. Every line can only be
 * configured for a single port, reconfiguring it will override the previous
 * configuration. Each line is linked to the pins of the same id (ex : pin 1 for
 * exti 1). When possible, it is recommanded to use the lowest id possible for
 * better performance. The ExtiConfig enum can be used as mask. If no callback
 * is specified, the interrupt won't be enabled, but an event will still be sent
 * to wake the cpu up.
 *
 * Note: wich port is linked to a line can be changed atfer the fact using
 * afio_map_exti()
 */
void exti_configure(enum ExtiLine line_mask, enum GpioPort port,
		enum ExtiConfig config_mask, ExtiCallback callback);

/**
 * Resets lines. The ExtiLine enum can be used as a mask to configure multiple
 * lines at the same time
 */
void exti_reset(enum ExtiLine line_mask);

/**
 * Configure lines for specific, non-gpio peripherals. The ExtiLineSpecific enum
 * can be used as a mask to configure multiple lines at the same time. The
 * ExtiConfig enum can be used as mask. If no callback is specified, the
 * interrupt won't be enabled, but an event will still be sent to wake the cpu
 * up
 */
void exti_configure_specific(enum ExtiLineSpecific line_mask,
		enum ExtiConfig config_mask, ExtiCallback callback);

/**
 * Resets lines for specific, non-gpio peripherals. The ExtiLineSpecific enum
 * can be used as a mask to configure multiple lines at the same time.
 */
void exti_reset_specific(enum ExtiLineSpecific line_mask);

/**
 * Resets all lines. The exti peripheral is returned to its reset configuration
 */
void exti_reset_peripheral(void);


#endif //_EXTI_H_