DCC1000 User Guide: Difference between revisions

From Phidgets Support
No edit summary
No edit summary
Line 48: Line 48:
{{UGC-Entry|DCMotor:|Controls the velocity and current of the motor, and the on-board fan|
{{UGC-Entry|DCMotor:|Controls the velocity and current of the motor, and the on-board fan|
In your Control Panel, double click on "DC Motor Controller":
In your Control Panel, double click on "DC Motor Controller":
[[Image:DCC1000-test-DCMotor.jpg|850px|center|link=]]}}
[[Image:DCC1000-DCMotor.jpg|850px|center|link=]]}}


{{UGC-Entry|Position Controller:|A built-in PID position controller|
{{UGC-Entry|Position Controller:|A built-in PID position controller|
In your Control Panel, double click on "Position Controller":
In your Control Panel, double click on "Position Controller":
[[Image:DCC1000-test-MPC.jpg|850px|center|link=]]}}
[[Image:DCC1000-MPC.jpg|850px|center|link=]]}}


{{UGC-Entry|Encoder Input:|Reads encoder input so you can implement closed-loop control of the motor|
{{UGC-Entry|Encoder Input:|Reads encoder input so you can implement closed-loop control of the motor|
In your Control Panel, double click on "Encoder Input":  
In your Control Panel, double click on "Encoder Input":  
[[Image:DCC1000-test-Enc.jpg|850px|center|link=]]}}
[[Image:DCC1000-Enc.jpg|850px|center|link=]]}}


{{UGC-Entry|Current Sensor:|Measures the amount of current flowing through the motor's coils|
{{UGC-Entry|Current Sensor:|Measures the amount of current flowing through the motor's coils|
In your Control Panel, double click on "Current Sensor":
In your Control Panel, double click on "Current Sensor":
[[Image:DCC1000-test-Cur.jpg|center|link=]]}}
[[Image:DCC1000-Cur.jpg|center|link=]]}}


{{UGC-Entry|Voltage Ratio:|Measures the "Analog In" port (Intended for feedback potentiometers that some motors have)|
{{UGC-Entry|Voltage Ratio:|Measures the "Analog In" port (Intended for feedback potentiometers that some motors have)|
In your Control Panel, double click on "Voltage Ratio":
In your Control Panel, double click on "Voltage Ratio":
[[Image:DCC1000-test-Voltageratio.jpg|800px|center|link=]]}}
[[Image:DCC1000-Voltageratio.jpg|800px|center|link=]]}}


{{UGC-Entry|Temperature Sensor:|Measures the board temperature so you can tell if the DCC1000 is overheating|
{{UGC-Entry|Temperature Sensor:|Measures the board temperature so you can tell if the DCC1000 is overheating|
In your Control Panel, double click on "Temperature Sensor":
In your Control Panel, double click on "Temperature Sensor":
[[Image:DCC1000-test-Temp.jpg|center|link=]]}}
[[Image:DCC1000-Temp.jpg|center|link=]]}}


{{UGC-End}}
{{UGC-End}}

Revision as of 18:22, 21 April 2020



Part 1: Setup

Welcome to the DCC1000 user guide! In order to get started, make sure you have the following hardware on hand:

Next, you will need to connect the pieces:

DCC1000 Functional.jpeg
  1. Connect the DCC1000 to the VINT Hub using the Phidget cable.
  2. Connect the motor to the Phidget's output terminals.
  3. Connect the VINT Hub to your computer with a USB cable.
  4. (Optional) If your motor has an encoder, connect it to the encoder port on the DCC1000.
  5. Connect the power supply to the power terminals.


Now that you have everything together, let's start using the DCC1000!

Phidget Control Panel

In order to demonstrate the functionality of the DCC1000, the Phidget Control Panel running on a Windows machine will be used.


The Phidget Control Panel is available for use on both macOS and Windows machines.

Windows

To open the Phidget Control Panel on Windows, find the Ph.jpg icon in the taskbar. If it is not there, open up the start menu and search for Phidget Control Panel

Windows PhidgetTaskbar.PNG

macOS

To open the Phidget Control Panel on macOS, open Finder and navigate to the Phidget Control Panel in the Applications list. Double click on the Ph.jpg icon to bring up the Phidget Control Panel.


For more information, take a look at the getting started guide for your operating system:


Linux users can follow the getting started with Linux guide and continue reading here for more information about the DCC1000.

First Look

After plugging the DCC1000 into your computer and opening the Phidget Control Panel, you will see something like this:

DCC1000 Panel.jpg


The Phidget Control Panel will list all connected Phidgets and associated objects, as well as the following information:

  • Serial number: allows you to differentiate between similar Phidgets.
  • Channel: allows you to differentiate between similar objects on a Phidget.
  • Version number: corresponds to the firmware version your Phidget is running. If your Phidget is listed in red, your firmware is out of date. Update the firmware by double-clicking the entry.


The Phidget Control Panel can also be used to test your device. Double-clicking on an object will open an example.

Part 2: Using Your Phidget

About

The DCC1000 allows you to control a DC motor or DC linear actuator. With this Phidget, you can control your motor by:

  • Setting the velocity and acceleration with the DC Motor Controller
  • Setting a specific target position using the Motor Position Controller (requires an encoder)

You can use the DCC1000 to monitor current passing through the motor, connect and monitor the motor’s potentiometer, and monitor the temperature of the motor.

Explore Your Phidget Channels Using the Control Panel

You can use your Control Panel to explore your Phidget's channels.

1. Open your Control Panel, and you will find the following channels:

DCC1000 Panel.jpg

2. Double click on a channel to open an example program. Each channel belongs to one of these channel classes:

Expand All
DCMotor:Controls the velocity and current of the motor, and the on-board fan

In your Control Panel, double click on "DC Motor Controller":

DCC1000-DCMotor.jpg
Position Controller:A built-in PID position controller

In your Control Panel, double click on "Position Controller":

DCC1000-MPC.jpg
Encoder Input:Reads encoder input so you can implement closed-loop control of the motor

In your Control Panel, double click on "Encoder Input":

DCC1000-Enc.jpg
Current Sensor:Measures the amount of current flowing through the motor's coils

In your Control Panel, double click on "Current Sensor":

DCC1000-Cur.jpg
Voltage Ratio:Measures the "Analog In" port (Intended for feedback potentiometers that some motors have)

In your Control Panel, double click on "Voltage Ratio":

DCC1000-Voltageratio.jpg
Temperature Sensor:Measures the board temperature so you can tell if the DCC1000 is overheating

In your Control Panel, double click on "Temperature Sensor":

DCC1000-Temp.jpg

Part 3: Create your Program

Part 4: Advanced Topics and Troubleshooting

Expand All
PositionController Settings

There are a number of settings that can be adjusted to customize the position controller. You can save these variables into the program so you don't have to re-enter them manually (NOTE: This does not store the settings on the DCC1000, it simply saves them inside the control panel program, so you'll have to re-enter them if it's used on another computer).

Kp, Ki, and Kd

You can set the control parameters Kp, Ki, and Kd in order to change the behavior of the control loop. For more information on how each of these three tuning parameters affect the control loop, see “Control Loop Parameters ”.

Velocity and Acceleration

Velocity is how fast the motor will move to the target position, and acceleration controls how quickly the motor will reach its velocity and how quickly it will slow down. These values are measured in position per second and position per second squared, and position by default is measured in encoder pulses.

Rescale Factor

If you want position to be measured in another unit (degrees, for example), you can set the rescale factor. For more information on choosing the correct rescale factor, see “Setting the Rescale Factor”.

Deadband

Sometimes the motor will oscillate back and forth across the target position when holding position. Adding a deadband will widen the target position so the motor will stop when it gets within the target position plus or minus the deadband.

Current Limit

Setting the current limit gives you control over how much power is being supplied to the motor. Generally, we advise that you set the current limit to your motor’s specified coil current.

Fan Mode

This turns the cooling fan on and off. Setting it to auto will result in the fan turning on only when the temperature sensor detects rising board temperatures.

Encoder IO Mode

Changes between different encoder modes based on your encoder’s circuitry. For more information see the Encoder Primer.

Current Regulator Gain

Depending on power supply voltage and motor coil inductance, the current through the motor can change relatively slowly or extremely rapidly. A physically larger DC Motor will typically have a lower inductance, requiring a higher current regulator gain. A higher power supply voltage will result in motor current changing more rapidly, requiring a higher current regulator gain. If the current regulator gain is too small, spikes in current will occur, causing large variations in torque, and possibly damaging the motor controller. If the current regulator gain is too high, the current will jitter, causing the motor to sound 'rough', especially when changing directions.

Control Loop Parameters

In order to get the desired behavior from your controller, you will have to tune your control parameters. This video explains the tuning procedure and gives information on how the controller works.

Interfacing Encoders

The DCC1000 can connect to any of the encoders we sell without any modification just by setting the EncoderIOMode property to Push-Pull . If you're trying to use your own encoder, you may need to change the IO mode to Open Collector or Line Driver mode. Have a look at the Encoder Primer for more details on what to use.

Setting the Rescale Factor

There are three pieces of information to consider when setting a rescale factor to change your units into degrees or rotations:

  • Your encoder's CPR (counts per rotation)
  • Your encoder interface's resolution
  • Your motor's gear ratio

First, check your encoder's datasheet for the CPR. It's usually 360 or 300. This is the number of quadrature cycles the encoder will send out for one full rotation.

Next, you need your encoder interface's resolution. The encoder port on the DCC1000 has a x4 resolution, meaning it reads in 4 pulses per quadrature cycle (see the Encoder Primer for a more in-depth explanation).

Next, you need to find out the gear ratio in your motor's datasheet. Note: If you plan on having your motor run for many rotations in a row, try to find the exact gear ratio, expressed as a fraction. Using the rounded value will result in accumulating errors the more you rotate.

Once you have these numbers, you can calculate the rescale factor:

DCC1000-equations.jpg

For example, if you wanted to have your motor's position measured in degrees and your encoder had 300 CPR and your motor had a 50 801⁄895 : 1 gearbox, you would set your rescale factor to 360 / 300*4*(50+(801/895)), or 0.005894.


Setting the Change Trigger and Data Interval

The Change Trigger is the minimum change in the sensor data needed to trigger a new data event.

The Data Interval is the time (in ms) between data events sent out from your Phidget.

The Data Rate is the reciprocal of Data Interval (measured in Hz), and setting it will set the reciprocal value for Data Interval and vice-versa.

You can modify one or both of these values to achieve different data outputs. You can learn more about these properties here.

My motor moves away from the target position in Position Controller mode!

Reverse your motor’s wires. The control loop has to make an assumption about what direction your motor moves with a positive voltage, and in this case, the assumption was incorrect. Don’t worry, DC motors are fine being wired up backward since they’re essentially just a long loop of wire on the inside.