Skip to main content
Version: 5.0.x {stable}

Rest variables

rest = Rotor position ESTimator

info

Next variables are located in the folder /driver/rest.

danger

Wrong settings in this folder may cause unexpected motor spining, even with in the stop command issued and/or any other freewheeling mode! Proceed with caution.

tip

The VECTOR algorithm supports multiple motor sensors. Not all parameters are used for every sensor type.

State varibles

angle [rad]

Estimated sensor angle position output (after the processing).

hall

Position of hall sensors. This variable is used only in the hall sensor mode.

ValueDescription
0All hall sensors are off - Error value
7All hall sensors are on - Error value
1-6Hall sensor position

Parameters for sensors

tip

All the sensor parametres are automatically identified with the identrun procedure, no need to set it manually.

omega [erad/s]

If the PMSM (Permanent Magnet Synchronous Machine) motor is selected (by setting psi to other than zero), and asynchronous mode is selected (prest = 0), this parameter defines the rotation speed of the forced magnetic filed (the electrical angle is not coupled to the shaft angle).

If the ACIM (AC induction machine) motor is selected (by setting psi to zero), this parameter defines either: U/F ratio of the induction machine (when prest = 0 - sensorless), OR the current-dependent slip frequency of the induction machine (when prest is other than zero and a sensor is used).

hinv [-]

UVW hall sensor polarity inversion.

A bitwise parameter that allows the user to flip polarity of the selected hall input. The inversion is useful e.g. with 60° hall sensor.

bitdescription
0U hall inversion
1V hall inversion
2W hall inversion

This picture depicits the schematic of two possible hall sensor configurations: 60° and 120°. With 60° configuration, the hall_W must be inverted:

Colors of the hall sensors are usually used on msens wires.

caution

This parameter is not automatically detected during identification procedure and must be set manually. For more standard 120°, use the default, zero value.

hvar [-]

Hall sensor connection variant. This parameter maps the hall sensor inputs to the motor coils.

roff1 [LSB]

SIN input offset. When encoder is used, this parameter defines the number of encoder pulses per mechanical revolution.

roff2 [LSB]

COS input offset.

rpole []

Defines the number of electrical revolutions per one sensor revolution.

rangle [rad]

Sensor angle offset


Parameters for REST

The position estimator is a dynamic state observer that aims to filter out the sensor issues while preserving the zero phase shift and latency. Using this estimator, you can filter out misreadings or even compensate the intrinsic delay in the sensor hardware. Tuning up the estimator is an intensive topic and will be covered elsewhere.

esk [-]

The estimator speed gain. The higher the number, the more the estimator 'trusts' the speed measured by the sensor.

eak [-]

The estimator angle gain. The higher the number, the more the estimator 'trusts' the angle measured by the sensor.

eca [rad]

The estimator angle clip. Used in the hall sensor mode only.

ect [s]

The estimator angle clip time constant. Used in the hall sensor mode only.

edc [s]

The estimator sensor latency compensation. Can be used to compensate the time delay in the sensor hardware.


Parameters for auto sensoreless mode

Some sensors may have problems at high speeds. This parameter allows to automaticaly employ sensoreless mode when the motor speed raises above the assh. The driver falls back into the sensored mode when motor speed is below the assl. If any of these parameters is set to zero, this function is disabled.

tip

Most usefull with bad hall sensors - hall sensors are used at low speeds, and sensoreless mode is used at high speeds.

assl [RPM]

Auto sensoreless mode low treshold.

If motor speed /driver/rpmf is below this value, the selected sensored mode is activated (defined with the prest parameter).

assh [RPM]

Auto sensoreless mode high treshold.

If motor speed /driver/rpmf is abowe this value, sensoreless mode is forced.