1 /******************************************************************************* 2 * Copyright (C) 2018, Huada Semiconductor Co.,Ltd All rights reserved. 3 * 4 * This software is owned and published by: 5 * Huada Semiconductor Co.,Ltd ("HDSC"). 6 * 7 * BY DOWNLOADING, INSTALLING OR USING THIS SOFTWARE, YOU AGREE TO BE BOUND 8 * BY ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT. 9 * 10 * This software contains source code for use with HDSC 11 * components. This software is licensed by HDSC to be adapted only 12 * for use in systems utilizing HDSC components. HDSC shall not be 13 * responsible for misuse or illegal use of this software for devices not 14 * supported herein. HDSC is providing this software "AS IS" and will 15 * not be responsible for issues arising from incorrect user implementation 16 * of the software. 17 * 18 * Disclaimer: 19 * HDSC MAKES NO WARRANTY, EXPRESS OR IMPLIED, ARISING BY LAW OR OTHERWISE, 20 * REGARDING THE SOFTWARE (INCLUDING ANY ACOOMPANYING WRITTEN MATERIALS), 21 * ITS PERFORMANCE OR SUITABILITY FOR YOUR INTENDED USE, INCLUDING, 22 * WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, THE IMPLIED 23 * WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE, AND THE IMPLIED 24 * WARRANTY OF NONINFRINGEMENT. 25 * HDSC SHALL HAVE NO LIABILITY (WHETHER IN CONTRACT, WARRANTY, TORT, 26 * NEGLIGENCE OR OTHERWISE) FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT 27 * LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, 28 * LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING FROM USE OR 29 * INABILITY TO USE THE SOFTWARE, INCLUDING, WITHOUT LIMITATION, ANY DIRECT, 30 * INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOSS OF DATA, 31 * SAVINGS OR PROFITS, 32 * EVEN IF Disclaimer HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 33 * YOU ASSUME ALL RESPONSIBILITIES FOR SELECTION OF THE SOFTWARE TO ACHIEVE YOUR 34 * INTENDED RESULTS, AND FOR THE INSTALLATION OF, USE OF, AND RESULTS OBTAINED 35 * FROM, THE SOFTWARE. 36 * 37 * This software may be replicated in part or whole for the licensed use, 38 * with the restriction that this Disclaimer and Copyright notice must be 39 * included with each copy of this software, whether used in part or whole, 40 * at all times. 41 */ 42 /******************************************************************************/ 43 /** \file timer3.h 44 ** 45 ** 基本定时器数据结构及API声明 46 ** @link Timer3 Group Some description @endlink 47 ** 48 ** History: 49 ** - 2019-04-18 Husj First Version 50 ** 51 *****************************************************************************/ 52 53 #ifndef __TIMER3_H__ 54 #define __TIMER3_H__ 55 56 /***************************************************************************** 57 * Include files 58 *****************************************************************************/ 59 #include "ddl.h" 60 61 62 #ifdef __cplusplus 63 extern "C" 64 { 65 #endif 66 67 /** 68 ****************************************************************************** 69 ** \defgroup Tim3Group Timer3 (TIM3) 70 ** 71 ******************************************************************************/ 72 //@{ 73 74 /******************************************************************************/ 75 /* Global pre-processor symbols/macros ('#define') */ 76 /******************************************************************************/ 77 78 /****************************************************************************** 79 * Global type definitions 80 ******************************************************************************/ 81 82 /** 83 ****************************************************************************** 84 ** \brief Timer3 通道定义 85 *****************************************************************************/ 86 typedef enum en_tim3_channel 87 { 88 Tim3CH0 = 0u, ///< Timer3通道0 89 Tim3CH1 = 1u, ///< Timer3通道1 90 Tim3CH2 = 2u, ///< Timer3通道2 91 }en_tim3_channel_t; 92 93 /** 94 ****************************************************************************** 95 ** \brief 工作模式选择数据类型重定义 (MODE)(模式0/1/23) 96 *****************************************************************************/ 97 typedef enum en_tim3_work_mode 98 { 99 Tim3WorkMode0 = 0u, ///< 定时器模式 100 Tim3WorkMode1 = 1u, ///< PWC模式 101 Tim3WorkMode2 = 2u, ///< 锯齿波模式 102 Tim3WorkMode3 = 3u, ///< 三角波模式 103 }en_tim3_work_mode_t; 104 105 /** 106 ****************************************************************************** 107 ** \brief 极性控制数据类型重定义 (GATE_P)(模式0) 108 *****************************************************************************/ 109 typedef enum en_tim3_m0cr_gatep 110 { 111 Tim3GatePositive = 0u, ///< 高电平有效 112 Tim3GateOpposite = 1u, ///< 低电平有效 113 }en_tim3_m0cr_gatep_t; 114 115 /** 116 ****************************************************************************** 117 ** \brief TIM3 预除频选择 (PRS)(模式0/1/23) 118 *****************************************************************************/ 119 typedef enum en_tim3_cr_timclkdiv 120 { 121 Tim3PCLKDiv1 = 0u, ///< Div 1 122 Tim3PCLKDiv2 = 1u, ///< Div 2 123 Tim3PCLKDiv4 = 2u, ///< Div 4 124 Tim3PCLKDiv8 = 3u, ///< Div 8 125 Tim3PCLKDiv16 = 4u, ///< Div 16 126 Tim3PCLKDiv32 = 5u, ///< Div 32 127 Tim3PCLKDiv64 = 6u, ///< Div 64 128 Tim3PCLKDiv256 = 7u, ///< Div 256 129 }en_tim3_cr_timclkdiv_t; 130 131 /** 132 ****************************************************************************** 133 ** \brief 计数/定时器功能选择数据类型重定义 (CT)(模式0/1/23) 134 *****************************************************************************/ 135 typedef enum en_tim3_cr_ct 136 { 137 Tim3Timer = 0u, ///< 定时器功能，计数时钟为内部PCLK 138 Tim3Counter = 1u, ///< 计数器功能，计数时钟为外部ETR 139 }en_tim3_cr_ct_t; 140 141 142 /** 143 ****************************************************************************** 144 ** \brief 定时器工作模式数据类型重定义 (MD)(模式0) 145 *****************************************************************************/ 146 typedef enum en_tim3_m0cr_md 147 { 148 Tim332bitFreeMode = 0u, ///< 32位计数器/定时器 149 Tim316bitArrMode = 1u, ///< 自动重装载16位计数器/定时器 150 }en_tim3_m0cr_md_t; 151 152 /** 153 ****************************************************************************** 154 ** \brief TIM3中断类型数据类型重定义(模式0/1/23) 155 *****************************************************************************/ 156 typedef enum en_tim3_irq_type 157 { 158 Tim3UevIrq = 0u, ///< 溢出/事件更新中断 159 Tim3CA0Irq = 2u, ///< CH0A捕获/比较中断(仅模式1/23存在) 160 Tim3CA1Irq = 3u, ///< CH1A捕获/比较中断(仅模式23存在) 161 Tim3CA2Irq = 4u, ///< CH2A捕获/比较中断(仅模式23存在) 162 Tim3CB0Irq = 5u, ///< CH0B捕获/比较中断(仅模式23存在) 163 Tim3CB1Irq = 6u, ///< CH1B捕获/比较中断(仅模式23存在) 164 Tim3CB2Irq = 7u, ///< CH2B捕获/比较中断(仅模式23存在) 165 Tim3CA0E = 8u, ///< CH0A捕获数据丢失标志(仅模式23存在)(不是中断) 166 Tim3CA1E = 9u, ///< CH1A捕获数据丢失标志(仅模式23存在)(不是中断) 167 Tim3CA2E = 10u, ///< CH2A捕获数据丢失标志(仅模式23存在)(不是中断) 168 Tim3CB0E = 11u, ///< CH0B捕获数据丢失标志(仅模式23存在)(不是中断) 169 Tim3CB1E = 12u, ///< CH1B捕获数据丢失标志(仅模式23存在)(不是中断) 170 Tim3CB2E = 13u, ///< CH2B捕获数据丢失标志(仅模式23存在)(不是中断) 171 Tim3BkIrq = 14u, ///< 刹车中断(仅模式23存在） 172 Tim3TrigIrq = 15u, ///< 触发中断(仅模式23存在） 173 }en_tim3_irq_type_t; 174 175 /** 176 ****************************************************************************** 177 ** \brief 测量开始结束数据类型重定义 (Edg1stEdg2nd)(模式1) 178 *****************************************************************************/ 179 typedef enum en_tim3_m1cr_Edge 180 { 181 Tim3PwcRiseToRise = 0u, ///< 上升沿到上升沿(周期) 182 Tim3PwcFallToRise = 1u, ///< 下降沿到上升沿(低电平) 183 Tim3PwcRiseToFall = 2u, ///< 上升沿到下降沿(高电平) 184 Tim3PwcFallToFall = 3u, ///< 下降沿到下降沿(周期) 185 }en_tim3_m1cr_Edge_t; 186 187 /** 188 ****************************************************************************** 189 ** \brief PWC测量测试模式选择数据类型重定义 (Oneshot)(模式1) 190 *****************************************************************************/ 191 typedef enum en_tim3_m1cr_oneshot 192 { 193 Tim3PwcCycleDetect = 0u, ///< PWC循环测量 194 Tim3PwcOneShotDetect = 1u, ///< PWC单次测量 195 }en_tim3_m1cr_oneshot_t; 196 197 /** 198 ****************************************************************************** 199 ** \brief PWC IA0选择数据类型重定义 (IA0S)(模式1) 200 *****************************************************************************/ 201 typedef enum en_tim3_m1_mscr_ia0s 202 { 203 Tim3IA0Input = 0u, ///< IAO输入 204 Tim3XORInput = 1u, ///< IA0 ETR GATE XOR(TIM0/1/2)/IA0 IA1 IA2 XOR(TIM3) 205 }en_tim3_m1_mscr_ia0s_t; 206 207 /** 208 ****************************************************************************** 209 ** \brief PWC IB0选择数据类型重定义 (IA0S)(模式1) 210 *****************************************************************************/ 211 typedef enum en_tim3_m1_mscr_ib0s 212 { 213 Tim3IB0Input = 0u, ///< IBO输入 214 Tim3TsInput = 1u, ///< 内部触发TS选择信号 215 }en_tim3_m1_mscr_ib0s_t; 216 217 /** 218 ****************************************************************************** 219 ** \brief 输出极性、输入相位 数据类型重定义 (CCPA0/CCPB0/ETP/BKP)(模式1/23) 220 *****************************************************************************/ 221 typedef enum en_tim3_port_polarity 222 { 223 Tim3PortPositive = 0u, ///< 正常输入输出 224 Tim3PortOpposite = 1u, ///< 反向输入输出 225 }en_tim3_port_polarity_t; 226 227 /** 228 ****************************************************************************** 229 ** \brief 滤波选择数据类型重定义 (FLTET/FLTA0/FLAB0)(模式1/23) 230 *****************************************************************************/ 231 typedef enum en_tim3_flt 232 { 233 Tim3FltNone = 0u, ///< 无滤波 234 Tim3FltPCLKCnt3 = 4u, ///< PCLK 3个连续有效 235 Tim3FltPCLKDiv4Cnt3 = 5u, ///< PCLK/4 3个连续有效 236 Tim3FltPCLKDiv16Cnt3 = 6u, ///< PCLK/16 3个连续有效 237 Tim3FltPCLKDiv64Cnt3 = 7u, ///< PCLK/64 3个连续有效 238 }en_tim3_flt_t; 239 240 /** 241 ****************************************************************************** 242 ** \brief 通道比较控制 数据类型重定义 (OCMA/OCMB)(模式23) 243 *****************************************************************************/ 244 typedef enum en_tim3_m23_fltr_ocm 245 { 246 Tim3ForceLow = 0u, ///< 强制为0 247 Tim3ForceHigh = 1u, ///< 强制为1 248 Tim3CMPForceLow = 2u, ///< 比较匹配时强制为0 249 Tim3CMPForceHigh = 3u, ///< 比较匹配时强制为1 250 Tim3CMPInverse = 4u, ///< 比较匹配时翻转电平 251 Tim3CMPOnePrdHigh = 5u, ///< 比较匹配时输出一个计数周期的高电平 252 Tim3PWMMode1 = 6u, ///< 通道控制为PWM mode 1 253 Tim3PWMMode2 = 7u, ///< 通道控制为PWM mode 2 254 }en_tim3_m23_fltr_ocm_t; 255 256 /** 257 ****************************************************************************** 258 ** \brief 主从模式TS数据类型重定义 (TS)(模式1/23) 259 *****************************************************************************/ 260 typedef enum en_tim3_mscr_ts 261 { 262 Tim3Ts0ETR = 0u, ///< ETR外部输入滤波后的相位选择信号 263 Tim3Ts1TIM0TRGO = 1u, ///< Timer0的TRGO输出信号 264 Tim3Ts2TIM1TRGO = 2u, ///< Timer1的TRGO输出信号 265 Tim3Ts3TIM2TRGO = 3u, ///< Timer2的TRGO输出信号 266 Tim3Ts4TIM3TRGO = 4u, ///< Timer3的TRGO输出信号 267 //Tim3Ts5IA0ED = 5u, ///< 无效 268 Tim3Ts6IAFP = 6u, ///< CH0A 外部输输入滤波后的相位选择信号 269 Tim3Ts7IBFP = 7u, ///< CH0B 外部输输入滤波后的相位选择信 270 }en_tim3_mscr_ts_t; 271 272 /** 273 ****************************************************************************** 274 ** \brief PWM输出模式选择数据类型重定义 (COMP)(模式23) 275 *****************************************************************************/ 276 typedef enum en_tim3_m23cr_comp 277 { 278 Tim3IndependentPWM = 0u, ///< 独立PWM输出 279 Tim3ComplementaryPWM = 1u, ///< 互补PWM输出 280 }en_tim3_m23cr_comp_t; 281 282 /** 283 ****************************************************************************** 284 ** \brief 计数方向选择数据类型重定义 (DIR)(模式23) 285 *****************************************************************************/ 286 typedef enum en_tim3_m23cr_dir 287 { 288 Tim3CntUp = 0u, ///< 向上计数 289 Tim3CntDown = 1u, ///< 向下计数 290 }en_tim3_m23cr_dir_t; 291 292 /** 293 ****************************************************************************** 294 ** \brief 计数方向选择数据类型重定义 (PWM2S)(模式23) 295 *****************************************************************************/ 296 typedef enum en_tim3_m23cr_pwm2s 297 { 298 Tim3DoublePointCmp = 0u, ///< 双点比较使能，使用CCRA,CCRB比较控制OCREFA输出 299 Tim3SinglePointCmp = 1u, ///< 单点比较使能，使用CCRA比较控制OCREFA输出 300 }en_tim3_m23cr_pwm2s_t; 301 302 /** 303 ****************************************************************************** 304 ** \brief GATE在PWM互补模式下捕获或比较功能 选择数据类型重定义 (CSG)(模式23) 305 *****************************************************************************/ 306 typedef enum en_tim3_m23cr_csg 307 { 308 Tim3PWMCompGateCmpOut = 0u, ///< 在PWM互补模式下，Gate作为比较输出 309 Tim3PWMCompGateCapIn = 1u, ///< 在PWM互补模式下，Gate作为捕获输入 310 }en_tim3_m23cr_csg_t; 311 312 313 /** 314 ****************************************************************************** 315 ** \brief 比较捕获寄存器 数据类型重定义 (CCR0A,CCR0B)(模式23) 316 *****************************************************************************/ 317 typedef enum en_tim3_m23_ccrx 318 { 319 Tim3CCR0A = 0u, ///< CCR0A比较捕获寄存器 320 Tim3CCR0B = 1u, ///< CCR0B比较捕获寄存器 321 Tim3CCR1A = 2u, ///< CCR1A比较捕获寄存器 322 Tim3CCR1B = 3u, ///< CCR1B比较捕获寄存器 323 Tim3CCR2A = 4u, ///< CCR2A比较捕获寄存器 324 Tim3CCR2B = 5u, ///< CCR2B比较捕获寄存器 325 }en_tim3_m23_ccrx_t; 326 327 /** 328 ****************************************************************************** 329 ** \brief OCREF清除源 选择数据类型重定义 (OCCS)(模式23) 330 *****************************************************************************/ 331 typedef enum en_tim3_m23ce_occs 332 { 333 Tim3OC_Ref_Clr = 0u, ///< 来自VC的OC_Ref_Clr 334 Tim3ETRf = 1u, ///< 外部ETRf 335 }en_tim3_m23ce_occs_t; 336 337 /** 338 ****************************************************************************** 339 ** \brief 比较匹配中断模式 选择数据类型重定义 (CIS/CISB)(模式23) 340 *****************************************************************************/ 341 typedef enum en_tim3_m23_cisa_cisb 342 { 343 Tim3CmpIntNone = 0u, ///< 无比较匹配中断 344 Tim3CmpIntRise = 1u, ///< 比较匹配上升沿中断 345 Tim3CmpIntFall = 2u, ///< 比较匹配下降沿中断 346 Tim3CmpIntRiseFall = 3u, ///< 比较匹配上升沿下降沿中断 347 }en_tim3_m23_cisa_cisb_t; 348 349 /** 350 ****************************************************************************** 351 ** \brief TIM3端口控制 - 刹车时CHx输出状态控制(BKSA/BKSB)(模式23) 352 ** 353 ** \note 354 ******************************************************************************/ 355 typedef enum en_tim3_m23_crchx_bks 356 { 357 Tim3CHxBksHiZ = 0u, ///< 刹车使能时，CHx端口输出高阻态 358 Tim3CHxBksNorm = 1u, ///< 刹车使能时，CHx端口正常输出 359 Tim3CHxBksLow = 2u, ///< 刹车使能时，CHx端口输出低电平 360 Tim3CHxBksHigh = 3u, ///< 刹车使能时，CHx端口输出高电平 361 }en_tim3_m23_crchx_bks_t; 362 363 /** 364 ****************************************************************************** 365 ** \brief TIM3端口控制 - CHx上升沿下降沿捕获(CRx/CFx)(模式23) 366 ** 367 ** \note 368 ******************************************************************************/ 369 typedef enum en_tim3_m23_crch0_cfx_crx 370 { 371 Tim3CHxCapNone = 0u, ///< CHx通道捕获禁止 372 Tim3CHxCapRise = 1u, ///< CHx通道上升沿捕获使能 373 Tim3CHxCapFall = 2u, ///< CHx通道下降沿捕获使能 374 Tim3CHxCapFallRise = 3u, ///< CHx通道上升沿下降沿捕获都使能 375 }en_tim3_m23_crch0_cfx_crx_t; 376 377 /** 378 ****************************************************************************** 379 ** \brief TIM3端口控制 - CHx比较捕获模式(CSA/CSB)(模式23) 380 ** 381 ** \note 382 ******************************************************************************/ 383 typedef enum en_tim3_m23_crch0_csa_csb 384 { 385 Tim3CHxCmpMode = 0u, ///< CHx通道设置为比较模式 386 Tim3CHxCapMode = 1u, ///< CHx通道设置为捕获模式 387 }en_tim3_m23_crch0_csa_csb_t; 388 389 /** 390 ****************************************************************************** 391 ** \brief 比较模式下 DMA比较触发选择 数据类型重定义 (CCDS)(模式23) 392 *****************************************************************************/ 393 typedef enum en_tim3_m23_mscr_ccds 394 { 395 Tim3CmpTrigDMA = 0u, ///< 比较匹配触发DMA 396 Tim3UEVTrigDMA = 1u, ///< 事件更新代替比较匹配触发DMA 397 }en_tim3_m23_mscr_ccds_t; 398 399 /** 400 ****************************************************************************** 401 ** \brief 主从模式选择 数据类型重定义 (MSM)(模式23) 402 *****************************************************************************/ 403 typedef enum en_tim3_m23_mscr_msm 404 { 405 Tim3SlaveMode = 0u, ///< 从模式 406 Tim3MasterMode = 1u, ///< 主模式 407 }en_tim3_m23_mscr_msm_t; 408 409 /** 410 ****************************************************************************** 411 ** \brief 触发主模式输出源 数据类型重定义 (MMS)(模式23) 412 *****************************************************************************/ 413 typedef enum en_tim3_m23_mscr_mms 414 { 415 Tim3MasterUG = 0u, ///< UG(软件更新)源 416 Tim3MasterCTEN = 1u, ///< CTEN源 417 Tim3MasterUEV = 2u, ///< UEV更新源 418 Tim3MasterCMPSO = 3u, ///< 比较匹配选择输出源 419 Tim3MasterOCA0Ref = 4u, ///< OCA0_Ref源 420 Tim3MasterOCB0Ref = 5u, ///< OCB0_Ref源 421 //Tim3MasterOCB0Ref = 6u, 422 //Tim3MasterOCB0Ref = 7u, 423 }en_tim3_m23_mscr_mms_t; 424 425 /** 426 ****************************************************************************** 427 ** \brief 触发从模式选择 数据类型重定义 (SMS)(模式23) 428 *****************************************************************************/ 429 typedef enum en_tim3_m23_mscr_sms 430 { 431 Tim3SlaveIClk = 0u, ///< 使用内部时钟 432 Tim3SlaveResetTIM = 1u, ///< 复位功能 433 Tim3SlaveTrigMode = 2u, ///< 触发模式 434 Tim3SlaveEClk = 3u, ///< 外部时钟模式 435 Tim3SlaveCodeCnt1 = 4u, ///< 正交编码计数模式1 436 Tim3SlaveCodeCnt2 = 5u, ///< 正交编码计数模式2 437 Tim3SlaveCodeCnt3 = 6u, ///< 正交编码计数模式3 438 Tim3SlaveGateCtrl = 7u, ///< 门控功能 439 }en_tim3_m23_mscr_sms_t; 440 441 /** 442 ****************************************************************************** 443 ** \brief 定时器运行控制数据类型重定义 (CTEN) 444 *****************************************************************************/ 445 typedef enum en_tim3_start 446 { 447 Tim3CTENDisable = 0u, ///< 停止 448 Tim3CTENEnable = 1u, ///< 运行 449 }en_tim3_start_t; 450 451 /** 452 ****************************************************************************** 453 ** \brief TIM3 mode0 配置结构体定义(模式0) 454 *****************************************************************************/ 455 typedef struct stc_tim3_mode0_cfg 456 { 457 en_tim3_work_mode_t enWorkMode; ///< 工作模式设置 458 en_tim3_m0cr_gatep_t enGateP; ///< 门控极性控制 459 boolean_t bEnGate; ///< 门控使能 460 en_tim3_cr_timclkdiv_t enPRS; ///< 预除频配置 461 boolean_t bEnTog; ///< 翻转输出使能 462 en_tim3_cr_ct_t enCT; ///< 定时/计数功能选择 463 en_tim3_m0cr_md_t enCntMode; ///< 计数模式配置 464 }stc_tim3_mode0_cfg_t; 465 466 /** 467 ****************************************************************************** 468 ** \brief TIM3 mode1 配置结构体定义(模式1) 469 *****************************************************************************/ 470 typedef struct stc_tim3_mode1_cfg 471 { 472 en_tim3_work_mode_t enWorkMode; ///< 工作模式设置 473 en_tim3_cr_timclkdiv_t enPRS; ///< 预除频配置 474 en_tim3_cr_ct_t enCT; ///< 定时/计数功能选择 475 en_tim3_m1cr_oneshot_t enOneShot; ///< 单次测量/循环测量选择 476 }stc_tim3_mode1_cfg_t; 477 478 /** 479 ****************************************************************************** 480 ** \brief PWC输入配置结构体定义(模式1) 481 *****************************************************************************/ 482 typedef struct stc_tim3_pwc_input_cfg 483 { 484 en_tim3_mscr_ts_t enTsSel; ///< 触发输入源选择 485 en_tim3_m1_mscr_ia0s_t enIA0Sel; ///< CHA0输入选择 486 en_tim3_m1_mscr_ib0s_t enIB0Sel; ///< CHB0输入选择 487 en_tim3_port_polarity_t enETRPhase; ///< ETR相位选择 488 en_tim3_flt_t enFltETR; ///< ETR滤波设置 489 en_tim3_flt_t enFltIA0; ///< CHA0滤波设置 490 en_tim3_flt_t enFltIB0; ///< CHB0滤波设置 491 }stc_tim3_pwc_input_cfg_t; 492 493 /** 494 ****************************************************************************** 495 ** \brief TIM3 mode23 配置结构体定义(模式23) 496 *****************************************************************************/ 497 typedef struct stc_tim3_mode23_cfg 498 { 499 en_tim3_work_mode_t enWorkMode; ///< 工作模式设置 500 en_tim3_m23cr_dir_t enCntDir; ///< 计数方向 501 en_tim3_cr_timclkdiv_t enPRS; ///< 时钟预除频配置 502 en_tim3_cr_ct_t enCT; ///< 定时/计数功能选择 503 en_tim3_m23cr_comp_t enPWMTypeSel; ///< PWM模式选择（独立/互补） 504 en_tim3_m23cr_pwm2s_t enPWM2sSel; ///< OCREFA双点比较功能选择 505 boolean_t bOneShot; ///< 单次触发模式使能/禁止 506 boolean_t bURSSel; ///< 更新源选择 507 }stc_tim3_mode23_cfg_t; 508 509 /** 510 ****************************************************************************** 511 ** \brief GATE在PWM互补模式下捕获或比较功能 配置结构体定义(模式23) 512 *****************************************************************************/ 513 typedef struct stc_tim3_m23_gate_cfg 514 { 515 en_tim3_m23cr_csg_t enGateFuncSel; ///< Gate比较、捕获功能选择 516 boolean_t bGateRiseCap; ///< GATE作为捕获功能时，上沿捕获有效控制 517 boolean_t bGateFallCap; ///< GATE作为捕获功能时，下沿捕获有效控制 518 }stc_tim3_m23_gate_cfg_t; 519 520 /** 521 ****************************************************************************** 522 ** \brief CHA/CHB通道比较控制 配置结构体定义(模式23) 523 *****************************************************************************/ 524 typedef struct stc_tim3_m23_compare_cfg 525 { 526 en_tim3_m23_crch0_csa_csb_t enCHxACmpCap; ///< CH0A比较/捕获功能选择 527 en_tim3_m23_fltr_ocm_t enCHxACmpCtrl; ///< CH0A通道比较控制 528 en_tim3_port_polarity_t enCHxAPolarity; ///< CH0A输出极性控制 529 boolean_t bCHxACmpBufEn; ///< 比较A缓存功能 使能/禁止 530 en_tim3_m23_cisa_cisb_t enCHxACmpIntSel; ///< CHA比较匹配中断选择 531 532 en_tim3_m23_crch0_csa_csb_t enCHxBCmpCap; ///< CH0B比较/捕获功能选择 533 en_tim3_m23_fltr_ocm_t enCHxBCmpCtrl; ///< CH0B通道比较控制 534 en_tim3_port_polarity_t enCHxBPolarity; ///< CH0B输出极性控制 535 boolean_t bCHxBCmpBufEn; ///< 比较B缓存功能 使能/禁止 536 en_tim3_m23_cisa_cisb_t enCHxBCmpIntSel; ///< CHB0比较匹配中断选择 537 }stc_tim3_m23_compare_cfg_t; 538 539 /** 540 ****************************************************************************** 541 ** \brief CHA/CHB通道捕获控制 配置结构体定义(模式23) 542 *****************************************************************************/ 543 typedef struct stc_tim3_m23_input_cfg 544 { 545 en_tim3_m23_crch0_csa_csb_t enCHxACmpCap; ///< CH0A比较/捕获功能选择 546 en_tim3_m23_crch0_cfx_crx_t enCHxACapSel; ///< CH0A捕获边沿选择 547 en_tim3_flt_t enCHxAInFlt; ///< CH0A通道捕获滤波控制 548 en_tim3_port_polarity_t enCHxAPolarity; ///< CH0A输入相位 549 550 en_tim3_m23_crch0_csa_csb_t enCHxBCmpCap; ///< CH0A比较/捕获功能选择 551 en_tim3_m23_crch0_cfx_crx_t enCHxBCapSel; ///< CH0B捕获边沿选择 552 en_tim3_flt_t enCHxBInFlt; ///< CH0B通道捕获滤波控制 553 en_tim3_port_polarity_t enCHxBPolarity; ///< CH0B输入相位 554 555 }stc_tim3_m23_input_cfg_t; 556 557 /** 558 ****************************************************************************** 559 ** \brief ETR输入相位滤波配置结构体定义(模式23) 560 *****************************************************************************/ 561 typedef struct stc_tim3_m23_etr_input_cfg 562 { 563 en_tim3_port_polarity_t enETRPolarity; ///< ETR输入极性设置 564 en_tim3_flt_t enETRFlt; ///< ETR滤波设置 565 }stc_tim3_m23_etr_input_cfg_t; 566 567 /** 568 ****************************************************************************** 569 ** \brief 刹车BK输入相位滤波配置结构体定义(模式23) 570 *****************************************************************************/ 571 typedef struct stc_tim3_m23_bk_input_cfg 572 { 573 boolean_t bEnBrake; ///< 刹车使能 574 boolean_t bEnVCBrake; ///< 使能VC刹车 575 boolean_t bEnSafetyBk; ///< 使能safety刹车 576 boolean_t bEnBKSync; ///< TIM0/TIM1/TIM2刹车同步使能 577 en_tim3_m23_crchx_bks_t enBkCH0AStat; ///< 刹车时CHA端口状态设置 578 en_tim3_m23_crchx_bks_t enBkCH0BStat; ///< 刹车时CHB端口状态设置 579 en_tim3_m23_crchx_bks_t enBkCH1AStat; ///< 刹车时CHA端口状态设置 580 en_tim3_m23_crchx_bks_t enBkCH1BStat; ///< 刹车时CHB端口状态设置 581 en_tim3_m23_crchx_bks_t enBkCH2AStat; ///< 刹车时CHA端口状态设置 582 en_tim3_m23_crchx_bks_t enBkCH2BStat; ///< 刹车时CHB端口状态设置 583 en_tim3_port_polarity_t enBrakePolarity; ///< 刹车BK输入极性设置 584 en_tim3_flt_t enBrakeFlt; ///< 刹车BK滤波设置 585 }stc_tim3_m23_bk_input_cfg_t; 586 587 /** 588 ****************************************************************************** 589 ** \brief 死区功能配置结构体定义(模式23) 590 *****************************************************************************/ 591 typedef struct stc_tim3_m23_dt_cfg 592 { 593 boolean_t bEnDeadTime; ///< 刹车时CHA端口状态设置 594 uint8_t u8DeadTimeValue; ///< 刹车时CHA端口状态设置 595 }stc_tim3_m23_dt_cfg_t; 596 597 /** 598 ****************************************************************************** 599 ** \brief 触发ADC配置结构体定义(模式23) 600 *****************************************************************************/ 601 typedef struct stc_tim3_m23_adc_trig_cfg 602 { 603 boolean_t bEnTrigADC; ///< 触发ADC全局控制 604 boolean_t bEnUevTrigADC; ///< 事件更新触发ADC 605 boolean_t bEnCH0ACmpTrigADC; ///< CH0A比较匹配触发ADC 606 boolean_t bEnCH0BCmpTrigADC; ///< CH0B比较匹配触发ADC 607 boolean_t bEnCH1ACmpTrigADC; ///< CH0A比较匹配触发ADC 608 boolean_t bEnCH1BCmpTrigADC; ///< CH0B比较匹配触发ADC 609 boolean_t bEnCH2ACmpTrigADC; ///< CH0A比较匹配触发ADC 610 boolean_t bEnCH2BCmpTrigADC; ///< CH0B比较匹配触发ADC 611 }stc_tim3_m23_adc_trig_cfg_t; 612 613 /** 614 ****************************************************************************** 615 ** \brief DMA触发 配置结构体定义(模式23) 616 *****************************************************************************/ 617 typedef struct stc_tim3_m23_trig_dma_cfg 618 { 619 boolean_t bUevTrigDMA; ///< 更新 触发DMA使能 620 boolean_t bTITrigDMA; ///< Trig 触发DMA功能 621 boolean_t bCmpA0TrigDMA; ///< CH0A捕获比较触发DMA使能 622 boolean_t bCmpB0TrigDMA; ///< CH0B捕获比较触发DMA使能 623 boolean_t bCmpA1TrigDMA; ///< CH1A捕获比较触发DMA使能 624 boolean_t bCmpB1TrigDMA; ///< CH1B捕获比较触发DMA使能 625 boolean_t bCmpA2TrigDMA; ///< CH2A捕获比较触发DMA使能 626 boolean_t bCmpB2TrigDMA; ///< CH2B捕获比较触发DMA使能 627 en_tim3_m23_mscr_ccds_t enCmpUevTrigDMA; ///< 比较模式下DMA比较触发选择 628 }stc_tim3_m23_trig_dma_cfg_t; 629 630 /** 631 ****************************************************************************** 632 ** \brief 主从模式 配置结构体定义(模式23) 633 *****************************************************************************/ 634 typedef struct stc_tim3_m23_master_slave_cfg 635 { 636 en_tim3_m23_mscr_msm_t enMasterSlaveSel; ///< 主从模式选择 637 en_tim3_m23_mscr_mms_t enMasterSrc; ///< 主模式触发源选择 638 en_tim3_m23_mscr_sms_t enSlaveModeSel; ///< 从模式选择 639 en_tim3_mscr_ts_t enTsSel; ///< 触发输入源选择 640 }stc_tim3_m23_master_slave_cfg_t; 641 642 /** 643 ****************************************************************************** 644 ** \brief OCREF清除功能 配置结构体定义(模式23) 645 *****************************************************************************/ 646 typedef struct stc_tim3_m23_OCREF_Clr_cfg 647 { 648 en_tim3_m23ce_occs_t enOCRefClrSrcSel; ///< OCREF清除源选择 649 boolean_t bVCClrEn; ///< 是否使能来自VC的OCREF_Clr 650 }stc_tim3_m23_OCREF_Clr_cfg_t; 651 652 /****************************************************************************** 653 * Global variable declarations ('extern', definition in C source) 654 *****************************************************************************/ 655 656 /****************************************************************************** 657 * Global function prototypes (definition in C source) 658 *****************************************************************************/ 659 //中断相关函数 660 661 //中断标志获取 662 boolean_t Tim3_GetIntFlag(en_tim3_irq_type_t enTim3Irq); 663 //中断标志清除 664 en_result_t Tim3_ClearIntFlag(en_tim3_irq_type_t enTim3Irq); 665 //所有中断标志清除 666 en_result_t Tim3_ClearAllIntFlag(void); 667 //模式0中断使能 668 en_result_t Tim3_Mode0_EnableIrq(void); 669 //模式1中断使能 670 en_result_t Tim3_Mode1_EnableIrq (en_tim3_irq_type_t enTim3Irq); 671 //模式2中断使能 672 en_result_t Tim3_Mode23_EnableIrq (en_tim3_irq_type_t enTim3Irq); 673 //模式0中断禁止 674 en_result_t Tim3_Mode0_DisableIrq(void); 675 //模式1中断禁止 676 en_result_t Tim3_Mode1_DisableIrq (en_tim3_irq_type_t enTim3Irq); 677 //模式2中断禁止 678 en_result_t Tim3_Mode23_DisableIrq (en_tim3_irq_type_t enTim3Irq); 679 680 681 //模式0初始化及相关功能操作 682 683 //timer配置及初始化 684 en_result_t Tim3_Mode0_Init(stc_tim3_mode0_cfg_t* pstcCfg); 685 //timer 启动/停止 686 en_result_t Tim3_M0_Run(void); 687 en_result_t Tim3_M0_Stop(void); 688 //重载值设置 689 en_result_t Tim3_M0_ARRSet(uint16_t u16Data); 690 //16位计数值设置/获取 691 en_result_t Tim3_M0_Cnt16Set(uint16_t u16Data); 692 uint16_t Tim3_M0_Cnt16Get(void); 693 //32位计数值设置/获取 694 en_result_t Tim3_M0_Cnt32Set(uint32_t u32Data); 695 uint32_t Tim3_M0_Cnt32Get(void); 696 //端口输出使能/禁止设定 697 en_result_t Tim3_M0_Enable_Output(boolean_t bEnOutput); 698 //翻转使能/禁止（低电平）设定 699 en_result_t Tim3_M0_EnTOG(boolean_t bEnTOG); 700 701 //模式1初始化及相关功能操作 702 703 //timer配置及初始化 704 en_result_t Tim3_Mode1_Init(stc_tim3_mode1_cfg_t* pstcCfg); 705 //PWC 输入配置 706 en_result_t Tim3_M1_Input_Cfg(stc_tim3_pwc_input_cfg_t* pstcCfg); 707 //PWC测量边沿起始结束选择 708 en_result_t Tim3_M1_PWC_Edge_Sel(en_tim3_m1cr_Edge_t enEdgeSel); 709 //timer 启动/停止 710 en_result_t Tim3_M1_Run(void); 711 en_result_t Tim3_M1_Stop(void); 712 //16位计数值设置/获取 713 en_result_t Tim3_M1_Cnt16Set(uint16_t u16Data); 714 uint16_t Tim3_M1_Cnt16Get(void); 715 //脉冲宽度测量结果数值获取 716 uint16_t Tim3_M1_PWC_CapValueGet(void); 717 718 719 //模式23初始化及相关功能操作 720 721 //timer配置及初始化 722 en_result_t Tim3_Mode23_Init(stc_tim3_mode23_cfg_t* pstcCfg); 723 //timer 启动/停止 724 en_result_t Tim3_M23_Run(void); 725 en_result_t Tim3_M23_Stop(void); 726 //PWM输出使能 727 en_result_t Tim3_M23_EnPWM_Output(boolean_t bEnOutput, boolean_t bEnAutoOutput); 728 //重载值设置 729 en_result_t Tim3_M23_ARRSet(uint16_t u16Data, boolean_t bArrBufEn); 730 //16位计数值设置/获取 731 en_result_t Tim3_M23_Cnt16Set(uint16_t u16Data); 732 uint16_t Tim3_M23_Cnt16Get(void); 733 //比较捕获寄存器CCR0A/CCR0B设置/读取 734 en_result_t Tim3_M23_CCR_Set(en_tim3_m23_ccrx_t enCCRSel, uint16_t u16Data); 735 uint16_t Tim3_M23_CCR_Get(en_tim3_m23_ccrx_t enCCRSel); 736 //PWM互补输出模式下，GATE功能选择 737 en_result_t Tim3_M23_GateFuncSel(stc_tim3_m23_gate_cfg_t* pstcCfg); 738 //主从模式配置 739 en_result_t Tim3_M23_MasterSlave_Set(stc_tim3_m23_master_slave_cfg_t* pstcCfg); 740 //CH0A/CH0B比较通道控制 741 en_result_t Tim3_M23_PortOutput_Cfg(en_tim3_channel_t enTim3Chx, stc_tim3_m23_compare_cfg_t* pstcCfg); 742 //CH0A/CH0B输入控制 743 en_result_t Tim3_M23_PortInput_Cfg(en_tim3_channel_t enTim3Chx, stc_tim3_m23_input_cfg_t* pstcCfg); 744 //ERT输入控制 745 en_result_t Tim3_M23_ETRInput_Cfg(stc_tim3_m23_etr_input_cfg_t* pstcCfg); 746 //刹车BK输入控制 747 en_result_t Tim3_M23_BrakeInput_Cfg(stc_tim3_m23_bk_input_cfg_t* pstcBkCfg); 748 //触发ADC控制 749 en_result_t Tim3_M23_TrigADC_Cfg(stc_tim3_m23_adc_trig_cfg_t* pstcCfg); 750 //死区功能 751 en_result_t Tim3_M23_DT_Cfg(stc_tim3_m23_dt_cfg_t* pstcCfg); 752 //重复周期设置 753 en_result_t Tim3_M23_SetValidPeriod(uint8_t u8ValidPeriod); 754 //OCREF清除功能 755 en_result_t Tim3_M23_OCRefClr(stc_tim3_m23_OCREF_Clr_cfg_t* pstcCfg); 756 //使能DMA传输 757 en_result_t Tim3_M23_EnDMA(stc_tim3_m23_trig_dma_cfg_t* pstcCfg); 758 //捕获比较A软件触发 759 en_result_t Tim3_M23_EnSwTrigCapCmpA(en_tim3_channel_t enTim3Chx); 760 //捕获比较B软件触发 761 en_result_t Tim3_M23_EnSwTrigCapCmpB(en_tim3_channel_t enTim3Chx); 762 //软件更新使能 763 en_result_t Tim3_M23_EnSwUev(void); 764 //软件触发使能 765 en_result_t Tim3_M23_EnSwTrig(void); 766 //软件刹车使能 767 en_result_t Tim3_M23_EnSwBk(void); 768 769 770 //@} // Tim3Group 771 772 #ifdef __cplusplus 773 #endif 774 775 776 #endif /* __BT_H__ */ 777 /****************************************************************************** 778 * EOF (not truncated) 779 *****************************************************************************/ 780 781 782