237 lines
9.3 KiB
C
237 lines
9.3 KiB
C
/*================================================================
|
||
Copyright (c) 2021, Quectel Wireless Solutions Co., Ltd. All rights reserved.
|
||
Quectel Wireless Solutions Proprietary and Confidential.
|
||
=================================================================*/
|
||
/**
|
||
******************************************************************************
|
||
* @file ql_gpio.h
|
||
* @author Juson.zhang
|
||
* @version V1.0.0
|
||
* @date 2019/12/17
|
||
* @brief This file contains the lcd functions's declaration
|
||
******************************************************************************
|
||
*/
|
||
#ifndef _QUEC_GPIO_H_
|
||
#define _QUEC_GPIO_H_
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
typedef enum GPIO_PIN_NUMBER_ENUM {
|
||
GPIO_PIN_NO_NOT_ASSIGNED = -1,
|
||
|
||
GPIO_PIN_NO_0=0,GPIO_PIN_NO_1, GPIO_PIN_NO_2, GPIO_PIN_NO_3, GPIO_PIN_NO_4, GPIO_PIN_NO_5, GPIO_PIN_NO_6, GPIO_PIN_NO_7,
|
||
GPIO_PIN_NO_8, GPIO_PIN_NO_9, GPIO_PIN_NO_10, GPIO_PIN_NO_11, GPIO_PIN_NO_12, GPIO_PIN_NO_13, GPIO_PIN_NO_14, GPIO_PIN_NO_15,
|
||
GPIO_PIN_NO_16, GPIO_PIN_NO_17, GPIO_PIN_NO_18, GPIO_PIN_NO_19, GPIO_PIN_NO_20, GPIO_PIN_NO_21, GPIO_PIN_NO_22, GPIO_PIN_NO_23,
|
||
GPIO_PIN_NO_24, GPIO_PIN_NO_25, GPIO_PIN_NO_26, GPIO_PIN_NO_27, GPIO_PIN_NO_28, GPIO_PIN_NO_29, GPIO_PIN_NO_30, GPIO_PIN_NO_31,
|
||
GPIO_PIN_NO_32, GPIO_PIN_NO_33, GPIO_PIN_NO_34, GPIO_PIN_NO_35, GPIO_PIN_NO_36, GPIO_PIN_NO_37, GPIO_PIN_NO_38, GPIO_PIN_NO_39,
|
||
GPIO_PIN_NO_40, GPIO_PIN_NO_41, GPIO_PIN_NO_42, GPIO_PIN_NO_43, GPIO_PIN_NO_44, GPIO_PIN_NO_45, GPIO_PIN_NO_46, GPIO_PIN_NO_47,
|
||
GPIO_PIN_NO_48, GPIO_PIN_NO_49, GPIO_PIN_NO_50, GPIO_PIN_NO_51, GPIO_PIN_NO_52, GPIO_PIN_NO_53, GPIO_PIN_NO_54, GPIO_PIN_NO_55,
|
||
GPIO_PIN_NO_56, GPIO_PIN_NO_57, GPIO_PIN_NO_58, GPIO_PIN_NO_59, GPIO_PIN_NO_60, GPIO_PIN_NO_61, GPIO_PIN_NO_62, GPIO_PIN_NO_63,
|
||
|
||
GPIO_PIN_NO_64, GPIO_PIN_NO_65, GPIO_PIN_NO_66, GPIO_PIN_NO_67, GPIO_PIN_NO_68, GPIO_PIN_NO_69, GPIO_PIN_NO_70, GPIO_PIN_NO_71,
|
||
GPIO_PIN_NO_72, GPIO_PIN_NO_73, GPIO_PIN_NO_74, GPIO_PIN_NO_75, GPIO_PIN_NO_76, GPIO_PIN_NO_77, GPIO_PIN_NO_78, GPIO_PIN_NO_79,
|
||
GPIO_PIN_NO_80, GPIO_PIN_NO_81, GPIO_PIN_NO_82, GPIO_PIN_NO_83, GPIO_PIN_NO_84, GPIO_PIN_NO_85, GPIO_PIN_NO_86, GPIO_PIN_NO_87,
|
||
GPIO_PIN_NO_88, GPIO_PIN_NO_89, GPIO_PIN_NO_90, GPIO_PIN_NO_91, GPIO_PIN_NO_92, GPIO_PIN_NO_93, GPIO_PIN_NO_94, GPIO_PIN_NO_95,
|
||
GPIO_PIN_NO_96, GPIO_PIN_NO_97, GPIO_PIN_NO_98, GPIO_PIN_NO_99, GPIO_PIN_NO_100, GPIO_PIN_NO_101, GPIO_PIN_NO_102, GPIO_PIN_NO_103,
|
||
GPIO_PIN_NO_104, GPIO_PIN_NO_105, GPIO_PIN_NO_106, GPIO_PIN_NO_107, GPIO_PIN_NO_108, GPIO_PIN_NO_109, GPIO_PIN_NO_110, GPIO_PIN_NO_111,
|
||
GPIO_PIN_NO_112, GPIO_PIN_NO_113, GPIO_PIN_NO_114, GPIO_PIN_NO_115, GPIO_PIN_NO_116, GPIO_PIN_NO_117, GPIO_PIN_NO_118, GPIO_PIN_NO_119,
|
||
GPIO_PIN_NO_120, GPIO_PIN_NO_121, GPIO_PIN_NO_122, GPIO_PIN_NO_123, GPIO_PIN_NO_124, GPIO_PIN_NO_125, GPIO_PIN_NO_126, GPIO_PIN_NO_127,
|
||
GPIO_PIN_NO_MAX,
|
||
}GPIO_PIN_NUMBER_E;
|
||
|
||
typedef enum PIN_DIRECTION_ENUM {
|
||
PIN_DIRECTION_IN = 0,
|
||
PIN_DIRECTION_OUT,
|
||
}PIN_DIRECTION_E;
|
||
|
||
typedef enum PIN_LEVEL_ENUM {
|
||
PIN_LEVEL_LOW = 0,
|
||
PIN_LEVEL_HIGH,
|
||
}PIN_LEVEL_E;
|
||
|
||
typedef enum PIN_PULL_ENUM {
|
||
PIN_PULL_DISABLE = 0,
|
||
PIN_PULL_PU,
|
||
PIN_PULL_PD,
|
||
}PIN_PULL_E;
|
||
|
||
typedef enum PIN_EDGE_ENUM {
|
||
PIN_NO_EDGE = 0,
|
||
PIN_RISING_EDGE,
|
||
PIN_FALLING_EDGE,
|
||
PIN_BOTH_EDGE,
|
||
}PIN_EDGE_E;
|
||
|
||
typedef enum PIN_DRIVE_LEVEL_ENUM {
|
||
GPIO_DRV_LEVEL_VERY_SLOW = 0,
|
||
GPIO_DRV_LEVEL_SLOW,
|
||
GPIO_DRV_LEVEL_MED,
|
||
GPIO_DRV_LEVEL_FAST
|
||
}QL_PIN_DRIVE_LEVEL_E;
|
||
|
||
typedef enum QL_LDO_VOL_ENUM {
|
||
QL_LDO_1_8V,
|
||
QL_LDO_2_8V,
|
||
}QL_LDO_VOL_E;
|
||
|
||
typedef struct quec_gpio_cfg_struct {
|
||
GPIO_PIN_NUMBER_E gpio_pin_num;
|
||
PIN_DIRECTION_E pin_dir;
|
||
PIN_EDGE_E pin_edge;
|
||
PIN_PULL_E pin_pull;
|
||
PIN_LEVEL_E pin_level;
|
||
}quec_gpio_cfg_t;
|
||
|
||
typedef enum QL_PIMC_GPIO_ENUM{
|
||
PMIC_GPIO_PIN_209,
|
||
PMIC_GPIO_PIN_210,
|
||
PMIC_GPIO_PIN_217,
|
||
}QL_PIMC_GPIO_E;
|
||
|
||
typedef enum QL_USIM2_IO_ENUM{
|
||
USIM2_IO_VOL_1_8V,
|
||
USIM2_IO_VOL_3_3V,
|
||
}QL_USIM2_IO_E;
|
||
|
||
int ql_gpio_init(GPIO_PIN_NUMBER_E gpio_num, PIN_DIRECTION_E pin_dir, PIN_PULL_E pin_pull, PIN_LEVEL_E pin_level);
|
||
int ql_gpio_deinit(GPIO_PIN_NUMBER_E gpio_num);
|
||
int ql_gpio_set_level(GPIO_PIN_NUMBER_E gpio_num, PIN_LEVEL_E pin_level);
|
||
int ql_gpio_get_level(GPIO_PIN_NUMBER_E gpio_num, PIN_LEVEL_E *p_pin_level);
|
||
int ql_gpio_set_direction(GPIO_PIN_NUMBER_E gpio_num, PIN_DIRECTION_E pin_dir);
|
||
int ql_gpio_get_direction(GPIO_PIN_NUMBER_E gpio_num, PIN_DIRECTION_E *p_pin_dir);
|
||
int ql_gpio_set_pull(GPIO_PIN_NUMBER_E gpio_num, PIN_PULL_E pin_pull);
|
||
int ql_gpio_get_pull(GPIO_PIN_NUMBER_E gpio_num, PIN_PULL_E *p_pin_pull);
|
||
|
||
int ql_eint_register(GPIO_PIN_NUMBER_E gpio_num, PIN_EDGE_E pin_edge, PIN_PULL_E pin_pull, void *eint_cb, void *wakeup_eint_cb);
|
||
int ql_eint_unregister(GPIO_PIN_NUMBER_E gpio_num);
|
||
int ql_eint_enable(GPIO_PIN_NUMBER_E gpio_num, PIN_EDGE_E pin_edge);
|
||
int ql_eint_disable(GPIO_PIN_NUMBER_E gpio_num);
|
||
int ql_eint_enable_wakeup(GPIO_PIN_NUMBER_E gpio_num, PIN_EDGE_E pin_edge);
|
||
int ql_eint_disable_wakeup(GPIO_PIN_NUMBER_E gpio_num);
|
||
|
||
int ql_set_pmic_gpio_level(QL_PIMC_GPIO_E PINx,unsigned char level);/* somer.zhang-2020/05/11:set pmic gpio out high level(1) or low level(0) */
|
||
|
||
/*****************************************************************
|
||
* Function: ql_pin_set_func
|
||
*
|
||
Description: 设置pin脚的复用功能
|
||
*
|
||
* Parameters:
|
||
* gpio_num:
|
||
* fun_sel:0-7,对应pinmux表的
|
||
* Return:
|
||
* 0 , succeed.
|
||
* -1, error.
|
||
*****************************************************************/
|
||
|
||
int ql_pin_set_func(GPIO_PIN_NUMBER_E gpio_num, unsigned char func_sel);
|
||
|
||
/*****************************************************************
|
||
* Function: ql_gpio_map_clock
|
||
*
|
||
Description: Notice
|
||
* Configure GPIO_122 to output 32K clock(32787Hz).
|
||
* Parameters:
|
||
* only: gpio_num = GPIO_PIN_NO_122
|
||
* Return:
|
||
* 0 , the function execution succeed.
|
||
* -1, the parameter error.
|
||
*****************************************************************/
|
||
|
||
int ql_gpio_map_clock(GPIO_PIN_NUMBER_E gpio_num);
|
||
|
||
/***********************************************************************
|
||
*
|
||
* Name: ql_set_usim2_io_vol
|
||
*
|
||
* Description: 设置usim相关引脚电压域（GPIO45~47,此接口仅适用于1606平台项目）
|
||
*
|
||
* Parameters: onoff： 开启或关闭电压域：0：关闭；1：开启
|
||
vol: 要设置的电压域，参考枚举QL_USIM2_IO_E
|
||
*
|
||
* Returns: 0 sucess
|
||
-1 fail
|
||
* Notes:
|
||
*
|
||
***********************************************************************/
|
||
int ql_set_usim2_io_vol(char onoff, QL_USIM2_IO_E vol);
|
||
|
||
/*****************************************************************
|
||
* Function: ql_sfp_eint_register
|
||
*
|
||
* Description: Notice：注册特殊功能引脚唤醒中断
|
||
*
|
||
* Parameters:
|
||
* gpio_num : gpio号
|
||
* wakeup_eint_cb : 唤醒中断回调函数
|
||
|
||
* Return:
|
||
* 0 , the function execution succeed.
|
||
* -1, the parameter error.
|
||
*****************************************************************/
|
||
int ql_sfp_eint_register(GPIO_PIN_NUMBER_E gpio_num, void *wakeup_eint_cb);
|
||
/*****************************************************************
|
||
* Function: ql_sfp_eint_unregister
|
||
*
|
||
* Description: Notice：注销特殊功能引脚唤醒中断
|
||
*
|
||
* Parameters: gpio_num : gpio号
|
||
*
|
||
* Return:
|
||
* 0 , the function execution succeed.
|
||
* -1, the parameter error.
|
||
*****************************************************************/
|
||
int ql_sfp_eint_unregister(GPIO_PIN_NUMBER_E gpio_num);
|
||
|
||
/*****************************************************************
|
||
* Function: ql_gpio_set_drv_level
|
||
*
|
||
* Description: Notice：配置对应GPIO的驱动能力等级,需要在GPIO初始化
|
||
* (ql_gpio_init & ql_gpio_set_direction)之后调用
|
||
*
|
||
*
|
||
* Parameters: gpio_num : gpio号
|
||
*
|
||
* Return:
|
||
* 0 , the function execution succeed.
|
||
* -1, the parameter error.
|
||
*****************************************************************/
|
||
int ql_gpio_set_drv_level(GPIO_PIN_NUMBER_E gpio_num, QL_PIN_DRIVE_LEVEL_E drive_level);
|
||
|
||
/*****************************************************************
|
||
* Function: ql_gpio_get_drv_level
|
||
*
|
||
* Description: Notice：获取对应GPIO的驱动能力等级
|
||
*
|
||
*
|
||
* Parameters: gpio_num : gpio号
|
||
*
|
||
* Return:
|
||
* 0 , the function execution succeed.
|
||
* -1, the parameter error.
|
||
*****************************************************************/
|
||
int ql_gpio_get_drv_level(GPIO_PIN_NUMBER_E gpio_num, QL_PIN_DRIVE_LEVEL_E *drive_level);
|
||
|
||
/*****************************************************************
|
||
* Function: ql_peripherals_pin_not_config
|
||
*
|
||
* Description: Notice：设置gpio脚不配置复用功能
|
||
*
|
||
* Parameters:
|
||
* gpio_num : gpio号
|
||
|
||
* Return:
|
||
* 0 , the function execution succeed.
|
||
* -1, the parameter error.
|
||
*****************************************************************/
|
||
int ql_peripherals_pin_not_config(GPIO_PIN_NUMBER_E gpio_num);
|
||
|
||
#ifdef __cplusplus
|
||
} /*"C" */
|
||
#endif
|
||
|
||
#endif /* _QUEC_GPIO_H_ */
|
||
|