AVR Butterfly MP3 Player

File Release Notes and Changelog

Release Name: 0.5

Notes:
ButterflyMP3 0.5 20060428 - FIRMWARE
====================================

This firmware is intended with REV_D hardware but may be adapted to use other 
(earlier) arrangements by altering the appropriate header files. 
For any issues with getting the necesarry hardware see the HW distribution.

NOTE!! I have changed the makefile operation in this release in order to 
streamline producing builds for different hardware. The defines for different 
displays are no longer specified in main.h but are written in the command line 
of the make command. See below for more details

If you've built the hardware correctly then all you need to do is load up the 
butterfly with the hex file via the bootloader and AVRprog (JTAG, ISP or your 
favourite AVR programmer will also work) and you'll be away.

Most of the firmware was originally based on the work of Jesper Hansen. 
My adaptions have been made to make it work on the butterfly without any 
external ram and with FAT16. FAT16 and root directory ONLY are supported.


WHATS NEW

New Makefile operation:
Now instead of editing main.h and the makefile to build for different display 
options you simply specify the display in the make command line. If now display 
is specified it defaults to NOKIA. An example of typical command lines is given 
below:
	make clean all			(make default display version)
	make "LCD=ALPHA" clean all	(make original display version)
	make "LCD=NOKIA" clean all	(make Nokia 3310 display version)
	make "LCD=NO_DISPLAY" clean all	(make no display version)

Support for alternative pinout LCD:
I have added code to support an alternative wiring of the graphical lcd.
This version is implemented in the "butterfly to nokia" LCD adaptor PCB 
available from the files section of the Source Forge page.

New Graphics for the Nokia version:
Rich has revamped the whole display for the graphical version making it much 
cleaner and sensible than the original basic "proof of concept" style I had 
going.

ID3 Tags:
Rich has added code to use ID3 information and display the song name. On the 
graphical LCD version the artist name is also displayed as well as curent play 
time.

There may be other minor differences, please check the logs for more details.

These and other features can be controlled by setting appropriate definitions in 
main.h. Please see the webpage for more details.


Current Joystick operation:

center	play / pause
Left 	previous song
Right	next Song
Up		volume up 
Up 		toggle Bass boost ( when paused)	
Up		power up (when in powerdown / bootloader mode)
Down 	volume down
Down 	power down (When paused or stopped only)
Down	save player state and jump to bootloader. (When powered down only)


Current consumption is about 20mA when idle and up to 50mA when playing.
Standby/power off mode is approx 1~2mA.

Monitor the serial output for debugging info @ 38400, 8N1

Tested current code with mp3s @ 128kbps, 160kbps, 192kbps & 320kbps

Your feature requests and comments are most welcome. 

See http://butterflymp3.sourceforge.net/ and 
http://www.sourceforge.net/projects/butterflymp3 for futher details.

brokentoaster@users.sf.net


Changes:
BUTTERFLYMP3 Change Log
=======================

+ addition
- removed code
~ changed code operation
! Bug discovered
* Bug Fixed
. Note

VERSION 0.5

27 Mar
+	Added support for alternative pinout to NOKIA LCD this is doen by defining 
	NOKIA_ALTPINOUT in pcd8544.h
	
22 Mar
+	Added very basic Directory support
!	Directory support doesn't work yet.

6 Mar
+	new variables in makefile use 'make "LCD=ALPHA" clean all' to build.
.	LCD=NOKIA by default, LCD=NO_DISPLAY also available

5 Mar
+	Added Richs update to the NOKIA code
+	Added Rich's ID3 code
~	Volume is only adjusted during playback
*	Fixed play without mmc bug
*	Fixed startup lcd bug (ALPHA)