Using FOC Software - Revision history

Johu: Added categories

2024-12-02T12:47:14Z

Added categories

← Older revision		Revision as of 12:47, 2 December 2024
Line 50:		Line 50:
	SPM motors (magnets mounted outside the rotor) need lqminusld set to 0.		SPM motors (magnets mounted outside the rotor) need lqminusld set to 0.
	[[Category:Tutorial]]		[[Category:Tutorial]]
			[[Category:OpenInverter]]

Johu: updated tuning instructions

2024-03-30T17:55:28Z

updated tuning instructions

Manny: fixed dead link to MLX91204, added the MLX90380 info

2024-01-26T18:31:21Z

fixed dead link to MLX91204, added the MLX90380 info

← Older revision		Revision as of 18:31, 26 January 2024
Line 8:		Line 8:
	Field oriented control is only implemented for permanent magnet motors. Moreover it is optimized for IPM motors (interior permanent magnet). So it will not drive BLDC motors in an efficient manner. It will yield no movement at all with induction motors.		Field oriented control is only implemented for permanent magnet motors. Moreover it is optimized for IPM motors (interior permanent magnet). So it will not drive BLDC motors in an efficient manner. It will yield no movement at all with induction motors.

	Since the absolute rotor position is a key factor with synchronous motors, said software requires an absolute position feedback device. This can be a resolver or a [https://www.melexis.com/-/media/files/documents/datasheets/~~mlx91204~~-datasheet-melexis.pdf ~~sin/cos chip~~] on top of a small magnet. Resolvers will need a so-called excitation. That is a high frequency (4.4kHz in our case) sine wave. Only V3 main boards generate this excitation signal. sin/cos chips do not need excitation and can also be run with V2 main boards.		Since the absolute rotor position is a key factor with synchronous motors, said software requires an absolute position feedback device. This can be a resolver or a sin/cos chip [https://www.mouser.com/datasheet/2/734/MLX91204-Datasheet-Melexis-961599.pdf MLX91204] or [https://media.melexis.com/-/media/files/documents/datasheets/mlx90380-datasheet-melexis.pdf MLX90380] on top of a small magnet. Resolvers will need a so-called excitation. That is a high frequency (4.4kHz in our case) sine wave. Only V3 main boards generate this excitation signal. sin/cos chips do not need excitation and can also be run with V2 main boards.

	Most of Damiens Toyota Designs implement V3 main board circuitry.		Most of Damiens Toyota Designs implement V3 main board circuitry.
Line 20:		Line 20:

	The rev3 mainboard requires sin and cos resolver/encoder inputs between 0 and 3.3V, centred around 1.65V. The Melexis MLX91204 encoder chip linked above unfortunately does not operate on 3.3V, and requires 5V, and it outputs 0.5-4.5V (centred around 2.5V). This is easy enough to 'fix' by using a simple resistor potential divider, but it can be difficult to arrive at a strong signal centred on 1.65V. The openinverter software will cope with a small offset, but to improve encoder performance, a new parameter 'sincosofs' has been introduced (committed on 23rd Feb, no new releases since then as yet). To set this, slowly turn the motor while measuring the voltage from the encoder (after your resistor divider). Note down min and max voltages (these should be between, but as close as possible, to 0V and 3.3V) and calculate the average (min voltage + max voltage, divide by two). This gives your signal midpoint. To convert to digits, divide this by 3.3, then multiply by 4096. Enter your result as sincosofs, and save parameters.		The rev3 mainboard requires sin and cos resolver/encoder inputs between 0 and 3.3V, centred around 1.65V. The Melexis MLX91204 encoder chip linked above unfortunately does not operate on 3.3V, and requires 5V, and it outputs 0.5-4.5V (centred around 2.5V). This is easy enough to 'fix' by using a simple resistor potential divider, but it can be difficult to arrive at a strong signal centred on 1.65V. The openinverter software will cope with a small offset, but to improve encoder performance, a new parameter 'sincosofs' has been introduced (committed on 23rd Feb, no new releases since then as yet). To set this, slowly turn the motor while measuring the voltage from the encoder (after your resistor divider). Note down min and max voltages (these should be between, but as close as possible, to 0V and 3.3V) and calculate the average (min voltage + max voltage, divide by two). This gives your signal midpoint. To convert to digits, divide this by 3.3, then multiply by 4096. Enter your result as sincosofs, and save parameters.

			With the MLX90380 running on 3.3V this offset won't be necessary.

	== Software setup ==		== Software setup ==

Eightdot at 13:07, 6 November 2023

2023-11-06T13:07:16Z

← Older revision		Revision as of 13:07, 6 November 2023
Line 3:		Line 3:
	Here is a video manual, created by Johannes Hubner and Damien Maguire, which describes process of setting up FOC-operated system from the very beginning: https://youtu.be/1SlL6cEoRBgv It is strongly recommended to watch it carefully. (also available with chapters: https://youtu.be/tirDQJ6iH28 ).		Here is a video manual, created by Johannes Hubner and Damien Maguire, which describes process of setting up FOC-operated system from the very beginning: https://youtu.be/1SlL6cEoRBgv It is strongly recommended to watch it carefully. (also available with chapters: https://youtu.be/tirDQJ6iH28 ).

	~~small note~~ about the table at time 40:00 : ~~I (Eightdot)~~ think that 2 of the 4 combinations will work (you will just find the wrong 'dip' first, see the part about adding 32768 below), the other 2 should also work by xoring pinswap with 2.		Note by eightdot and giplt, about the table at time 40:00 : We think that 2 of the 4 combinations will work (you will just find the wrong 'dip' first, see the part about adding 32768 below), the other 2 should also work by xoring pinswap with 2.

	== Hardware requirements ==		== Hardware requirements ==

Eightdot at 00:27, 6 November 2023

2023-11-06T00:27:01Z

← Older revision		Revision as of 00:27, 6 November 2023
Line 3:		Line 3:
	Here is a video manual, created by Johannes Hubner and Damien Maguire, which describes process of setting up FOC-operated system from the very beginning: https://youtu.be/1SlL6cEoRBgv It is strongly recommended to watch it carefully. (also available with chapters: https://youtu.be/tirDQJ6iH28 ).		Here is a video manual, created by Johannes Hubner and Damien Maguire, which describes process of setting up FOC-operated system from the very beginning: https://youtu.be/1SlL6cEoRBgv It is strongly recommended to watch it carefully. (also available with chapters: https://youtu.be/tirDQJ6iH28 ).

	small note about the table at time 40:00 : I (we) think that 2 of the 4 combinations will work (you will just find the wrong 'dip' first, see the part about adding 32768 below), the other 2 should also work by xoring pinswap with 2.		small note about the table at time 40:00 : I (Eightdot) think that 2 of the 4 combinations will work (you will just find the wrong 'dip' first, see the part about adding 32768 below), the other 2 should also work by xoring pinswap with 2.

	== Hardware requirements ==		== Hardware requirements ==

Eightdot at 16:55, 4 November 2023

2023-11-04T16:55:17Z

← Older revision		Revision as of 16:55, 4 November 2023
Line 1:		Line 1:
	Synchronous motors have turned out only to be well drivable when their stator current is controlled by means of a feedback current loop. Due to this, the existing feed forward control used for induction motors could not be extended for use with synchronous motors. Therefor the well known field oriented control approach was implemented in a separate software.		Synchronous motors have turned out only to be well drivable when their stator current is controlled by means of a feedback current loop. Due to this, the existing feed forward control used for induction motors could not be extended for use with synchronous motors. Therefor the well known field oriented control approach was implemented in a separate software.

	Here is a video manual, created by Johannes Hubner and Damien Maguire, which describes process of setting up FOC-operated system from the very beginning: https://youtu.be/1SlL6cEoRBgv It is strongly recommended to watch it carefully.		Here is a video manual, created by Johannes Hubner and Damien Maguire, which describes process of setting up FOC-operated system from the very beginning: https://youtu.be/1SlL6cEoRBgv It is strongly recommended to watch it carefully. (also available with chapters: https://youtu.be/tirDQJ6iH28 ).

			small note about the table at time 40:00 : I (we) think that 2 of the 4 combinations will work (you will just find the wrong 'dip' first, see the part about adding 32768 below), the other 2 should also work by xoring pinswap with 2.

	== Hardware requirements ==		== Hardware requirements ==

Eightdot: /* Software setup */

2023-11-04T16:13:16Z

Software setup

← Older revision		Revision as of 16:13, 4 November 2023
Line 28:		Line 28:
	It is important that the PWM channels line up with the current sensors. So current sensor "il1" must sense the phase generated by "PWM1", same for il2. You don't need to hardware-swap anything since we have parameter "pinswap". For example on some inverters current sensors are on phases 1 and 3. (next software revision) has the entry "PWMOutput23" in pinswap. That will essentially make PWM channel 3 responsible for phase 2 and PWM channel 2 becomes phase 3.		It is important that the PWM channels line up with the current sensors. So current sensor "il1" must sense the phase generated by "PWM1", same for il2. You don't need to hardware-swap anything since we have parameter "pinswap". For example on some inverters current sensors are on phases 1 and 3. (next software revision) has the entry "PWMOutput23" in pinswap. That will essentially make PWM channel 3 responsible for phase 2 and PWM channel 2 becomes phase 3.

	Next step is to find out your motors "syncofs". That is the offset between what the resolver reports as 0° and what actually is 0° alignment between the stator and the rotor magnetic field. To do this, a test mode has been implemented. First start your inverter with the "start" input, then switch to manual mode with the corresponding button on the web interface. '''Warning''': manual mode does not implement any rotor speed limit! When used carelessly you might overspeed your motor to the point were it looses structural integrity - it explodes. So have means to brake your motor externally e.g. by doing this tuning with an already mounted motor and jacked up wheels. Then you can use your cars friction brakes. ''If the motor doesn't spin at all during the process but you hear the PWM whine and il1 and il2 show current flowing, try swapping 2 of the motor phases over.''		Next step is to find out your motors "syncofs". That is the offset between what the resolver reports as 0° and what actually is 0° alignment between the stator and the rotor magnetic field. To do this, a test mode has been implemented. First start your inverter with the "start" input, then switch to manual mode with the corresponding button on the web interface. '''Warning''': manual mode does not implement any rotor speed limit! When used carelessly you might overspeed your motor to the point were it looses structural integrity - it explodes. So have means to brake your motor externally e.g. by doing this tuning with an already mounted motor and jacked up wheels. Then you can use your cars friction brakes. ''If the motor doesn't spin at all during the process but you hear the PWM whine and il1 and il2 show current flowing, try swapping 2 of the motor phases over. or swap the resolver inputs (xor pinswap with 2)''

	Tuning Process:		Tuning Process:

Marcexec at 10:55, 14 June 2023

2023-06-14T10:55:34Z

← Older revision		Revision as of 10:55, 14 June 2023
Line 45:		Line 45:

	SPM motors (magnets mounted outside the rotor) need lqminusld set to 0.		SPM motors (magnets mounted outside the rotor) need lqminusld set to 0.
			[[Category:Tutorial]]

Janosch: /* Software setup */

2023-05-28T09:15:32Z

Software setup

← Older revision		Revision as of 09:15, 28 May 2023
Line 20:		Line 20:

	== Software setup ==		== Software setup ==
	First of all you need to flash your board with preferable the [https://github.com/jsphuebner/stm32-sine/releases/latest latest] FOC version (stm32_foc.bin or hex). It will identify itself with the version value of "X.YY.R-foc". '''Version 4.97.R is the last one that supports switching from Run mode to Manual Run mode! Silly Johannes keeps forgetting to fix this. So temporarily switch to 4.97.R.'''		First of all you need to flash your board with preferable the [https://github.com/jsphuebner/stm32-sine/releases/latest latest] FOC version (stm32_foc.bin or hex). It will identify itself with the version value of "X.YY.R-foc". '''Version [https://github.com/jsphuebner/stm32-sine/releases/tag/v4.97.R 4.97.R] is the last one that supports switching from Run mode to Manual Run mode! Silly Johannes keeps forgetting to fix this. So temporarily switch to 4.97.R.'''

	If not using a pretuned kit (like Leaf dropin board) do the [[Schematics and Instructions#Connecting the sensor boards\|usual current and voltage calibration]]. Be aware that polarity is important. So if current flows '''from''' the IGBT '''to''' the motor the reading must be positive. Therefor it is possible to set negative gain. When setting negative gain ocurlim must be negative also.		If not using a pretuned kit (like Leaf dropin board) do the [[Schematics and Instructions#Connecting the sensor boards\|usual current and voltage calibration]]. Be aware that polarity is important. So if current flows '''from''' the IGBT '''to''' the motor the reading must be positive. Therefor it is possible to set negative gain. When setting negative gain ocurlim must be negative also.

Johu at 10:01, 11 September 2022

2022-09-11T10:01:03Z

← Older revision		Revision as of 10:01, 11 September 2022
Line 38:		Line 38:
	# If motor spins, change syncofs in 1000 digit increments until it stops spinning. If you need to go below 0, like -1000 enter 64536 (=65536-1000)		# If motor spins, change syncofs in 1000 digit increments until it stops spinning. If you need to go below 0, like -1000 enter 64536 (=65536-1000)
	# If manualid is less than about max_motor_current/2 go back to 4. When approaching rated_motor_current/2 make your increments/decrements smaller, like down to 300 digits		# If manualid is less than about max_motor_current/2 go back to 4. When approaching rated_motor_current/2 make your increments/decrements smaller, like down to 300 digits
	# You have found 1 of 2 possible offsets. Now you can enter a small value for "manualiq" and set "manualid" to 0.1~~. The~~ motor should spin ~~clockwise.~~		# You have found 1 of 2 possible offsets. Now you can enter a small value for "manualiq" and set "manualid" to 0.1, the motor should spin smooth in both directions
	# If ~~its spins counter-clockwise~~, add 32768 to syncofs. If the resulting value is > 65535, subtract 32768 instead (or do modulo addition in the first place)		# If it behaves differently in forward and reverse, add 32768 to syncofs. If the resulting value is > 65535, subtract 32768 instead (or do modulo addition in the first place)
	Congratulations, the most difficult step is done. The default values or curkp and curki can usually stay untouched, I don't know a good tuning procedure anyway. ~~Higher curki means faster reaction but also tends to oscillate at low speed~~. Next set up the "throtcur" parameter. It defines how many motor amps are produced per % of throttle travel.		Congratulations, the most difficult step is done. The default values or curkp and curki can usually stay untouched, I don't know a good tuning procedure anyway. It are dependent on the motor inductance and higher values can yield higher stability. Next set up the "throtcur" parameter. It defines how many motor amps are produced per % of throttle travel.

	Internally, this is split into a so-called direct and a quadrature current by means of the "Most Torque Per Amp" algorithm (MTPA). MTPA usually needs setup for the motor that your working with. ~~Right now some typical constants are hard coded in~~ the ~~software. This might be replaced by auto-tuning in~~ the ~~future~~. ~~But the deviation from optimal should not be too large~~ with ~~most IPM~~ motors ~~out there~~.		Internally, this is split into a so-called direct and a quadrature current by means of the "Most Torque Per Amp" algorithm (MTPA). MTPA usually needs setup for the motor that your working with. You can customize the two parameters lqminusld and fluxlinkage, ideally with the real values of your motor. Otherwise keep fluxlinkage at its default, start with lqminusld=1 and slowly raise it until you get best acceleration.

			SPM motors (magnets mounted outside the rotor) need lqminusld set to 0.

← Older revision		Revision as of 17:55, 30 March 2024
Line 24:		Line 24:

	== Software setup ==		== Software setup ==
	First of all you need to flash your board with preferable the [https://github.com/jsphuebner/stm32-sine/releases/latest latest] FOC version (stm32_foc.bin or hex). It will identify itself with the version value of "X.YY.R-foc". '''Version [https://github.com/jsphuebner/stm32-sine/releases/tag/v4.97.R 4.97.R] is the last one that supports switching from Run mode to Manual Run mode! Silly Johannes keeps forgetting to fix this. So temporarily switch to 4.97.R.'''		First of all you need to flash your board with preferable the [https://github.com/jsphuebner/stm32-sine/releases/latest latest] FOC version (stm32_foc.bin or hex). It will identify itself with the version value of "X.YY.R-foc".

	If not using a pretuned kit (like Leaf dropin board) do the [[Schematics and Instructions#Connecting the sensor boards\|usual current and voltage calibration]]. Be aware that polarity is important. So if current flows '''from''' the IGBT '''to''' the motor the reading must be positive. Therefor it is possible to set negative gain. When setting negative gain ocurlim must be negative also.		If not using a pretuned kit (like Leaf dropin board) do the [[Schematics and Instructions#Connecting the sensor boards\|usual current and voltage calibration]]. Be aware that polarity is important. So if current flows '''from''' the IGBT '''to''' the motor the reading must be positive. Therefor it is possible to set negative gain. When setting negative gain ocurlim must be negative also.
Line 35:		Line 35:

	Tuning Process:		Tuning Process:
	# ~~Go into manual mode~~ -> start input~~, then button~~ on web interface. Select forward direction.		# Start inverter -> start input or "manualrun" on web interface. Select forward direction.
	# Observe value "angle" and turn rotor by hand -> you should see angle changes between 0 to 360°. If not, check resolver connection and excitation signal.		# Observe value "angle" and turn rotor by hand -> you should see angle changes between 0 to 360°. If not, check resolver connection and excitation signal.
	# Start with syncofs=0		# Start with syncofs=0
	# enter a positive value for "manualid". Start low, with respect to motor rating. E.g. 5% of rated current		# enter a positive value for "manualid". Start low, with respect to motor rating. E.g. 5% of rated current
	# Keep increasing the value until you notice that the motor starts to spin - make sure you hear PWM going		# Keep increasing the value until you notice that the motor starts to spin - make sure you hear PWM going
	# If motor spins, change syncofs in 1000 digit increments until it stops spinning. If you need to go below 0, like -1000 enter 64536 (=65536-1000)		# If motor spins, change syncofs in 1000 digit increments until it '''stops''' spinning. If you need to go below 0, like -1000 enter 64536 (=65536-1000)
	# If manualid is less than about max_motor_current/2 go back to 4. When approaching rated_motor_current/2 make your increments/decrements smaller, like down to 300 digits		# If manualid is less than about max_motor_current/2 go back to 4. When approaching rated_motor_current/2 make your increments/decrements smaller, like down to 300 digits
	# You have found 1 of 2 possible offsets. Now you can enter a small value for "manualiq" and set "manualid" to 0.1, the motor should spin smooth in both directions		# You have found 1 of 2 possible offsets. Now you can enter a small value for "manualiq" and set "manualid" to 0.1, the motor should spin smooth in both directions