xref: /btstack/port/msp432p401lp-cc256x/ti/devices/msp432p4xx/driverlib/pss.c (revision 5fd0122a3e19d95e11e1f3eb8a08a2b2acb2557e)
1*5fd0122aSMatthias Ringwald /* --COPYRIGHT--,BSD
2*5fd0122aSMatthias Ringwald  * Copyright (c) 2017, Texas Instruments Incorporated
3*5fd0122aSMatthias Ringwald  * All rights reserved.
4*5fd0122aSMatthias Ringwald  *
5*5fd0122aSMatthias Ringwald  * Redistribution and use in source and binary forms, with or without
6*5fd0122aSMatthias Ringwald  * modification, are permitted provided that the following conditions
7*5fd0122aSMatthias Ringwald  * are met:
8*5fd0122aSMatthias Ringwald  *
9*5fd0122aSMatthias Ringwald  * *  Redistributions of source code must retain the above copyright
10*5fd0122aSMatthias Ringwald  *    notice, this list of conditions and the following disclaimer.
11*5fd0122aSMatthias Ringwald  *
12*5fd0122aSMatthias Ringwald  * *  Redistributions in binary form must reproduce the above copyright
13*5fd0122aSMatthias Ringwald  *    notice, this list of conditions and the following disclaimer in the
14*5fd0122aSMatthias Ringwald  *    documentation and/or other materials provided with the distribution.
15*5fd0122aSMatthias Ringwald  *
16*5fd0122aSMatthias Ringwald  * *  Neither the name of Texas Instruments Incorporated nor the names of
17*5fd0122aSMatthias Ringwald  *    its contributors may be used to endorse or promote products derived
18*5fd0122aSMatthias Ringwald  *    from this software without specific prior written permission.
19*5fd0122aSMatthias Ringwald  *
20*5fd0122aSMatthias Ringwald  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21*5fd0122aSMatthias Ringwald  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
22*5fd0122aSMatthias Ringwald  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23*5fd0122aSMatthias Ringwald  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
24*5fd0122aSMatthias Ringwald  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25*5fd0122aSMatthias Ringwald  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26*5fd0122aSMatthias Ringwald  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
27*5fd0122aSMatthias Ringwald  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
28*5fd0122aSMatthias Ringwald  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29*5fd0122aSMatthias Ringwald  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30*5fd0122aSMatthias Ringwald  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31*5fd0122aSMatthias Ringwald  * --/COPYRIGHT--*/
32*5fd0122aSMatthias Ringwald /* Standard Includes */
33*5fd0122aSMatthias Ringwald #include <stdint.h>
34*5fd0122aSMatthias Ringwald 
35*5fd0122aSMatthias Ringwald /* DriverLib Includes */
36*5fd0122aSMatthias Ringwald #include <ti/devices/msp432p4xx/driverlib/pss.h>
37*5fd0122aSMatthias Ringwald #include <ti/devices/msp432p4xx/driverlib/interrupt.h>
38*5fd0122aSMatthias Ringwald #include <ti/devices/msp432p4xx/driverlib/debug.h>
39*5fd0122aSMatthias Ringwald #include <ti/devices/msp432p4xx/driverlib/cpu.h>
40*5fd0122aSMatthias Ringwald 
__PSSUnlock()41*5fd0122aSMatthias Ringwald static void __PSSUnlock()
42*5fd0122aSMatthias Ringwald {
43*5fd0122aSMatthias Ringwald     PSS->KEY = PSS_KEY_VALUE;
44*5fd0122aSMatthias Ringwald }
45*5fd0122aSMatthias Ringwald 
__PSSLock()46*5fd0122aSMatthias Ringwald static void __PSSLock()
47*5fd0122aSMatthias Ringwald {
48*5fd0122aSMatthias Ringwald     PSS->KEY = 0;
49*5fd0122aSMatthias Ringwald }
50*5fd0122aSMatthias Ringwald 
51*5fd0122aSMatthias Ringwald 
PSS_enableForcedDCDCOperation(void)52*5fd0122aSMatthias Ringwald void PSS_enableForcedDCDCOperation(void)
53*5fd0122aSMatthias Ringwald {
54*5fd0122aSMatthias Ringwald     __PSSUnlock();
55*5fd0122aSMatthias Ringwald 
56*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->CTL0, PSS_CTL0_DCDC_FORCE_OFS) = 1;
57*5fd0122aSMatthias Ringwald 
58*5fd0122aSMatthias Ringwald     __PSSLock();
59*5fd0122aSMatthias Ringwald }
60*5fd0122aSMatthias Ringwald 
PSS_disableForcedDCDCOperation(void)61*5fd0122aSMatthias Ringwald void PSS_disableForcedDCDCOperation(void)
62*5fd0122aSMatthias Ringwald {
63*5fd0122aSMatthias Ringwald     __PSSUnlock();
64*5fd0122aSMatthias Ringwald 
65*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->CTL0, PSS_CTL0_DCDC_FORCE_OFS) = 0;
66*5fd0122aSMatthias Ringwald 
67*5fd0122aSMatthias Ringwald     __PSSLock();
68*5fd0122aSMatthias Ringwald 
69*5fd0122aSMatthias Ringwald }
70*5fd0122aSMatthias Ringwald 
PSS_enableHighSidePinToggle(bool activeLow)71*5fd0122aSMatthias Ringwald void PSS_enableHighSidePinToggle(bool activeLow)
72*5fd0122aSMatthias Ringwald {
73*5fd0122aSMatthias Ringwald     __PSSUnlock();
74*5fd0122aSMatthias Ringwald 
75*5fd0122aSMatthias Ringwald     if (activeLow)
76*5fd0122aSMatthias Ringwald         PSS->CTL0 |= (PSS_CTL0_SVMHOE | PSS_CTL0_SVMHOUTPOLAL);
77*5fd0122aSMatthias Ringwald     else
78*5fd0122aSMatthias Ringwald     {
79*5fd0122aSMatthias Ringwald         BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVMHOUTPOLAL_OFS) = 0;
80*5fd0122aSMatthias Ringwald         BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVMHOE_OFS) = 1;
81*5fd0122aSMatthias Ringwald     }
82*5fd0122aSMatthias Ringwald 
83*5fd0122aSMatthias Ringwald     __PSSLock();
84*5fd0122aSMatthias Ringwald }
85*5fd0122aSMatthias Ringwald 
PSS_disableHighSidePinToggle(void)86*5fd0122aSMatthias Ringwald void PSS_disableHighSidePinToggle(void)
87*5fd0122aSMatthias Ringwald {
88*5fd0122aSMatthias Ringwald     __PSSUnlock();
89*5fd0122aSMatthias Ringwald 
90*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVMHOE_OFS) = 0;
91*5fd0122aSMatthias Ringwald 
92*5fd0122aSMatthias Ringwald     __PSSLock();
93*5fd0122aSMatthias Ringwald }
94*5fd0122aSMatthias Ringwald 
PSS_enableHighSide(void)95*5fd0122aSMatthias Ringwald void PSS_enableHighSide(void)
96*5fd0122aSMatthias Ringwald {
97*5fd0122aSMatthias Ringwald     __PSSUnlock();
98*5fd0122aSMatthias Ringwald 
99*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVSMHOFF_OFS) = 0;
100*5fd0122aSMatthias Ringwald 
101*5fd0122aSMatthias Ringwald     __PSSLock();
102*5fd0122aSMatthias Ringwald }
103*5fd0122aSMatthias Ringwald 
PSS_disableHighSide(void)104*5fd0122aSMatthias Ringwald void PSS_disableHighSide(void)
105*5fd0122aSMatthias Ringwald {
106*5fd0122aSMatthias Ringwald     __PSSUnlock();
107*5fd0122aSMatthias Ringwald 
108*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVSMHOFF_OFS) = 1;
109*5fd0122aSMatthias Ringwald 
110*5fd0122aSMatthias Ringwald     __PSSLock();
111*5fd0122aSMatthias Ringwald }
112*5fd0122aSMatthias Ringwald 
PSS_setHighSidePerformanceMode(uint_fast8_t powerMode)113*5fd0122aSMatthias Ringwald void PSS_setHighSidePerformanceMode(uint_fast8_t powerMode)
114*5fd0122aSMatthias Ringwald {
115*5fd0122aSMatthias Ringwald     __PSSUnlock();
116*5fd0122aSMatthias Ringwald 
117*5fd0122aSMatthias Ringwald     if (powerMode == PSS_FULL_PERFORMANCE_MODE)
118*5fd0122aSMatthias Ringwald         BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVSMHLP_OFS) = 0;
119*5fd0122aSMatthias Ringwald     else
120*5fd0122aSMatthias Ringwald         BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVSMHLP_OFS) = 1;
121*5fd0122aSMatthias Ringwald 
122*5fd0122aSMatthias Ringwald     __PSSLock();
123*5fd0122aSMatthias Ringwald }
124*5fd0122aSMatthias Ringwald 
PSS_getHighSidePerformanceMode(void)125*5fd0122aSMatthias Ringwald uint_fast8_t PSS_getHighSidePerformanceMode(void)
126*5fd0122aSMatthias Ringwald {
127*5fd0122aSMatthias Ringwald     if (BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVSMHLP_OFS))
128*5fd0122aSMatthias Ringwald         return PSS_NORMAL_PERFORMANCE_MODE;
129*5fd0122aSMatthias Ringwald     else
130*5fd0122aSMatthias Ringwald         return PSS_FULL_PERFORMANCE_MODE;
131*5fd0122aSMatthias Ringwald }
132*5fd0122aSMatthias Ringwald 
PSS_enableHighSideMonitor(void)133*5fd0122aSMatthias Ringwald void PSS_enableHighSideMonitor(void)
134*5fd0122aSMatthias Ringwald {
135*5fd0122aSMatthias Ringwald     __PSSUnlock();
136*5fd0122aSMatthias Ringwald 
137*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVSMHS_OFS) = 1;
138*5fd0122aSMatthias Ringwald 
139*5fd0122aSMatthias Ringwald     __PSSLock();
140*5fd0122aSMatthias Ringwald }
141*5fd0122aSMatthias Ringwald 
PSS_disableHighSideMonitor(void)142*5fd0122aSMatthias Ringwald void PSS_disableHighSideMonitor(void)
143*5fd0122aSMatthias Ringwald {
144*5fd0122aSMatthias Ringwald     __PSSUnlock();
145*5fd0122aSMatthias Ringwald 
146*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->CTL0, PSS_CTL0_SVSMHS_OFS) = 0;
147*5fd0122aSMatthias Ringwald 
148*5fd0122aSMatthias Ringwald     __PSSLock();
149*5fd0122aSMatthias Ringwald }
150*5fd0122aSMatthias Ringwald 
PSS_setHighSideVoltageTrigger(uint_fast8_t triggerVoltage)151*5fd0122aSMatthias Ringwald void PSS_setHighSideVoltageTrigger(uint_fast8_t triggerVoltage)
152*5fd0122aSMatthias Ringwald {
153*5fd0122aSMatthias Ringwald     __PSSUnlock();
154*5fd0122aSMatthias Ringwald 
155*5fd0122aSMatthias Ringwald     ASSERT(!(triggerVoltage & 0xF8))
156*5fd0122aSMatthias Ringwald 
157*5fd0122aSMatthias Ringwald     PSS->CTL0 &= ~PSS_CTL0_SVSMHTH_MASK;
158*5fd0122aSMatthias Ringwald     PSS->CTL0 |= (triggerVoltage & 0x07) << PSS_CTL0_SVSMHTH_OFS;
159*5fd0122aSMatthias Ringwald 
160*5fd0122aSMatthias Ringwald     __PSSLock();
161*5fd0122aSMatthias Ringwald }
162*5fd0122aSMatthias Ringwald 
PSS_getHighSideVoltageTrigger(void)163*5fd0122aSMatthias Ringwald uint_fast8_t PSS_getHighSideVoltageTrigger(void)
164*5fd0122aSMatthias Ringwald {
165*5fd0122aSMatthias Ringwald     return (uint_fast8_t)((PSS->CTL0 & PSS_CTL0_SVSMHTH_MASK)
166*5fd0122aSMatthias Ringwald             >> PSS_CTL0_SVSMHTH_OFS);
167*5fd0122aSMatthias Ringwald }
168*5fd0122aSMatthias Ringwald 
PSS_enableInterrupt(void)169*5fd0122aSMatthias Ringwald void PSS_enableInterrupt(void)
170*5fd0122aSMatthias Ringwald {
171*5fd0122aSMatthias Ringwald     __PSSUnlock();
172*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->IE,PSS_IE_SVSMHIE_OFS) = 1;
173*5fd0122aSMatthias Ringwald     __PSSLock();
174*5fd0122aSMatthias Ringwald }
175*5fd0122aSMatthias Ringwald 
PSS_disableInterrupt(void)176*5fd0122aSMatthias Ringwald void PSS_disableInterrupt(void)
177*5fd0122aSMatthias Ringwald {
178*5fd0122aSMatthias Ringwald     __PSSUnlock();
179*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->IE,PSS_IE_SVSMHIE_OFS) = 0;
180*5fd0122aSMatthias Ringwald     __PSSLock();
181*5fd0122aSMatthias Ringwald }
182*5fd0122aSMatthias Ringwald 
PSS_getInterruptStatus(void)183*5fd0122aSMatthias Ringwald uint32_t PSS_getInterruptStatus(void)
184*5fd0122aSMatthias Ringwald {
185*5fd0122aSMatthias Ringwald     return PSS->IFG;
186*5fd0122aSMatthias Ringwald }
187*5fd0122aSMatthias Ringwald 
PSS_clearInterruptFlag(void)188*5fd0122aSMatthias Ringwald void PSS_clearInterruptFlag(void)
189*5fd0122aSMatthias Ringwald {
190*5fd0122aSMatthias Ringwald     __PSSUnlock();
191*5fd0122aSMatthias Ringwald     BITBAND_PERI(PSS->CLRIFG,PSS_CLRIFG_CLRSVSMHIFG_OFS) = 1;
192*5fd0122aSMatthias Ringwald     __PSSLock();
193*5fd0122aSMatthias Ringwald }
194*5fd0122aSMatthias Ringwald 
PSS_registerInterrupt(void (* intHandler)(void))195*5fd0122aSMatthias Ringwald void PSS_registerInterrupt(void (*intHandler)(void))
196*5fd0122aSMatthias Ringwald {
197*5fd0122aSMatthias Ringwald     //
198*5fd0122aSMatthias Ringwald     // Register the interrupt handler, returning an error if an error occurs.
199*5fd0122aSMatthias Ringwald     //
200*5fd0122aSMatthias Ringwald     Interrupt_registerInterrupt(INT_PSS, intHandler);
201*5fd0122aSMatthias Ringwald 
202*5fd0122aSMatthias Ringwald     //
203*5fd0122aSMatthias Ringwald     // Enable the system control interrupt.
204*5fd0122aSMatthias Ringwald     //
205*5fd0122aSMatthias Ringwald     Interrupt_enableInterrupt(INT_PSS);
206*5fd0122aSMatthias Ringwald }
207*5fd0122aSMatthias Ringwald 
PSS_unregisterInterrupt(void)208*5fd0122aSMatthias Ringwald void PSS_unregisterInterrupt(void)
209*5fd0122aSMatthias Ringwald {
210*5fd0122aSMatthias Ringwald     //
211*5fd0122aSMatthias Ringwald     // Disable the interrupt.
212*5fd0122aSMatthias Ringwald     //
213*5fd0122aSMatthias Ringwald     Interrupt_disableInterrupt(INT_PSS);
214*5fd0122aSMatthias Ringwald 
215*5fd0122aSMatthias Ringwald     //
216*5fd0122aSMatthias Ringwald     // Unregister the interrupt handler.
217*5fd0122aSMatthias Ringwald     //
218*5fd0122aSMatthias Ringwald     Interrupt_unregisterInterrupt(INT_PSS);
219*5fd0122aSMatthias Ringwald }
220