Beeper interface

Files
file	beep.h
	Interface to the beeper.

Functions
void	beep_beep (int len)
	Beep for a specified time. More...
void	beep_alarm (int alarmmode, int len)
	Beep an alarm for a specified time. More...
void	beep (void)
	Produces a quick click-like beep. More...
void	beep_down (int len)
	A beep with a pitch-bend down. More...
void	beep_on (void)
	Turn the beeper on. More...
void	beep_off (void)
	Turn the beeper off. More...
void	beep_spinup (void)
	Produce a sound similar to a hard-drive spinup. More...
void	beep_long (clock_time_t len)
	Beep for a long time (seconds) More...

Detailed Description

Function Documentation

void beep

(

void

)

Produces a quick click-like beep.

This function produces a short beep that sounds like a click.

Produces a quick click-like beep.

This routine simply toggles a port pin at an audio frequency, which causes a tone to be emitted from the Raven's speaker. The beep consists of two tones at two different frequencies. At the end, the beeper port pin is kept low, which causes the speaker amplifier to shut down.

Definition at line 62 of file beep.c.

Referenced by uart_serial_rcv_frame().

void beep_alarm	(	int	alarmmode,
		int	len
	)

Beep an alarm for a specified time.

This function causes the beeper to beep for the specified time. The time is measured in the same units as for the clock_delay() function.

Note

This function will hang the CPU during the beep.

This function will stop any beep that was on previously when this function ends.

If the beeper is turned off with beep_off() this call will still take the same time, though it will be silent.

Parameters

alarmmode	The alarm mode (BEEP_ALARM1,BEEP_ALARM2)
len	The length of the beep.

Definition at line 41 of file beep.c.

void beep_beep

(

int

len

)

Beep for a specified time.

This function causes the beeper to beep for the specified time. The time is measured in the same units as for the clock_delay() function.

Note

This function will hang the CPU during the beep.

This function will stop any beep that was on previously when this function ends.

If the beeper is turned off with beep_off() this call will still take the same time, though it will be silent.

Parameters

len	The length of the beep.

Definition at line 47 of file beep.c.

void beep_down

(

int

len

)

A beep with a pitch-bend down.

This function produces a pitch-bend sound with deecreasing frequency.

Parameters

len	The length of the pitch-bend.

Definition at line 59 of file beep.c.

void beep_long

(

clock_time_t

len

)

Beep for a long time (seconds)

This function produces a beep with the specified length and will not return until the beep is complete. The length of the beep is specified using CLOCK_SECOND: a two second beep is CLOCK_SECOND * 2, and a quarter second beep is CLOCK_SECOND / 4.

Note

If the beeper is turned off with beep_off() this call will still take the same time, though it will be silent.

Parameters

len	The length of the beep, measured in units of CLOCK_SECOND

Definition at line 88 of file beep.c.

void beep_off

(

void

)

Turn the beeper off.

This function turns the beeper off after it has been turned on with beep_on().

Definition at line 71 of file beep.c.

void beep_on

(

void

)

Turn the beeper on.

This function turns on the beeper. The beeper is turned off with the beep_off() function.

Definition at line 65 of file beep.c.

void beep_spinup

(

void

)

Produce a sound similar to a hard-drive spinup.

This function produces a sound that is intended to be similar to the sound a hard-drive makes when it starts.

Definition at line 77 of file beep.c.