文件列表:

LICENSE.txt (1064, 2023-12-03)
Register-Summary.md (2373, 2023-12-03)
examples/ (0, 2023-12-03)
examples/AY3891x_EX1_Find_Address/ (0, 2023-12-03)
examples/AY3891x_EX1_Find_Address/AY3891x_EX1_Find_Address.ino (2118, 2023-12-03)
examples/AY3891x_EX2_Test_Registers/ (0, 2023-12-03)
examples/AY3891x_EX2_Test_Registers/AY3891x_EX2_Test_Registers.ino (1593, 2023-12-03)
examples/AY3891x_EX3_Simple_Tone/ (0, 2023-12-03)
examples/AY3891x_EX3_Simple_Tone/AY3891x_EX3_Simple_Tone.ino (3437, 2023-12-03)
examples/AY3891x_EX4_IO_Ports/ (0, 2023-12-03)
examples/AY3891x_EX4_IO_Ports/AY3891x_EX4_IO_Ports.ino (1952, 2023-12-03)
examples/AY3891x_EX5_Serial_Commands/ (0, 2023-12-03)
examples/AY3891x_EX5_Serial_Commands/AY3891x_EX5_Serial_Commands.ino (13910, 2023-12-03)
examples/AY3891x_EX6_Chiptunes_Flash/ (0, 2023-12-03)
examples/AY3891x_EX6_Chiptunes_Flash/AY3891x_EX6_Chiptunes_Flash.ino (2895, 2023-12-03)
examples/AY3891x_EX6_Chiptunes_Flash/chiptunes.h (288, 2023-12-03)
examples/AY3891x_EX7_Chiptunes_SD/ (0, 2023-12-03)
examples/AY3891x_EX7_Chiptunes_SD/AY3891x_EX7_Chiptunes_SD.ino (6106, 2023-12-03)
extras/ (0, 2023-12-03)
extras/hardware/ (0, 2023-12-03)
extras/hardware/ChiptunesPlayer-Bottom.jpg (332135, 2023-12-03)
extras/hardware/ChiptunesPlayer-Top.jpg (261848, 2023-12-03)
extras/tools/ (0, 2023-12-03)
extras/tools/bin2c14.py (773, 2023-12-03)
library.properties (472, 2023-12-03)
src/ (0, 2023-12-03)
src/AY3891x.cpp (9839, 2023-12-03)
src/AY3891x.h (2637, 2023-12-03)
... ...

# AY3891x Library [](https://github.com/Andy4495/AY3891x/actions/workflows/arduino-compile-sketches.yml) [](https://github.com/Andy4495/AY3891x/actions/workflows/CheckMarkdownLinks.yml) [](https://github.com/Andy4495/AY3891x/actions/workflows/arduino-lint.yml) Arduino library and chiptunes player for General Instrument AY-3-8910 / AY-3-8912 Programmable Sound Generator (PSG) chip, including clones like the YM2149. The AY-3-8910 and AY-3-8912 have the same programming interface. The 8910 has two 8-bit I/O ports and the 8912 has a single 8-bit I/O port (and correspondingly fewer pins). These general purpose I/O pins are not related to the sound generation functions. This library has only been tested with the 8910 variant of the chip, but should also work with the 8912. The AY-3-8913 variant has a different programming interface which uses a Chip Select signal. *The 8913 variant is not currently supported by the library. A future iteration of this library may include support.* Note that other libraries and PSG-related projects typically discuss the need to use fast pin switching in order to meet the strict signal timing requirements when using the PSG, meaning that they don't use the slower, platform-agnostic `digitalWrite()` function. This ends up creating non-portable, processor specific code. While the PSG has tight timing requirements, it is possible to still use `digitalWrite()` by cycling through an extra state when reading and writing the chip registers. This library uses the generic `digitalWrite()` function instead of direct port manipulation, and should therefore work across most, if not all, processors supported by the Arduino and Energia IDEs, so long as enough I/O pins are available for the interface to the PSG. There are several [variants][3] of the chip from other manufacturers, including the Yamaha YM2149F and YM3439 and Toshiba T7766A. The YM2149F has been tested with this library. The other variants are probably compatible but have not been tested. I created an Arduino-AY38910 chiptunes player board; see the [README][9] in the `extras/hardware` folder. ## Usage *Refer to the sketches in the `examples` folder.* 1. Include the library header file: ```C++ #include "AY3891x.h" ``` 2. (optional) Include definitions for eight octaves of musical notes: ```C++ #include "AY3891x_sounds.h" ``` It is not strictly necessary to use this header file, but you can include it to make playing notes a little easier. If you aren't using it, then it will save a little flash memory by not including the file. It is used by example programs 3 and 5. Note that as of version 1.1.0 of the library, the `Notes[]` array in AY3891x_sounds.h is defined as `PROGMEM`. This will require minor changes to any sketches which include this file and use the `Notes[]` array. See example programs 3 and 5. 3. Instantiate the object. There are two forms of the constructor. The first one supports all of the chip's interface pins. The second one allows for a slightly simplified format when using only the minimal pins necessary to interface with the chip. ```C++ AY3891x(byte DA7, byte DA6, byte DA5, byte DA4, byte DA3, byte DA2, byte DA1, byte DA0, byte BDIR, byte BC2, byte BC1, byte A9, byte A8, byte reset, byte clock); ``` ```C++ AY3891x(byte DA7, byte DA6, byte DA5, byte DA4, byte DA3, byte DA2, byte DA1, byte DA0, byte BDIR, byte BC2, byte BC1); ``` ```C++ // Example constructor using the simpler form AY3891x psg(4, 5, 6, 7, 8, 10, 11, 12, 2, A5, 3); ``` Use the enumeration `AY3891x::NO_PIN` if any of the pins required by the constructor are not connected. 4. Initialize the object. ```C++ psg.begin(); ``` 5. Use the read() and write() methods to program the chip: ```C++ psg.write(AY3891x::Enable_Reg, 0x3F); psg.read(AY3891x::IO_Port_A_Reg; ``` 6. See the library source code and example sketches for other available methods and usage. ## Example Sketches *NOTE: While the library itself does not use any platform-specific code, the examples that generate tones (EX3, EX5, EX6, EX7) have platform-specific code to generate the `CLOCK` signal required by the sound generator chip. If you are using an ATmega329 or ATmega32u4 chip, then the examples should run as-is. For other chips, consult the respective datasheet or connect an externally-generated clock signal to the sound generator chip and update the example code accordingly.* **EX1 - Find Address** The AY-3-8910 chip typically has a binary address of `01 0000 xxxx`, where `xxxx` represents the specific register you are addressing. It is possible to request a different mask-programmed address from the factory. This example code determines the chip's address by writing a value to one of the chip's registers and reads it back to see if it matches. If it matches, then we found the address. If not, then the next address is checked. **EX2 - Test Registers** Writes a value to each of the chip's registers and reads it back to see if it matches. **EX3 - Simple Tone** This sketch will play through the middle-octave notes C4 to C5. Note that an external clock is required for the chip's audio functions to work. This can be [generated by the microcontroller][2] or other hardware clock circuit. **EX4 - I/O Ports** This sketch demonstrates the use of the I/O ports on the AY-3-8910 or -8912. **EX5 - Serial Commands** This sketch allows you to send commands to the AY-3-891x chip through the serial port. It makes it easy to experiment with the various sound generation capabilities of the chip. This example depends on the [SerialCommands][10] library. **EX6 - Chiptunes Flash** This examples plays a converted YM file which is compiled into the program as a byte array of the data values to write to the 14 audio registers on the sound chip. Since the audio data is compiled into the program, there is a relatively small limit on the duration of the chiptune to be played. The sketch itself takes 1632 bytes, leaving about 29,000 bytes on an Atmega328. Fourteen bytes of data are written 50 times a second, meaning that the largest data array can store about 41 seconds of music. See this [README][6] for details on finding and converting YM files for use with this sketch. **EX7 - Chiptunes SD** This example sketch plays YM files which are stored on an SD card. The sketch sequentially goes through each file in the root directory. Press the button defined as `NEXT_BUTTON` to advance to the next song on the card. See this [README][6] for details on finding and converting YM files for use with this sketch. ## YouTube Videos My library was featured in two YouTube videos by [Gadget Reboot][11]: - [AY-3-8910 Sound Generator with Arduino][13] - [AY-3-8910 Sound Generator with Arduino Nano - How it Works][14] ## References - AY-3-891x [datasheet][1] - Chiptunes player board [hardware design][9] - Details on [finding and converting][6] YM files for use with the example sketches - Info from the Synth DIY [wiki][4] - [Summary][5] of the registers (simplified info from datasheet) - YMduino [code][8] which provided inspiration for chiptunes example sketches 6 and 7 - Associated [GitHub repo][15] for the YouTube videos mentioned [above](#youtube-videos) ## License The software and other files in this repository are released under what is commonly called the [MIT License][100]. See the file [`LICENSE.txt`][101] in this repository. [1]: http://map.grauw.nl/resources/sound/generalinstrument_ay-3-8910.pdf [2]: https://www.instructables.com/Arduino-MIDI-Chiptune-Synthesizer/ [3]: https://en.wikipedia.org/wiki/General_Instrument_AY-3-8910#Variants [4]: https://sdiy.info/wiki/General_Instrument_AY-3-8910 [5]: ./Register-Summary.md [6]: ./extras/tools/README.md [8]: https://github.com/eqy/ymduino [9]: ./extras/hardware/README.md [10]: https://github.com/ppedro74/Arduino-SerialCommands [11]: https://www.youtube.com/@GadgetReboot/about [13]: https://www.youtube.com/watch?v=b8uAda926so [14]: https://www.youtube.com/watch?v=x9Ac49FLJ0c [15]: https://github.com/GadgetReboot/AY-3-8910 [100]: https://choosealicense.com/licenses/mit/ [101]: ./LICENSE.txt [//]: # ([200]: https://github.com/Andy4495/AY3891x) [//]: # (Dead link from older version of README: ymduino project page https://homes.cs.washington.edu/~eqy/ymduino.html)

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：