Readme.txt 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. /*******************************************************************
  2. * MYM Player to Serial port *
  3. * (c) 2014 Manoel "Godzil" Trapier *
  4. *******************************************************************/
  5. First for the formal things, this project is licensed under the
  6. WTFPL v2 Postal Card Edition:
  7. DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
  8. Version 2, December 2004
  9. Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
  10. Everyone is permitted to copy and distribute verbatim or modified
  11. copies of this license document, and changing it is allowed as long
  12. as the name is changed.
  13. DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
  14. TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  15. 0. You just DO WHAT THE FUCK YOU WANT TO.
  16. 1. If you like this software you can send me a (virtual) postals
  17. card. Details bellow:
  18. < godzil-nospambot at godzil dot net >
  19. If you want to send a real postal card, send me an email, I'll
  20. give you my address. Of course remove the -nospambot from my
  21. e-mail address.
  22. *********************************************************************
  23. Now the formal things are done.
  24. This small project is to provide a simple and easy way to play YM
  25. files on a computer using the less possible component.
  26. It is currently only using a resistor, a AY-3-3910 (but any version
  27. is fine for playing music), a femal audio jack connector to let you
  28. ear the nice sound, an Arduino, a buch of wire, and nothing more.
  29. Most project I saw before was using a quartz to provide a clock to
  30. the AY, but this is just useless and expensive when you have a µC
  31. with timers :)
  32. As the Arduino does not have enought memory to store the YM file,
  33. it is stream from the PC trought the USB virtual serial port.
  34. You can find a Fritzing schematic in the file
  35. project-ay-3-3910-breadboard.png
  36. This project may evolve in a fully autonomous Arduino capable of
  37. playing YM/MYM file without the need of a PC. I may use the
  38. Gameduino2 for its display and SD connector.
  39. More information on this project can be found here:
  40. http://www.986-studio.com/category/electronic/ay-3-8910/
  41. *********************************************************************
  42. I've included a simple MYM file with this project: Thrust.mym
  43. It's the Title music of the game Thrust on the Atari ST, music
  44. composed by Rob Hubbard.
  45. To convert ym to mym I recommend the ym2mym tool that come with the
  46. OSDK (Oric SDK) that can be found here: http://osdk.defence-force.org
  47. Enjoy!
  48. Godzil / Manoel