423 lines
12 KiB
C
423 lines
12 KiB
C
/****************************************************************************
|
|
* apps/industry/foc/fixed16/foc_picontrol.c
|
|
* This file implements classical FOC PI current controller for fixed16
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership. The
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include <assert.h>
|
|
#include <errno.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
|
|
#include "industry/foc/fixed16/foc_handler.h"
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
#if CONFIG_MOTOR_FOC_PHASES != 3
|
|
# error
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Private Data Types
|
|
****************************************************************************/
|
|
|
|
/* FOC PI fixed16 controller data */
|
|
|
|
struct foc_picontrol_b16_s
|
|
{
|
|
b16_t vbase_last; /* Last VBASE sample */
|
|
phase_angle_b16_t angle; /* Phase angle */
|
|
struct foc_initdata_b16_s cfg; /* Controller configuration */
|
|
struct foc_data_b16_s data; /* Controller private data */
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Function Prototypes
|
|
****************************************************************************/
|
|
|
|
static int foc_control_init_b16(FAR foc_handler_b16_t *h);
|
|
static void foc_control_deinit_b16(FAR foc_handler_b16_t *h);
|
|
static void foc_control_cfg_b16(FAR foc_handler_b16_t *h, FAR void *cfg);
|
|
static void foc_control_input_set_b16(FAR foc_handler_b16_t *h,
|
|
FAR b16_t *current,
|
|
b16_t vbase,
|
|
b16_t angle);
|
|
static void foc_control_voltage_run_b16(FAR foc_handler_b16_t *h,
|
|
FAR dq_frame_b16_t *dq_ref,
|
|
FAR ab_frame_b16_t *v_ab_mod);
|
|
static void foc_control_current_run_b16(FAR foc_handler_b16_t *h,
|
|
FAR dq_frame_b16_t *dq_ref,
|
|
FAR dq_frame_b16_t *vdq_comp,
|
|
FAR ab_frame_b16_t *v_ab_mod);
|
|
static void foc_control_state_get_b16(FAR foc_handler_b16_t *h,
|
|
FAR struct foc_state_b16_s *state);
|
|
|
|
/****************************************************************************
|
|
* Public Data
|
|
****************************************************************************/
|
|
|
|
/* FOC control fixed16 interface */
|
|
|
|
struct foc_control_ops_b16_s g_foc_control_pi_b16 =
|
|
{
|
|
.init = foc_control_init_b16,
|
|
.deinit = foc_control_deinit_b16,
|
|
.cfg = foc_control_cfg_b16,
|
|
.input_set = foc_control_input_set_b16,
|
|
.voltage_run = foc_control_voltage_run_b16,
|
|
.current_run = foc_control_current_run_b16,
|
|
.state_get = foc_control_state_get_b16,
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: foc_control_init_b16
|
|
*
|
|
* Description:
|
|
* Initialize the FOC PI controller (fixed16)
|
|
*
|
|
* Input Parameter:
|
|
* h - pointer to FOC handler
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int foc_control_init_b16(FAR foc_handler_b16_t *h)
|
|
{
|
|
int ret = OK;
|
|
|
|
DEBUGASSERT(h);
|
|
|
|
/* Connect controller data */
|
|
|
|
h->control = zalloc(sizeof(struct foc_picontrol_b16_s));
|
|
if (h->control == NULL)
|
|
{
|
|
ret = -ENOMEM;
|
|
goto errout;
|
|
}
|
|
|
|
errout:
|
|
return ret;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: foc_control_deinit_b16
|
|
*
|
|
* Description:
|
|
* Deinitialize the FOC PI controller (fixed16)
|
|
*
|
|
* Input Parameter:
|
|
* h - pointer to FOC handler
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void foc_control_deinit_b16(FAR foc_handler_b16_t *h)
|
|
{
|
|
DEBUGASSERT(h);
|
|
|
|
/* Free controller data */
|
|
|
|
if (h->control)
|
|
{
|
|
free(h->control);
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: foc_control_cfg_set_b16
|
|
*
|
|
* Description:
|
|
* Configure the FOC controller (fixed16)
|
|
*
|
|
* Input Parameter:
|
|
* h - pointer to FOC handler
|
|
* cfg - pointer to controller configuration data
|
|
* (struct foc_picontrol_b16_s)
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void foc_control_cfg_b16(FAR foc_handler_b16_t *h, FAR void *cfg)
|
|
{
|
|
FAR struct foc_picontrol_b16_s *foc = NULL;
|
|
|
|
DEBUGASSERT(h);
|
|
DEBUGASSERT(cfg);
|
|
|
|
/* Get controller data */
|
|
|
|
DEBUGASSERT(h->control);
|
|
foc = h->control;
|
|
|
|
/* Copy data */
|
|
|
|
memcpy(&foc->cfg, cfg, sizeof(struct foc_initdata_b16_s));
|
|
|
|
/* Initialize FOC controller data */
|
|
|
|
foc_init_b16(&foc->data, &foc->cfg);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: foc_control_input_set_b16
|
|
*
|
|
* Description:
|
|
* Update input for controller (fixed16)
|
|
*
|
|
* Input Parameter:
|
|
* h - pointer to FOC handler
|
|
* current - phase currents in amps
|
|
* vbase - base voltage for controller
|
|
* angle - phase angle in rad
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void foc_control_input_set_b16(FAR foc_handler_b16_t *h,
|
|
FAR b16_t *current,
|
|
b16_t vbase,
|
|
b16_t angle)
|
|
{
|
|
FAR struct foc_picontrol_b16_s *foc = NULL;
|
|
abc_frame_b16_t i_abc;
|
|
|
|
DEBUGASSERT(h);
|
|
DEBUGASSERT(current);
|
|
|
|
/* Get controller data */
|
|
|
|
DEBUGASSERT(h->control);
|
|
foc = h->control;
|
|
|
|
/* Get current in abc frame */
|
|
|
|
i_abc.a = current[0];
|
|
i_abc.b = current[1];
|
|
i_abc.c = current[2];
|
|
|
|
foc_iabc_update_b16(&foc->data, &i_abc);
|
|
|
|
/* Update base voltage only if changed */
|
|
|
|
if (foc->vbase_last != vbase)
|
|
{
|
|
/* Update FOC base voltage */
|
|
|
|
foc_vbase_update_b16(&foc->data, vbase);
|
|
|
|
/* Update last FOC base voltage */
|
|
|
|
foc->vbase_last = vbase;
|
|
}
|
|
|
|
/* Update phase angle */
|
|
|
|
#ifndef CONFIG_INDUSTRY_FOC_CORDIC_ANGLE
|
|
phase_angle_update_b16(&foc->angle, angle);
|
|
#else
|
|
foc_cordic_angle_b16(h->fd, &foc->angle, angle);
|
|
#endif
|
|
|
|
/* Feed the controller with phase angle */
|
|
|
|
foc_angle_update_b16(&foc->data, &foc->angle);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: foc_control_voltage_b16
|
|
*
|
|
* Description:
|
|
* Handle the FOC voltage control (fixed16)
|
|
*
|
|
* Input Parameter:
|
|
* h - pointer to FOC handler
|
|
* dq_ref - DQ voltage reference frame
|
|
* v_ab_mod - (out) modulation alpha-veta voltage
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void foc_control_voltage_run_b16(FAR foc_handler_b16_t *h,
|
|
FAR dq_frame_b16_t *dq_ref,
|
|
FAR ab_frame_b16_t *v_ab_mod)
|
|
{
|
|
FAR struct foc_picontrol_b16_s *foc = NULL;
|
|
b16_t mag_max = 0;
|
|
|
|
DEBUGASSERT(h);
|
|
DEBUGASSERT(dq_ref);
|
|
DEBUGASSERT(v_ab_mod);
|
|
|
|
/* Get controller data */
|
|
|
|
DEBUGASSERT(h->control);
|
|
foc = h->control;
|
|
|
|
/* Get maximum possible voltage DQ vetor magnitude */
|
|
|
|
foc_vdq_mag_max_get_b16(&foc->data, &mag_max);
|
|
|
|
/* Saturate voltage DQ vector */
|
|
|
|
#ifndef CONFIG_INDUSTRY_FOC_CORDIC_DQSAT
|
|
dq_saturate_b16(dq_ref, mag_max);
|
|
#else
|
|
foc_cordic_dqsat_b16(h->fd, dq_ref, mag_max);
|
|
#endif
|
|
|
|
/* Call FOC voltage controller */
|
|
|
|
foc_voltage_control_b16(&foc->data, dq_ref);
|
|
|
|
/* Get output v_ab_mod frame */
|
|
|
|
foc_vabmod_get_b16(&foc->data, v_ab_mod);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: foc_control_current_b16
|
|
*
|
|
* Description:
|
|
* Handle the FOC current control (fixed16)
|
|
*
|
|
* h - pointer to FOC handler
|
|
* dq_ref - DQ current reference frame
|
|
* vdq_comp - DQ voltage compensation
|
|
* v_ab_mod - (out) modulation alpha-veta voltage
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void foc_control_current_run_b16(FAR foc_handler_b16_t *h,
|
|
FAR dq_frame_b16_t *dq_ref,
|
|
FAR dq_frame_b16_t *vdq_comp,
|
|
FAR ab_frame_b16_t *v_ab_mod)
|
|
{
|
|
FAR struct foc_picontrol_b16_s *foc = NULL;
|
|
dq_frame_b16_t v_dq_ref;
|
|
b16_t mag_max = 0;
|
|
|
|
DEBUGASSERT(h);
|
|
DEBUGASSERT(dq_ref);
|
|
DEBUGASSERT(vdq_comp);
|
|
DEBUGASSERT(v_ab_mod);
|
|
|
|
/* Get controller data */
|
|
|
|
DEBUGASSERT(h->control);
|
|
foc = h->control;
|
|
|
|
/* Reset voltage reference */
|
|
|
|
v_dq_ref.d = 0;
|
|
v_dq_ref.q = 0;
|
|
|
|
/* Call FOC current controller */
|
|
|
|
foc_current_control_b16(&foc->data, dq_ref, vdq_comp, &v_dq_ref);
|
|
|
|
/* Get maximum possible voltage DQ vetor magnitude */
|
|
|
|
foc_vdq_mag_max_get_b16(&foc->data, &mag_max);
|
|
|
|
/* Saturate voltage DQ vector */
|
|
|
|
#ifndef CONFIG_INDUSTRY_FOC_CORDIC_DQSAT
|
|
dq_saturate_b16(&v_dq_ref, mag_max);
|
|
#else
|
|
foc_cordic_dqsat_b16(h->fd, &v_dq_ref, mag_max);
|
|
#endif
|
|
|
|
/* Call FOC voltage control */
|
|
|
|
foc_voltage_control_b16(&foc->data, &v_dq_ref);
|
|
|
|
/* Get output v_ab_mod frame */
|
|
|
|
foc_vabmod_get_b16(&foc->data, v_ab_mod);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: foc_control_state_get_b16
|
|
*
|
|
* Description:
|
|
* Get the FOC controller state (fixed16)
|
|
*
|
|
* Input Parameter:
|
|
* h - pointer to FOC handler
|
|
* state - (out) pointer to FOC state data
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void foc_control_state_get_b16(FAR foc_handler_b16_t *h,
|
|
FAR struct foc_state_b16_s *state)
|
|
{
|
|
FAR struct foc_picontrol_b16_s *foc = NULL;
|
|
|
|
DEBUGASSERT(h);
|
|
DEBUGASSERT(state);
|
|
|
|
/* Get controller data */
|
|
|
|
DEBUGASSERT(h->control);
|
|
foc = h->control;
|
|
|
|
/* Copy DQ voltage */
|
|
|
|
state->vdq.q = foc->data.v_dq.q;
|
|
state->vdq.d = foc->data.v_dq.d;
|
|
|
|
/* Copy DQ current */
|
|
|
|
state->idq.q = foc->data.i_dq.q;
|
|
state->idq.d = foc->data.i_dq.d;
|
|
|
|
/* Copy alpha-beta current */
|
|
|
|
state->iab.a = foc->data.i_ab.a;
|
|
state->iab.b = foc->data.i_ab.b;
|
|
|
|
/* Copy alpha-beta voltage */
|
|
|
|
state->vab.a = foc->data.v_ab.a;
|
|
state->vab.b = foc->data.v_ab.b;
|
|
|
|
/* Copy phase current */
|
|
|
|
state->curr[0] = foc->data.i_abc.a;
|
|
state->curr[1] = foc->data.i_abc.b;
|
|
state->curr[2] = foc->data.i_abc.c;
|
|
|
|
/* Copy phase voltage */
|
|
|
|
state->volt[0] = foc->data.v_abc.a;
|
|
state->volt[1] = foc->data.v_abc.b;
|
|
state->volt[2] = foc->data.v_abc.c;
|
|
|
|
/* Copy modulation scale */
|
|
|
|
state->mod_scale = foc->data.vab_mod_scale;
|
|
}
|