xref: /qemu/hw/audio/fmopl.h (revision 72ac97cd)
1 #ifndef __FMOPL_H_
2 #define __FMOPL_H_
3 
4 /* --- select emulation chips --- */
5 #define BUILD_YM3812 (HAS_YM3812)
6 //#define BUILD_YM3526 (HAS_YM3526)
7 //#define BUILD_Y8950  (HAS_Y8950)
8 
9 /* --- system optimize --- */
10 /* select bit size of output : 8 or 16 */
11 #define OPL_OUTPUT_BIT 16
12 
13 /* compiler dependence */
14 #ifndef OSD_CPU_H
15 #define OSD_CPU_H
16 typedef unsigned char	UINT8;   /* unsigned  8bit */
17 typedef unsigned short	UINT16;  /* unsigned 16bit */
18 typedef unsigned int	UINT32;  /* unsigned 32bit */
19 typedef signed char		INT8;    /* signed  8bit   */
20 typedef signed short	INT16;   /* signed 16bit   */
21 typedef signed int		INT32;   /* signed 32bit   */
22 #endif
23 
24 #if (OPL_OUTPUT_BIT==16)
25 typedef INT16 OPLSAMPLE;
26 #endif
27 #if (OPL_OUTPUT_BIT==8)
28 typedef unsigned char  OPLSAMPLE;
29 #endif
30 
31 
32 #if BUILD_Y8950
33 #include "ymdeltat.h"
34 #endif
35 
36 typedef void (*OPL_TIMERHANDLER)(int channel,double interval_Sec);
37 typedef void (*OPL_IRQHANDLER)(int param,int irq);
38 typedef void (*OPL_UPDATEHANDLER)(int param,int min_interval_us);
39 typedef void (*OPL_PORTHANDLER_W)(int param,unsigned char data);
40 typedef unsigned char (*OPL_PORTHANDLER_R)(int param);
41 
42 /* !!!!! here is private section , do not access there member direct !!!!! */
43 
44 #define OPL_TYPE_WAVESEL   0x01  /* waveform select    */
45 #define OPL_TYPE_ADPCM     0x02  /* DELTA-T ADPCM unit */
46 #define OPL_TYPE_KEYBOARD  0x04  /* keyboard interface */
47 #define OPL_TYPE_IO        0x08  /* I/O port */
48 
49 /* Saving is necessary for member of the 'R' mark for suspend/resume */
50 /* ---------- OPL one of slot  ---------- */
51 typedef struct fm_opl_slot {
52 	INT32 TL;		/* total level     :TL << 8            */
53 	INT32 TLL;		/* adjusted now TL                     */
54 	UINT8  KSR;		/* key scale rate  :(shift down bit)   */
55 	INT32 *AR;		/* attack rate     :&AR_TABLE[AR<<2]   */
56 	INT32 *DR;		/* decay rate      :&DR_TALBE[DR<<2]   */
57 	INT32 SL;		/* sustin level    :SL_TALBE[SL]       */
58 	INT32 *RR;		/* release rate    :&DR_TABLE[RR<<2]   */
59 	UINT8 ksl;		/* keyscale level  :(shift down bits)  */
60 	UINT8 ksr;		/* key scale rate  :kcode>>KSR         */
61 	UINT32 mul;		/* multiple        :ML_TABLE[ML]       */
62 	UINT32 Cnt;		/* frequency count :                   */
63 	UINT32 Incr;	/* frequency step  :                   */
64 	/* envelope generator state */
65 	UINT8 eg_typ;	/* envelope type flag                  */
66 	UINT8 evm;		/* envelope phase                      */
67 	INT32 evc;		/* envelope counter                    */
68 	INT32 eve;		/* envelope counter end point          */
69 	INT32 evs;		/* envelope counter step               */
70 	INT32 evsa;	/* envelope step for AR :AR[ksr]           */
71 	INT32 evsd;	/* envelope step for DR :DR[ksr]           */
72 	INT32 evsr;	/* envelope step for RR :RR[ksr]           */
73 	/* LFO */
74 	UINT8 ams;		/* ams flag                            */
75 	UINT8 vib;		/* vibrate flag                        */
76 	/* wave selector */
77 	INT32 **wavetable;
78 }OPL_SLOT;
79 
80 /* ---------- OPL one of channel  ---------- */
81 typedef struct fm_opl_channel {
82 	OPL_SLOT SLOT[2];
83 	UINT8 CON;			/* connection type                     */
84 	UINT8 FB;			/* feed back       :(shift down bit)   */
85 	INT32 *connect1;	/* slot1 output pointer                */
86 	INT32 *connect2;	/* slot2 output pointer                */
87 	INT32 op1_out[2];	/* slot1 output for selfeedback        */
88 	/* phase generator state */
89 	UINT32  block_fnum;	/* block+fnum      :                   */
90 	UINT8 kcode;		/* key code        : KeyScaleCode      */
91 	UINT32  fc;			/* Freq. Increment base                */
92 	UINT32  ksl_base;	/* KeyScaleLevel Base step             */
93 	UINT8 keyon;		/* key on/off flag                     */
94 } OPL_CH;
95 
96 /* OPL state */
97 typedef struct fm_opl_f {
98 	UINT8 type;			/* chip type                         */
99 	int clock;			/* master clock  (Hz)                */
100 	int rate;			/* sampling rate (Hz)                */
101 	double freqbase;	/* frequency base                    */
102 	double TimerBase;	/* Timer base time (==sampling time) */
103 	UINT8 address;		/* address register                  */
104 	UINT8 status;		/* status flag                       */
105 	UINT8 statusmask;	/* status mask                       */
106 	UINT32 mode;		/* Reg.08 : CSM , notesel,etc.       */
107 	/* Timer */
108 	int T[2];			/* timer counter                     */
109 	UINT8 st[2];		/* timer enable                      */
110 	/* FM channel slots */
111 	OPL_CH *P_CH;		/* pointer of CH                     */
112 	int	max_ch;			/* maximum channel                   */
113 	/* Rhythm sention */
114 	UINT8 rhythm;		/* Rhythm mode , key flag */
115 #if BUILD_Y8950
116 	/* Delta-T ADPCM unit (Y8950) */
117 	YM_DELTAT *deltat;			/* DELTA-T ADPCM       */
118 #endif
119 	/* Keyboard / I/O interface unit (Y8950) */
120 	UINT8 portDirection;
121 	UINT8 portLatch;
122 	OPL_PORTHANDLER_R porthandler_r;
123 	OPL_PORTHANDLER_W porthandler_w;
124 	int port_param;
125 	OPL_PORTHANDLER_R keyboardhandler_r;
126 	OPL_PORTHANDLER_W keyboardhandler_w;
127 	int keyboard_param;
128 	/* time tables */
129 	INT32 AR_TABLE[75];	/* atttack rate tables */
130 	INT32 DR_TABLE[75];	/* decay rate tables   */
131 	UINT32 FN_TABLE[1024];  /* fnumber -> increment counter */
132 	/* LFO */
133 	INT32 *ams_table;
134 	INT32 *vib_table;
135 	INT32 amsCnt;
136 	INT32 amsIncr;
137 	INT32 vibCnt;
138 	INT32 vibIncr;
139 	/* wave selector enable flag */
140 	UINT8 wavesel;
141 	/* external event callback handler */
142 	OPL_TIMERHANDLER  TimerHandler;		/* TIMER handler   */
143 	int TimerParam;						/* TIMER parameter */
144 	OPL_IRQHANDLER    IRQHandler;		/* IRQ handler    */
145 	int IRQParam;						/* IRQ parameter  */
146 	OPL_UPDATEHANDLER UpdateHandler;	/* stream update handler   */
147 	int UpdateParam;					/* stream update parameter */
148 } FM_OPL;
149 
150 /* ---------- Generic interface section ---------- */
151 #define OPL_TYPE_YM3526 (0)
152 #define OPL_TYPE_YM3812 (OPL_TYPE_WAVESEL)
153 #define OPL_TYPE_Y8950  (OPL_TYPE_ADPCM|OPL_TYPE_KEYBOARD|OPL_TYPE_IO)
154 
155 FM_OPL *OPLCreate(int type, int clock, int rate);
156 void OPLDestroy(FM_OPL *OPL);
157 void OPLSetTimerHandler(FM_OPL *OPL,OPL_TIMERHANDLER TimerHandler,int channelOffset);
158 void OPLSetIRQHandler(FM_OPL *OPL,OPL_IRQHANDLER IRQHandler,int param);
159 void OPLSetUpdateHandler(FM_OPL *OPL,OPL_UPDATEHANDLER UpdateHandler,int param);
160 /* Y8950 port handlers */
161 void OPLSetPortHandler(FM_OPL *OPL,OPL_PORTHANDLER_W PortHandler_w,OPL_PORTHANDLER_R PortHandler_r,int param);
162 void OPLSetKeyboardHandler(FM_OPL *OPL,OPL_PORTHANDLER_W KeyboardHandler_w,OPL_PORTHANDLER_R KeyboardHandler_r,int param);
163 
164 void OPLResetChip(FM_OPL *OPL);
165 int OPLWrite(FM_OPL *OPL,int a,int v);
166 unsigned char OPLRead(FM_OPL *OPL,int a);
167 int OPLTimerOver(FM_OPL *OPL,int c);
168 
169 /* YM3626/YM3812 local section */
170 void YM3812UpdateOne(FM_OPL *OPL, INT16 *buffer, int length);
171 
172 void Y8950UpdateOne(FM_OPL *OPL, INT16 *buffer, int length);
173 
174 #endif
175