MotorWare f2806x Module API Documentation
hvkit_rev1p1/f28x/f2806x/src/hal_obj.h
Go to the documentation of this file.
1 #ifndef _HAL_OBJ_H_
2 #define _HAL_OBJ_H_
3 /* --COPYRIGHT--,BSD
4  * Copyright (c) 2012, Texas Instruments Incorporated
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * * Redistributions of source code must retain the above copyright
12  * notice, this list of conditions and the following disclaimer.
13  *
14  * * Redistributions in binary form must reproduce the above copyright
15  * notice, this list of conditions and the following disclaimer in the
16  * documentation and/or other materials provided with the distribution.
17  *
18  * * Neither the name of Texas Instruments Incorporated nor the names of
19  * its contributors may be used to endorse or promote products derived
20  * from this software without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
23  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
24  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
25  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
26  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
27  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
28  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
29  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
30  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
31  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
32  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33  * --/COPYRIGHT--*/
34 
39 
40 
41 // drivers
42 #include "sw/drivers/adc/src/32b/f28x/f2806x/adc.h"
43 #include "sw/drivers/clk/src/32b/f28x/f2806x/clk.h"
44 #include "sw/drivers/cpu/src/32b/f28x/f2806x/cpu.h"
45 #include "sw/drivers/flash/src/32b/f28x/f2806x/flash.h"
46 #include "sw/drivers/gpio/src/32b/f28x/f2806x/gpio.h"
47 #include "sw/drivers/osc/src/32b/f28x/f2806x/osc.h"
48 #include "sw/drivers/pie/src/32b/f28x/f2806x/pie.h"
49 #include "sw/drivers/pll/src/32b/f28x/f2806x/pll.h"
50 #include "sw/drivers/pwm/src/32b/f28x/f2806x/pwm.h"
51 #include "sw/drivers/pwmdac/src/32b/f28x/f2806x/pwmdac.h"
52 #include "sw/drivers/pwr/src/32b/f28x/f2806x/pwr.h"
53 #include "sw/drivers/timer/src/32b/f28x/f2806x/timer.h"
54 #include "sw/drivers/wdog/src/32b/f28x/f2806x/wdog.h"
55 
56 #ifdef QEP
57 #include "sw/drivers/qep/src/32b/f28x/f2806x/qep.h"
58 #endif
59 
60 // modules
64 
65 
66 // platforms
67 #include "user.h"
68 
69 
74 
75 
76 
77 #ifdef __cplusplus
78 extern "C" {
79 #endif
80 typedef struct _HAL_AdcData_t_
86 {
87  MATH_vec3 I;
88 
89  MATH_vec3 V;
90 
91  _iq dcBus;
92 
94 
95 
100 typedef struct _HAL_DacData_t_
101 {
102  _iq value[4];
103 
104 } HAL_DacData_t;
105 
106 
113 typedef struct _HAL_PwmData_t_
114 {
115  MATH_vec3 Tabc;
116 
117 } HAL_PwmData_t;
118 
119 
125 typedef struct _HAL_Obj_
126 {
127  ADC_Handle adcHandle;
128 
129  CLK_Handle clkHandle;
130 
131  CPU_Handle cpuHandle;
132 
133  FLASH_Handle flashHandle;
134 
135  GPIO_Handle gpioHandle;
136 
138  OFFSET_Obj offset_I[3];
139 
141  OFFSET_Obj offset_V[3];
142 
143  OSC_Handle oscHandle;
144 
145  PIE_Handle pieHandle; //<! the PIE handle
146 
147  PLL_Handle pllHandle;
148 
149  PWM_Handle pwmHandle[3]; //<! the PWM handles
150 
151  PWMDAC_Handle pwmDacHandle[3]; //<! the PWMDAC handles
152 
153  PWR_Handle pwrHandle; //<! the power handle
154 
155  TIMER_Handle timerHandle[3]; //<! the timer handles
156 
157  WDOG_Handle wdogHandle;
158 
160 
161  _iq current_sf;
162 
163  _iq voltage_sf;
164 
165  uint_least8_t numCurrentSensors;
166  uint_least8_t numVoltageSensors;
167 
168 #ifdef QEP
169  QEP_Handle qepHandle[1];
170 #endif
171 
172 } HAL_Obj;
173 
174 
180 typedef struct _HAL_Obj_ *HAL_Handle;
181 
182 
185 extern HAL_Obj hal;
186 
187 
193 inline void HAL_runOffsetEst(HAL_Handle handle,const HAL_AdcData_t *pAdcData)
194 {
195  uint_least8_t cnt;
196  HAL_Obj *obj = (HAL_Obj *)handle;
197 
198 
199  // estimate the current offsets
200  for(cnt=0;cnt<obj->numCurrentSensors;cnt++)
201  {
202  OFFSET_run(obj->offsetHandle_I[cnt],pAdcData->I.value[cnt]);
203  }
204 
205 
206  // estimate the voltage offsets
207  for(cnt=0;cnt<obj->numVoltageSensors;cnt++)
208  {
209  OFFSET_run(obj->offsetHandle_V[cnt],pAdcData->V.value[cnt]);
210  }
211 
212  return;
213 } // end of HAL_runOffsetEst() function
214 
215 
216 #ifdef __cplusplus
217 }
218 #endif // extern "C"
219 
221 #endif // end of _HAL_OBJ_H_ definition
222 
OFFSET_Handle offsetHandle_I[3]
the handles for the current offset estimators
OFFSET_Obj offset_V[3]
the voltage offset objects
Contains the public interface to the types definitions.
Contains the public interface to the offset (OFFSET) module routines.
_iq value[3]
Definition: 32b/math.h:261
CLK_Handle clkHandle
the clock handle
_iq current_sf
the current scale factor, amps_pu/cnt
long _iq
HAL_AdcData_t adcBias
the ADC bias
FLASH_Handle flashHandle
the flash handle
Contains public interface to the micro-second delay function.
MATH_vec3 Tabc
the PWM time-durations for each motor phase
struct _HAL_Obj_ * HAL_Handle
Defines the HAL handle.
Defines a three element vector.
Definition: 32b/math.h:258
void HAL_runOffsetEst(HAL_Handle handle, const HAL_AdcData_t *pAdcData)
Runs offset estimation.
struct _HAL_DacData_t_ HAL_DacData_t
Defines the DAC data.
uint_least8_t numCurrentSensors
the number of current sensors
struct _OFFSET_Obj_ * OFFSET_Handle
Defines the OFFSET handle.
Definition: 32b/offset.h:95
_iq voltage_sf
the voltage scale factor, volts_pu/cnt
WDOG_Handle wdogHandle
the watchdog handle
struct _HAL_PwmData_t_ HAL_PwmData_t
Defines the PWM data.
struct _HAL_AdcData_t_ HAL_AdcData_t
Defines the ADC data.
OSC_Handle oscHandle
the oscillator handle
ADC_Handle adcHandle
the ADC handle
CPU_Handle cpuHandle
the CPU handle
struct _HAL_Obj_ HAL_Obj
Defines the hardware abstraction layer (HAL) data.
HAL_Obj hal
Defines the HAL object.
OFFSET_Obj offset_I[3]
the current offset objects
PLL_Handle pllHandle
the PLL handle
uint_least8_t numVoltageSensors
the number of voltage sensors
static void OFFSET_run(OFFSET_Handle handle, const _iq inputValue)
Runs an offset filter of the form y[n] = beta*(x[n]+bias) + (1 - beta)*y[n-1] y -> The DC offset x ->...
Definition: 32b/offset.h:137
OFFSET_Handle offsetHandle_V[3]
the handles for the voltage offset estimators
Defines the hardware abstraction layer (HAL) data.
GPIO_Handle gpioHandle
the GPIO handle
Defines the offset (OFFSET) object.
Definition: 32b/offset.h:82