Editing Signal path of motor drive

In Granite Devices drives the torque, velocity and position limits and setpoints are defined as integer numbers. The vales are represented "hardware" scale which are described below.
==Setpoint signal path==
[[Setpoint]] signal path converts user setpoint to ''internal setpoint''. 

===Setpoint signal path===
Main parts are:
*Input multiplier. Purpose of this is to increase resolution of input setpoint to allow more fine grained velocity & acceleration control in trajectory planner. By default {{param|MUL}} value is 50.
*Setpoint smoothing filter. If enabled, applies low pass filter to signal reducing jitter and roughness of signal but also introduces about some delay. By default the filter has 100% attenuation at 250Hz.
*[[Trajectory planner]]. This limits rate of change of setpoint signal based on {{param|CVL}} and {{param|CAL}} parameters. Output rate maximum rate of change:
**Velocity changes max {{param|CAL}} nubmer of units per [[control cycle]] (control cycle is 400µs in most GD drives)
**Velocity maximum value is limited to {{param|CVL}}
*Input divider. This divides setpoint signal by {{param|DIV}} to give desired output scale for ''internal setpoint''. Combination of multiplier and divider can be used change total scaling of setpoint signal.


[[File:Driveblockdiagram setpoint v1.png|900px]]

===Setpoint source scales===
Different [[setpoint]] sources have different range and scale:
{| class="wikitable"
|-
! Setpoint source !! Type !! Range !! Scale
|-
| Pulse & directon || Incremental || Infinite || 
* Position and torque mode: one pulse changes setpoint by one
* Velocity mode: pulse frequency input, setpoint = number of pulses per [[control cycle]]
|-
| Quadrature || Incremental || Infinite || 
* Position and torque mode: one edge of either channel changes setpoint by one
* Velocity mode: frequency input, setpoint = number of edges of either channel per [[control cycle]]
|-
| PWM || rowspan=2 |Absolute || Full input scale equals setpoint range of +/-16384. In loss of PWM signal, setpoint is 0. || rowspan=3 |
*Direct 1:1 absolute value in position mode
*Velocity & torque mode: +/-16834 represents full torque or speed scale
|-
| Analog || Full input scale equals setpoint range of +/-16384 
|-
| Serial ([[SimpleMotion V2]]) || Absolute & incremental || Infinite 
|}

It should be noted that trajectory planner operates after multiplier meaning that {{param|CVL}} velocity limit value is not in equal scale with velocity setpoint value.

===Internal setpoint===
Internal setpoint is a predefined setpoint scale inside the drive. The scale of internal setpoint signals are:
*Position mode: position sensor [[Quadrature|counter]] raw value
*Velocity mode: internal goes through '''Velocity normalized''' that changes scales depending on setpoint source:
**In PWM & Analog source: Internal setpoint of +/-16384 represents whole speed range covered by {{param|CVL}} parameter. I.e. 10V input to analog input runs motor at 100% speed and -5V at -50% etc.
**In all other sources: number of feedback device [[Quadrature|counts]] per one [[control cycle]]. Obtained by calculating the difference of position feedback values at every control cycle.
*Torque mode: '''Torque normalizer''' scales internal setpoint so that value of +/-16384 represents full torque scale (i.e. internal setpoint value 16384 outputs configured peak current {{param|MMC}} and 8192 outputs {{param|MMC}}/2)

==Controller==
The default controller type of GD drives is cascaded type where each controlled variable has it's own PI or P controller. In position mode such structure is called as PIV controller.

The block diagram below represents simplified structure of GD drives.


[[File:Driveblockdiagram controller.png|800px]]




==Calculation formulas and examples==
These examples focus on calculating values on a rotary motor and linear axis.
===Constants used later in calculations===
Assuming control cycle to be 400µs / 2500 Hz (default in GD drives):

<math>f=2500</math>

Calculation of how many counts the [[feedback devices|feedback device]] produces per one physical unit:

<math>X_{FeedbackDeviceCountsPerUnit}=4\frac{FBR}{AXS}</math>

AXS is a number that tells how many physical lenght units (such as millimeters a linear axis) translates per one rotary motor revolution.

===Example 1 - Calculating setpoint in position mode===
Here we convert physical units (such as millimeters) to setpoint value in position control mode:

<math>setpoint=\frac{MUL}{DIV}D_{DesiredPosition}X_{FeedbackDeviceCountsPerUnit}</math>

===Example 2 - Calculating value for CVL parameter===
Here we convert speed (such as mm/sec, or whatever lenght units AXS represents) to {{param|CVL}} value:

<math>P_{CVL}=\frac{V_{DesiredSpeedLimit}*X_{FeedbackDeviceCountsPerUnit}*P_{DIV}}{f}</math>

===Example 3 - Calculating value for CAL parameter===
Here we convert speed (such as mm/sec<sup>2</sup>, or whatever lenght units AXS represents) to {{param|CAL}} value:

<math>P_{CAL}=\frac{A_{DesiredAccelerationLimit}*X_{FeedbackDeviceCountsPerUnit}*P_{DIV}}{f^2}</math>

In alternative method we don't need acceleration value, but just time <math>t</math> in seconds to define how long motor should take to accelerate from zero speed to maximum speed defined by CAL:

<math>P_{CAL}=\frac{P_{CVL}}{tf}</math>

{{tip|Granity calculates real world units thus it can be used to calculate and experiment with the scales. As scales are linear, interpolation of values is viable choice.}}

==See also==
*[[Trajectory planner]]