PWM Output Mode - Revision history

TK: Fix minor typos

2017-11-16T01:12:33Z

Fix minor typos

TK: Added note for setting the KFLOP Axis Parameters

2017-01-13T01:22:21Z

Added note for setting the KFLOP Axis Parameters

TK: Added PWM Descriptions

2017-01-13T01:08:46Z

Added PWM Descriptions

New page

KFLOP has 8 hardware PWMs (Pulse Width Modulators) that output on dedicated KFLOP JP6 pins

[[File:KFLOP_PWMS.png|none|link=]]

There is no direct output support for KFLOP PWMs. A few lines of C Code executing in a loop are required to output the Servo Outputs to the pwms and possibly directions (sometimes referred to as signs) in your required format. This allows flexibility for controlling Mode, Frequency, Range, Polarity, etc... Pre-made examples exist. Often this code can be added to an existing forever loop toward the end of your Initialization C Program.

The PWMs are accessed via a pair of FPGA Registers. The first in the pair is a value 0-255 to set the pulse width. The second register is a single bit enable register. A value of 1 enables the PWM to take control of the Output pin and begin pulsing. The PWM pin must be configured as an output via a SetBitDirection call. A value of 0 disables the PWM and allows the pin to be used as General Purpose IO.

There is also a global pre-scaler to set the frequency of all the PWMs. All PWMs must operate at the same frequency. The pre-scaler divides the 16.67MHz input clock by N+1. Where N is a value of 0-255.

PWM1KHz.c is a simple example to enable a PWM to operate at a fixed period and frequency:

<pre class="brush:c">#include "KMotionDef.h"

main()
{
SetBitDirection(26,1); // define bit as an output
FPGA(IO_PWMS_PRESCALE) = 65; // divide clock by 65 (1 KHz)
FPGA(IO_PWMS) = 128; // square wave
FPGA(IO_PWMS+1) = 1; // Enable
}</pre>

Usually a PWM is used to drive a Full H-Bridge Driver to control the effective voltage to a motor coil. There are two basic modes of operation: Sign/Magnitude and Anti-Phase. With Sign and Magnitude the Sign controls the polarity of voltage (either positive or negative) and the PWM pulse controls the fraction of time the voltage is applied. The voltage is applied for some fraction of the time period and zero volts are applied for the remainder. With Anti-phase there is no Direction Output required. Instead both positive and negative voltages are applied every cycle. Equal amounts of positive and negative voltage results in effectively zero volts. With KFLOP's 8-bit PWMs setting a PWM value of 128 will result in equal positive and negative times.

See the example below "OutputToPWM_sign_mag_single_axis.c"

<pre class="brush:c">#include "KMotionDef.h"

// Send Servo Output to PWM as Sign/mag

#define MAXPWM 242
#define DIR_BIT0 30

void OutputSignMag(int ch, int pwm, int dir_bit);

main()
{
SetBitDirection(26,1); // Set bit 26 (PWM 0 as an output)
SetBitDirection(DIR_BIT0,1); // Set bit 30 (Direction an output)
FPGA(IO_PWMS_PRESCALE) = 1; // set pwm period to 30 KHz
FPGA(IO_PWMS+1) = 1; // enable the PWM

for (;;) //loop forever
{
WaitNextTimeSlice();
OutputSignMag(0,0,DIR_BIT0);
}
}

// put the servo Output to a specified PWM channel
// and direction bit in signed and magnitude mode

void OutputSignMag(int ch, int pwm, int dir_bit)
{
if (chan[ch].Enable)
{
if (chan[ch].Output >= 0)
{
if (chan[ch].Output > MAXPWM) // don't go to 100%
FPGA(IO_PWMS+pwm*2) = MAXPWM;
else
FPGA(IO_PWMS+pwm*2) = chan[ch].Output;
SetBit(dir_bit);
}
else
{
if (chan[ch].Output < -MAXPWM) // don't go to 100%
FPGA(IO_PWMS+pwm*2) = MAXPWM;
else
FPGA(IO_PWMS+pwm*2) = -chan[ch].Output;
ClearBit(dir_bit);
}
}
else
{
FPGA(IO_PWMS+pwm*2) = 0; // whenever not enabled put 0% duty cycle
}
}</pre>

See the example below "OutputToPWM.c" written for an anti-phase type of H Bridge drive:

<pre class="brush:c">#include "KMotionDef.h"

main()
{
SetBitDirection(26,1); // Set bit 26 (PWM 0 as an output)
FPGA(IO_PWMS_PRESCALE) = 1; // set pwm period to 30 KHz
FPGA(IO_PWMS+1) = 1; // enable the PWM

for (;;) //loop forever
{
WaitNextTimeSlice();
if (ch0->Enable)
FPGA(IO_PWMS+0) = ch0->Output + 128; // +128 converts to anti-phase
else
FPGA(IO_PWMS+0) = 128; // whenever not enabled put 50% duty cycle
}
}</pre>

You might also search the C Programs directory for other PWM examples.

← Older revision		Revision as of 01:22, 13 January 2017
Line 27:		Line 27:

	Usually a PWM is used to drive a Full H-Bridge Driver to control the effective voltage to a motor coil. There are two basic modes of operation: Sign/Magnitude and Anti-Phase. With Sign and Magnitude the Sign controls the polarity of voltage (either positive or negative) and the PWM pulse controls the fraction of time the voltage is applied. The voltage is applied for some fraction of the time period and zero volts are applied for the remainder. With Anti-phase there is no Direction Output required. Instead both positive and negative voltages are applied every cycle. Equal amounts of positive and negative voltage results in effectively zero volts. With KFLOP's 8-bit PWMs setting a PWM value of 128 will result in equal positive and negative times.		Usually a PWM is used to drive a Full H-Bridge Driver to control the effective voltage to a motor coil. There are two basic modes of operation: Sign/Magnitude and Anti-Phase. With Sign and Magnitude the Sign controls the polarity of voltage (either positive or negative) and the PWM pulse controls the fraction of time the voltage is applied. The voltage is applied for some fraction of the time period and zero volts are applied for the remainder. With Anti-phase there is no Direction Output required. Instead both positive and negative voltages are applied every cycle. Equal amounts of positive and negative voltage results in effectively zero volts. With KFLOP's 8-bit PWMs setting a PWM value of 128 will result in equal positive and negative times.
		+
		+
		+	The KFLOP Axis Output Mode should be set to "NO Output" as your C Code will be performing the Output. The Max Output should be set to less than the maximum PWM range. Either 255 for Sign/Mag types or 127 for Anti-Phase types.

@@ Line 1: / Line 1: @@
-KFLOP has 8 hardware PWMs (Pulse Width Modulators) that output on dedicated KFLOP JP6 pins
+KFLOP has 8 hardware 8-bit PWMs (Pulse Width Modulators) that output on dedicated KFLOP JP6 pins
 [[File:KFLOP_PWMS.png|none|link=]]
@@ Line 21: / Line 21: @@
+{
 	SetBitDirection(26,1);  // define bit as an output
-	FPGA(IO_PWMS_PRESCALE) = 65;  	// divide clock by 65 (1 KHz)
+	FPGA(IO_PWMS_PRESCALE) = 64;  	// divide clock by 65 (~1KHz)
 	FPGA(IO_PWMS) = 128;  			// square wave
 	FPGA(IO_PWMS+1) = 1;  			// Enable
@@ Line 47: / Line 47: @@
 	SetBitDirection(26,1);  		// Set bit 26 (PWM 0 as an output)
 	SetBitDirection(DIR_BIT0,1);	// Set bit 30 (Direction an output)
-	FPGA(IO_PWMS_PRESCALE) = 1;  	// set pwm period to 30 KHz
+	FPGA(IO_PWMS_PRESCALE) = 1;  	// set pwm period to ~33 KHz
 	FPGA(IO_PWMS+1) = 1;			// enable the PWM
@@ Line 94: / Line 94: @@
+{
 	SetBitDirection(26,1);  	// Set bit 26 (PWM 0 as an output)
-	FPGA(IO_PWMS_PRESCALE) = 1;  	// set pwm period to 30 KHz
+	FPGA(IO_PWMS_PRESCALE) = 1;  	// set pwm period to ~33 KHz
 	FPGA(IO_PWMS+1) = 1;		// enable the PWM