1 /* *****************************************************************************
2 * Copyright (C) 2016 Maxim Integrated Products, Inc., All Rights Reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included
12 * in all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
18 * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
21 *
22 * Except as contained in this notice, the name of Maxim Integrated
23 * Products, Inc. shall not be used except as stated in the Maxim Integrated
24 * Products, Inc. Branding Policy.
25 *
26 * The mere transfer of this software does not imply any licenses
27 * of trade secrets, proprietary technology, copyrights, patents,
28 * trademarks, maskwork rights, or any other form of intellectual
29 * property whatsoever. Maxim Integrated Products, Inc. retains all
30 * ownership rights.
31 *
32 * $Date: 2018-10-17 14:16:30 -0500 (Wed, 17 Oct 2018) $
33 * $Revision: 38560 $
34 *
35 **************************************************************************** */
36
37 /* **** Includes **** */
38 #include <stddef.h>
39 #include "mxc_assert.h"
40 #include "tmr.h"
41 #include "tmr_utils.h"
42
43 /* **** Definitions **** */
44
45 /* **** Globals **** */
46
47 /* **** Functions **** */
48
49 /* ************************************************************************** */
TMR_Delay(mxc_tmr_regs_t * tmr,unsigned long us,const sys_cfg_tmr_t * sys_cfg)50 void TMR_Delay(mxc_tmr_regs_t *tmr, unsigned long us, const sys_cfg_tmr_t *sys_cfg)
51 {
52 // Return immediately if delay is 0
53 if (!us) {
54 return;
55 }
56
57 TMR_TO_Start(tmr, us, sys_cfg);
58
59 while (TMR_TO_Check(tmr) != E_TIME_OUT) {}
60 }
61
62 /* ************************************************************************** */
TMR_TO_Start(mxc_tmr_regs_t * tmr,unsigned long us,const sys_cfg_tmr_t * sys_cfg)63 void TMR_TO_Start(mxc_tmr_regs_t *tmr, unsigned long us, const sys_cfg_tmr_t *sys_cfg)
64 {
65 uint64_t ticks;
66 int clk_shift = 0;
67
68 ticks = (uint64_t)us * (uint64_t)PeripheralClock / (uint64_t)1000000;
69 while (ticks > 0xFFFFFFFFUL) {
70 ticks >>= 1;
71 ++clk_shift;
72 }
73 tmr_pres_t prescale = (tmr_pres_t)(clk_shift << MXC_F_TMR_CN_PRES_POS);
74
75 TMR_Init(tmr, prescale, sys_cfg);
76
77 // Initialize the timer in one-shot mode
78 tmr_cfg_t cfg;
79 cfg.mode = TMR_MODE_ONESHOT;
80 cfg.cmp_cnt = ticks;
81 cfg.pol = 0;
82
83 TMR_Disable(tmr);
84 TMR_Config(tmr, &cfg);
85
86 TMR_IntClear(tmr);
87 TMR_Enable(tmr);
88 }
89
90 /* ************************************************************************** */
TMR_TO_Check(mxc_tmr_regs_t * tmr)91 int TMR_TO_Check(mxc_tmr_regs_t *tmr)
92 {
93 if (TMR_IntStatus(tmr)) {
94 return E_TIME_OUT;
95 }
96 return E_NO_ERROR;
97 }
98
99 /* ************************************************************************** */
TMR_TO_Stop(mxc_tmr_regs_t * tmr)100 void TMR_TO_Stop(mxc_tmr_regs_t *tmr)
101 {
102 TMR_Disable(tmr);
103 TMR_SetCount(tmr, 0x0);
104 }
105
106 /* ************************************************************************** */
TMR_TO_Clear(mxc_tmr_regs_t * tmr)107 void TMR_TO_Clear(mxc_tmr_regs_t *tmr)
108 {
109 TMR_IntClear(tmr);
110 TMR_SetCount(tmr, 0x0);
111 }
112
113 /* ************************************************************************** */
TMR_TO_Elapsed(mxc_tmr_regs_t * tmr)114 unsigned int TMR_TO_Elapsed(mxc_tmr_regs_t *tmr)
115 {
116 uint32_t elapsed;
117 tmr_unit_t units;
118
119 TMR_GetTime(tmr, TMR_GetCount(tmr), &elapsed, &units);
120
121 switch (units) {
122 case TMR_UNIT_NANOSEC:
123 default:
124 return (elapsed / 1000);
125 case TMR_UNIT_MICROSEC:
126 return (elapsed);
127 case TMR_UNIT_MILLISEC:
128 return (elapsed * 1000);
129 case TMR_UNIT_SEC:
130 return (elapsed * 1000000);
131 }
132 }
133
134 /* ************************************************************************** */
TMR_TO_Remaining(mxc_tmr_regs_t * tmr)135 unsigned int TMR_TO_Remaining(mxc_tmr_regs_t *tmr)
136 {
137 uint32_t remaining_ticks, remaining_time;
138 tmr_unit_t units;
139
140 remaining_ticks = TMR_GetCompare(tmr) - TMR_GetCount(tmr);
141 TMR_GetTime(tmr, remaining_ticks, &remaining_time, &units);
142
143 switch (units) {
144 case TMR_UNIT_NANOSEC:
145 default:
146 return (remaining_time / 1000);
147 case TMR_UNIT_MICROSEC:
148 return (remaining_time);
149 case TMR_UNIT_MILLISEC:
150 return (remaining_time * 1000);
151 case TMR_UNIT_SEC:
152 return (remaining_time * 1000000);
153 }
154 }
155
156 /* ************************************************************************** */
TMR_SW_Start(mxc_tmr_regs_t * tmr,const sys_cfg_tmr_t * sys_cfg)157 void TMR_SW_Start(mxc_tmr_regs_t *tmr, const sys_cfg_tmr_t *sys_cfg)
158 {
159 TMR_TO_Start(tmr, 0xFFFFFFFF, sys_cfg);
160 }
161
162 /* ************************************************************************** */
TMR_SW_Stop(mxc_tmr_regs_t * tmr)163 unsigned int TMR_SW_Stop(mxc_tmr_regs_t *tmr)
164 {
165 unsigned int elapsed = TMR_TO_Elapsed(tmr);
166 TMR_TO_Stop(tmr);
167 return elapsed;
168 }
169