[freertos] /

/*******************************************************************************\r
 * (c) Copyright 2008-2013 Microsemi SoC Products Group.  All rights reserved.\r
 * \r
 *  SmartFusion2 Microcontroller Subsystem GPIO bare metal software driver public\r
 *  API.\r
 *\r
 * SVN $Revision: 5487 $\r
 * SVN $Date: 2013-03-29 15:33:22 +0000 (Fri, 29 Mar 2013) $\r
 */\r
\r
/*=========================================================================*//**\r
  @mainpage SmartFusion2 MSS GPIO Bare Metal Driver.\r
\r
  @section intro_sec Introduction\r
  The SmartFusion2 Microcontroller Subsystem (MSS) includes a block of 32 general\r
  purpose input/outputs (GPIO).\r
  This software driver provides a set of functions for controlling the MSS GPIO\r
  block as part of a bare metal system where no operating system is available.\r
  This driver can be adapted for use as part of an operating system but the\r
  implementation of the adaptation layer between this driver and the operating\r
  system's driver model is outside the scope of this driver.\r
  \r
  @section hw_dependencies Hardware Flow Dependencies\r
  The configuration of all features of the MSS GPIOs is covered by this driver\r
  with the exception of the SmartFusion2 IOMUX configuration. SmartFusion2\r
  allows multiple non-concurrent uses of some external pins through IOMUX\r
  configuration. This feature allows optimization of external pin usage by\r
  assigning external pins for use by either the microcontroller subsystem or the\r
  FPGA fabric. The MSS GPIOs share SmartFusion2 device external pins with the\r
  FPGA fabric and with other MSS peripherals via an IOMUX. The MSS GPIO ports\r
  can alternatively be routed to the FPGA fabric through an IOMUX. \r
  The IOMUXs are configured using the SmartFusion2 MSS configurator tool. You\r
  must ensure that the MSS GPIOs are enabled and configured in the SmartFusion2\r
  MSS configurator if you wish to use them. For more information on IOMUXs,\r
  refer to the IOMUX section of the SmartFusion2 Microcontroller Subsystem (MSS)\r
  User’s Guide.\r
  The base address, register addresses and interrupt number assignment for the\r
  MSS GPIO block are defined as constants in the SmartFusion2 CMSIS HAL. You\r
  must ensure that the latest SmartFusion2 CMSIS HAL is included in the project\r
  settings of the software tool chain used to build your project and that it is\r
  generated into your project.\r
  \r
  @section theory_op Theory of Operation\r
  The MSS GPIO driver functions are grouped into the following categories:\r
    - Initialization\r
    - Configuration\r
    - Reading and setting GPIO state\r
    - Interrupt control\r
    \r
  Initialization\r
  The MSS GPIO driver is initialized through a call to the MSS_GPIO_init()\r
  function. The MSS_GPIO_init() function must be called before any other MSS\r
  GPIO driver functions can be called.\r
  \r
  Configuration\r
  Each GPIO port is individually configured through a call to the\r
  MSS_GPIO_config() function. Configuration includes deciding if a GPIO port\r
  will be used as an input, an output or both. GPIO ports configured as inputs\r
  can be further configured to generate interrupts based on the input's state.\r
  Interrupts can be level or edge sensitive.\r
  \r
  Reading and Setting GPIO State\r
  The state of the GPIO ports can be read and set using the following functions:\r
    - MSS_GPIO_get_inputs()\r
    - MSS_GPIO_get_outputs()\r
    - MSS_GPIO_set_outputs()\r
    - MSS_GPIO_set_output()\r
    - MSS_GPIO_drive_inout()\r
  \r
  Interrupt Control\r
  Interrupts generated by GPIO ports configured as inputs are controlled using\r
  the following functions:\r
    - MSS_GPIO_enable_irq()\r
    - MSS_GPIO_disable_irq()\r
    - MSS_GPIO_clear_irq()\r
  \r
 *//*=========================================================================*/\r
#ifndef MSS_GPIO_H_\r
#define MSS_GPIO_H_\r
\r
#ifdef __cplusplus\r
extern "C" {\r
#endif \r
\r
#include "../../CMSIS/m2sxxx.h"\r
\r
/*-------------------------------------------------------------------------*//**\r
  The mss_gpio_id_t enumeration is used to identify individual GPIO ports as an\r
  argument to functions:\r
    - MSS_GPIO_config()\r
    - MSS_GPIO_set_output() and MSS_GPIO_drive_inout()\r
    - MSS_GPIO_enable_irq(), MSS_GPIO_disable_irq() and MSS_GPIO_clear_irq()\r
 */\r
typedef enum __mss_gpio_id_t\r
{\r
    MSS_GPIO_0 = 0,\r
    MSS_GPIO_1 = 1,\r
    MSS_GPIO_2 = 2,\r
    MSS_GPIO_3 = 3,\r
    MSS_GPIO_4 = 4,\r
    MSS_GPIO_5 = 5,\r
    MSS_GPIO_6 = 6,\r
    MSS_GPIO_7 = 7,\r
    MSS_GPIO_8 = 8,\r
    MSS_GPIO_9 = 9,\r
    MSS_GPIO_10 = 10,\r
    MSS_GPIO_11 = 11,\r
    MSS_GPIO_12 = 12,\r
    MSS_GPIO_13 = 13,\r
    MSS_GPIO_14 = 14,\r
    MSS_GPIO_15 = 15,\r
    MSS_GPIO_16 = 16,\r
    MSS_GPIO_17 = 17,\r
    MSS_GPIO_18 = 18,\r
    MSS_GPIO_19 = 19,\r
    MSS_GPIO_20 = 20,\r
    MSS_GPIO_21 = 21,\r
    MSS_GPIO_22 = 22,\r
    MSS_GPIO_23 = 23,\r
    MSS_GPIO_24 = 24,\r
    MSS_GPIO_25 = 25,\r
    MSS_GPIO_26 = 26,\r
    MSS_GPIO_27 = 27,\r
    MSS_GPIO_28 = 28,\r
    MSS_GPIO_29 = 29,\r
    MSS_GPIO_30 = 30,\r
    MSS_GPIO_31 = 31\r
} mss_gpio_id_t;\r
\r
/*-------------------------------------------------------------------------*//**\r
  These constant definitions are used as an argument to the\r
  MSS_GPIO_set_outputs() function to identify GPIO ports. A logical OR of these\r
  constants can be used to specify multiple GPIO ports.\r
  These definitions can also be used to identify GPIO ports through logical\r
  operations on the return value of the MSS_GPIO_get_inputs() function.\r
 */\r
#define MSS_GPIO_0_MASK         0x00000001uL\r
#define MSS_GPIO_1_MASK         0x00000002uL\r
#define MSS_GPIO_2_MASK         0x00000004uL\r
#define MSS_GPIO_3_MASK         0x00000008uL\r
#define MSS_GPIO_4_MASK         0x00000010uL\r
#define MSS_GPIO_5_MASK         0x00000020uL\r
#define MSS_GPIO_6_MASK         0x00000040uL\r
#define MSS_GPIO_7_MASK         0x00000080uL\r
#define MSS_GPIO_8_MASK         0x00000100uL\r
#define MSS_GPIO_9_MASK         0x00000200uL\r
#define MSS_GPIO_10_MASK        0x00000400uL\r
#define MSS_GPIO_11_MASK        0x00000800uL\r
#define MSS_GPIO_12_MASK        0x00001000uL\r
#define MSS_GPIO_13_MASK        0x00002000uL\r
#define MSS_GPIO_14_MASK        0x00004000uL\r
#define MSS_GPIO_15_MASK        0x00008000uL\r
#define MSS_GPIO_16_MASK        0x00010000uL\r
#define MSS_GPIO_17_MASK        0x00020000uL\r
#define MSS_GPIO_18_MASK        0x00040000uL\r
#define MSS_GPIO_19_MASK        0x00080000uL\r
#define MSS_GPIO_20_MASK        0x00100000uL\r
#define MSS_GPIO_21_MASK        0x00200000uL\r
#define MSS_GPIO_22_MASK        0x00400000uL\r
#define MSS_GPIO_23_MASK        0x00800000uL\r
#define MSS_GPIO_24_MASK        0x01000000uL\r
#define MSS_GPIO_25_MASK        0x02000000uL\r
#define MSS_GPIO_26_MASK        0x04000000uL\r
#define MSS_GPIO_27_MASK        0x08000000uL\r
#define MSS_GPIO_28_MASK        0x10000000uL\r
#define MSS_GPIO_29_MASK        0x20000000uL\r
#define MSS_GPIO_30_MASK        0x40000000uL\r
#define MSS_GPIO_31_MASK        0x80000000uL\r
\r
/*-------------------------------------------------------------------------*//**\r
  These constant definitions are used as an argument to the MSS_GPIO_config()\r
  function to specify the I/O mode of each GPIO port.\r
 */\r
#define MSS_GPIO_INPUT_MODE              0x0000000002uL\r
#define MSS_GPIO_OUTPUT_MODE             0x0000000005uL\r
#define MSS_GPIO_INOUT_MODE              0x0000000003uL\r
\r
/*-------------------------------------------------------------------------*//**\r
  These constant definitions are used as an argument to the MSS_GPIO_config()\r
  function to specify the interrupt mode of each GPIO port.\r
 */\r
#define MSS_GPIO_IRQ_LEVEL_HIGH           0x0000000000uL\r
#define MSS_GPIO_IRQ_LEVEL_LOW            0x0000000020uL\r
#define MSS_GPIO_IRQ_EDGE_POSITIVE        0x0000000040uL\r
#define MSS_GPIO_IRQ_EDGE_NEGATIVE        0x0000000060uL\r
#define MSS_GPIO_IRQ_EDGE_BOTH            0x0000000080uL\r
\r
/*-------------------------------------------------------------------------*//**\r
  The mss_gpio_inout_state_t enumeration is used to specify the output state of\r
  an INOUT GPIO port as an argument to the MSS_GPIO_drive_inout() function.\r
 */\r
typedef enum mss_gpio_inout_state\r
{\r
    MSS_GPIO_DRIVE_LOW = 0,\r
    MSS_GPIO_DRIVE_HIGH,\r
    MSS_GPIO_HIGH_Z\r
} mss_gpio_inout_state_t;\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_init() function initializes the SmartFusion2 MSS GPIO block. It\r
  resets the MSS GPIO hardware block and it also clears any pending MSS GPIO\r
  interrupts in the ARM Cortex-M3 interrupt controller. When the function exits,\r
  it takes the MSS GPIO block out of reset.\r
  \r
   @param\r
    This function has no parameters.\r
    \r
   @return\r
    This function does not return a value.\r
 */\r
void MSS_GPIO_init( void );\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_config() function is used to configure an individual GPIO port.\r
 \r
  @param port_id\r
    The port_id parameter identifies the GPIO port to be configured. An\r
    enumeration item of the form MSS_GPIO_n, where n is the number of the GPIO\r
    port, is used to identify the GPIO port. For example, MSS_GPIO_0 identifies\r
    the first GPIO port and MSS_GPIO_31 is the last one.\r
    \r
  @param config\r
    The config parameter specifies the configuration to be applied to the GPIO\r
    port identified by the port_id parameter. It is a logical OR of the required\r
    I/O mode and the required interrupt mode. The interrupt mode is not relevant\r
    if the GPIO is configured as an output only.\r
       These I/O mode constants are allowed:\r
           - MSS_GPIO_INPUT_MODE\r
           - MSS_GPIO_OUTPUT_MODE\r
           - MSS_GPIO_INOUT_MODE\r
       These interrupt mode constants are allowed:\r
           - MSS_GPIO_IRQ_LEVEL_HIGH\r
           - MSS_GPIO_IRQ_LEVEL_LOW\r
           - MSS_GPIO_IRQ_EDGE_POSITIVE\r
           - MSS_GPIO_IRQ_EDGE_NEGATIVE\r
           - MSS_GPIO_IRQ_EDGE_BOTH\r
  \r
   @return\r
    none.\r
\r
  Example:\r
  The following call will configure GPIO 4 as an input generating interrupts on\r
  a Low to High transition of the input:\r
  @code\r
  MSS_GPIO_config( MSS_GPIO_4, MSS_GPIO_INPUT_MODE | MSS_GPIO_IRQ_EDGE_POSITIVE );\r
  @endcode\r
 */\r
void MSS_GPIO_config\r
(\r
    mss_gpio_id_t port_id,\r
    uint32_t config\r
);\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_set_outputs() function is used to set the state of all GPIO ports\r
  configured as outputs.\r
 \r
  @param value\r
    The value parameter specifies the state of the GPIO ports configured as\r
    outputs. It is a bit mask of the form (MSS_GPIO_n_MASK | MSS_GPIO_m_MASK)\r
    where n and m are numbers identifying GPIOs. For example, (MSS_GPIO_0_MASK |\r
    MSS_GPIO_1_MASK | MSS_GPIO_2_MASK ) specifies that the first, second and\r
    third GPIO outputs must be set High and all other GPIO outputs set Low. The\r
    driver provides 32 mask constants, MSS_GPIO_0_MASK to MSS_GPIO_31_MASK\r
    inclusive, for this purpose.\r
  \r
  @return\r
    none.\r
\r
  Example 1:\r
    Set GPIOs outputs 0 and 8 high and all other GPIO outputs low.\r
    @code\r
        MSS_GPIO_set_outputs( MSS_GPIO_0_MASK | MSS_GPIO_8_MASK );\r
    @endcode\r
\r
  Example 2:\r
    Set GPIOs outputs 2 and 4 low without affecting other GPIO outputs.\r
    @code\r
        uint32_t gpio_outputs;\r
        gpio_outputs = MSS_GPIO_get_outputs();\r
        gpio_outputs &= ~( MSS_GPIO_2_MASK | MSS_GPIO_4_MASK );\r
        MSS_GPIO_set_outputs(  gpio_outputs );\r
    @endcode\r
\r
  @see MSS_GPIO_get_outputs()\r
 */\r
static __INLINE void\r
MSS_GPIO_set_outputs\r
(\r
   uint32_t value\r
)\r
{\r
    GPIO->GPIO_OUT = value;\r
}\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_set_output() function is used to set the state of a single GPIO\r
  port configured as an output.\r
  Note: Using bit-band writes might be a better option than this function for\r
        performance critical applications where the application code is not\r
        intended to be ported to a processor other than the ARM Cortex-M3 in\r
        SmartFusion2. The bit-band write equivalent to this function would be:\r
            GPIO_BITBAND->GPIO_OUT[port_id] = (uint32_t)value;\r
 \r
  @param port_id\r
    The port_id parameter identifies the GPIO port that is to have its output\r
    set. An enumeration item of the form MSS_GPIO_n, where n is the number of\r
    the GPIO port, is used to identify the GPIO port. For example, MSS_GPIO_0\r
    identifies the first GPIO port and MSS_GPIO_31 is the last one.\r
  \r
  @param value\r
    The value parameter specifies the desired state for the GPIO output. A value\r
    of 0 will set the output Low and a value of 1 will set the output High.\r
  \r
  @return\r
    This function does not return a value.\r
    \r
  Example:\r
  The following call will set GPIO output 12 High, leaving all other GPIO\r
  outputs unaffected:\r
  @code\r
    _GPIO_set_output(MSS_GPIO_12, 1);\r
  @endcode\r
 */\r
void MSS_GPIO_set_output\r
(\r
    mss_gpio_id_t       port_id,\r
    uint8_t             value\r
);\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_get_inputs() function is used to read the current state all GPIO\r
  ports configured as inputs.\r
 \r
  @return\r
    This function returns a 32-bit unsigned integer where each bit represents\r
    the state of a GPIO input. The least significant bit represents the state of\r
    GPIO input 0 and the most significant bit the state of GPIO input 31.\r
\r
  Example:\r
    Read and assign the current state of the GPIO outputs to a variable.\r
    @code\r
        uint32_t gpio_inputs;\r
        gpio_inputs = MSS_GPIO_get_inputs();\r
    @endcode\r
 */\r
static __INLINE uint32_t\r
MSS_GPIO_get_inputs( void )\r
{\r
    return GPIO->GPIO_IN;\r
}\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_get_outputs() function is used to read the current state all GPIO\r
  ports configured as outputs.\r
 \r
  @return\r
     This function returns a 32-bit unsigned integer where each bit represents\r
     the state of a GPIO output. The least significant bit represents the state\r
     of GPIO output 0 and the most significant bit the state of GPIO output 31.\r
\r
  Example:\r
    Read and assign the current state of the GPIO outputs to a variable.\r
    @code\r
        uint32_t gpio_outputs;\r
        gpio_outputs = MSS_GPIO_get_outputs();\r
    @endcode\r
 */\r
static __INLINE uint32_t\r
MSS_GPIO_get_outputs( void )\r
{\r
    return GPIO->GPIO_OUT;\r
}\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_drive_inout() function is used to set the output state of a\r
  single GPIO port configured as an INOUT. An INOUT GPIO can be in one of three\r
  states:\r
    - High\r
    - Low\r
    - High impedance\r
  An INOUT output would typically be used where several devices can drive the\r
  state of a shared signal line. The High and Low states are equivalent to the\r
  High and Low states of a GPIO configured as an output. The High impedance\r
  state is used to prevent the GPIO from driving its output state onto the\r
  signal line, while at the same time allowing the input state of the GPIO to\r
  be read.\r
  \r
  @param port_id\r
    The port_id parameter identifies the GPIO port for which you want to change\r
    the output state. An enumeration item of the form MSS_GPIO_n, where n is the\r
    number of the GPIO port, is used to identify the GPIO port. For example,\r
    MSS_GPIO_0 identifies the first GPIO port and MSS_GPIO_31 is the last one.\r
    \r
  @param inout_state\r
    The inout_state parameter specifies the state of the GPIO port identified by\r
    the port_id parameter. Allowed values of type mss_gpio_inout_state_t are as\r
    follows:\r
        - MSS_GPIO_DRIVE_HIGH\r
        - MSS_GPIO_DRIVE_LOW\r
        - MSS_GPIO_HIGH_Z  (High impedance)\r
        \r
  @return\r
    This function does not return a value.\r
\r
  Example:\r
    The call to MSS_GPIO_drive_inout() below will set the GPIO 7 output to the\r
    high impedance state.\r
    @code\r
    MSS_GPIO_drive_inout( MSS_GPIO_7, MSS_GPIO_HIGH_Z );\r
    @endcode\r
 */\r
void MSS_GPIO_drive_inout\r
(\r
    mss_gpio_id_t           port_id,\r
    mss_gpio_inout_state_t  inout_state\r
);\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_enable_irq() function is used to enable interrupt generation for\r
  the specified GPIO input. Interrupts are generated based on the state of the\r
  GPIO input and the interrupt mode configured for it by MSS_GPIO_config().\r
 \r
  @param port_id\r
    The port_id parameter identifies the GPIO port for which you want to enable\r
    interrupt generation. An enumeration item of the form MSS_GPIO_n, where n is\r
    the number of the GPIO port, is used to identify the GPIO port. For example,\r
    MSS_GPIO_0 identifies the first GPIO port and MSS_GPIO_31 is the last one.\r
    \r
  @return\r
    This function does not return a value.\r
\r
  Example:\r
    The call to MSS_GPIO_enable_irq() below will allow GPIO 8 to generate\r
    interrupts.\r
    @code\r
    MSS_GPIO_enable_irq( MSS_GPIO_8 );\r
    @endcode\r
 */\r
void MSS_GPIO_enable_irq\r
(\r
    mss_gpio_id_t port_id\r
);\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_disable_irq() function is used to disable interrupt generation\r
  for the specified GPIO input.\r
 \r
  @param port_id\r
    The port_id parameter identifies the GPIO port for which you want to disable\r
    interrupt generation. An enumeration item of the form MSS_GPIO_n, where n is\r
    the number of the GPIO port, is used to identify the GPIO port. For example,\r
    MSS_GPIO_0 identifies the first GPIO port and MSS_GPIO_31 is the last one.\r
 \r
  @return\r
    This function does not return a value.\r
\r
  Example:\r
    The call to MSS_GPIO_disable_irq() below will prevent GPIO 8 from generating\r
    interrupts.\r
    @code\r
    MSS_GPIO_disable_irq( MSS_GPIO_8 );\r
    @endcode\r
 */\r
void MSS_GPIO_disable_irq\r
(\r
    mss_gpio_id_t port_id\r
);\r
\r
/*-------------------------------------------------------------------------*//**\r
  The MSS_GPIO_clear_irq() function is used to clear a pending interrupt from\r
  the specified GPIO input.\r
  Note: The MSS_GPIO_clear_irq() function must be called as part of any GPIO\r
        interrupt service routine (ISR) in order to prevent the same interrupt\r
        event retriggering a call to the GPIO ISR.\r
 \r
  @param port_id\r
    The port_id parameter identifies the GPIO port for which you want to clear\r
    the interrupt. An enumeration item of the form MSS_GPIO_n, where n is the\r
    number of the GPIO port, is used to identify the GPIO port. For example,\r
    MSS_GPIO_0 identifies the first GPIO port and MSS_GPIO_31 is the last one.\r
    \r
  @return\r
    none.\r
\r
  Example:\r
    The example below demonstrates the use of the MSS_GPIO_clear_irq() function\r
    as part of the GPIO 9 interrupt service routine.  \r
    @code\r
    void GPIO9_IRQHandler( void )\r
    {\r
        do_interrupt_processing();\r
        \r
        MSS_GPIO_clear_irq( MSS_GPIO_9 );\r
    }\r
    @endcode\r
 */\r
void MSS_GPIO_clear_irq\r
(\r
    mss_gpio_id_t port_id\r
);\r
\r
#ifdef __cplusplus\r
}\r
#endif\r
\r
#endif /* MSS_GPIO_H_ */\r