GithubHelp home page GithubHelp logo

fivefishstudios / ym3812_vgm_player Goto Github PK

View Code? Open in Web Editor NEW

This project forked from aidanhockey5/ym3812_vgm_player

0.0 1.0 0.0 4.23 MB

A Video Game Music player based on the YM3812 (OPL2) and Teensy 3.5

License: GNU Affero General Public License v3.0

C++ 100.00%

ym3812_vgm_player's Introduction

YM3812_VGM_Player

A Video Game Music player based on the YM3812 (OPL2) and Teensy 3.5.

You can view this project in action here: https://www.youtube.com/watch?v=aLaUDFnNqQc

Information about the main sound chips and VGM

The YM3812, AKA OPL2 was a staple FM soundchip of the early 1990's. It claim to fame was its inclusion on the Adlib and Soundblaster soundcards. OPL2 is THE FM sound of 1990's PC gaming.

VGM stands for Video Game Music, and it is a 44.1KHz logging format that stores real soundchip register information. My player will parse these files and send the data to the appropriate chips. You can learn more about the VGM file format here: http://www.smspower.org/Music/VGMFileFormat

http://www.smspower.org/uploads/Music/vgmspec170.txt?sid=58da937e68300c059412b536d4db2ca0

Hook-up Guide

Teensy 3.5 YM
23, 22, 21...17, 16 D0-D7
34 CS
33 RD
32 WR
31 A0
30 IC
29 IRQ

The YM3812 requires a 3.579545 MHz signal to function properly. I just used a full-can crystal for this, but any clock source of that speed will work. You will also need a Y3014B DAC IC along with an OP-amp (LM358).

SD Card Information

The Teensy 3.5 has a built-in, high speed micro-SD card reader. You must format your SD card to Fat32 in order for this device to work correctly. Your SD card must only contain uncompressed .vgm files. VGZ FILES WILL NOT WORK! You may download .vgz files and use 7zip to extract the uncompressed file out of them. Vgm files on the SD card do not need to have the .vgm extension. As long as they contain valid, uncompressed vgm data, they will be read by the program regardless of their name. You can find VGM files by Googling "myGameName VGM," or by checking out sites like http://vgmrips.net/packs/

Control Over Serial

You can use a serial connection to control playback features. The commands are as follows:

Command Result
+ Next Track
- Previous Track
* Random Track
/ Toggle Shuffle Mode
. Toggle Song Looping
r: Request song

A song request is formatted as follows: r:mySongFile.vgm Once a song request is sent through the serial console, an attempt will be made to open that song file. The file must exist on the Teensy's SD card, and spelling/capitalization must be correct. Need an easy-to-use serial console? I've made one here.

Schematic

Schematic

PDF

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.