27588be53e
Decouple the FOC example configuration from the FOC lib configuration. Purely cosmetic change, without affecting functionality.
286 lines
9.1 KiB
C
286 lines
9.1 KiB
C
/****************************************************************************
|
|
* apps/examples/foc/foc_cfg.h
|
|
*
|
|
* 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.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef __APPS_EXAMPLES_FOC_FOC_CFG_H
|
|
#define __APPS_EXAMPLES_FOC_FOC_CFG_H
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include <stdbool.h>
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
#if defined(CONFIG_EXAMPLES_FOC_SENSORLESS) && \
|
|
defined(CONFIG_EXAMPLES_FOC_SENSORED)
|
|
# error Simultaneous support for sensorless and sensored mode not supported
|
|
#endif
|
|
|
|
/* For now only sensorless velocity control supported */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_SENSORLESS
|
|
# ifndef CONFIG_EXAMPLES_FOC_HAVE_VEL
|
|
# error
|
|
# endif
|
|
#endif
|
|
|
|
/* Position controller needs velocity controller */
|
|
|
|
#if defined(CONFIG_EXAMPLES_FOC_HAVE_POS) && \
|
|
!defined(CONFIG_EXAMPLES_FOC_HAVE_VEL)
|
|
# error Position controller needs velocity controller
|
|
#endif
|
|
|
|
/* Velocity controller needs torque controller */
|
|
|
|
#if defined(CONFIG_EXAMPLES_FOC_HAVE_VEL) && \
|
|
!defined(CONFIG_EXAMPLES_FOC_HAVE_TORQ)
|
|
# error Velocity controller needs torque controller
|
|
#endif
|
|
|
|
/* Open-loop configuration */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_OPENLOOP
|
|
# ifndef CONFIG_EXAMPLES_FOC_HAVE_VEL
|
|
# error open-loop needs CONFIG_EXAMPLES_FOC_HAVE_VEL set
|
|
# endif
|
|
# ifndef CONFIG_EXAMPLES_FOC_HAVE_OPENLOOP
|
|
# error open-loop needs CONFIG_EXAMPLES_FOC_HAVE_OPENLOOP
|
|
# endif
|
|
#endif
|
|
|
|
/* For now only the FOC PI current controller supported */
|
|
|
|
#ifndef CONFIG_EXAMPLES_FOC_CONTROL_PI
|
|
# error For now only the FOC PI current controller supported
|
|
#endif
|
|
|
|
/* Velocity ramp must be configured */
|
|
|
|
#if (CONFIG_EXAMPLES_FOC_RAMP_THR == 0)
|
|
# error CONFIG_EXAMPLES_FOC_RAMP_THR not configured
|
|
#endif
|
|
#if (CONFIG_EXAMPLES_FOC_RAMP_ACC == 0)
|
|
# error CONFIG_EXAMPLES_FOC_RAMP_ACC not configured
|
|
#endif
|
|
#if (CONFIG_EXAMPLES_FOC_RAMP_DEC == 0)
|
|
# error CONFIG_EXAMPLES_FOC_RAMP_DEC not configured
|
|
#endif
|
|
|
|
/* Motor identification support */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_IDENT
|
|
# if (CONFIG_EXAMPLES_FOC_IDENT_RES_CURRENT == 0)
|
|
# error CONFIG_EXAMPLES_FOC_IDENT_RES_CURRENT not configured
|
|
# endif
|
|
# if (CONFIG_EXAMPLES_FOC_IDENT_RES_KI == 0)
|
|
# error CONFIG_EXAMPLES_FOC_IDENT_RES_KI not configured
|
|
# endif
|
|
# if (CONFIG_EXAMPLES_FOC_IDENT_IND_VOLTAGE == 0)
|
|
# error CONFIG_EXAMPLES_FOC_IDENT_IND_VOLTAGE not configured
|
|
# endif
|
|
# if (CONFIG_EXAMPLES_FOC_IDENT_RES_SEC == 0)
|
|
# error CONFIG_EXAMPLES_FOC_IDENT_RES_SEC not configured
|
|
# endif
|
|
# if (CONFIG_EXAMPLES_FOC_IDENT_IND_SEC == 0)
|
|
# error CONFIG_EXAMPLES_FOC_IDENT_IND_SEC not configured
|
|
# endif
|
|
#endif
|
|
|
|
/* Printer prescaler */
|
|
|
|
#if defined(CONFIG_INDUSTRY_FOC_HANDLER_PRINT) && \
|
|
(CONFIG_EXAMPLES_FOC_STATE_PRINT_FREQ > 0)
|
|
# define FOC_STATE_PRINT_PRE (CONFIG_EXAMPLES_FOC_NOTIFIER_FREQ / \
|
|
CONFIG_EXAMPLES_FOC_STATE_PRINT_FREQ)
|
|
#else
|
|
# undef FOC_STATE_PRINT_PRE
|
|
#endif
|
|
|
|
/* Velocity ramp configuration */
|
|
|
|
#define RAMP_CFG_THR (CONFIG_EXAMPLES_FOC_RAMP_THR / 1.0f)
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_STATE_USE_MODEL_PMSM
|
|
|
|
/* PMSM model parameters */
|
|
|
|
# define FOC_MODEL_POLES 7
|
|
# define FOC_MODEL_LOAD (1.0f)
|
|
# define FOC_MODEL_RES (0.11f)
|
|
# define FOC_MODEL_IND (0.0002f)
|
|
# define FOC_MODEL_INER (0.1f)
|
|
# define FOC_MODEL_FLUX (0.001f)
|
|
# define FOC_MODEL_INDD (0.0002f)
|
|
# define FOC_MODEL_INDQ (0.0002f)
|
|
#endif
|
|
|
|
/* Qenco configuration */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_QENCO
|
|
# if CONFIG_EXAMPLES_FOC_MOTOR_POLES == 0
|
|
# error CONFIG_EXAMPLES_FOC_MOTOR_POLES must be defined
|
|
# endif
|
|
# if CONFIG_EXAMPLES_FOC_QENCO_POSMAX == 0
|
|
# error CONFIG_EXAMPLES_FOC_QENCO_POSMAX must be defined
|
|
# endif
|
|
#endif
|
|
|
|
/* Setpoint source must be specified */
|
|
|
|
#if !defined(CONFIG_EXAMPLES_FOC_SETPOINT_CONST) && \
|
|
!defined(CONFIG_EXAMPLES_FOC_SETPOINT_ADC) && \
|
|
!defined(CONFIG_EXAMPLES_FOC_SETPOINT_CHAR)
|
|
# error setpoint source not selected
|
|
#endif
|
|
|
|
/* Setpoint ADC scale factor */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_SETPOINT_ADC
|
|
# define SETPOINT_INTF_SCALE (1.0f / CONFIG_EXAMPLES_FOC_ADC_MAX)
|
|
#endif
|
|
|
|
/* If constant setpoint is selected, setpoint value must be provided */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_SETPOINT_CONST
|
|
# define SETPOINT_INTF_SCALE (1)
|
|
# if CONFIG_EXAMPLES_FOC_SETPOINT_CONST_VALUE == 0
|
|
# error CONFIG_EXAMPLES_FOC_SETPOINT_CONST_VALUE not configured
|
|
# endif
|
|
#endif
|
|
|
|
/* CHARCTRL setpoint control */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_SETPOINT_CHAR
|
|
# define SETPOINT_INTF_SCALE (1.0f / (CONFIG_EXAMPLES_FOC_SETPOINT_MAX / 1000.0f))
|
|
#endif
|
|
|
|
/* VBUS source must be specified */
|
|
|
|
#if !defined(CONFIG_EXAMPLES_FOC_VBUS_CONST) && \
|
|
!defined(CONFIG_EXAMPLES_FOC_VBUS_ADC)
|
|
# error no VBUS source selected !
|
|
#endif
|
|
|
|
/* VBUS ADC scale factor */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_VBUS_ADC
|
|
# define VBUS_ADC_SCALE (CONFIG_EXAMPLES_FOC_ADC_VREF * \
|
|
CONFIG_EXAMPLES_FOC_VBUS_SCALE / \
|
|
CONFIG_EXAMPLES_FOC_ADC_MAX / \
|
|
1000.0f / \
|
|
1000.0f)
|
|
#endif
|
|
|
|
/* If constant VBUS is selected, VBUS value must be provided */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_VBUS_CONST
|
|
# define VBUS_ADC_SCALE (1)
|
|
# define VBUS_CONST_VALUE (CONFIG_EXAMPLES_FOC_VBUS_CONST_VALUE / 1000.0f)
|
|
# if CONFIG_EXAMPLES_FOC_VBUS_CONST_VALUE == 0
|
|
# error CONFIG_EXAMPLES_FOC_VBUS_CONST_VALUE not configured
|
|
# endif
|
|
#endif
|
|
|
|
/* Velocity controller prescaler */
|
|
|
|
#define VEL_CONTROL_PRESCALER (CONFIG_EXAMPLES_FOC_NOTIFIER_FREQ / \
|
|
CONFIG_EXAMPLES_FOC_VELCTRL_FREQ)
|
|
|
|
/* Open-loop to observer angle merge factor */
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_SENSORLESS
|
|
# if CONFIG_EXAMPLES_FOC_ANGOBS_MERGE_RATIO > 0
|
|
# define ANGLE_MERGE_FACTOR (CONFIG_EXAMPLES_FOC_ANGOBS_MERGE_RATIO / 100.0f)
|
|
# endif
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Public Type Definition
|
|
****************************************************************************/
|
|
|
|
struct foc_thr_cfg_s
|
|
{
|
|
int fmode; /* FOC control mode */
|
|
int mmode; /* Motor control mode */
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_OPENLOOP
|
|
uint32_t qparam; /* Open-loop Q setting (x1000) */
|
|
bool ol_force; /* Force open-loop */
|
|
# ifdef CONFIG_EXAMPLES_FOC_ANGOBS
|
|
uint32_t ol_thr; /* Observer vel threshold [x1] */
|
|
uint32_t ol_hys; /* Observer vel hysteresys [x1] */
|
|
# endif
|
|
#endif
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_CONTROL_PI
|
|
uint32_t foc_pi_kp; /* FOC PI Kp (x1000) */
|
|
uint32_t foc_pi_ki; /* FOC PI Ki (x1000) */
|
|
#endif
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_TORQ
|
|
uint32_t torqmax; /* Torque max (x1000) */
|
|
#endif
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_VEL
|
|
uint32_t velmax; /* Velocity max (x1000) */
|
|
uint32_t acc; /* Acceleration (x1) */
|
|
uint32_t dec; /* Deceleration (x1) */
|
|
#endif
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_POS
|
|
uint32_t posmax; /* Position max (x1000) */
|
|
#endif
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_IDENT
|
|
uint32_t ident_res_ki; /* Ident res Ki (x1000) */
|
|
uint32_t ident_res_curr; /* Ident res current (x1000) */
|
|
uint32_t ident_res_sec; /* Ident res sec */
|
|
uint32_t ident_ind_volt; /* Ident res voltage (x1000) */
|
|
uint32_t ident_ind_sec; /* Ident ind sec */
|
|
#endif
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_HAVE_VEL
|
|
uint32_t vel_filter; /* Velocity filter (x1000) */
|
|
#endif
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_VELOBS_PLL
|
|
uint32_t vel_pll_kp; /* Vel PLL observer Kp (x1000) */
|
|
uint32_t vel_pll_ki; /* Vel PLL observer Ki (x1000) */
|
|
#endif
|
|
#ifdef CONFIG_EXAMPLES_FOC_VELOBS_DIV
|
|
uint32_t vel_div_samples; /* Vel DIV observer samples */
|
|
uint32_t vel_div_filter; /* Vel DIV observer filter (x1000) */
|
|
#endif
|
|
#ifdef CONFIG_EXAMPLES_FOC_VELCTRL_PI
|
|
uint32_t vel_pi_kp; /* Vel controller PI Kp (x1000000) */
|
|
uint32_t vel_pi_ki; /* Vel controller PI Ki (x1000000) */
|
|
#endif
|
|
|
|
#ifdef CONFIG_EXAMPLES_FOC_ANGOBS_NFO
|
|
uint32_t ang_nfo_slow; /* Ang NFO slow gain (x1) */
|
|
uint32_t ang_nfo_gain; /* Ang NFO gain (x1) */
|
|
#endif
|
|
};
|
|
|
|
#endif /* __APPS_EXAMPLES_FOC_FOC_CFG_H */
|