156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/*---------------------------------------------------------------------------- 256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * 356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * File: 456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * eas_fmengine.h 556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * 656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * Contents and purpose: 756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * Declarations, interfaces, and prototypes for FM synthesize low-level. 856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * 956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * Copyright Sonic Network Inc. 2004 107df30109963092559d3760c0661a020f9daf1030The Android Open Source Project 117df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 127df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * you may not use this file except in compliance with the License. 137df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * You may obtain a copy of the License at 147df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * 157df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 167df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * 177df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 187df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 197df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 207df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * See the License for the specific language governing permissions and 217df30109963092559d3760c0661a020f9daf1030The Android Open Source Project * limitations under the License. 2256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * 2356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks *---------------------------------------------------------------------------- 2456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * Revision Control: 2556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * $Revision: 664 $ 2656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks * $Date: 2007-04-25 13:11:22 -0700 (Wed, 25 Apr 2007) $ 2756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks *---------------------------------------------------------------------------- 2856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks*/ 2956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 3056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* sentinel */ 3156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#ifndef _FMENGINE_H 3256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define _FMENGINE_H 3356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 3456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* check for split architecture */ 3556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#if defined (EAS_SPLIT_HYBRID_SYNTH) || defined(EAS_SPLIT_FM_SYNTH) 3656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FM_OFFBOARD 3756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#endif 3856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 3956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* output level to mix buffer (3 = -24dB) */ 4056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FM_GAIN_SHIFT 3 4156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FM_MONO_GAIN_SHIFT 9 4256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 4356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* voice output level for stereo 15 = +6dB */ 4456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FM_STEREO_PRE_GAIN_SHIFT 11 4556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FM_STEREO_POST_GAIN_SHIFT 10 4656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 4756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* modulator input level shift (21 = -30dB) */ 4856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FM_MODULATOR_INPUT_SHIFT 21 4956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 5056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* feedback control level shift (7 = 0dB) */ 5156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FM_FEEDBACK_SHIFT 7 5256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 5356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* synth final output level */ 5456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define SYNTH_POST_GAIN_SHIFT 14 5556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 5656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* LFO modulation to gain control */ 5756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FM_LFO_GAIN_SHIFT 12 5856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 5956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* sine table is always a power of 2 - saves cycles in inner loop */ 6056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define SINE_TABLE_SIZE_IN_BITS 11 6156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define SINE_TABLE_SIZE 2048 6256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 6356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* operator structure for FM engine */ 6456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparkstypedef struct 6556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks{ 6656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U32 phase; /* current waveform phase */ 6756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 gain; /* current internal gain */ 6856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 outputGain; /* current output gain */ 6956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks} S_FM_ENG_OPER; 7056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 7156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparkstypedef struct 7256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks{ 7356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks S_FM_ENG_OPER oper[4]; /* operator data */ 7456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_I16 op1Out; /* op1 output for feedback loop */ 7556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_I16 op3Out; /* op3 output for feedback loop */ 7656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 voiceGain; /* LFO + channel parameters */ 7756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#if (NUM_OUTPUT_CHANNELS == 2) 7856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 gainLeft; /* left gain multiplier */ 7956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 gainRight; /* right gain multiplier */ 8056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#endif 8156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U8 flags; /* mode bits and noise waveform flags */ 8256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U8 feedback; /* feedback for Op1 and Op3 */ 8356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks} S_FM_ENG_VOICE; 8456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 8556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparkstypedef struct 8656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks{ 8756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 gain[4]; /* initial operator gain value */ 8856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 outputGain[4]; /* initial operator output gain value */ 8956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 voiceGain; /* initial voice gain */ 9056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U8 flags; /* mode bits and noise waveform flags */ 9156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U8 feedback; /* feedback for Op1 and Op3 */ 9256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#if (NUM_OUTPUT_CHANNELS == 2) 9356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_I8 pan; /* pan value +/-64 */ 9456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#endif 9556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks} S_FM_VOICE_CONFIG; 9656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 9756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparkstypedef struct 9856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks{ 9956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 gain[4]; /* new operator gain value */ 10056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_I16 pitch[4]; /* new pitch value */ 10156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks EAS_U16 voiceGain; /* new voice gain */ 10256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks} S_FM_VOICE_FRAME; 10356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 10456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* bit definitions for S_FM_ENG_VOICE.flags */ 10556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FLAG_FM_ENG_VOICE_OP1_NOISE 0x10 /* operator 1 source is PRNG */ 10656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FLAG_FM_ENG_VOICE_OP2_NOISE 0x20 /* operator 2 source is PRNG */ 10756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FLAG_FM_ENG_VOICE_OP3_NOISE 0x40 /* operator 3 source is PRNG */ 10856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#define FLAG_FM_ENG_VOICE_OP4_NOISE 0x80 /* operator 4 source is PRNG */ 10956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 11056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#ifdef FM_OFFBOARD 11156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparksextern EAS_BOOL FM_StartFrame (EAS_FRAME_BUFFER_HANDLE pFrameBuffer); 11256c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparksextern EAS_BOOL FM_EndFrame (EAS_FRAME_BUFFER_HANDLE pFrameBuffe, EAS_I32 *pMixBuffer, EAS_I16 masterGain); 11356c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#endif 11456c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 11556c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* FM engine prototypes */ 11656c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparksextern void FM_ConfigVoice (EAS_I32 voiceNum, S_FM_VOICE_CONFIG *vCfg, EAS_FRAME_BUFFER_HANDLE pFrameBuffer); 11756c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparksextern void FM_ProcessVoice (EAS_I32 voiceNum, S_FM_VOICE_FRAME *pFrame, EAS_I32 numSamplesToAdd, EAS_PCM *pTempBuffer, EAS_PCM *pBuffer, EAS_I32 *pMixBuffer, EAS_FRAME_BUFFER_HANDLE pFrameBuffer); 11856c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 11956c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks#endif 12056c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks/* #ifndef _FMENGINE_H */ 12156c99cd2c2c1e6ab038dac5fced5b92ccf11ff6cDave Sparks 122