Skip to content

Latest commit

 

History

History
executable file
·
198 lines (130 loc) · 7.11 KB

README.md

File metadata and controls

executable file
·
198 lines (130 loc) · 7.11 KB

Garvuino

The Garvuino is a PCB board for creating music, sounds and chiptunes, either through programming, soundtracker or live recording (midi).

It works with an Arduino Nano and an Atmega8 chip.

Manual

You can find the manual here.

Features

AY-3-8910 emulator

On Atmega8 chip, driven by the Arduino nano, from the AVR-AY project

  • It can replay Sinclair ZX Spectrum, Atari ST, Amstrad chiptunes from the sd card.
  • It might be possible to use it as a (very simple and dirty) AY synth. We just need to code the synth in the future.

Sid emulator

On Arduino, from the sid emulator lib

  • It can replay some sid files, from the arduino memory, which is limited (so tunes will be cut). We'd like to find a way to stream the tune from the sd card, it's probably possible.
  • It can be used as a Sid synth, driven by midi.

1-bit music

From various 1-bit engines (on arduino)

  • It can play music from the arduino memory. 1-bit music don't need much memory so a whole song, even a complex one, can fit in the memory. It might be possible to stream data from SD if the 1-bit music engine chosen is the same for all the songs.
  • It should be possible to create a 1-bit synth in the future. Probably not an easy task.

Mozzi synth

  • Mozzy synth, can output fun FM sounds and many other effects.

How does it sound?

AVRAY

Mozzi

SID emulator

Beeper

Bill of Materials

Name                            nb    (optionnal part)
		
Garvuino PCB                     1	
crystal 24 mhz                   1	
arduino nano                     1	
atmega8                          1	
ceramic capacitor 820 pF         2	
electrolytic capac. 10 uF        2	
ceramic capacitor 100 nF         1       x
led                              1       x
DIN5 connector (midi)            1       x
1 kΩ Resistor                    1       x
10 kΩ Resistor                   2	
micro sd module                  1	
momentary switch (6x6mm type)    1	
audio jack 3.5 mm (TRS)          1	
jumper                           6	
female header socket PCB 2.54mm  1
male pin strips 2.54             1
female pin strips 2.54           1

Atmega8 setup

Get a "USBASP USB ISP Programmer & 10 Pin ISP interface Cable - AVR ATMEL ATMega".

Connect it according to this schematic for the atmega8:

Basically it's:

SD reader Atmega
MISO pin 18: PB4
MOSI pin 17: PB3
RESET pin 01: PC6
VCC pin 20: AVCC
SCK pin 19: PB5
GND pin 22: GND

Use a 16 Mhz crystal for example, on pin 09 (PB6) and pin 10 (PB7).

Once it's connected, you can program the atmega8 chip with this command-line:

avrdude -p atmega8 -c USBasp -U flash:w:AY_Emul_244_2ch.hex -U eeprom:w:Conf_standard_24MHz_1_75Mhz.hex -U lfuse:w:0xCE:m -U hfuse:w:0xCF:m 

Please refer to this folder for more info about setting up the atmega8 chip.

PCB

Please refer to this folder for the fritzing sources and gerber files.

Breadboard

It can also work without the PCB. Just use a breadboard and a few wires!

Please refer to this folder for the fritzing sources and pdf version.

Arduino sketches

Get the sketches in this folder

(more infos to come later)

You can find some tunes for using with the AVR-AY setup in here. The arduino sketch can read the RSF files from the SD (it can't read the YM or AY files directly). You can convert to RSF with the AVR-AY Player.

Expansion board

The expansion board is a new board for using with the Garvuino or other projects. Solder 5K or 10K potentiometers onto the board. You don't need to solder the switches, they are not used at the moment.

Connect the digital pin D3 to the audio out, under the L or R of the AY>L or AY>R pin.

And also connect the 2 right top pins and the 3 bottom pins to the A0 to A4 pins on the arduino, connect the + to 5V and the - to ground, and you'll be able to control the Auduino and Auduino midi sketches found there: https://github.com/farvardin/garvuino/tree/master/arduino_sketches/others

Links

Credits

  • Yoruk for his help on the PCB
  • Evgeniy for AVR-AY emulator and invaluable help (initial code by Ramiros)
  • Klaud for help with avr-ay
  • Shiru for the 1-bit engines on Arduino
  • Christoph Haberer and Mario Patino for the Sid-arduino lib
  • The Mozzi team

Licence

This BSD licence is only for the PCB sketch rendition, and code written from scratch. Code derived from other projects retains the original licence. For example Avray is GPLv3.

BSD 3-Clause License
Copyright (c) 2015-2017, Garvalf
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of the <organization> nor the
      names of its contributors may be used to endorse or promote products
      derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.