BeagleBoard/GSoC/2010 Projects/Pulse Width Modulation

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: http://beagleboard-pwm.blogspot.com/feeds/posts/default|charset=UTF-8|max=3

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
git clone git://github.com/neo01124/omap3-pwm.git cd omap3-pwm/
 * Clone my git tree for the driver.This can be done using the following commands:


 * A cross compiling environment will be needed for compiling the driver. Instructions below work with OpenEmbedded but can adapted for codesourcery as well.

$ beagle-source-me.txt Modify 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.

pwm.ko
 * root@beagleboard# ls

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.

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

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

1. 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.
 * There are two ways of modifying the parameters from userland.

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. 2. 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     #include  //#define PWM_IOC_MAGIC  0x00 /**/ main {	int fd, status, k, f, sc;
 * 1) include 
 * 2) include 
 * 3) include 
 * 1) define PWM_SET_DUTYCYCLE 1074003969
 * 2) define PWM_GET_DUTYCYCLE 1074003970
 * 3) define PWM_SET_FREQUENCY 1074003971
 * 4) define PWM_GET_FREQUENCY 1074003972
 * 5) define PWM_ON 1074003973
 * 6) define PWM_OFF 1074003974
 * 7) define PWM_SET_POLARITY 1074003975

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

 * 
 *