1 /*! 2 \file gd32f403_ctc.h 3 \brief definitions for the CTC 4 5 \version 2017-02-10, V1.0.0, firmware for GD32F403 6 \version 2018-12-25, V2.0.0, firmware for GD32F403 7 \version 2020-09-30, V2.1.0, firmware for GD32F403 8 */ 9 10 /* 11 Copyright (c) 2020, GigaDevice Semiconductor Inc. 12 13 Redistribution and use in source and binary forms, with or without modification, 14 are permitted provided that the following conditions are met: 15 16 1. Redistributions of source code must retain the above copyright notice, this 17 list of conditions and the following disclaimer. 18 2. Redistributions in binary form must reproduce the above copyright notice, 19 this list of conditions and the following disclaimer in the documentation 20 and/or other materials provided with the distribution. 21 3. Neither the name of the copyright holder nor the names of its contributors 22 may be used to endorse or promote products derived from this software without 23 specific prior written permission. 24 25 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 26 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 27 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 28 IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 29 INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 30 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 31 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 32 WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 33 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY 34 OF SUCH DAMAGE. 35 */ 36 37 #ifndef GD32F403_CTC_H 38 #define GD32F403_CTC_H 39 40 #include "gd32f403.h" 41 42 /* CTC definitions */ 43 #define CTC CTC_BASE 44 45 /* registers definitions */ 46 #define CTC_CTL0 REG32((CTC) + 0x00U) /*!< CTC control register 0 */ 47 #define CTC_CTL1 REG32((CTC) + 0x04U) /*!< CTC control register 1 */ 48 #define CTC_STAT REG32((CTC) + 0x08U) /*!< CTC status register */ 49 #define CTC_INTC REG32((CTC) + 0x0CU) /*!< CTC interrupt clear register */ 50 51 /* bits definitions */ 52 /* CTC_CTL0 */ 53 #define CTC_CTL0_CKOKIE BIT(0) /*!< clock trim OK(CKOKIF) interrupt enable */ 54 #define CTC_CTL0_CKWARNIE BIT(1) /*!< clock trim warning(CKWARNIF) interrupt enable */ 55 #define CTC_CTL0_ERRIE BIT(2) /*!< error(ERRIF) interrupt enable */ 56 #define CTC_CTL0_EREFIE BIT(3) /*!< EREFIF interrupt enable */ 57 #define CTC_CTL0_CNTEN BIT(5) /*!< CTC counter enable */ 58 #define CTC_CTL0_AUTOTRIM BIT(6) /*!< hardware automatically trim mode */ 59 #define CTC_CTL0_SWREFPUL BIT(7) /*!< software reference source sync pulse */ 60 #define CTC_CTL0_TRIMVALUE BITS(8,13) /*!< IRC48M trim value */ 61 62 /* CTC_CTL1 */ 63 #define CTC_CTL1_RLVALUE BITS(0,15) /*!< CTC counter reload value */ 64 #define CTC_CTL1_CKLIM BITS(16,23) /*!< clock trim base limit value */ 65 #define CTC_CTL1_REFPSC BITS(24,26) /*!< reference signal source prescaler */ 66 #define CTC_CTL1_REFSEL BITS(28,29) /*!< reference signal source selection */ 67 #define CTC_CTL1_REFPOL BIT(31) /*!< reference signal source polarity */ 68 69 /* CTC_STAT */ 70 #define CTC_STAT_CKOKIF BIT(0) /*!< clock trim OK interrupt flag */ 71 #define CTC_STAT_CKWARNIF BIT(1) /*!< clock trim warning interrupt flag */ 72 #define CTC_STAT_ERRIF BIT(2) /*!< error interrupt flag */ 73 #define CTC_STAT_EREFIF BIT(3) /*!< expect reference interrupt flag */ 74 #define CTC_STAT_CKERR BIT(8) /*!< clock trim error bit */ 75 #define CTC_STAT_REFMISS BIT(9) /*!< reference sync pulse miss */ 76 #define CTC_STAT_TRIMERR BIT(10) /*!< trim value error bit */ 77 #define CTC_STAT_REFDIR BIT(15) /*!< CTC trim counter direction when reference sync pulse occurred */ 78 #define CTC_STAT_REFCAP BITS(16,31) /*!< CTC counter capture when reference sync pulse occurred */ 79 80 /* CTC_INTC */ 81 #define CTC_INTC_CKOKIC BIT(0) /*!< CKOKIF interrupt clear bit */ 82 #define CTC_INTC_CKWARNIC BIT(1) /*!< CKWARNIF interrupt clear bit */ 83 #define CTC_INTC_ERRIC BIT(2) /*!< ERRIF interrupt clear bit */ 84 #define CTC_INTC_EREFIC BIT(3) /*!< EREFIF interrupt clear bit */ 85 86 /* constants definitions */ 87 /* hardware automatically trim mode definitions */ 88 #define CTC_HARDWARE_TRIM_MODE_ENABLE CTC_CTL0_AUTOTRIM /*!< hardware automatically trim mode enable*/ 89 #define CTC_HARDWARE_TRIM_MODE_DISABLE ((uint32_t)0x00000000U) /*!< hardware automatically trim mode disable*/ 90 91 /* reference signal source polarity definitions */ 92 #define CTC_REFSOURCE_POLARITY_FALLING CTC_CTL1_REFPOL /*!< reference signal source polarity is falling edge*/ 93 #define CTC_REFSOURCE_POLARITY_RISING ((uint32_t)0x00000000U) /*!< reference signal source polarity is rising edge*/ 94 95 /* reference signal source selection definitions */ 96 #define CTL1_REFSEL(regval) (BITS(28,29) & ((uint32_t)(regval) << 28)) 97 #define CTC_REFSOURCE_GPIO CTL1_REFSEL(0) /*!< GPIO is selected */ 98 #define CTC_REFSOURCE_LXTAL CTL1_REFSEL(1) /*!< LXTAL is selected */ 99 #define CTC_REFSOURCE_USBFS_SOF CTL1_REFSEL(2) /*!< USBFS_SOF is selected */ 100 101 /* reference signal source prescaler definitions */ 102 #define CTL1_REFPSC(regval) (BITS(24,26) & ((uint32_t)(regval) << 24)) 103 #define CTC_REFSOURCE_PSC_OFF CTL1_REFPSC(0) /*!< reference signal not divided */ 104 #define CTC_REFSOURCE_PSC_DIV2 CTL1_REFPSC(1) /*!< reference signal divided by 2 */ 105 #define CTC_REFSOURCE_PSC_DIV4 CTL1_REFPSC(2) /*!< reference signal divided by 4 */ 106 #define CTC_REFSOURCE_PSC_DIV8 CTL1_REFPSC(3) /*!< reference signal divided by 8 */ 107 #define CTC_REFSOURCE_PSC_DIV16 CTL1_REFPSC(4) /*!< reference signal divided by 16 */ 108 #define CTC_REFSOURCE_PSC_DIV32 CTL1_REFPSC(5) /*!< reference signal divided by 32 */ 109 #define CTC_REFSOURCE_PSC_DIV64 CTL1_REFPSC(6) /*!< reference signal divided by 64 */ 110 #define CTC_REFSOURCE_PSC_DIV128 CTL1_REFPSC(7) /*!< reference signal divided by 128 */ 111 112 /* CTC interrupt enable definitions */ 113 #define CTC_INT_CKOK CTC_CTL0_CKOKIE /*!< clock trim OK interrupt enable */ 114 #define CTC_INT_CKWARN CTC_CTL0_CKWARNIE /*!< clock trim warning interrupt enable */ 115 #define CTC_INT_ERR CTC_CTL0_ERRIE /*!< error interrupt enable */ 116 #define CTC_INT_EREF CTC_CTL0_EREFIE /*!< expect reference interrupt enable */ 117 118 /* CTC interrupt source definitions */ 119 #define CTC_INT_FLAG_CKOK CTC_STAT_CKOKIF /*!< clock trim OK interrupt flag */ 120 #define CTC_INT_FLAG_CKWARN CTC_STAT_CKWARNIF /*!< clock trim warning interrupt flag */ 121 #define CTC_INT_FLAG_ERR CTC_STAT_ERRIF /*!< error interrupt flag */ 122 #define CTC_INT_FLAG_EREF CTC_STAT_EREFIF /*!< expect reference interrupt flag */ 123 #define CTC_INT_FLAG_CKERR CTC_STAT_CKERR /*!< clock trim error bit */ 124 #define CTC_INT_FLAG_REFMISS CTC_STAT_REFMISS /*!< reference sync pulse miss */ 125 #define CTC_INT_FLAG_TRIMERR CTC_STAT_TRIMERR /*!< trim value error */ 126 127 /* CTC flag definitions */ 128 #define CTC_FLAG_CKOK CTC_STAT_CKOKIF /*!< clock trim OK flag */ 129 #define CTC_FLAG_CKWARN CTC_STAT_CKWARNIF /*!< clock trim warning flag */ 130 #define CTC_FLAG_ERR CTC_STAT_ERRIF /*!< error flag */ 131 #define CTC_FLAG_EREF CTC_STAT_EREFIF /*!< expect reference flag */ 132 #define CTC_FLAG_CKERR CTC_STAT_CKERR /*!< clock trim error bit */ 133 #define CTC_FLAG_REFMISS CTC_STAT_REFMISS /*!< reference sync pulse miss */ 134 #define CTC_FLAG_TRIMERR CTC_STAT_TRIMERR /*!< trim value error bit */ 135 136 /* function declarations */ 137 /* reset ctc clock trim controller */ 138 void ctc_deinit(void); 139 140 /* enable CTC trim counter */ 141 void ctc_counter_enable(void); 142 /* disable CTC trim counter */ 143 void ctc_counter_disable(void); 144 145 /* configure the IRC48M trim value */ 146 void ctc_irc48m_trim_value_config(uint8_t trim_value); 147 /* generate software reference source sync pulse */ 148 void ctc_software_refsource_pulse_generate(void); 149 /* configure hardware automatically trim mode */ 150 void ctc_hardware_trim_mode_config(uint32_t hardmode); 151 152 /* configure reference signal source polarity */ 153 void ctc_refsource_polarity_config(uint32_t polarity); 154 /* select reference signal source */ 155 void ctc_refsource_signal_select(uint32_t refs); 156 /* configure reference signal source prescaler */ 157 void ctc_refsource_prescaler_config(uint32_t prescaler); 158 /* configure clock trim base limit value */ 159 void ctc_clock_limit_value_config(uint8_t limit_value); 160 /* configure CTC counter reload value */ 161 void ctc_counter_reload_value_config(uint16_t reload_value); 162 163 /* read CTC counter capture value when reference sync pulse occurred */ 164 uint16_t ctc_counter_capture_value_read(void); 165 /* read CTC trim counter direction when reference sync pulse occurred */ 166 FlagStatus ctc_counter_direction_read(void); 167 /* read CTC counter reload value */ 168 uint16_t ctc_counter_reload_value_read(void); 169 /* read the IRC48M trim value */ 170 uint8_t ctc_irc48m_trim_value_read(void); 171 172 /* interrupt & flag functions */ 173 /* enable the CTC interrupt */ 174 void ctc_interrupt_enable(uint32_t interrupt); 175 /* disable the CTC interrupt */ 176 void ctc_interrupt_disable(uint32_t interrupt); 177 /* get CTC interrupt flag */ 178 FlagStatus ctc_interrupt_flag_get(uint32_t int_flag); 179 /* clear CTC interrupt flag */ 180 void ctc_interrupt_flag_clear(uint32_t int_flag); 181 /* get CTC flag */ 182 FlagStatus ctc_flag_get(uint32_t flag); 183 /* clear CTC flag */ 184 void ctc_flag_clear(uint32_t flag); 185 186 #endif /* GD32F403_CTC_H */ 187
