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