Component: Grove I2C Motor Driver (Mechatronics) - Revision history

SteveT: Text replacement - "style="background-color:#EAE1EA;"" to "class="mtx-class-propfolder""

2026-07-13T14:36:44Z

Text replacement - "style="background-color:#EAE1EA;"" to "class="mtx-class-propfolder""

← Older revision		Revision as of 14:36, 13 July 2026
Line 108:		Line 108:
	\|-		\|-
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#EAE1EA;~~" \| [[File:Fc9-conn-icon.png]]		\| width="10%" align="center" class="mtx-class-propfolder" \| [[File:Fc9-conn-icon.png]]
	\| width="90%" class="mtx-class-propfolder" \| Communications		\| width="90%" class="mtx-class-propfolder" \| Communications
	\|-		\|-
Line 152:		Line 152:
	\| colspan="2" \|		\| colspan="2" \|
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#EAE1EA;~~" \| [[File:Fc9-conn-icon.png]]		\| width="10%" align="center" class="mtx-class-propfolder" \| [[File:Fc9-conn-icon.png]]
	\| width="90%" class="mtx-class-propfolder" \| Simulation		\| width="90%" class="mtx-class-propfolder" \| Simulation
	\|-		\|-

SteveT: Text replacement - "style="background-color:#EAE1EA; color:#4B008D;"" to "class="mtx-class-propfolder""

2026-07-13T14:35:56Z

Text replacement - "style="background-color:#EAE1EA; color:#4B008D;"" to "class="mtx-class-propfolder""

← Older revision		Revision as of 14:35, 13 July 2026
Line 109:		Line 109:
	\|-		\|-
	\| width="10%" align="center" style="background-color:#EAE1EA;" \| [[File:Fc9-conn-icon.png]]		\| width="10%" align="center" style="background-color:#EAE1EA;" \| [[File:Fc9-conn-icon.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#EAE1EA; color:#4B008D;~~" \| Communications		\| width="90%" class="mtx-class-propfolder" \| Communications
	\|-		\|-
	\|-		\|-
Line 153:		Line 153:
	\|-		\|-
	\| width="10%" align="center" style="background-color:#EAE1EA;" \| [[File:Fc9-conn-icon.png]]		\| width="10%" align="center" style="background-color:#EAE1EA;" \| [[File:Fc9-conn-icon.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#EAE1EA; color:#4B008D;~~" \| Simulation		\| width="90%" class="mtx-class-propfolder" \| Simulation
	\|-		\|-
	\|-		\|-

SteveT: Text replacement - "width="90%" style="background-color:#D8C9D8; color:#4B008D;"" to "width="90%" class="mtx-class-macrohead""

2026-07-13T14:23:10Z

Text replacement - "width="90%" style="background-color:#D8C9D8; color:#4B008D;"" to "width="90%" class="mtx-class-macrohead""

← Older revision		Revision as of 14:23, 13 July 2026
Line 28:		Line 28:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#D8C9D8; color:#4B008D;~~" \| '''Frequency'''		\| width="90%" class="mtx-class-macrohead" \| '''Frequency'''
	\|-		\|-
	\| colspan="2" \| Set the frequency of PWM (cycle length = 510, system clock = 16MHz)		\| colspan="2" \| Set the frequency of PWM (cycle length = 510, system clock = 16MHz)
Line 47:		Line 47:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#D8C9D8; color:#4B008D;~~" \| '''Initialise'''		\| width="90%" class="mtx-class-macrohead" \| '''Initialise'''
	\|-		\|-
	\| colspan="2" \| Sets up the I2C ready for communications		\| colspan="2" \| Sets up the I2C ready for communications
Line 61:		Line 61:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#D8C9D8; color:#4B008D;~~" \| '''Speed'''		\| width="90%" class="mtx-class-macrohead" \| '''Speed'''
	\|-		\|-
	\| colspan="2" \| Sets the speed of a motor.		\| colspan="2" \| Sets the speed of a motor.
Line 85:		Line 85:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#D8C9D8; color:#4B008D;~~" \| '''Stop'''		\| width="90%" class="mtx-class-macrohead" \| '''Stop'''
	\|-		\|-
	\| colspan="2" \| Stop one motor		\| colspan="2" \| Stop one motor
Line 105:		Line 105:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-prop-icon.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-prop-icon.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#D8C9D8; color:#4B008D;~~" \| '''Properties'''		\| width="90%" class="mtx-class-macrohead" \| '''Properties'''
	\|-		\|-
	\|-		\|-

SteveT: Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;"" to "width="10%" align="center" class="mtx-class-macrohead""

2026-07-13T14:20:58Z

Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;"" to "width="10%" align="center" class="mtx-class-macrohead""

← Older revision		Revision as of 14:20, 13 July 2026
Line 104:		Line 104:
	{\| class="mtx-class-macrotable wikitable"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#D8C9D8;~~" \| [[File:Fc9-prop-icon.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-prop-icon.png]]
	\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Properties'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Properties'''
	\|-		\|-

SteveT: Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;" align="center"" to "width="10%" align="center" class="mtx-class-macrohead""

2026-07-13T14:17:08Z

Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;" align="center"" to "width="10%" align="center" class="mtx-class-macrohead""

← Older revision		Revision as of 14:17, 13 July 2026
Line 27:		Line 27:
	{\| class="mtx-class-macrotable wikitable"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#D8C9D8;" align="center~~" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]
	\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Frequency'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Frequency'''
	\|-		\|-
Line 46:		Line 46:
	{\| class="mtx-class-macrotable wikitable"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#D8C9D8;" align="center~~" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]
	\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Initialise'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Initialise'''
	\|-		\|-
Line 60:		Line 60:
	{\| class="mtx-class-macrotable wikitable"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#D8C9D8;" align="center~~" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]
	\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Speed'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Speed'''
	\|-		\|-
Line 84:		Line 84:
	{\| class="mtx-class-macrotable wikitable"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#D8C9D8;" align="center~~" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-comp-macro.png]]
	\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Stop'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Stop'''
	\|-		\|-

SteveT: Text replacement - "class="wikitable" style="width:60%; background-color:#FFFFFF;"" to "class="mtx-class-macrotable wikitable""

2026-07-13T14:15:12Z

Text replacement - "class="wikitable" style="width:60%; background-color:#FFFFFF;"" to "class="mtx-class-macrotable wikitable""

← Older revision		Revision as of 14:15, 13 July 2026
Line 25:		Line 25:

	===Frequency===		===Frequency===
	{\| class="wikitable~~" style="width:60%; background-color:#FFFFFF;~~"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]
Line 44:		Line 44:

	===Initialise===		===Initialise===
	{\| class="wikitable~~" style="width:60%; background-color:#FFFFFF;~~"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]
Line 58:		Line 58:

	===Speed===		===Speed===
	{\| class="wikitable~~" style="width:60%; background-color:#FFFFFF;~~"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]
Line 82:		Line 82:

	===Stop===		===Stop===
	{\| class="wikitable~~" style="width:60%; background-color:#FFFFFF;~~"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]
Line 102:		Line 102:
	==Property reference==		==Property reference==

	{\| class="wikitable~~" style="width:60%; background-color:#FFFFFF;~~"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" style="background-color:#D8C9D8;" \| [[File:Fc9-prop-icon.png]]		\| width="10%" align="center" style="background-color:#D8C9D8;" \| [[File:Fc9-prop-icon.png]]

BenR at 11:29, 20 October 2023

2023-10-20T11:29:03Z

← Older revision		Revision as of 11:29, 20 October 2023
Line 20:		Line 20:

	Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_Grove_I2C_Motor_Driver.fcfx FC_Comp_Source_Grove_I2C_Motor_Driver.fcfx]		Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_Grove_I2C_Motor_Driver.fcfx FC_Comp_Source_Grove_I2C_Motor_Driver.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.~~

	~~[[Image:EncoderCircuit.jpg]]~~

	~~==Examples==~~

	~~===Polling===~~

	~~Example program showing how to use a quadrature encoder component using a polling method.~~
	~~{{Fcfile\|Quad_Encoder_Test_2d.fcfx\|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.~~
	~~{{Fcfile\|Quad_Encoder_Timer_2d.fcfx\|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).~~
	~~{{Fcfile\|Quad_Encoder_IOC_2d.fcfx\|Quad_Encoder_IOC}}~~

Wiki bot: Created page with "{| style="width:50%" |- | width="20%" style="color:gray;" | Author | Matrix TSL |- | width="20%" style="color:gray;" | Version | 1.0 |- | width="20%" style="color:gray..."

2023-10-20T11:19:41Z

Created page with "{| style="width:50%" |- | width="20%" style="color:gray;" | Author | Matrix TSL |- | width="20%" style="color:gray;" | Version | 1.0 |- | width="20%" style="color:gray..."

New page

{| style="width:50%"
|-
| width="20%" style="color:gray;" | Author
| Matrix TSL
|-
| width="20%" style="color:gray;" | Version
| 1.0
|-
| width="20%" style="color:gray;" | Category
| Mechatronics
|}

==Grove I2C Motor Driver component==
A grove board based around the L298P motor driver IC allowing control of two DC motors or a single stepper motor.

==Component Source Code==

Please click here to download the component source project: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_Grove_I2C_Motor_Driver.fcfx FC_Comp_Source_Grove_I2C_Motor_Driver.fcfx]

Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_Grove_I2C_Motor_Driver.fcfx FC_Comp_Source_Grove_I2C_Motor_Driver.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.

[[Image:EncoderCircuit.jpg]]

==Examples==

===Polling===

Example program showing how to use a quadrature encoder component using a polling method.
{{Fcfile|Quad_Encoder_Test_2d.fcfx|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.
{{Fcfile|Quad_Encoder_Timer_2d.fcfx|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).
{{Fcfile|Quad_Encoder_IOC_2d.fcfx|Quad_Encoder_IOC}}

==Macro reference==

===Frequency===
{| 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;" | '''Frequency'''
|-
| colspan="2" | Set the frequency of PWM (cycle length = 510, system clock = 16MHz) 
|-
|-
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
| width="90%" | FrequencySelection
|-
| colspan="2" | 1=31.372 KHz, 2=3.921 KHz, 3=490 Hz, 4=122 Hz, 5=30 Hz 
|-
| 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''
|}

===Initialise===
{| 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;" | '''Initialise'''
|-
| colspan="2" | Sets up the I2C ready for communications 
|-
|-
| 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''
|}

===Speed===
{| 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;" | '''Speed'''
|-
| colspan="2" | Sets the speed of a motor. 
|-
|-
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
| width="90%" | Motor
|-
| colspan="2" | 1=Motor1 / 2=Motor2 
|-
| width="10%" align="center" | [[File:Fc9-s16-icon.png]] - INT
| width="90%" | Speed
|-
| colspan="2" | Range: -255 to 255 where -255 = Full Backwards, 0=Stop, 255=Full Forwards 
|-
| 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''
|}

===Stop===
{| 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;" | '''Stop'''
|-
| colspan="2" | Stop one motor 
|-
|-
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
| width="90%" | Motor
|-
| colspan="2" | 1 = Motor1 / 2 = Motor2 
|-
| 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''
|}

==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;" | Communications
|-
|-
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
| width="90%" | I2C Address
|-
| colspan="2" |  
|-
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
| width="90%" | Channel
|-
| colspan="2" | Channel selection 
|-
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
| width="90%" | SDA
|-
| colspan="2" | Pin used for SDA (data signal) 
|-
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
| width="90%" | SCL
|-
| colspan="2" | Pin used for SCL (clock signal) 
|-
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
| width="90%" | Stop Delay
|-
| colspan="2" | On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not a 10ms delay between an I2C stop event and the next I2C start event. Most modern microcontrollers will not have a problem so this property can be disabled to speed up the I2C communications.  
|-
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
| width="90%" | Baud Select
|-
| colspan="2" | Baud rate option selector 
|-
| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
| width="90%" | Baud Rate
|-
| colspan="2" | Baud rate to be used 
|-
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
| width="90%" | Default Frequency
|-
| colspan="2" |  
|-
| 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-7-icon.png]]
| width="90%" | Scope Traces
|-
| colspan="2" | Selects if the component pin connections are automatically generated on the data recorder window or not. Yes: Automatically add the component pins to a group on the data recorder which will reflect the sim data during simultion. No: Do not show the pin signals on the data recorder window. 
|-
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
| width="90%" | Console Data
|-
| colspan="2" | Selects if the console data is automatically generated or not 
|-
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
| width="90%" | API
|-
| colspan="2" | Specifies the API component on the panel to interact with to provide comms simulation. 
|}