Imported from GitHub: sparkletron/PICerino_SN76489 · commit e9f56a9 · license MIT

Description

Test board and software library for SN76489 sound chip

README

SN76489 Sound IC library

Software Library for TI SN76489 sound chips.

author: Jay Convertino

data: 2022.01.31

license: MIT

Release Versions

Current

• release_v0.0.1

Past

• none

Requirements

• xc8-cc V2.32
• PIC18F45K50 (MCU can be changed in makefile)
• PICerino development board

Building

• make : builds all
• make dox_gen : doxygen only
• make test : test only
• make libSN76489.a : static library only
• make clean : remove all build outputs.

Documentation

• See doxygen generated document
• Method for ready check is universal, NOT efficent. Optimize send data for your application!

Example Code

void main(void) 
{
  struct s_sn76489 sn76489;

  /* OSCCON SETUP */
  OSCCONbits.IRCF = 0x7;
  OSCCONbits.OSTS = 0;
  OSCCONbits.SCS  = 0x3;

  OSCCON2bits.PLLEN = 1;

  /* PORT E SETUP */
  INTCON2bits.nRBPU = 1;

  /* disable analog inputs */
  ANSELA = 0;
  ANSELC = 0;
  ANSELD = 0;
  ANSELE = 0;

  /* wait for chip to be ready */
  __delay_ms(10);

  initSN76489port(&sn76489, &TRISA, &TRISD, &TRISC, 6, 7, 0);

  /* mutes all channels as default */
  initSN76489(&sn76489, &LATA, &LATD, &PORTC);

  /* voice one freq */
  
  /* set attenuation */
  setSN76489voice_attn(&sn76489, 1, 2);
  
  /* set frequency to 440 hz */
  setSN76489voice_freq(&sn76489, 1, 254);
  
  /* play this lovely tune forever */
  for(;;);
  
}