TuneStudio2560 Reference Site

TuneStudio2560 allows the user editing of files on the SD card by individually editing every .txt file in the root "/" directory.
Want to create and edit songs in a user friendly GUI instead (Website)? Recommended

>> Check out the interactive MakerStudio2560 <<

The changelog shows all changes for major releases in TuneStudio2560.
Each public release is shown by an "R" and then a number. Ex: Public release 1 is R1.
The version is shown by the 1.X.X which shows the iteration (major.iterations since last major update.minor)

Major Iterations:
Represent signifigant changes in the program.
Major changes usually bring many additions and functions.

Minor Iterations:
Small fixes to the code.
Sometimes things are added but it minor iterations are usually bug fixes and code optimizations.
If there is a signifigant amount of minor iterations then a new release will be made.

• First Offical Release! 🎉

• Moved custom lcd characters into one PROGMEM array.
• Global variable renaming.
• Code Syntax Format.
• Optimized song class get_size() method to be much faster.
• Removed unused variables from song class.
• Moved delay, LiquidCrystal_I2C object, and SevSegShift object from inline to local reference.
• Optimized print_lcd and print_scrolling methods to be much more efficient.
• print_lcd and print_scrolling methods now use much less ram (stack ram in use) and only read char by char instead of copying from PROGMEM.
• General conditional branching optimizations in CreatorModeCreateNew class.
• Added new library for fast pinMode, digitalWrite, and digitalRead.
• Combined previous repeating print_lcd functions into one by combing large PROGMEM strings and allowing print_lcd to read \n characters to clear the display.
• Condensed sd_make_readme() to be much smaller in code size.
• General variable caching optimizations in CreatorModeCreateNew class.
• Optimized get_current_tone() method to be smaller and more efficient.
• analogWrite() has been replaced with digitalWrite() for when PRGM_MODE is set to 0 (smaller program size when PRGM_MODE = 0).
• Faster ADC (analogRead) performance due to new macros. (+30 Bytes for 4-5x faster analogRead performance, increases speed of CreatorModeCreateNew by 300-400 IPS)
• Added new library for fast and small tone() and noTone() functions.
• PERF_METRICS now has additional readouts in loop() function.
  Will now display microseconds per loop, SRAM consumption, free ram %, clock cycles for the previous iteration, and iterations per second (IPS).

• Converted strcpy_P to (__FlashStringHelper*) where applicable.
• Optimized ListeningModeMenu program state to be smaller.
• Optimized clear() method for song.cpp to use memset instead of for loop.
• Added additional Serial outs when DEBUG macro is enabled.
• Deleted select_btn_click and cancel_btn_click interrupts and replaced them with a single isr_btn_handle() method.
• General method optimizations in the main class.
• Added checks for PRGM_MODE to reduce program size when PRGM_MODE == 0. (README no longer prints in full for example)
• MAJOR Changed functionallity of how Songs are referenced and work in the program.
  Click to view developer comments.

  Songs are no longer dynamically allocated and deleted with pointers, rather a new prgmSong global variable is used as a sort of buffer to store the current song and use it.
  When finished, the song should have clear() applied to it instead of delete.
  This was done to prevent future heap fragmentation problems as well as to give the programmer a better idea of available RAM when the program first compiles.
  The size of the songs are now determined strictly by the MAX_SONG_LENGTH constant (at compile time) and the Song object now uses a C++ template to communicate size.

• MAJOR Moved PROGRAM_NOTES pitches string data from RAM to PROGMEM.
  Click to view developer comments.

  Moved all of the cstring data from RAM to PROGMEM which was previously present in PROGRAM_NOTES global array.
  Previously, only the array structure itself and the string pointers were stored into PROGMEM, the actual string data (like "FS2") was not.
  This addition allows a large chunk of SRAM to become free to use (now 1511 bytes) and it also means that the maximum SRAM usage (under PRGM_MODE==0) is now less then 2KB at any point in time.
  All of the PROGMEM string data was split into individual variables and moved into pitches.h file.
  A new method const char* pgm_pcpyr(uint8_t btnIndex, uint8_t noteIndex) is now responsible for retrieving the pitch data directly from PROGMEM.

• These optimizations mean SRAM utilization during execution is now below 2KB at any point in time meaning a potential Arduino Uno port has officially become possible.

• Added Doxygen compaitble comments.
• [WEB] Updated Website, Released MakerStudio2560, Doxygen Website, and Product Brief.
• Drastically improved comments and documentation.
• LED now blinks green on startup depending on program mode.
• Optimized sd_get_file to be much smaller.
• Optimized print_read_me.
• CreatorMode now removes [SONG] header when the top text bar is getting too long.
• Fixed errors when saving some songs.
• Optimized deletion when using lm_playing_song
• MAJOR Changed SD library from SD.h to SdFat.h
  Click to view developer comments.

  From now on the application will now use the more modern SdFat library for communication with the SD module.
  This new library allows us to adjust the MHz of the SPI bus as well.
  The new library shows a considerable performance improvement and is much smaller and less demanding then the old library.

• Fixed bug where editing an SD card on a PC would sometimes break the song.
• Fixed a bug where songs made or edited in MakerStudio2560 would not work on the Arduino (Invalid Song error).
• Fixed a bug where the selected song and selected page would not reset after a user deleted a song or loaded an invalid song in ListeningMode.
• Fixed a bug where attempting to name a saved song would exit shortly after the screen is loaded.
• Fixed a bug where skipping the listening mode instructions would sometimes make additional characters appear on the Listening Mode song select
• Minor size optimizations.
• delay_ms now uses an asm("nop") instead of continue.
• Added new option for PRGM_MODE 1 and PRGM_MODE 2 where the accuracy of the progress bar has been greatly improved due to the use of 32-bit floating point values (float). Does not work on PRGM_MODE==0.

1. Reduce SRAM by moving cstrings from PROGRAM_NOTES to PROGMEM.
2. Create a Cross-Platform desktop application that allows for the ease of use when adding/removing/editing notes from songs.
3. Continue flash and memory optimizations.
4. Use optimized SD card library.
5. Port TuneStudio2560 to more boards (including ARM).
6. Update website with pictures and video.
7. Create Doxygen documentation.
8. Update README to use HTML attributes and be cleaner.
9. Add ability for user to adjust pause length in song as well as have an option for each note to have a specific pause length via syntax such as (FS2::50) with 50 being the ms to delay for.
10. To be continued...