BLDCMotor API Guide - Revision history

Lmpacent: /* Rescale Factor */

2025-06-23T22:30:36Z

Rescale Factor

← Older revision		Revision as of 22:30, 23 June 2025
Line 58:		Line 58:

	===Rescale Factor===		===Rescale Factor===
			<center>{{#ev:youtube\|SbO3hAuYsAE\|rel=0}}</center>

	The Rescale Factor allows you to change the units of the following properties:		The Rescale Factor allows you to change the units of the following properties:
	* [[#Position\|Position]]		* [[#Position\|Position]]

Lmpacent: /* Rescale Factor */

2025-02-21T20:31:14Z

Rescale Factor

← Older revision		Revision as of 20:31, 21 February 2025
Line 59:		Line 59:
	===Rescale Factor===		===Rescale Factor===
	The Rescale Factor allows you to change the units of the following properties:		The Rescale Factor allows you to change the units of the following properties:
	* Position		* [[#Position\|Position]]

	By default, the units will be in commutations which is dictated by the number of poles/phases your motor and are often non-intuitive. We recommend utilizing the Rescale Factor so your software is easier to understand.		By default, the units will be in commutations which is dictated by the number of poles/phases your motor and are often non-intuitive. We recommend utilizing the Rescale Factor so your software is easier to understand.

Lmpacent: /* Converting to Degrees */

2025-02-19T21:01:08Z

Converting to Degrees

← Older revision		Revision as of 21:01, 19 February 2025
Line 76:		Line 76:
	* Motor phases: 3		* Motor phases: 3

	Rescale Factor = 360 / (10<nowiki></nowiki>2<nowiki></nowiki>3) = '''6'''		Rescale Factor = 360 / (10<nowiki></nowiki>2<nowiki></nowiki>3) = '''6.0'''

	=====Converting to Rotations=====		=====Converting to Rotations=====

Lmpacent: /* Converting to Rotations */

2025-02-19T21:00:57Z

Converting to Rotations

← Older revision		Revision as of 21:00, 19 February 2025
Line 83:		Line 83:
	* Motor poles: 2		* Motor poles: 2
	* Motor phases: 3		* Motor phases: 3
	* Preferred Units: Rotations

	Rescale Factor = 1 / (10<nowiki></nowiki>2<nowiki></nowiki>3) = '''0.016666667'''		Rescale Factor = 1 / (10<nowiki></nowiki>2<nowiki></nowiki>3) = '''0.016666667'''

Lmpacent: /* Converting to Degrees */

2025-02-19T21:00:50Z

Converting to Degrees

← Older revision		Revision as of 21:00, 19 February 2025
Line 75:		Line 75:
	* Motor poles: 2		* Motor poles: 2
	* Motor phases: 3		* Motor phases: 3
	* Preferred Units: Degrees

	Rescale Factor = 360 / (10<nowiki></nowiki>2<nowiki></nowiki>3) = '''6'''		Rescale Factor = 360 / (10<nowiki></nowiki>2<nowiki></nowiki>3) = '''6'''

Mparadis at 19:38, 18 November 2024

2024-11-18T19:38:23Z

← Older revision		Revision as of 19:38, 18 November 2024
Line 4:		Line 4:
	<div class="toclimit-4">		<div class="toclimit-4">
	=Introduction=		=Introduction=
	[[Image:DCC1120_0.png\|thumb\|link=https://~~wwwdev.int~~.phidgets.com/docs/images/3/38/DCC1120_0.png\|<center>30V 50A Brushless DC Motor Phidget (DCC1120_0)</center>]]		[[Image:DCC1120_0.png\|thumb\|link=https://cdn.phidgets.com/docs/images/3/38/DCC1120_0.png\|<center>30V 50A Brushless DC Motor Phidget (DCC1120_0)</center>]]
	This guide will provide information about the Brushless DC Motor (BLDC) API to get you up and running with your new BLDC Motor Phidget.		This guide will provide information about the Brushless DC Motor (BLDC) API to get you up and running with your new BLDC Motor Phidget.

Line 16:		Line 16:
	\|-\|		\|-\|
	DCC1120=		DCC1120=
	[[Image:DCC1120_0.png\|link=https://~~wwwdev.int~~.phidgets.com/docs/images/7/7d/~~DCC1002_0~~.~~jpg~~\|thumb\|200px\|[~~https://wwwdev.int.phidgets.com~~/?prodid=1334 30V 50A Brushless DC Motor Phidget (DCC1120_0)]]]		[[Image:DCC1120_0.png\|link=https://cdn.phidgets.com/docs/images/3/38/DCC1120_0.png\|thumb\|200px\|[{{SERVER}}/?prodid=1334 30V 50A Brushless DC Motor Phidget (DCC1120_0)]]]
	The [~~https://wwwdev.int.phidgets.com~~/?prodid=1334 30V 50A Brushless DC Motor Phidget (DCC1120_0)] is fully compatible with this guide.		The [{{SERVER}}/?prodid=1334 30V 50A Brushless DC Motor Phidget (DCC1120_0)] is fully compatible with this guide.
	\|-\|		\|-\|
	DCC1100=		DCC1100=
	[[Image:DCC1100_0.jpg\|link=https://~~wwwdev.int~~.phidgets.com/docs/images/8/87/DCC1100_0.jpg\|thumb\|200px\|[https://www.phidgets.com/?prodid=1013 Brushless DC Motor Phidget (DCC1100_0)]]]		[[Image:DCC1100_0.jpg\|link=https://cdn.phidgets.com/docs/images/8/87/DCC1100_0.jpg\|thumb\|200px\|[https://www.phidgets.com/?prodid=1013 Brushless DC Motor Phidget (DCC1100_0)]]]
	[https://www.phidgets.com/?prodid=1013 Brushless DC Motor Phidget (DCC1100_0)] considerations:		[https://www.phidgets.com/?prodid=1013 Brushless DC Motor Phidget (DCC1100_0)] considerations:
	* Stall Velocity is not covered in this guide. Information on this topic is available in the device API.		* Stall Velocity is not covered in this guide. Information on this topic is available in the device API.
Line 106:		Line 106:

	===Braking Strength===		===Braking Strength===
	{{~~Template:~~DCMotor_BrakingStrength}}		{{DCMotor_BrakingStrength}}

	===Position===		===Position===
Line 112:		Line 112:

	====Other Considerations====		====Other Considerations====
	* {{~~Template:~~DCMotor_RescaleFactorNote}}		* {{DCMotor_RescaleFactorNote}}
	* Consider using an encoder for more accurate position information.		* Consider using an encoder for more accurate position information.

Mparadis: Created page with "{{#seo:|description=Get started with your Brushless DC Motor Phidget}} Category:IntroGuide

=Introduction= 30V 50A Brushless DC Motor Phidget (DCC1120_0) This guide will provide information about the Brushless DC Motor (BLDC) API to get you up and running with your new BLDC Motor Phidget. Before starting t..."

2024-11-18T18:23:12Z

Created page with "{{#seo:|description=Get started with your Brushless DC Motor Phidget}} Category:IntroGuide <div class="nonumtoc"> <div class="toclimit-4"> =Introduction= thumb|link=https://wwwdev.int.phidgets.com/docs/images/3/38/DCC1120_0.png|<center>30V 50A Brushless DC Motor Phidget (DCC1120_0)</center> This guide will provide information about the Brushless DC Motor (BLDC) API to get you up and running with your new BLDC Motor Phidget. Before starting t..."

New page

{{#seo:|description=Get started with your Brushless DC Motor Phidget}}
[[Category:IntroGuide]]
<div class="nonumtoc">
<div class="toclimit-4">
=Introduction=
[[Image:DCC1120_0.png|thumb|link=https://wwwdev.int.phidgets.com/docs/images/3/38/DCC1120_0.png|<center>30V 50A Brushless DC Motor Phidget (DCC1120_0)</center>]]
This guide will provide information about the Brushless DC Motor (BLDC) API to get you up and running with your new BLDC Motor Phidget.

Before starting this guide, visit the Quick Start Guide on your BLDC Motor Phidget's product page for information about wiring and power.

==Guide Compatibility==
<tabber>
Info=
''Select your controller for compatibility information relating to this guide.''
|-|
DCC1120=
[[Image:DCC1120_0.png|link=https://wwwdev.int.phidgets.com/docs/images/7/7d/DCC1002_0.jpg|thumb|200px|[https://wwwdev.int.phidgets.com/?prodid=1334 30V 50A Brushless DC Motor Phidget (DCC1120_0)]]]
The [https://wwwdev.int.phidgets.com/?prodid=1334 30V 50A Brushless DC Motor Phidget (DCC1120_0)] is fully compatible with this guide.
|-|
DCC1100=
[[Image:DCC1100_0.jpg|link=https://wwwdev.int.phidgets.com/docs/images/8/87/DCC1100_0.jpg|thumb|200px|[https://www.phidgets.com/?prodid=1013 Brushless DC Motor Phidget (DCC1100_0)]]]
[https://www.phidgets.com/?prodid=1013 Brushless DC Motor Phidget (DCC1100_0)] considerations:
* Stall Velocity is not covered in this guide. Information on this topic is available in the device API.
|-|
</tabber>

=BLDCMotor API Overview=
==Phidget Control Panel==
After wiring your BLDC Motor Phidget, we recommend opening the [https://www.phidgets.com/docs/Phidget_Control_Panel Phidget Control Panel] on a Windows computer to experiment with key features.

[[Image:DCC1120_0_Panel.png|center|link=]]

When the BLDC Motor Phidget is powered, it will appear up on the Phidget Control Panel device list as shown above. Double-click on the ''BLDC Motor Controller'' entry to view the program.

[[Image:DCC1120_0_BLDC.png|800px|center|link=]]

After opening the program, you will see the screen shown above. The program is split into multiple sections to help you get familiar with your motor controller.
#Phidget Info
#Motor Status
#Controls
#Configuration

In this guide, we will focus on the areas that contain important information about controlling your Brushless DC motor. For information about the Phidget Info section, and the Phidget Control Panel in general, visit our [https://www.phidgets.com/docs/Phidget_Control_Panel Phidget Control Panel] Page.

==Controls==
{{DCBLDCMotor_Controls}}

==Configuration==
This area of the program allows you to try out different configurations with your BLDC Motor Phidget to determine the best fit for your application.

===Drive Mode===
{{DCBLDCMotor_DriveMode|bldc}}

===Rescale Factor===
The Rescale Factor allows you to change the units of the following properties:
* Position

By default, the units will be in commutations which is dictated by the number of poles/phases your motor and are often non-intuitive. We recommend utilizing the Rescale Factor so your software is easier to understand.

====Example Calculations====
Generally, most users will prefer units of degrees or rotations. To determine an appropriate Rescale Factor, you will need to know the following values:
*Commutations per revolution, equivalent to the number of poles multiplied by the number of phases
*Gearbox ratio (if applicable)

These values will be available from manufacturer data sheets, or directly on the motor.

=====Converting to Degrees=====
Specifications of system:
* Motor gear ratio: 10:1
* Motor poles: 2
* Motor phases: 3
* Preferred Units: Degrees

Rescale Factor = 360 / (10<nowiki>*</nowiki>2<nowiki>*</nowiki>3) = '''6'''

=====Converting to Rotations=====
Specifications of system:
* Motor gear ratio: 10:1
* Motor poles: 2
* Motor phases: 3
* Preferred Units: Rotations

Rescale Factor = 1 / (10<nowiki>*</nowiki>2<nowiki>*</nowiki>3) = '''0.016666667'''

===Braking Enabled===
{{DCBLDCMotor_BrakingEnabled}}

===Surge Current Limit===
{{DCBLDCMotor_SurgeCurrentLimit}}

===Acceleration===
{{DCBLDCMotor_Acceleration}}

===Data Interval===
{{DCBLDCMotor_DataInterval}}

==Motor Status==
This area of the program shows information that has been sent back from the BLDC Motor Phidget.
===Velocity===
{{DCMotor_VelocityStatus}}

===Braking Strength===
{{Template:DCMotor_BrakingStrength}}

===Position===
The most recent Position value reported by the controller. The Position is calculated using Hall Effect sensors mounted inside the motor, therefore, the resolution of the position depends on the motor you are using.

====Other Considerations====
* {{Template:DCMotor_RescaleFactorNote}}
* Consider using an encoder for more accurate position information.

===Active Current Limit===
{{DCMotor_ActiveCurrentLimit}}

===Motor Inductance===
{{DCMotor_MotorInductance}}

==Failsafe==
{{DCMotor_Failsafe}}

===E-Stop===
{{DCMotor_ESTOP|bldc}}

==Errors==
{{DCMotor_Errors|bldc}}