dac.h File Reference

#include "dac_types.h"
#include "types.h"
#include <stdbool.h>

Go to the source code of this file.

Functions
void	DAC_BUZInit (u8 timer_a, u8 timer_b, u8 int_priority)
	Initializes the DAC peripheral.
void	DAC_BUZDeinit (void)
void	DAC_BUZPlay (DAC_Tone tone, u16 bpm)
	Plays the given note for the given duration.
void	DAC_BUZSetVolume (u8 volume)
	Sets the volume of the buzzer.
bool	DAC_BUZIsPlaying (void)
void	DAC_BUZStop (void)

Function Documentation

DAC_BUZDeinit()

void DAC_BUZDeinit

(

void

)

Definition at line 76 of file dac.c.

{
    LPC_PINCON->PINSEL1 &= ~(3 << 20);
    LPC_GPIO0->FIODIR &= ~(1 << 26);
 
    DAC_BUZStop();
    TIMER_Deinit(DAC_SamplesTimer);
    TIMER_Deinit(DAC_SecondsTimer);
}

DAC_BUZInit()

void DAC_BUZInit	(	u8	timer_a,
		u8	timer_b,
		u8	int_priority
	)

Initializes the DAC peripheral.

Parameters

int_priority

The interrupt priority of the timer. If set to INT_PRIO_DEF, the default interrupt priority will be used.

Note

This implementation requires the use of 2 timers to feed the DAC with samples and to play the note for the given duration. By giving these parameters to this function, you ensure that those timers are not and won't be used for other purposes.

Definition at line 66 of file dac.c.

{
    // Enable Analog OUT (function 10) on PIN on P0.26, located in PINSEL1
    LPC_PINCON->PINSEL1 |= (2 << 20);
    LPC_GPIO0->FIODIR |= (1 << 26);
 
    TIMER_Init(&DAC_SamplesTimer, timer_a, NO_PRESCALER, int_priority);
    TIMER_Init(&DAC_SecondsTimer, timer_b, NO_PRESCALER, int_priority);
}

DAC_BUZIsPlaying()

bool DAC_BUZIsPlaying

(

void

)

Definition at line 114 of file dac.c.

{
    return TIMER_IsEnabled(DAC_SamplesTimer) && TIMER_IsEnabled(DAC_SecondsTimer);
}

DAC_BUZPlay()

void DAC_BUZPlay	(	DAC_Tone	tone,
		u16	bpm
	)

Plays the given note for the given duration.

Parameters

tone	The tone to be played
bpm	The tempo of the note (i.e. 60, 120, 240, etc.)

Definition at line 91 of file dac.c.

{
    // How many samples need to be sent to the DAC in a second in order to play the tone
    TIMER_SetInterruptHandler(DAC_SamplesTimer, TIM_INT_SRC_MR0, next_sample);
    TIMER_SetMatch(DAC_SamplesTimer, (TIMER_MatchRegister){.which = TIM_MR0,
                                                           .actions = TIM_MR_INT | TIM_MR_RES,
                                                           .match = get_tone_timing(tone.note, tone.octave)});
 
    // Since a tone has a type (i.e. a duration which depends on the BPM), the duration of the tone
    // needs to be controlled by another timer, which, on match, will stop & clear the samples timer.
    // The duration (in seconds) of the tone is calculated by the formula: (60 * type) / bpm. Since
    // each second the seconds timer ticks 25 million times, we need to multiply that by the duration
    const u32 tone_duration = DAC_CLK_HZ * ((60 * tone.type) / bpm);
    TIMER_SetInterruptHandler(DAC_SecondsTimer, TIM_INT_SRC_MR0, DAC_BUZStop);
    TIMER_SetMatch(DAC_SecondsTimer, (TIMER_MatchRegister){.which = TIM_MR0,
                                                           .actions = TIM_MR_INT | TIM_MR_RES | TIM_MR_STP,
                                                           .match = tone_duration});
 
    // Starts the timers (i.e. plays)
    TIMER_Enable(DAC_SamplesTimer);
    TIMER_Enable(DAC_SecondsTimer);
}

DAC_BUZSetVolume()

void DAC_BUZSetVolume

(

u8

volume

)

Sets the volume of the buzzer.

Parameters

volume

The volume of the buzzer (between 0 and 10).

Definition at line 86 of file dac.c.

{
    DAC_SinVolume = (IS_BETWEEN_EQ(volume, 0, 10)) ? volume : DAC_VOL_DEFAULT;
}

DAC_BUZStop()

void DAC_BUZStop

(

void

)

Definition at line 119 of file dac.c.

{
    DAC_SinVolume = DAC_VOL_DEFAULT;
    DAC_SinTableIndex = 0;
    LPC_DAC->DACR &= ~(0x3FF << 6);
 
    TIMER_Disable(DAC_SamplesTimer);
    TIMER_Reset(DAC_SamplesTimer);
 
    TIMER_Reset(DAC_SecondsTimer);
    TIMER_Disable(DAC_SecondsTimer);
}