Difference between revisions of "Component: Quadrature Encoder (General Input)"
Line 16: | Line 16: | ||
==Component Source Code== | ==Component Source Code== | ||
+ | |||
+ | Please click here to download the component source project: [https://www.flowcode.co.uk/wikicopy/componentsource/FC_Comp_Source_Encoder_Quadrature.fcfx FC_Comp_Source_Encoder_Quadrature.fcfx] | ||
Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_Encoder_Quadrature.fcfx FC_Comp_Source_Encoder_Quadrature.fcfx] | Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_Encoder_Quadrature.fcfx FC_Comp_Source_Encoder_Quadrature.fcfx] | ||
==Detailed description== | ==Detailed description== | ||
+ | |||
+ | |||
Line 34: | Line 38: | ||
==Examples== | ==Examples== | ||
+ | |||
+ | |||
Line 70: | Line 76: | ||
==Macro reference== | ==Macro reference== | ||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''CheckForChanges''' | ||
+ | |- | ||
+ | | colspan="2" | Polling function to check changes Returns 1 for chaged, 0 for no change, 255 for error | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Disable''' | ||
+ | |- | ||
+ | | colspan="2" | Disables the use of the quad encoder Once this ist called, the read functions will return zeros until the next Enable() call | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteCounter32''' | ||
+ | |- | ||
+ | | colspan="2" | Sets the value of the internal count variable. Range: -2147483648 to 2147483647 | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-s32-icon.png]] - LONG | ||
+ | | width="90%" | Value | ||
+ | |- | ||
+ | | colspan="2" | Range: -2147483648 to 2147483647 | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Enable''' | ||
+ | |- | ||
+ | | colspan="2" | Enables the use of the quad encoder If this is not called, the read functions will return zeros | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Rotate''' | ||
+ | |- | ||
+ | | colspan="2" | Simulation Rotate function to allow accurate rotation during simulation. Automatically called by any attached coupling or gearbox component. | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-f32-icon.png]] - FLOAT | ||
+ | | width="90%" | Angle | ||
+ | |- | ||
+ | | colspan="2" | Amount to rotate the shaft input in degrees | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadCounter''' | ||
+ | |- | ||
+ | | colspan="2" | Reads the current dial counter This is a counter from -32768 to 32767 | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-s16-icon.png]] - INT | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteCounter''' | ||
+ | |- | ||
+ | | colspan="2" | Sets the value of the internal count variable. Range: -32768 to 32767 | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-s16-icon.png]] - INT | ||
+ | | width="90%" | Value | ||
+ | |- | ||
+ | | colspan="2" | Range: -32768 to 32767 | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ResetCounter''' | ||
+ | |- | ||
+ | | colspan="2" | Resets the current dial counter to zero | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadCounter32''' | ||
+ | |- | ||
+ | | colspan="2" | Reads the current dial counter as a 32-bit value This is a counter from -2147483648 to 2147483647 | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-s32-icon.png]] - LONG | ||
+ | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==Property reference== | ||
+ | |||
+ | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]] | ||
+ | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties''' | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
+ | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Count Variable | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
+ | | width="90%" | Variable Type | ||
+ | |- | ||
+ | | colspan="2" | Selects the size of the encoder count variable depending on the number of encoder counts required to be stored. The 16 bit variable counter is accessed via the ReadCounter and WriteCounter functions. The 32 bit variable counter is accessed via the ReadCounter32 and WriteCounter32 functions. | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
+ | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Encoder Resolution | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
+ | | width="90%" | Post Scaler | ||
+ | |- | ||
+ | | colspan="2" | Encoders with a mechanical click will often have 4 transitions per click. 1:1 would provide the maximum output resolution. 1:4 would provide the encoder click count. | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-21-icon.png]] | ||
+ | | width="90%" | Edges Per Revolution | ||
+ | |- | ||
+ | | colspan="2" | Number of signal transitions per revolution. E.g. for a 360 degree encoder you would likely get 360 x 4 = 1440 transitions and an accuracy of 0.25 degrees. | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-15-icon.png]] | ||
+ | | width="90%" | Resolution | ||
+ | |- | ||
+ | | colspan="2" | The resolution of the encoder in degrees | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
+ | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-5-icon.png]] | ||
+ | | width="90%" | A | ||
+ | |- | ||
+ | | colspan="2" | Input pin A | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-5-icon.png]] | ||
+ | | width="90%" | B | ||
+ | |- | ||
+ | | colspan="2" | Input Pin B | ||
+ | |- | ||
+ | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
+ | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation | ||
+ | |- | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
+ | | width="90%" | Repeat Rate | ||
+ | |- | ||
+ | | colspan="2" | Simulated repeat rate when clicking and rotating the encoder | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-15-icon.png]] | ||
+ | | width="90%" | Rotation Increment | ||
+ | |- | ||
+ | | colspan="2" | Number of degrees to rotate when performing a single quadrature pin transition. | ||
+ | |- | ||
+ | | width="10%" align="center" | [[File:Fc9-type-7-icon.png]] | ||
+ | | width="90%" | Scope Traces | ||
+ | |- | ||
+ | | colspan="2" | | ||
+ | |}==Macro reference== | ||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" |
Revision as of 15:21, 20 January 2023
Author | Matrix TSL |
Version | 1.5 |
Category | General Input |
Contents
Quadrature Encoder component
Quadrature Encoder component implements a rotary encoder connected to two pins. Quadrature Encoders provides incremental positioning rather than absolute positioning.
Component Source Code
Please click here to download the component source project: FC_Comp_Source_Encoder_Quadrature.fcfx
Please click here to view the component source code (Beta): FC_Comp_Source_Encoder_Quadrature.fcfx
Detailed description
Mechanical encoders can be a bit electrically noisy when switching and so to have reliable operation it is recommended to have a simple filter as shown here.
Examples
Polling
Example program showing how to use a quadrature encoder component using a polling method.
Quad_Encoder_Test
Timer Interrupt Based Polling
Example program showing how to use a quadrature encoder component using a polling method via a timer interrupt.
Quad_Encoder_Timer
Interrupt On Change
Example program showing how to use a quadrature encoder component using a interrupt on pin state change interrupt (IOC).
Quad_Encoder_IOC
Macro reference
![]() |
CheckForChanges |
Polling function to check changes Returns 1 for chaged, 0 for no change, 255 for error | |
![]() |
Return |
![]() |
Disable |
Disables the use of the quad encoder Once this ist called, the read functions will return zeros until the next Enable() call | |
![]() |
Return |
![]() |
WriteCounter32 |
Sets the value of the internal count variable. Range: -2147483648 to 2147483647 | |
![]() |
Value |
Range: -2147483648 to 2147483647 | |
![]() |
Return |
![]() |
Enable |
Enables the use of the quad encoder If this is not called, the read functions will return zeros | |
![]() |
Return |
![]() |
ReadCounter |
Reads the current dial counter This is a counter from -32768 to 32767 | |
![]() |
Return |
![]() |
WriteCounter |
Sets the value of the internal count variable. Range: -32768 to 32767 | |
![]() |
Value |
Range: -32768 to 32767 | |
![]() |
Return |
![]() |
ResetCounter |
Resets the current dial counter to zero | |
![]() |
Return |
![]() |
ReadCounter32 |
Reads the current dial counter as a 32-bit value This is a counter from -2147483648 to 2147483647 | |
![]() |
Return |
Property reference
==Macro reference==
![]() |
CheckForChanges |
Polling function to check changes Returns 1 for chaged, 0 for no change, 255 for error | |
![]() |
Return |
![]() |
Disable |
Disables the use of the quad encoder Once this ist called, the read functions will return zeros until the next Enable() call | |
![]() |
Return |
![]() |
WriteCounter32 |
Sets the value of the internal count variable. Range: -2147483648 to 2147483647 | |
![]() |
Value |
Range: -2147483648 to 2147483647 | |
![]() |
Return |
![]() |
Enable |
Enables the use of the quad encoder If this is not called, the read functions will return zeros | |
![]() |
Return |
![]() |
ReadCounter |
Reads the current dial counter This is a counter from -32768 to 32767 | |
![]() |
Return |
![]() |
WriteCounter |
Sets the value of the internal count variable. Range: -32768 to 32767 | |
![]() |
Value |
Range: -32768 to 32767 | |
![]() |
Return |
![]() |
ResetCounter |
Resets the current dial counter to zero | |
![]() |
Return |
![]() |
ReadCounter32 |
Reads the current dial counter as a 32-bit value This is a counter from -2147483648 to 2147483647 | |
![]() |
Return |
Property reference
==Macro reference==
![]() |
CheckForChanges |
Polling function to check changes Returns 1 for chaged, 0 for no change, 255 for error | |
![]() |
Return |
![]() |
Disable |
Disables the use of the quad encoder Once this ist called, the read functions will return zeros until the next Enable() call | |
![]() |
Return |
![]() |
WriteCounter32 |
Sets the value of the internal count variable. Range: -2147483648 to 2147483647 | |
![]() |
Value |
Range: -2147483648 to 2147483647 | |
![]() |
Return |
![]() |
Enable |
Enables the use of the quad encoder If this is not called, the read functions will return zeros | |
![]() |
Return |
![]() |
ReadCounter |
Reads the current dial counter This is a counter from -32768 to 32767 | |
![]() |
Return |
![]() |
WriteCounter |
Sets the value of the internal count variable. Range: -32768 to 32767 | |
![]() |
Value |
Range: -32768 to 32767 | |
![]() |
Return |
![]() |
ResetCounter |
Resets the current dial counter to zero | |
![]() |
Return |
![]() |
ReadCounter32 |
Reads the current dial counter as a 32-bit value This is a counter from -2147483648 to 2147483647 | |
![]() |
Return |