nuttx-apps/industry/foc/float/foc_ang_onfo.c
raiden00pl 768d5b29f1 industry/foc: force angle observers output to zero if motor stopped
this prevents junk data from the observer when the motor is stopped
2023-10-16 13:42:57 -04:00

318 lines
8.7 KiB
C

/****************************************************************************
* apps/industry/foc/float/foc_ang_onfo.c
*
* 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 "industry/foc/foc_log.h"
#include "industry/foc/float/foc_angle.h"
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
#define SIGN(x) ((x > 0.0f) ? 1.0f : -1.0f)
#define LINEAR_MAP(x, in_min, in_max, out_min, out_max) \
((x - in_min) * (out_max - out_min) / (in_max - in_min) + out_min)
/****************************************************************************
* Private Data Types
****************************************************************************/
/* sensorless observer data */
struct foc_ang_onfo_f32_s
{
struct foc_angle_onfo_cfg_f32_s cfg;
struct motor_aobserver_nfo_f32_s data;
struct motor_aobserver_f32_s o;
float sensor_dir;
};
/****************************************************************************
* Private Function Prototypes
****************************************************************************/
static int foc_angle_onfo_init_f32(FAR foc_angle_f32_t *h);
static void foc_angle_onfo_deinit_f32(FAR foc_angle_f32_t *h);
static int foc_angle_onfo_cfg_f32(FAR foc_angle_f32_t *h, FAR void *cfg);
static int foc_angle_onfo_zero_f32(FAR foc_angle_f32_t *h);
static int foc_angle_onfo_dir_f32(FAR foc_angle_f32_t *h, float dir);
static int foc_angle_onfo_run_f32(FAR foc_angle_f32_t *h,
FAR struct foc_angle_in_f32_s *in,
FAR struct foc_angle_out_f32_s *out);
/****************************************************************************
* Public Data
****************************************************************************/
/* FOC angle float interface */
struct foc_angle_ops_f32_s g_foc_angle_onfo_f32 =
{
.init = foc_angle_onfo_init_f32,
.deinit = foc_angle_onfo_deinit_f32,
.cfg = foc_angle_onfo_cfg_f32,
.zero = foc_angle_onfo_zero_f32,
.dir = foc_angle_onfo_dir_f32,
.run = foc_angle_onfo_run_f32,
};
/****************************************************************************
* Private Functions
****************************************************************************/
/****************************************************************************
* Name: foc_angle_onfo_init_f32
*
* Description:
* Initialize the sensorless observer FOC angle handler (float32)
*
* Input Parameter:
* h - pointer to FOC angle handler
*
****************************************************************************/
static int foc_angle_onfo_init_f32(FAR foc_angle_f32_t *h)
{
int ret = OK;
DEBUGASSERT(h);
/* Connect angle data */
h->data = zalloc(sizeof(struct foc_ang_onfo_f32_s));
if (h->data == NULL)
{
ret = -ENOMEM;
goto errout;
}
errout:
return ret;
}
/****************************************************************************
* Name: foc_angle_onfo_deinit_f32
*
* Description:
* De-initialize the sensorless observer FOC angle handler (float32)
*
* Input Parameter:
* h - pointer to FOC angle handler
*
****************************************************************************/
static void foc_angle_onfo_deinit_f32(FAR foc_angle_f32_t *h)
{
DEBUGASSERT(h);
if (h->data)
{
/* Free angle data */
free(h->data);
}
}
/****************************************************************************
* Name: foc_angle_onfo_cfg_f32
*
* Description:
* Configure the sensorless observer FOC angle handler (float32)
*
* Input Parameter:
* h - pointer to FOC angle handler
* cfg - pointer to angle handler configuration data
* (struct foc_ang_onfo_f32_s)
*
****************************************************************************/
static int foc_angle_onfo_cfg_f32(FAR foc_angle_f32_t *h, FAR void *cfg)
{
FAR struct foc_ang_onfo_f32_s *ob = NULL;
int ret = OK;
DEBUGASSERT(h);
/* Get sensorless observer data */
DEBUGASSERT(h->data);
ob = h->data;
/* Copy configuration */
memcpy(&ob->cfg, cfg, sizeof(struct foc_angle_onfo_cfg_f32_s));
/* Initialize sensorless observer controller data */
DEBUGASSERT(ob->cfg.per > 0.0f);
/* Initialize nolinear fluxlink angle observer */
motor_aobserver_nfo_init(&ob->data);
/* Initialize sensorless observer */
motor_aobserver_init(&ob->o, &ob->data, ob->cfg.per);
/* Initialize with CW direction */
ob->sensor_dir = DIR_CW;
return ret;
}
/****************************************************************************
* Name: foc_angle_onfo_zero_f32
*
* Description:
* Zero the sensorless observer FOC angle handler (float32)
*
* Input Parameter:
* h - pointer to FOC angle handler
*
****************************************************************************/
static int foc_angle_onfo_zero_f32(FAR foc_angle_f32_t *h)
{
FAR struct foc_ang_onfo_f32_s *ob = NULL;
DEBUGASSERT(h);
/* Get sensorless observer data */
DEBUGASSERT(h->data);
ob = h->data;
/* Reinitialize observer data */
motor_aobserver_nfo_init(&ob->data);
/* Reset angle */
ob->o.angle = 0.0f;
return OK;
}
/****************************************************************************
* Name: foc_angle_onfo_dir_f32
*
* Description:
* Set the sensorless observer FOC angle handler direction (float32)
*
* Input Parameter:
* h - pointer to FOC angle handler
* dir - sensor direction (1 if normal -1 if inverted)
*
****************************************************************************/
static int foc_angle_onfo_dir_f32(FAR foc_angle_f32_t *h, float dir)
{
FAR struct foc_ang_onfo_f32_s *ob = NULL;
DEBUGASSERT(h);
/* Get sensorless observer data */
DEBUGASSERT(h->data);
ob = h->data;
/* Configure direction */
ob->sensor_dir = dir;
return OK;
}
/****************************************************************************
* Name: foc_angle_onfo_run_f32
*
* Description:
* Process the FOC sensorless observer angle data (float32)
*
* Input Parameter:
* h - pointer to FOC angle handler
* in - pointer to FOC angle handler input data
* out - pointer to FOC angle handler output data
*
****************************************************************************/
static int foc_angle_onfo_run_f32(FAR foc_angle_f32_t *h,
FAR struct foc_angle_in_f32_s *in,
FAR struct foc_angle_out_f32_s *out)
{
FAR struct foc_ang_onfo_f32_s *ob = NULL;
FAR dq_frame_f32_t v_dq_mod;
float duty_now;
float dyn_gain;
DEBUGASSERT(h);
/* Get sensorless observer data */
DEBUGASSERT(h->data);
ob = h->data;
if (in->vel == 0.0f)
{
/* Do nothing if motor stopped */
out->type = FOC_ANGLE_TYPE_ELE;
out->angle = 0.0f;
return OK;
}
/* Normalize the d-q voltage to get the d-q modulation voltage */
v_dq_mod.d = in->state->vdq.d * in->state->mod_scale;
v_dq_mod.q = in->state->vdq.q * in->state->mod_scale;
/* Update duty cycle now */
duty_now = SIGN(in->state->vdq.q) * vector2d_mag(v_dq_mod.d, v_dq_mod.q);
/* Update and the observer gain. */
dyn_gain = LINEAR_MAP(fabsf(duty_now), 0.0f, 1.0f,
ob->cfg.gain * ob->cfg.gain_slow, ob->cfg.gain) * 0.5f;
/* Update observer */
motor_aobserver_nfo(&ob->o, &in->state->iab, &in->state->vab,
&ob->cfg.phy, dyn_gain);
/* Copy data */
out->type = FOC_ANGLE_TYPE_ELE;
out->angle = ob->sensor_dir * motor_aobserver_angle_get(&ob->o);
return OK;
}