File content as of revision 1:ff57945c704c:

/**
@file beep.h
@brief program implementation
@author Zang,Junwei
@date May 2015
*/

#ifndef MBED_BEEP_H
#define MBED_BEEP_H
 
#include "mbed.h"
 
/** class to make sound with a buzzer, based on a PwmOut
 *   The class use a timeout to switch off the sound  - it is not blocking while making noise
 *
 * Example:
 * @code
 * // Beep with 1Khz for 0.5 seconds
 * #include "mbed.h"
 * #include "beep.h"
 * 
 * Beep buzzer(p21);
 * 
 * int main() {
 *        ...
 *   buzzer.beep(1000,0.5);    
 *       ...
 * }
 * @endcode
 */
 
 
namespace mbed {
 
/* Class: Beep
 *  A class witch uses pwm to controle a beeper to generate sounds.
 */
class Beep {
 
public:
 
/** Create a Beep object connected to the specified PwmOut pin
 *
 * @param pin PwmOut pin to connect to 
 */
    Beep (PinName pin);
 
/** Beep with given frequency and duration.
 *
 * @param frequency - the frequency of the tone in Hz
 * @param time - the duration of the tone in seconds
 */
    void beep (float frequency, float time);
 
/** stop the beep instantaneous 
 * usually not used 
 */
    void nobeep();
 
private :
    PwmOut _pwm;
    Timeout toff;
};
 
}
#endif