ExternalFilter.java
/**
* This file is part of reSID, a MOS6581 SID emulator engine.
* Copyright (C) 2004 Dag Lem <resid@nimrod.no>
* <p>
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License or
* (at your option) any later version.
* <p>
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
* <p>
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* @author Ken Händel
*
*/
package builder.resid.resid;
/**
*
* The audio output stage in a Commodore 64 consists of two STC networks, a
* low-pass filter with 3-dB frequency 16kHz followed by a high-pass filter with
* 3-dB frequency 16Hz (the latter provided an audio equipment input impedance
* of 1kOhm).
* <p>
* The STC networks are connected with a BJT supposedly meant to act as a unity
* gain buffer, which is not really how it works. A more elaborate model would
* include the BJT; however, DC circuit analysis yields BJT base-emitter and
* emitter-base impedances low enough to produce additional low-pass and
* high-pass 3dB-frequencies in the order of hundreds of kHz. This calls for a
* sampling frequency of several MHz, which is far too high for practical use.
*
* @author Ken Händel
* @author Dag Lem
* @author Antti Lankila
*/
final class ExternalFilter {
/**
* lowpass
*/
private int Vlp;
/**
* highpass
*/
private int Vhp;
private int w0lp_1_s7;
private int w0hp_1_s20;
/**
* SID clocking - 1 cycle.
*
* @param Vi vi
*/
int clock(int Vi) {
int dVlp = w0lp_1_s7 * ((Vi << 11) - Vlp) >> 7;
int dVhp = w0hp_1_s20 * (Vlp - Vhp) >> 20;
Vlp += dVlp;
Vhp += dVhp;
return Vlp - Vhp >> 11;
}
void zeroDenormals() {
if (Vhp > -1e-12f && Vhp < 1e-12f) {
Vhp = 0;
}
if (Vlp > -1e-12f && Vlp < 1e-12f) {
Vlp = 0;
}
}
/**
* Constructor.
*/
ExternalFilter() {
reset();
}
/**
* Setup of the external filter sampling parameters.
*
* @param frequency frequency in Hz
*/
void setClockFrequency(final double frequency) {
// Low-pass: R = 10kOhm, C = 1000pF; w0l = 1/RC = 1/(1e4*1e-9) = 100000
// High-pass: R = 1kOhm, C = 10uF; w0h = 1/RC = 1/(1e3*1e-5) = 100
w0lp_1_s7 = (int) (100000 / frequency * (1 << 7) + 0.5);
w0hp_1_s20 = (int) (10 / frequency * (1 << 20) + 0.5);
}
/**
* SID reset.
*/
void reset() {
// State of filter.
Vlp = 1 << 15 + 11;
Vhp = 0;
}
}