andrekwr/musical-embedded-system

APS-Musical

A embedded system that can play monophonic music. Here`s a link to a video that demonstrates the project working.

Table of contents:

Components

Connections

Set-up/Running the project

Code Structure

References/Credits

Components

Here are all components used in this project:

• Atmel SAM E70 XPLAINED (link)
• OLED1XPLAINEDpro (link)
• 1x BUZZER
• 2x JUMPERS (female-to-female or male-to-female)
• 1x PROTOBOARD (only necessary when jumpers are male-to-female)

Connections

The connection needs to be as the following:

Set-up/Running the project

After connecting the components, the cable must be plugged in the computer USB. To compile the program, the software used is Atmel Studio 7.0, so it needs to be opened in order to run the project.

The buttons, led, buzzer and screen works as the following:

Type	Action	Connection
Button 1	Previous music	PIOD28
Button 2	Play / Pause	PIOC31
Button 3	Next Music	PIA19
Led 1	Lower frequencies	PA0
Led 2	Mid frequencies	PIOC30
Led 3	Higher frequencies	PIOB2
Buzzer	Play frequency	PIOA3 / GND
Screen	Displays music name	---------------

Code Structure

The code structure is expalined below:

📁 screen/

// Files used by OLED display.

📁 include_files/pios.h

// Header file that define all OLED buttons, led and the buzzer PIO`s.

📁 include_files/structures.h

// Header file that define the music struct.
typedef  struct {
...
} Song_to_play;

📁 include_files/musics.h

(all credits)

// Header file that define the musics frequencies and tempo`s.
int mario_main[]
int mario_main_tempo[]
int pirates_of_the_caribean[]
int pirates_of_the_caribean_tempo[]
int underworld_mario[]
int underworld_mario_tempo[]

📁 include_files/frequencies.h

// Header file that define all frequencies.

📁 include_files/init_functions.h

// Header file that define all initial configurations.
void create_songs() { ... } // Create all songs and transform them into structures for function passing
void init(void) { ... } // Clock init, create interruptions, set pio output and input
// Callbacks functions for interruption
void but_next_callback(void){ ... }
void but_prev_callback(void){ ... }
void but_play_callback(void){ ... } 

📁 include_files/core_functions.h

// Header file that define all core and functional functions.
void pause() { ... } // Pause music
void oled_draw(char*  string, int  size) { ... } // Function that display the given string to oled with text centralization
void buzz(int  frequency, int  length, int  max, int  min) { ... } // Make the buzzer play the song frequency and control the LED`s.
void play(Song_to_play  song) { ... } // Play the given song, call buzz() whenever a note needs to be played and pause() whenever the pause button is pressed

📃 asf.h

// Header file that includes all API header files for the selected drivers from ASF.

📃 aps.h

// Header file that includes all include_files/ and screen/ header file.
#include  "include_files/*.h" 

📑 main.c

// c file that control wich core_functions are called, skip, play and return to previous music. Uses the init_functions to create songs and init pio clock
int main(void) {
	init();
	create_songs();
	
	while (1) { ... } // Play, pause, draw, ...
}

References/Credits

🎵 Super Mario Main Theme

by Prince @ princetronics.com

🎵 Pirates of The Caribbean

by Xitang 2016.06.27 @ github

🎵 Underworld Mario

by Prince @ princetronics.com

📃 Code adapted from:

https://www.princetronics.com/supermariothemesong/