nuttx-apps/industry/foc/fixed16/foc_ang_hall.c

595 lines
14 KiB
C

/****************************************************************************
* apps/industry/foc/fixed16/foc_ang_hall.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 <sys/ioctl.h>
#include <assert.h>
#include <errno.h>
#include <stdlib.h>
#include <fcntl.h>
#include <nuttx/sensors/hall3ph.h>
#include "industry/foc/foc_log.h"
#include "industry/foc/fixed16/foc_angle.h"
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
#define HALL_MAX (6)
#define ONE_BY_HALL_MAX (b16idiv(1, HALL_MAX))
#define HALL_ANGLE_STEP (b16mulb16(ONE_BY_HALL_MAX, MOTOR_ANGLE_E_MAX_B16))
/****************************************************************************
* Private Data Types
****************************************************************************/
/* Hall private data */
struct foc_hall_b16_s
{
int fd;
int8_t sector;
int8_t offset;
b16_t sensor_dir;
b16_t angle;
#ifdef CONFIG_INDUSTRY_FOC_ANGLE_HALL_EST
int8_t sector_last;
int8_t sector_diff;
int8_t sector_diff_last;
b16_t per_acc;
b16_t vel_est;
b16_t angle_diff;
#endif
struct foc_hall_cfg_b16_s cfg;
};
/****************************************************************************
* Private Function Prototypes
****************************************************************************/
static int foc_angle_hl_init_b16(FAR foc_angle_b16_t *h);
static void foc_angle_hl_deinit_b16(FAR foc_angle_b16_t *h);
static int foc_angle_hl_cfg_b16(FAR foc_angle_b16_t *h, FAR void *cfg);
static int foc_angle_hl_zero_b16(FAR foc_angle_b16_t *h);
static int foc_angle_hl_dir_b16(FAR foc_angle_b16_t *h, b16_t dir);
static int foc_angle_hl_run_b16(FAR foc_angle_b16_t *h,
FAR struct foc_angle_in_b16_s *in,
FAR struct foc_angle_out_b16_s *out);
/****************************************************************************
* Public Data
****************************************************************************/
/* FOC angle fixed16 interface */
struct foc_angle_ops_b16_s g_foc_angle_hl_b16 =
{
.init = foc_angle_hl_init_b16,
.deinit = foc_angle_hl_deinit_b16,
.cfg = foc_angle_hl_cfg_b16,
.zero = foc_angle_hl_zero_b16,
.dir = foc_angle_hl_dir_b16,
.run = foc_angle_hl_run_b16,
};
/* Sector angles */
static b16_t g_sector_angle[7] =
{
b16muli(HALL_ANGLE_STEP, 0),
b16muli(HALL_ANGLE_STEP, 1),
b16muli(HALL_ANGLE_STEP, 2),
b16muli(HALL_ANGLE_STEP, 3),
b16muli(HALL_ANGLE_STEP, 4),
b16muli(HALL_ANGLE_STEP, 5),
b16muli(HALL_ANGLE_STEP, 6)
};
/****************************************************************************
* Private Functions
****************************************************************************/
/****************************************************************************
* Name: foc_angle_hl_decode
****************************************************************************/
static int8_t foc_angle_hl_decode_sector(uint8_t hall)
{
int8_t sector = -1;
#if defined(CONFIG_INDUSTRY_FOC_ANGLE_HALL_120DEG)
switch (hall)
{
case HALL3_120DEG_POS_1:
{
sector = 0;
break;
}
case HALL3_120DEG_POS_2:
{
sector = 1;
break;
}
case HALL3_120DEG_POS_3:
{
sector = 2;
break;
}
case HALL3_120DEG_POS_4:
{
sector = 3;
break;
}
case HALL3_120DEG_POS_5:
{
sector = 4;
break;
}
case HALL3_120DEG_POS_6:
{
sector = 5;
break;
}
default:
{
sector = -1;
}
}
#elif defined(CONFIG_INDUSTRY_FOC_ANGLE_HALL_60DEG)
switch (hall)
{
case HALL3_60DEG_POS_1:
{
sector = 0;
break;
}
case HALL3_60DEG_POS_2:
{
sector = 1;
break;
}
case HALL3_60DEG_POS_3:
{
sector = 2;
break;
}
case HALL3_60DEG_POS_4:
{
sector = 3;
break;
}
case HALL3_60DEG_POS_5:
{
sector = 4;
break;
}
case HALL3_60DEG_POS_6:
{
sector = 5;
break;
}
default:
{
sector = -1;
}
}
#else
# error Invalid configuration
#endif
return sector;
}
/****************************************************************************
* Name: foc_angle_hl_sector_get()
****************************************************************************/
static uint8_t foc_angle_hl_sector_get(FAR foc_angle_b16_t *h)
{
FAR struct foc_hall_b16_s *hl = NULL;
int ret = OK;
int8_t sector = -1;
uint8_t hall = 0;
DEBUGASSERT(h);
/* Get hall data */
DEBUGASSERT(h->data);
hl = h->data;
/* Get the positions from hall */
ret = ioctl(hl->fd, SNIOC_GET_POSITION, (unsigned long)((uintptr_t)&hall));
if (ret < 0)
{
FOCLIBERR("ERROR: H3PH_POSITION failed, errno=%d\n", errno);
goto errout;
}
/* Decode hall sector */
sector = foc_angle_hl_decode_sector(hall);
if (sector == -1)
{
goto errout;
}
errout:
return sector;
}
/****************************************************************************
* Name: foc_angle_hl_init_b16
*
* Description:
* Initialize hall the FOC angle handler (fixed16)
*
* Input Parameter:
* h - pointer to FOC angle handler
*
****************************************************************************/
static int foc_angle_hl_init_b16(FAR foc_angle_b16_t *h)
{
int ret = OK;
DEBUGASSERT(h);
/* Connect angle data */
h->data = zalloc(sizeof(struct foc_hall_b16_s));
if (h->data == NULL)
{
ret = -ENOMEM;
goto errout;
}
errout:
return ret;
}
/****************************************************************************
* Name: foc_angle_hl_deinit_b16
*
* Description:
* De-initialize hall the FOC angle handler (fixed16)
*
* Input Parameter:
* h - pointer to FOC angle handler
*
****************************************************************************/
static void foc_angle_hl_deinit_b16(FAR foc_angle_b16_t *h)
{
FAR struct foc_hall_b16_s *hl = NULL;
DEBUGASSERT(h);
/* Get hall data */
DEBUGASSERT(h->data);
hl = h->data;
if (h->data)
{
/* Close file */
if (hl->fd > 0)
{
close(hl->fd);
}
/* Free angle data */
free(h->data);
}
}
/****************************************************************************
* Name: foc_angle_hl_cfg_b16
*
* Description:
* Configure the hall FOC angle handler (fixed16)
*
* Input Parameter:
* h - pointer to FOC angle handler
* cfg - pointer to angle handler configuration data
* (struct foc_hall_b16_s)
*
****************************************************************************/
static int foc_angle_hl_cfg_b16(FAR foc_angle_b16_t *h, FAR void *cfg)
{
FAR struct foc_hall_b16_s *hl = NULL;
int ret = OK;
DEBUGASSERT(h);
/* Get hall data */
DEBUGASSERT(h->data);
hl = h->data;
/* Copy configuration */
memcpy(&hl->cfg, cfg, sizeof(struct foc_hall_cfg_b16_s));
/* Open hall device */
hl->fd = open(hl->cfg.devpath, O_RDONLY);
if (hl->fd <= 0)
{
FOCLIBERR("ERROR: failed to open %s, errno=%d\n",
hl->cfg.devpath, errno);
ret = -errno;
goto errout;
}
/* Initialize with CW direction */
hl->sensor_dir = DIR_CW_B16;
errout:
return ret;
}
/****************************************************************************
* Name: foc_angle_hl_zero_b16
*
* Description:
* Zero the hl FOC angle handler (fixed16)
*
* Input Parameter:
* h - pointer to FOC angle handler
*
****************************************************************************/
static int foc_angle_hl_zero_b16(FAR foc_angle_b16_t *h)
{
FAR struct foc_hall_b16_s *hl = NULL;
int ret = OK;
DEBUGASSERT(h);
/* Get hall data */
DEBUGASSERT(h->data);
hl = h->data;
/* Get hall offset */
hl->offset = foc_angle_hl_sector_get(h);
if (hl->offset == -1)
{
ret = -EINVAL;
goto errout;
}
/* Reset data */
hl->angle = 0;
hl->sector = 0;
errout:
return ret;
}
/****************************************************************************
* Name: foc_angle_hl_dir_b16
*
* Description:
* Set the hl FOC angle handler direction (fixed16)
*
* Input Parameter:
* h - pointer to FOC angle handler
* dir - sensor direction (1 if normal -1 if inverted)
*
****************************************************************************/
static int foc_angle_hl_dir_b16(FAR foc_angle_b16_t *h, b16_t dir)
{
FAR struct foc_hall_b16_s *hl = NULL;
DEBUGASSERT(h);
/* Get hall data */
DEBUGASSERT(h->data);
hl = h->data;
/* Configure direction */
hl->sensor_dir = dir;
return OK;
}
/****************************************************************************
* Name: foc_angle_hl_run_b16
*
* Description:
* Process the hall FOC angle data (fixed16)
*
* 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_hl_run_b16(FAR foc_angle_b16_t *h,
FAR struct foc_angle_in_b16_s *in,
FAR struct foc_angle_out_b16_s *out)
{
FAR struct foc_hall_b16_s *hl = NULL;
int ret = OK;
int8_t sector = -1;
#ifdef CONFIG_INDUSTRY_FOC_ANGLE_HALL_EST
b16_t tmp1 = 0;
#endif
DEBUGASSERT(h);
/* Get hall data */
DEBUGASSERT(h->data);
hl = h->data;
/* Get hall sector now */
sector = foc_angle_hl_sector_get(h);
if (sector == -1)
{
ret = -EINVAL;
goto errout;
}
/* Correct sector with offset */
sector = sector - hl->offset;
if (sector < 0)
{
sector = sector + HALL_MAX;
}
#ifdef CONFIG_INDUSTRY_FOC_ANGLE_HALL_EST
/* Store previous state */
hl->sector_last = hl->sector;
#endif
/* Store current sector */
hl->sector = sector;
#ifdef CONFIG_INDUSTRY_FOC_ANGLE_HALL_EST
/* Sector diff */
hl->sector_diff = hl->sector - hl->sector_last;
/* Handle next sector or estimate angle between sectors */
if (hl->sector_diff != 0)
{
/* Only if per_acc is valid */
if (hl->per_acc > 0)
{
/* Do not update vel_est on boundaries */
if (hl->sector * hl->sector_last != 0)
{
/* Only if velocity direction not changed */
if (hl->sector_diff * hl->sector_diff_last > 0)
{
tmp1 = b16muli(hl->sector_diff, HALL_ANGLE_STEP);
/* Next sector - estimate velocity */
hl->vel_est = b16divb16(tmp1, hl->per_acc);
}
else
{
/* Velocity dir changed */
hl->vel_est = 0;
}
}
/* Reser accumulators */
hl->per_acc = 0;
hl->angle_diff = 0;
}
/* Store last sector diff */
hl->sector_diff_last = hl->sector_diff;
}
else
{
/* Accumulate period for velocity estimation */
hl->per_acc += hl->cfg.per;
/* Accumulate angle diff */
hl->angle_diff += b16mulb16(hl->vel_est, hl->cfg.per);
/* Saturate angle diff */
if (hl->angle_diff > HALL_ANGLE_STEP)
{
hl->angle_diff = HALL_ANGLE_STEP;
}
else if (hl->angle_diff < -HALL_ANGLE_STEP)
{
hl->angle_diff = -HALL_ANGLE_STEP;
}
}
/* Get corrected electrical angle */
hl->angle = b16mulb16(hl->sensor_dir,
g_sector_angle[hl->sector]) + hl->angle_diff;
#else
/* Get electrical angle */
hl->angle = b16mulb16(hl->sensor_dir, g_sector_angle[hl->sector]);
#endif /* CONFIG_INDUSTRY_FOC_ANGLE_HALL_EST */
/* Normalize angle */
angle_norm_2pi_b16(&hl->angle, MOTOR_ANGLE_E_MIN_B16,
MOTOR_ANGLE_E_MAX_B16);
/* Copy data */
out->type = FOC_ANGLE_TYPE_ELE;
out->angle = hl->angle;
errout:
return ret;
}