Editing Granity user guide/Fault limits

{{SetGranityTabPageTitle|Fault limits}}[[File:GranityFaultlimits.png|thumb]]
This tab serves as:
* Set fault triggering levels and tolerances
==Parameters==
===Drive fault limits===
{| class="wikitable"
|-
! Short [[GUI]] name !! [[GUI]] name !! Description !! How to use
|-
| FOC || Over current tolerance || Set sensitivity of over current faults || This variable defines how much over current (measured motor phase  current above the peak current limit (Machine/MMC) drive allows before entering into fault state. The ''Minimum'' setting has lowest threshold and gives fault easier, ''Maximum'' tolerates largest over current spikes before faulting.

Set this as low as possible without getting OC faults in normal use to maximally protect your equipment. If larger than ''Medium'' setting is needed, see [[Over current fault troubleshooting]] for solution to the problem.
|-
| FOV || Over voltage fault threshold || Maximum allowed HV DC bus voltage before entering into over voltage fault. Also defines at which voltage drive starts driving [[Argon user guide/Braking resistor|braking resistor]] to reduce bus voltage.|| See [[Configuring drive voltage limits FUV and FOV]].
|-
| FUV || Under voltage fault threshold || Minimum allowed HV DC bus voltage before drive starts motor initialization after power-on. Also if this voltage is exceeded during active operation, drive enters into under voltage fault state. || See [[Configuring drive voltage limits FUV and FOV]].
|}

===Goal deviation faults===
These settings define how much motor may deviate from the setpoints or allowed operating conditions before entering in fault state.
{| class="wikitable"
|-
! Short [[GUI]] name !! [[GUI]] name !! Description !! How to use
|-
| FFT || Goal fault filter time  || Set time filter for this fault group. Defines how long drive allows exceeding these conditions before entering into fault state. || Normally values between 0-0.5 seconds are safe. Higher value may pose danger to user or equipment as motor is not being stopped soon after error condition.
|-
| FPT || Position tracking error threshold || Defines how much position may deviate from the setpoint || rowspan="3" |The value is set as hardware units. Adjust the value and observe the right side value displaying the hardware value converted to a real world units such as ''revolutions/s''. Make sure [[Granity user guide/Machine|Machine tab]] settings are set-up first to get correct conversion. 
|-
| FVT|| Velocity tracking error threshold ||Defines how much velocity is allowed to deviate from velocity setpoint
|-
|FEV  ||  Over speed fault || Defines the maximum allowed speed (feedback based) which the axis is allowed to operate before entering to the overspeed fault state 
|-
|FMO  ||  Motion fault threshold|| Defines the sensitivity to enter into motion fault. Used for detecting mechanically blocked motion and DC motor runaway (loss of feedback) || If motion fault feature needed, adjust the value experimentally by increasing it until faults don't occur in normal use. A good starting value may be motor continuous current in milliamperes/2.
|-
|LSF  || Limit switch function || Define drive action when position is out of allowed travel range (i.e. limit switch input is open). Device specific notes: 
*[[Argon]]: the ''Servo stop'' option is not implemented
*Other drives (i.e. [[IONI]] and [[ATOMI]]): LSF also works with software limits (when {{param|HHL}} and {{param|HLL}} are set and homing is successfully finished
|| Choose preferred action when position of motor is beyond allowed travel (i.e. physical limit switches are open). Choices:
*''Do nothing'': no action is taken beyond travel limits (in other words, drive ignores travel limit)
*''Disable torque'': drive will set internal torque setpoint to zero if torque direction is set to cause motor go further from allowed travel direction (in other words, torque is allowed only towards allowed travel direction)
*''Fault stop'': drive sets Motion fault state active which sets drive in inactive state (i.e. motor will be braked and requires user action to move motor back to allowed travel range and then clear fault state)
*''Servo stop'': drive attempts to actively brake motor if it's being commanded to out of travel bounds but allows command towards allowed direction
|-
|LSP  || Limit switch polarity || Set the polarity of connected limit switch state interpretation
|| Choose which digital logic state represents the overtravel condition. As in typical wiring, switch is connected between GND and limit switch input (which has internal pull-up resistor), then following will apply:
*Normally closed (NC) switches, select Logic high when overtravel
*Normally open (NO) switches, select Logic low when overtravel
|}
{{next|[[Granity user guide/Testing]]}}