| Digital Power Starter Kit 3 Firmware dsPIC33C Boost Converter Voltage Mode Control Example |

v_loop_extensions.s
1 ; **********************************************************************************
2 ; SDK Version: PowerSmart(TM) Digital Control Library Designer v0.9.12.660
3 ; CGS Version: Code Generator Script v3.0.2 (01/05/2021)
4 ; Author: M91406
5 ; Date/Time: 01/12/2021 21:22:33
6 ; **********************************************************************************
7 ; Template for user extension functions extending functions of the common
8 ; control loop code using User Extension Hooks. These extensions allow user
9 ; to tie in proprietary user code into the assembly routine of the main control
10 ; loop.
11 ;
12 ; Please refer to the PS-DCLD User Guide for details about how to use this
13 ; feature.
14 ;
15 ; **********************************************************************************
16
17 ;------------------------------------------------------------------------------
18 ; file start
19 .nolist ; (no external dependencies)
20 .list ; list of all external dependencies
21
22 ;------------------------------------------------------------------------------
23 ; local inclusions.
24 .section .data ; place constant data in the data section
25
26 ;------------------------------------------------------------------------------
27 ; include NPNZ16B_t data structure and global constants to allow access
28 ; to the active control loop data object
29
30 .include "./sources/power_control/drivers/npnz16b.inc" ; include NPNZ16b_t object data structure value offsets and status flag labels
31
32 ;------------------------------------------------------------------------------
33 ; source code section.
34 .section .text ; place code in the text section
35
36 ;------------------------------------------------------------------------------
37 ; Global function call prototype declarations
38 ; These global function calls are used to publish functions across the
39 ; application. Add a function call prototype to a C-header file to allow
40 ; calling this function from C-code.
41 ;
42 ; extern void __attribute__((near))my_function(void);
43 ;
44 ;------------------------------------------------------------------------------
45
46 .global _my_function ; provide global scope to routine
47
48 ;------------------------------------------------------------------------------
49
50 ;------------------------------------------------------------------------------
51 ; User Functions
52 ;------------------------------------------------------------------------------
53
54 ;------------------------------------------------------------------------------
55 ; MY FUNCTION is a simple function template, when used as a user extension
56 ; function, this function will be directly called by a CALL Wn instruction
57 ; to minimize the function call overhead to 2 instruction cycles only.
58 ; However, there is no context handling as it is assumed user extension
59 ; functions are commonly using the same data object as the main control loop.
60 ; Hence, all data is kept in its place just like this code would be part of
61 ; the main loop itself.
62 ;
63 ; Please refer to the PS-DCLD User Guide for details about how to use this
64 ; feature, which working registers are in use by the main loop and which
65 ; can/may be used and/or manipulated by this routine.
66 ;
67 ;------------------------------------------------------------------------------
68 ; Start of routine
69 _my_function: ; local function label (placeholder)
70
71 nop ; place your code here
72 nop
73 nop
74
75 mov #0x88B8, w4
76
77 nop ; place your code here
78 nop
79 nop
80
81
82 lsr w4, w2
83
84 ; Check for upper limit violation
85 mov [w0 + #MaxOutput], w6 ; load upper limit value
86 lsr w6, w3 ; load upper limit value, shifted one bit to the right
87 cpslt w2, w3 ; compare values and skip next instruction if control output is within operating range (control output < upper limit)
88 mov w6, w4 ; override controller output
89
90 ; Check for lower limit violation
91 mov [w0 + #MinOutput], w6 ; load lower limit value
92 lsr w6, w3 ; load upper limit value, shifted one bit to the right
93 cpsgt w2, w3 ; compare values and skip next instruction if control output is within operating range (control output > lower limit)
94 mov w6, w4 ; override controller output
95
96
97
98 ;------------------------------------------------------------------------------
99 ; End of routine
100 return ; end of function; return to caller
101
102 ;------------------------------------------------------------------------------
103
104
105 ;------------------------------------------------------------------------------
106 ; End of file
107 .end ; end of file v_loop_extensions.s
108
109 ;------------------------------------------------------------------------------
110
111
112 ; **********************************************************************************
113 ; Download latest version of this tool here: https://areiter128.github.io/DCLD
114 ; **********************************************************************************