1 /*! 2 \file gd32f3x0_ctc.h 3 \brief definitions for the CTC 4 5 \version 2017-06-06, V1.0.0, firmware for GD32F3x0 6 \version 2019-06-01, V2.0.0, firmware for GD32F3x0 7 \version 2020-09-30, V2.1.0, firmware for GD32F3x0 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 GD32F3X0_CTC_H 38 #define GD32F3X0_CTC_H 39 40 #include "gd32f3x0.h" 41 42 /* CTC definitions */ 43 #define CTC CTC_BASE 44 45 /* registers definitions */ 46 #define CTC_CTL0 REG32(CTC + 0x00000000U) /*!< CTC control register 0 */ 47 #define CTC_CTL1 REG32(CTC + 0x00000004U) /*!< CTC control register 1 */ 48 #define CTC_STAT REG32(CTC + 0x00000008U) /*!< CTC status register */ 49 #define CTC_INTC REG32(CTC + 0x0000000CU) /*!< 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 #define CTL0_TRIMVALUE(regval) (BITS(8,13) & ((uint32_t)(regval) << 8)) 88 #define CTL1_CKLIM(regval) (BITS(16,23) & ((uint32_t)(regval) << 16)) 89 #define GET_STAT_REFCAP(regval) GET_BITS((regval),16,31) 90 #define GET_CTL0_TRIMVALUE(regval) GET_BITS((regval),8,13) 91 92 /* hardware automatically trim mode definitions */ 93 #define CTC_HARDWARE_TRIM_MODE_ENABLE CTC_CTL0_AUTOTRIM /*!< hardware automatically trim mode enable*/ 94 #define CTC_HARDWARE_TRIM_MODE_DISABLE ((uint32_t)0x00000000U) /*!< hardware automatically trim mode disable*/ 95 96 /* reference signal source polarity definitions */ 97 #define CTC_REFSOURCE_POLARITY_FALLING CTC_CTL1_REFPOL /*!< reference signal source polarity is falling edge*/ 98 #define CTC_REFSOURCE_POLARITY_RISING ((uint32_t)0x00000000U) /*!< reference signal source polarity is rising edge*/ 99 100 /* reference signal source selection definitions */ 101 #define CTL1_REFSEL(regval) (BITS(28,29) & ((uint32_t)(regval) << 28)) 102 #define CTC_REFSOURCE_GPIO CTL1_REFSEL(0) /*!< GPIO is selected */ 103 #define CTC_REFSOURCE_LXTAL CTL1_REFSEL(1) /*!< LXTAL is clock selected */ 104 #define CTC_REFSOURCE_USBSOF CTL1_REFSEL(2) /*!< USBFSSOF selected */ 105 106 /* reference signal source prescaler definitions */ 107 #define CTL1_REFPSC(regval) (BITS(24,26) & ((uint32_t)(regval) << 24)) 108 #define CTC_REFSOURCE_PSC_OFF CTL1_REFPSC(0) /*!< reference signal not divided */ 109 #define CTC_REFSOURCE_PSC_DIV2 CTL1_REFPSC(1) /*!< reference signal divided by 2 */ 110 #define CTC_REFSOURCE_PSC_DIV4 CTL1_REFPSC(2) /*!< reference signal divided by 4 */ 111 #define CTC_REFSOURCE_PSC_DIV8 CTL1_REFPSC(3) /*!< reference signal divided by 8 */ 112 #define CTC_REFSOURCE_PSC_DIV16 CTL1_REFPSC(4) /*!< reference signal divided by 16 */ 113 #define CTC_REFSOURCE_PSC_DIV32 CTL1_REFPSC(5) /*!< reference signal divided by 32 */ 114 #define CTC_REFSOURCE_PSC_DIV64 CTL1_REFPSC(6) /*!< reference signal divided by 64 */ 115 #define CTC_REFSOURCE_PSC_DIV128 CTL1_REFPSC(7) /*!< reference signal divided by 128 */ 116 117 /* CTC interrupt enable definitions */ 118 #define CTC_INT_CKOK CTC_CTL0_CKOKIE /*!< clock trim OK interrupt enable */ 119 #define CTC_INT_CKWARN CTC_CTL0_CKWARNIE /*!< clock trim warning interrupt enable */ 120 #define CTC_INT_ERR CTC_CTL0_ERRIE /*!< error interrupt enable */ 121 #define CTC_INT_EREF CTC_CTL0_EREFIE /*!< expect reference interrupt enable */ 122 123 /* CTC interrupt source definitions */ 124 #define CTC_INT_FLAG_CKOK CTC_STAT_CKOKIF /*!< clock trim OK interrupt flag */ 125 #define CTC_INT_FLAG_CKWARN CTC_STAT_CKWARNIF /*!< clock trim warning interrupt flag */ 126 #define CTC_INT_FLAG_ERR CTC_STAT_ERRIF /*!< error interrupt flag */ 127 #define CTC_INT_FLAG_EREF CTC_STAT_EREFIF /*!< expect reference interrupt flag */ 128 #define CTC_INT_FLAG_CKERR CTC_STAT_CKERR /*!< clock trim error bit */ 129 #define CTC_INT_FLAG_REFMISS CTC_STAT_REFMISS /*!< reference sync pulse miss */ 130 #define CTC_INT_FLAG_TRIMERR CTC_STAT_TRIMERR /*!< trim value error */ 131 132 /* CTC flag definitions */ 133 #define CTC_FLAG_CKOK CTC_STAT_CKOKIF /*!< clock trim OK flag */ 134 #define CTC_FLAG_CKWARN CTC_STAT_CKWARNIF /*!< clock trim warning flag */ 135 #define CTC_FLAG_ERR CTC_STAT_ERRIF /*!< error flag */ 136 #define CTC_FLAG_EREF CTC_STAT_EREFIF /*!< expect reference flag */ 137 #define CTC_FLAG_CKERR CTC_STAT_CKERR /*!< clock trim error bit */ 138 #define CTC_FLAG_REFMISS CTC_STAT_REFMISS /*!< reference sync pulse miss */ 139 #define CTC_FLAG_TRIMERR CTC_STAT_TRIMERR /*!< trim value error bit */ 140 141 /* function declarations */ 142 /* initialization functions */ 143 /* reset ctc clock trim controller */ 144 void ctc_deinit(void); 145 /* configure reference signal source polarity */ 146 void ctc_refsource_polarity_config(uint32_t polarity); 147 /* select reference signal source */ 148 void ctc_refsource_signal_select(uint32_t refs); 149 /* configure reference signal source prescaler */ 150 void ctc_refsource_prescaler_config(uint32_t prescaler); 151 /* configure clock trim base limit value */ 152 void ctc_clock_limit_value_config(uint8_t limit_value); 153 /* configure CTC counter reload value */ 154 void ctc_counter_reload_value_config(uint16_t reload_value); 155 /* enable CTC trim counter */ 156 void ctc_counter_enable(void); 157 /* disable CTC trim counter */ 158 void ctc_counter_disable(void); 159 160 /* function configuration */ 161 /* configure the IRC48M trim value */ 162 void ctc_irc48m_trim_value_config(uint8_t trim_value); 163 /* generate software reference source sync pulse */ 164 void ctc_software_refsource_pulse_generate(void); 165 /* configure hardware automatically trim mode */ 166 void ctc_hardware_trim_mode_config(uint32_t hardmode); 167 168 /* reading functions */ 169 /* read CTC counter capture value when reference sync pulse occurred */ 170 uint16_t ctc_counter_capture_value_read(void); 171 /* read CTC trim counter direction when reference sync pulse occurred */ 172 FlagStatus ctc_counter_direction_read(void); 173 /* read CTC counter reload value */ 174 uint16_t ctc_counter_reload_value_read(void); 175 /* read the IRC48M trim value */ 176 uint8_t ctc_irc48m_trim_value_read(void); 177 178 /* interrupt & flag functions */ 179 /* enable the CTC interrupt */ 180 void ctc_interrupt_enable(uint32_t interrupt); 181 /* disable the CTC interrupt */ 182 void ctc_interrupt_disable(uint32_t interrupt); 183 /* get CTC flag */ 184 FlagStatus ctc_flag_get(uint32_t flag); 185 /* clear CTC flag */ 186 void ctc_flag_clear(uint32_t flag); 187 /* get CTC interrupt flag */ 188 FlagStatus ctc_interrupt_flag_get(uint32_t interrupt); 189 /* clear CTC interrupt flag */ 190 void ctc_interrupt_flag_clear(uint32_t interrupt); 191 192 #endif /* GD32F3X0_CTC_H */ 193
