BeagleBoard/GSoC/2010 Projects/Pulse Width Modulation

From eLinux.org
< BeagleBoard‎ | GSoC‎ | 2010 Projects
Revision as of 10:33, 15 August 2010 by Neo01124 (talk | contribs) (Build and Run instructions)
Jump to: navigation, search

Project: Pulse Width Modulation

Student: Varun Jewalikar

Mentors: Søren Steen Christensen, Cristina Murillo

Repository: http://github.com/neo01124/omap3-pwm

Blog: http://beagleboard-pwm.blogspot.com/

Latest blog entries: Extension:RSS -- Error: "http://beagleboard-pwm.blogspot.com/feeds/posts/default%7Ccharset=UTF-8%7Cmax=3" is not in the whitelist of allowed feeds. There are no allowed feed URLs in the whitelist.

Abstract

The main aim of this project will be to provide a high level interface for the Pulse Width Modulation output pins of the OMAP3 found on the BeagleBoard. Another aim will be to push this driver upstream(the Linux-OMAP tree). Two applications will be developed to demonstrate the use of this driver:

  • Motor control using PWM signals generated by the BeagleBoard using the PWM driver.
  • Writing a glue layer for ALSA to communicate with the PWM driver and output sound from the PWM output pins.

Build and Run instructions

  • Clone my git tree for the driver.This can be done using the following commands:
git clone git://github.com/neo01124/omap3-pwm.git
cd omap3-pwm/
  • A cross compiling environment will be needed for compiling the driver. Instructions below work with OpenEmbedded but can adapted for codesourcery as well.
$ vim beagle-source-me.txt

Edit the OETREE path. OETREE should point to the OE folder. For me OETREE= ~/OE .

$ source beagle-source-me.txt

This will set the environment variables for cross compilation.

$ make 

This will generate the requisite pwm.ko kernel module file.

  • Copy the pwm.ko to your target board.
  • Once on the system, use insmod to load using the optional frequency parameter. The default frequency is 1024 Hz. Use multiples of two with a max of 16384. pwm9_enable,pwm10_enable and pwm11_enable and frequency are load time parameters.
root@beagleboard# ls
pwm.ko
root@beagleboard# insmod pwm.ko pwm9_enable=1

The driver implements a character device interface. When it loads, it will create a /dev/pwm9 entry.

  • To setup multiple pwm signals on the GPT9/10/11 you should use
root@beagleboard# insmod pwm.ko pwm9_enable=1 pwm10_enable=1

This will work similarly for any other (pwm_9/10/11) combinations as well.

  • There are two ways of modifying the parameters from userland.

Using the sysfs interface (Not advised and fully supported) : Then to issue commands you can use any program that can do file I/O cat and echo will work.

root@beagleboard# cat /dev/pwm9
PWM9 Frequency 1024 Hz Stopped
root@beagleboard# echo 50 > /dev/pwm9
root@beagleboard:~# cat /dev/pwm9
PWM9 Frequency 1024 Hz Duty Cycle 50%
root@beagleboard:~# echo 80 > /dev/pwm9
root@beagleboard:~# cat /dev/pwm9
PWM9 Frequency 1024 Hz Duty Cycle 80%

You can put an oscope on pin 28 of the expansion board to see the signal.Use pin 15 for ground. Or you can measure the voltage on pin 28 and you'll see the duty cycle percentage of 1.8v.

  • Using the ioctl() calls :

A fully supported ioctl() interface is available and it is advised to prefer this over the above sysfs interface. Sample code to use the ioctl interface:

#include <termios.h>
#include <fcntl.h>
#include <errno.h>
#include <sys/ioctl.h>
#include <linux/ioctl.h>
//#define PWM_IOC_MAGIC  0x00 
 /**/
#define PWM_SET_DUTYCYCLE 1074003969
#define PWM_GET_DUTYCYCLE 1074003970
#define PWM_SET_FREQUENCY 1074003971
#define PWM_GET_FREQUENCY 1074003972
#define PWM_ON 1074003973
#define PWM_OFF 1074003974
#define PWM_SET_POLARITY 1074003975
main()
{
	int fd, status, k, f, sc;

	fd = open("/dev/pwm9", O_RDWR);
	scanf("%d", &k);
	scanf("%d", &f);
	scanf("%d", &sc);

	if (ioctl(fd, PWM_SET_FREQUENCY, f) == -1)
		printf("TIOCMGET failed: %s\n", strerror(errno));

	if (ioctl(fd, PWM_SET_DUTYCYCLE, k) == -1)
		printf("TIOCMGET failed: %s\n", strerror(errno));

	if (ioctl(fd, PWM_SET_POLARITY, sc) == -1)
		printf("TIOCMGET failed: %s\n", strerror(errno));
	printf("%d",ioctl(fd, PWM_GET_FREQUENCY, sc));
	printf("\n%d",ioctl(fd, PWM_GET_DUTYCYCLE, sc));

	close(fd);
}

Links