device.h

Go to the documentation of this file.

/*****************************************************************************
 *   Copyright(C)2009-2022 by VSF Team                                       *
 *                                                                           *
 *  Licensed under the Apache License, Version 2.0 (the "License");          *
 *  you may not use this file except in compliance with the License.         *
 *  You may obtain a copy of the License at                                  *
 *                                                                           *
 *     http://www.apache.org/licenses/LICENSE-2.0                            *
 *                                                                           *
 *  Unless required by applicable law or agreed to in writing, software      *
 *  distributed under the License is distributed on an "AS IS" BASIS,        *
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
 *  See the License for the specific language governing permissions and      *
 *  limitations under the License.                                           *
 *                                                                           *
 ****************************************************************************/
 
/*============================ INCLUDES ======================================*/
/*============================ MACROS ========================================*/
 
#ifdef __VSF_HEADER_ONLY_SHOW_ARCH_INFO__
 
/*\note first define basic info for arch. */
#   define VSF_ARCH_PRI_NUM         8
#   define VSF_ARCH_PRI_BIT         3
 
#   define VSF_DEV_COMMON_SWI_NUM   32
 
#elif defined(__VSF_HAL_SHOW_VENDOR_INFO__)
 
/*\note __VSF_HAL_SHOW_VENDOR_INFO__ is defined to include vendor information only.
 *      Vendor information means the registers/structures/macros from vendor SDK.
 *      Usually these information are not visible from user side to avoid name-space pollution.
 */
 
#   define __VSF_HEADER_ONLY_SHOW_VENDOR_INFO__
#   include "./vendor/libraries/cmsis/cm4/device_support/at32f402_405.h"
 
#else
 
#ifndef __HAL_DEVICE_COMMON_ATTERY_AT32F402_405_H__
#define __HAL_DEVICE_COMMON_ATTERY_AT32F402_405_H__
 
/*============================ MACROS ========================================*/
 
// user configurations with default value
 
// HW definition
 
// SWI
 
#define VSF_DEV_COMMON_SWI_LIST                                                 \
    43, 46, 47, 48, 49,  50,  61,  62,                                          \
    63, 64, 65, 66, 70,  78,  79,  80,                                          \
    84, 86, 87, 88, 89,  90,  91,  93,                                          \
    95, 96, 97, 98, 99, 100, 101, 102
 
// RAM
 
#ifndef VSF_HW_RAM_COUNT
#   define VSF_HW_RAM_COUNT             1
#endif
#if VSF_HW_RAM_COUNT >= 1 && !defined(VSF_HW_RAM0_ADDR)
#   define VSF_HW_RAM0_ADDR             0x20000000
#endif
 
// FLASH
 
#ifndef VSF_HW_FLASH_COUNT
#   define VSF_HW_FLASH_COUNT           1
#endif
#if VSF_HW_FLASH_COUNT >= 1 && !defined(VSF_HW_FLASH0_ADDR)
#   define VSF_HW_FLASH0_ADDR           0x08000000
#endif
 
// GPIO: PORT0..PORT3, PORT5
 
#ifndef VSF_HW_GPIO_PORT_MASK
#   ifdef VSF_HW_GPIO_PORT_COUNT
#       define VSF_HW_GPIO_PORT_MASK    ((1 << VSF_HW_GPIO_PORT_COUNT) - 1)
#   else
#       define VSF_HW_GPIO_PORT_MASK    0x2F
#   endif
#endif
#if VSF_HW_GPIO_PORT_MASK & ~0x2F
#   error invalid VSF_HW_GPIO_PORT_MASK
#endif
 
#ifndef VSF_HW_GPIO_PIN_COUNT
#   define VSF_HW_GPIO_PIN_COUNT        16
#endif
#ifndef VSF_HW_GPIO_FUNCTION_MAX
#   define VSF_HW_GPIO_FUNCTION_MAX     16
#endif
 
#if VSF_HW_GPIO_PORT_MASK & (1 << 0)
#   define VSF_HW_GPIO_PORT0_REG        GPIOA
#   ifndef VSF_HW_GPIO_PORT0_MASK
#       define VSF_HW_GPIO_PORT0_MASK   0xFFFF
#   elif VSF_HW_GPIO_PORT0_MASK & ~0xFFFF
#       error invalid VSF_HW_GPIO_PORT0_MASK
#   endif
#endif
#if VSF_HW_GPIO_PORT_MASK & (1 << 1)
#   define VSF_HW_GPIO_PORT1_REG        GPIOB
#   ifndef VSF_HW_GPIO_PORT1_MASK
#       define VSF_HW_GPIO_PORT1_MASK   0xFFFF
#   elif VSF_HW_GPIO_PORT1_MASK & ~0xFFFF
#       error invalid VSF_HW_GPIO_PORT1_MASK
#   endif
#endif
#if VSF_HW_GPIO_PORT_MASK & (1 << 2)
#   define VSF_HW_GPIO_PORT2_REG        GPIOC
#   ifndef VSF_HW_GPIO_PORT2_MASK
#       define VSF_HW_GPIO_PORT2_MASK   0xFFFF
#   elif VSF_HW_GPIO_PORT2_MASK & ~0xFFFF
#       error invalid VSF_HW_GPIO_PORT2_MASK
#   endif
#endif
#if VSF_HW_GPIO_PORT_MASK & (1 << 3)
#   define VSF_HW_GPIO_PORT3_REG        GPIOD
#   ifndef VSF_HW_GPIO_PORT3_MASK
#       define VSF_HW_GPIO_PORT3_MASK   0x0004
#   elif VSF_HW_GPIO_PORT3_MASK & ~0xFFFF
#       error invalid VSF_HW_GPIO_PORT3_MASK
#   endif
#endif
#if VSF_HW_GPIO_PORT_MASK & (1 << 5)
#   define VSF_HW_GPIO_PORT5_REG        GPIOF
#   ifndef VSF_HW_GPIO_PORT5_MASK
#       define VSF_HW_GPIO_PORT5_MASK   0x08F3
#   elif VSF_HW_GPIO_PORT5_MASK & ~0x08F3
#       error invalid VSF_HW_GPIO_PORT5_MASK
#   endif
#endif
 
// USART: USART1..USART8
 
#ifndef VSF_HW_USART_MASK
#   ifdef VSF_HW_USART_COUNT
#       define VSF_HW_USART_MASK        ((1 << VSF_HW_USART_COUNT) - 1)
#   else
#       define VSF_HW_USART_MASK        0x01FE
#   endif
#endif
#if VSF_HW_USART_MASK & ~0x01FE
#   error invalid VSF_HW_USART_MASK
#endif
 
#if VSF_HW_USART_MASK & (1 << 1)
#   define VSF_HW_USART1_REG            USART1
#   define VSF_HW_USART1_CLK            VSF_HW_CLK_USART1
#   define VSF_HW_USART1_EN             VSF_HW_EN_USART1
#   define VSF_HW_USART1_RST            VSF_HW_RST_USART1
#   define VSF_HW_USART1_SYNC           true
#   define VSF_HW_USART1_IRQN           USART1_IRQn
#   define VSF_HW_USART1_IRQHandler     USART1_IRQHandler
#endif
#if VSF_HW_USART_MASK & (1 << 2)
#   define VSF_HW_USART2_REG            USART2
#   define VSF_HW_USART2_CLK            VSF_HW_CLK_USART2
#   define VSF_HW_USART2_EN             VSF_HW_EN_USART2
#   define VSF_HW_USART2_RST            VSF_HW_RST_USART2
#   define VSF_HW_USART2_SYNC           true
#   define VSF_HW_USART2_IRQN           USART2_IRQn
#   define VSF_HW_USART2_IRQHandler     USART2_IRQHandler
#endif
#if VSF_HW_USART_MASK & (1 << 3)
#   define VSF_HW_USART3_REG            USART3
#   define VSF_HW_USART3_CLK            VSF_HW_CLK_USART3
#   define VSF_HW_USART3_EN             VSF_HW_EN_USART3
#   define VSF_HW_USART3_RST            VSF_HW_RST_USART3
#   define VSF_HW_USART3_SYNC           true
#   define VSF_HW_USART3_IRQN           USART3_IRQn
#   define VSF_HW_USART3_IRQHandler     USART3_IRQHandler
#endif
#if VSF_HW_USART_MASK & (1 << 4)
#   define VSF_HW_USART4_REG            USART4
#   define VSF_HW_USART4_CLK            VSF_HW_CLK_USART4
#   define VSF_HW_USART4_EN             VSF_HW_EN_USART4
#   define VSF_HW_USART4_RST            VSF_HW_RST_USART4
#   define VSF_HW_USART4_SYNC           true
#   define VSF_HW_USART4_IRQN           USART4_IRQn
#   define VSF_HW_USART4_IRQHandler     USART4_IRQHandler
#endif
#if VSF_HW_USART_MASK & (1 << 5)
#   define VSF_HW_USART5_REG            USART5
#   define VSF_HW_USART5_CLK            VSF_HW_CLK_USART5
#   define VSF_HW_USART5_EN             VSF_HW_EN_USART5
#   define VSF_HW_USART5_RST            VSF_HW_RST_USART5
#   define VSF_HW_USART5_SYNC           true
#   define VSF_HW_USART5_IRQN           USART5_IRQn
#   define VSF_HW_USART5_IRQHandler     USART5_IRQHandler
#endif
#if VSF_HW_USART_MASK & (1 << 6)
#   define VSF_HW_USART6_REG            USART6
#   define VSF_HW_USART6_CLK            VSF_HW_CLK_USART6
#   define VSF_HW_USART6_EN             VSF_HW_EN_USART6
#   define VSF_HW_USART6_RST            VSF_HW_RST_USART6
#   define VSF_HW_USART6_SYNC           true
#   define VSF_HW_USART6_IRQN           USART6_IRQn
#   define VSF_HW_USART6_IRQHandler     USART6_IRQHandler
#endif
#if VSF_HW_USART_MASK & (1 << 7)
#   define VSF_HW_USART7_REG            UART7
#   define VSF_HW_USART7_CLK            VSF_HW_CLK_UART7
#   define VSF_HW_USART7_EN             VSF_HW_EN_UART7
#   define VSF_HW_USART7_RST            VSF_HW_RST_UART7
#   define VSF_HW_USART7_SYNC           false
#   define VSF_HW_USART7_IRQN           UART7_IRQn
#   define VSF_HW_USART7_IRQHandler     UART7_IRQHandler
#endif
#if VSF_HW_USART_MASK & (1 << 8)
#   define VSF_HW_USART8_REG            UART8
#   define VSF_HW_USART8_CLK            VSF_HW_CLK_UART8
#   define VSF_HW_USART8_EN             VSF_HW_EN_UART8
#   define VSF_HW_USART8_RST            VSF_HW_RST_UART8
#   define VSF_HW_USART8_SYNC           false
#   define VSF_HW_USART8_IRQN           UART8_IRQn
#   define VSF_HW_USART8_IRQHandler     UART8_IRQHandler
#endif
 
// SPI: SPI1..SPI3
 
#ifndef VSF_HW_SPI_MASK
#   ifdef VSF_HW_SPI_COUNT
#       define VSF_HW_SPI_MASK          ((1 << VSF_HW_SPI_COUNT) - 1)
#   else
#       define VSF_HW_SPI_MASK          0x0E
#   endif
#endif
#if VSF_HW_SPI_MASK & ~0x0E
#   error invalid VSF_HW_SPI_MASK
#endif
 
#if VSF_HW_SPI_MASK & (1 << 1)
#   define VSF_HW_SPI1_REG              SPI1
#   define VSF_HW_SPI1_CLK              VSF_HW_CLK_SPI1
#   define VSF_HW_SPI1_EN               VSF_HW_EN_SPI1
#   define VSF_HW_SPI1_RST              VSF_HW_RST_SPI1
#   define VSF_HW_SPI1_IRQN             SPI1_IRQn
#   define VSF_HW_SPI1_IRQ              SPI1_IRQHandler
#endif
#if VSF_HW_SPI_MASK & (1 << 2)
#   define VSF_HW_SPI2_REG              SPI2
#   define VSF_HW_SPI2_CLK              VSF_HW_CLK_SPI2
#   define VSF_HW_SPI2_EN               VSF_HW_EN_SPI2
#   define VSF_HW_SPI2_RST              VSF_HW_RST_SPI2
#   define VSF_HW_SPI2_IRQN             SPI2_IRQn
#   define VSF_HW_SPI2_IRQ              SPI2_IRQHandler
#endif
#if VSF_HW_SPI_MASK & (1 << 3)
#   define VSF_HW_SPI3_REG              SPI3
#   define VSF_HW_SPI3_CLK              VSF_HW_CLK_SPI3
#   define VSF_HW_SPI3_EN               VSF_HW_EN_SPI3
#   define VSF_HW_SPI3_RST              VSF_HW_RST_SPI3
#   define VSF_HW_SPI3_IRQN             SPI3_IRQn
#   define VSF_HW_SPI3_IRQ              SPI3_IRQHandler
#endif
 
// I2C: I2C1..I2C3
 
#ifndef VSF_HW_I2C_MASK
#   ifdef VSF_HW_I2C_COUNT
#       define VSF_HW_I2C_MASK          ((1 << VSF_HW_I2C_COUNT) - 1)
#   else
#       define VSF_HW_I2C_MASK          0x0E
#   endif
#endif
#if VSF_HW_I2C_MASK & ~0x0E
#   error invalid VSF_HW_I2C_MASK
#endif
 
#if VSF_HW_I2C_MASK & (1 << 1)
#   define VSF_HW_I2C1_REG              I2C1
#   define VSF_HW_I2C1_CLK              VSF_HW_CLK_I2C1
#   define VSF_HW_I2C1_EN               VSF_HW_EN_I2C1
#   define VSF_HW_I2C1_RST              VSF_HW_RST_I2C1
#   define VSF_HW_I2C1_EVENT_IRQN       I2C1_EVT_IRQn
#   define VSF_HW_I2C1_EVENT_IRQHandler I2C1_EVT_IRQHandler
#   define VSF_HW_I2C1_ERROR_IRQN       I2C1_ERR_IRQn
#   define VSF_HW_I2C1_ERROR_IRQHandler I2C1_ERR_IRQHandler
#endif
#if VSF_HW_I2C_MASK & (1 << 2)
#   define VSF_HW_I2C2_REG              I2C2
#   define VSF_HW_I2C2_CLK              VSF_HW_CLK_I2C2
#   define VSF_HW_I2C2_EN               VSF_HW_EN_I2C2
#   define VSF_HW_I2C2_RST              VSF_HW_RST_I2C2
#   define VSF_HW_I2C2_EVENT_IRQN       I2C2_EVT_IRQn
#   define VSF_HW_I2C2_EVENT_IRQHandler I2C2_EVT_IRQHandler
#   define VSF_HW_I2C2_ERROR_IRQN       I2C2_ERR_IRQn
#   define VSF_HW_I2C2_ERROR_IRQHandler I2C2_ERR_IRQHandler
#endif
#if VSF_HW_I2C_MASK & (1 << 3)
#   define VSF_HW_I2C3_REG              I2C3
#   define VSF_HW_I2C3_CLK              VSF_HW_CLK_I2C3
#   define VSF_HW_I2C3_EN               VSF_HW_EN_I2C3
#   define VSF_HW_I2C3_RST              VSF_HW_RST_I2C3
#   define VSF_HW_I2C3_EVENT_IRQN       I2C3_EVT_IRQn
#   define VSF_HW_I2C3_EVENT_IRQHandler I2C3_EVT_IRQHandler
#   define VSF_HW_I2C3_ERROR_IRQN       I2C3_ERR_IRQn
#   define VSF_HW_I2C3_ERROR_IRQHandler I2C3_ERR_IRQHandler
#endif
 
// USB OTG
 
#ifndef VSF_HW_USB_OTG_MASK
#   ifdef VSF_HW_USB_OTG_COUNT
#       define VSF_HW_USB_OTG_MASK      ((1 << VSF_HW_USB_OTG_COUNT) - 1)
#   else
#       define VSF_HW_USB_OTG_MASK      0x03
#   endif
#endif
 
// required by dwcotg, define the max ep number of dwcotg include ep0
#ifndef USB_DWCOTG_MAX_EP_NUM
#   define USB_DWCOTG_MAX_EP_NUM        16
#endif
 
#if VSF_HW_USB_OTG_MASK & (1 << 0)
#   define VSF_HW_USB_OTG0_IRQHandler   OTGFS1_IRQHandler
#   define VSF_HW_USB_OTG0_CONFIG                                               \
            .dc_ep_num                  = 8 << 1,                               \
            .hc_ep_num                  = 16,                                   \
            .reg                        = (void *)OTGFS1_BASE,                  \
            .irq                        = OTGFS1_IRQn,                          \
            .en                         = VSF_HW_EN_OTGFS1,                     \
            .phyclk                     = &VSF_HW_CLK_HICK,                     \
            .phyclk_freq_required       = 48 * 1000 * 1000,                     \
            /* vk_dwcotg_hw_info_t */                                           \
                .buffer_word_size       = 320,                                  \
                .speed                  = USB_SPEED_FULL,                       \
                .dma_en                 = false,                                \
                .ulpi_en                = false,                                \
                .utmi_en                = false,                                \
                .vbus_en                = false,
#endif
 
#if VSF_HW_USB_OTG_MASK & (1 << 1)
// TODO: 修复DMA模式BUG， 修复高速模式的BUG
#   define VSF_HW_USB_OTG1_IRQHandler   OTGHS_IRQHandler
#   define VSF_HW_USB_OTG1_CONFIG                                               \
            .dc_ep_num                  = 8 << 1,                               \
            .hc_ep_num                  = 16,                                   \
            .reg                        = (void *)OTGHS_BASE,                   \
            .irq                        = OTGHS_IRQn,                           \
            .en                         = VSF_HW_EN_OTGHS,                      \
            .phyclk                     = &VSF_HW_CLK_HEXT,                     \
            .phyclk_freq_required       = 12 * 1000 * 1000,                     \
            /* vk_dwcotg_hw_info_t */                                           \
                .buffer_word_size       = 1024,                                 \
                .speed                  = USB_SPEED_HIGH,                       \
                .dma_en                 = false,                                \
                .ulpi_en                = false,                                \
                .utmi_en                = false,                                \
                .vbus_en                = false,
#endif
 
/*============================ INCLUDES ======================================*/
 
// Include common irq and af headers after peripherals are defined, so that
//  irq and af can be adjusted according to the dedicated device configuration.
 
#include "./common.h"
#include "./device_irq.h"
#include "./device_af.h"
 
/*============================ MACROS ========================================*/
 
/*============================ MACROFIED FUNCTIONS ===========================*/
/*============================ TYPES =========================================*/
/*============================ GLOBAL VARIABLES ==============================*/
/*============================ LOCAL VARIABLES ===============================*/
/*============================ PROTOTYPES ====================================*/
 
#endif      // __HAL_DEVICE_COMMON_ATTERY_AT32F402_405_H__
#endif      // __VSF_HEADER_ONLY_SHOW_ARCH_INFO__
 
/* EOF */