Readme.txt 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. /*******************************************************************
  2. * MYM Player to Serial port *
  3. * (c) 2014 Manoel "Godzil" Trapier *
  4. *******************************************************************/
  5. First for the format 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 wan't 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. The 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 plug
  28. something to ear the nice sound, an Arduino and a buch of wire,
  29. nothing more.
  30. Most project I saw before was using a quartz to provide a clock to
  31. the AY, but this is just useless and expensive when you have a µC
  32. with timers :)
  33. As the Arduino does not have enought memory to store teh YM file,
  34. it is somewhat streamed from the PC trought the USB cable.
  35. A Fritzing schematic is not ready yet but will come ASAP.
  36. This project may evolve in a fully autonoous Arduino capable of playing
  37. YM/MYM file without the need of a PC streaming. I may use the
  38. Gameduino2 for it's the display and SD part.
  39. More information on this project can be found here:
  40. http://www.986-studio.com/category/electronic/ay-3-3910/
  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