111 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			111 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* Copyright 2016 Jack Humbert
 | 
						|
 *
 | 
						|
 * This program is free software: you can redistribute it and/or modify
 | 
						|
 * it under the terms of the GNU General Public License as published by
 | 
						|
 * the Free Software Foundation, either version 2 of the License, or
 | 
						|
 * (at your option) any later version.
 | 
						|
 *
 | 
						|
 * This program is distributed in the hope that it will be useful,
 | 
						|
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
						|
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
						|
 * GNU General Public License for more details.
 | 
						|
 *
 | 
						|
 * You should have received a copy of the GNU General Public License
 | 
						|
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
						|
 */
 | 
						|
#ifndef AUDIO_H
 | 
						|
#define AUDIO_H
 | 
						|
 | 
						|
#include <stdint.h>
 | 
						|
#include <stdbool.h>
 | 
						|
#if defined(__AVR__)
 | 
						|
#    include <avr/io.h>
 | 
						|
#endif
 | 
						|
#include "wait.h"
 | 
						|
#include "musical_notes.h"
 | 
						|
#include "song_list.h"
 | 
						|
#include "voices.h"
 | 
						|
#include "quantum.h"
 | 
						|
#include <math.h>
 | 
						|
 | 
						|
// Largely untested PWM audio mode (doesn't sound as good)
 | 
						|
// #define PWM_AUDIO
 | 
						|
 | 
						|
// #define VIBRATO_ENABLE
 | 
						|
 | 
						|
// Enable vibrato strength/amplitude - slows down ISR too much
 | 
						|
// #define VIBRATO_STRENGTH_ENABLE
 | 
						|
 | 
						|
typedef union {
 | 
						|
    uint8_t raw;
 | 
						|
    struct {
 | 
						|
        bool    enable : 1;
 | 
						|
        bool    clicky_enable : 1;
 | 
						|
        uint8_t level : 6;
 | 
						|
    };
 | 
						|
} audio_config_t;
 | 
						|
 | 
						|
bool is_audio_on(void);
 | 
						|
void audio_toggle(void);
 | 
						|
void audio_on(void);
 | 
						|
void audio_off(void);
 | 
						|
 | 
						|
// Vibrato rate functions
 | 
						|
 | 
						|
#ifdef VIBRATO_ENABLE
 | 
						|
 | 
						|
void set_vibrato_rate(float rate);
 | 
						|
void increase_vibrato_rate(float change);
 | 
						|
void decrease_vibrato_rate(float change);
 | 
						|
 | 
						|
#    ifdef VIBRATO_STRENGTH_ENABLE
 | 
						|
 | 
						|
void set_vibrato_strength(float strength);
 | 
						|
void increase_vibrato_strength(float change);
 | 
						|
void decrease_vibrato_strength(float change);
 | 
						|
 | 
						|
#    endif
 | 
						|
 | 
						|
#endif
 | 
						|
 | 
						|
// Polyphony functions
 | 
						|
 | 
						|
void set_polyphony_rate(float rate);
 | 
						|
void enable_polyphony(void);
 | 
						|
void disable_polyphony(void);
 | 
						|
void increase_polyphony_rate(float change);
 | 
						|
void decrease_polyphony_rate(float change);
 | 
						|
 | 
						|
void set_timbre(float timbre);
 | 
						|
void set_tempo(uint8_t tempo);
 | 
						|
 | 
						|
void increase_tempo(uint8_t tempo_change);
 | 
						|
void decrease_tempo(uint8_t tempo_change);
 | 
						|
 | 
						|
void audio_init(void);
 | 
						|
 | 
						|
#ifdef PWM_AUDIO
 | 
						|
void play_sample(uint8_t* s, uint16_t l, bool r);
 | 
						|
#endif
 | 
						|
void play_note(float freq, int vol);
 | 
						|
void stop_note(float freq);
 | 
						|
void stop_all_notes(void);
 | 
						|
void play_notes(float (*np)[][2], uint16_t n_count, bool n_repeat);
 | 
						|
 | 
						|
#define SCALE \
 | 
						|
    (int8_t[]) { 0 + (12 * 0), 2 + (12 * 0), 4 + (12 * 0), 5 + (12 * 0), 7 + (12 * 0), 9 + (12 * 0), 11 + (12 * 0), 0 + (12 * 1), 2 + (12 * 1), 4 + (12 * 1), 5 + (12 * 1), 7 + (12 * 1), 9 + (12 * 1), 11 + (12 * 1), 0 + (12 * 2), 2 + (12 * 2), 4 + (12 * 2), 5 + (12 * 2), 7 + (12 * 2), 9 + (12 * 2), 11 + (12 * 2), 0 + (12 * 3), 2 + (12 * 3), 4 + (12 * 3), 5 + (12 * 3), 7 + (12 * 3), 9 + (12 * 3), 11 + (12 * 3), 0 + (12 * 4), 2 + (12 * 4), 4 + (12 * 4), 5 + (12 * 4), 7 + (12 * 4), 9 + (12 * 4), 11 + (12 * 4), }
 | 
						|
 | 
						|
// These macros are used to allow play_notes to play an array of indeterminate
 | 
						|
// length. This works around the limitation of C's sizeof operation on pointers.
 | 
						|
// The global float array for the song must be used here.
 | 
						|
#define NOTE_ARRAY_SIZE(x) ((int16_t)(sizeof(x) / (sizeof(x[0]))))
 | 
						|
#define PLAY_NOTE_ARRAY(note_array, note_repeat, deprecated_arg)           \
 | 
						|
    play_notes(¬e_array, NOTE_ARRAY_SIZE((note_array)), (note_repeat)); \
 | 
						|
    _Pragma("message \"'PLAY_NOTE_ARRAY' macro is deprecated\"")
 | 
						|
#define PLAY_SONG(note_array) play_notes(¬e_array, NOTE_ARRAY_SIZE((note_array)), false)
 | 
						|
#define PLAY_LOOP(note_array) play_notes(¬e_array, NOTE_ARRAY_SIZE((note_array)), true)
 | 
						|
 | 
						|
bool is_playing_notes(void);
 | 
						|
 | 
						|
#endif
 |