Measured8580Waveforms.java

/*
 * Measured OSC3 curves from libsidplayfp/combined-waveforms.
 * Sampling credits: Trurl, ltx128, reFX-Mike; tools: Antti Lankila and Leandro Nini.
 * Distributed under GNU GPL version 2 or later; see the project COPYING file.
 */
package builder.resid;

/**
 * Measured MOS8580 profile, used only while constructing waveform tables.
 *
 * <p>These are the unchanged eight-bit OSC3 samples from dataset 8580_0590 at
 * combined-waveforms commit 3fdd27f0a3c52c7a2d56eeedb0f0ecd997062c1d.
 * Among the 17 retained 8580 datasets, this actual capture set minimizes total
 * bit differences against the collection for triangle+saw and pulse+saw together.
 * Four unmeasured DAC bits keep the existing model estimate. This is a digital
 * profile of retained hardware, not an analog calibration or universal SID law.
 *
 * <p>Source files and reproducible generation/selection are documented in
 * src/test/resources/sid/combined-waveform-profile.md.
 */
public final class Measured8580Waveforms {
    private Measured8580Waveforms() { }

    /** Eight measured DAC MSBs; waveform is 3 or 6, phase is 0..4095. */
    public static int msb(int waveform, int phase) {
        return (waveform == 3 ? TRIANGLE_SAW : PULSE_SAW)[phase] & 255;
    }

    private static byte[] decode(String hex) {
        byte[] samples = new byte[hex.length() / 2];
        for (int i = 0; i < samples.length; i++) {
            samples[i] = (byte) Integer.parseInt(hex.substring(i * 2, i * 2 + 2), 16);
        }
        return samples;
    }

    // Original capture SHA-256: 696d66efdbb952825ce69030ac105c01e1b844ce1c6381ef7c429d1c9d8e159c
    private static final byte[] TRIANGLE_SAW = decode(
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000307" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f0f0f0f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000707" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001e1e1e1e1f1f1f1f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000707" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f0f0f0f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000707" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000010103c3c3c3c3c3c3c3c3e3e3e3e3f3f3f3f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000707" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f0f0f0f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000707" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000808081e1e1e1e1f1f1f1f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000707" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040404040f0f0f0f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008080808082828787" +
            "c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0" +
            "c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0e1e3" +
            "f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0" +
            "f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8fcfcfcfcfcfcfcfcfcfcfcfcfcfcfcfcfefefefefefefefeffffffffffffffff");

    // Original capture SHA-256: c3dec92cec98dc741b5dbdd70ac804ab30ab946a46ece3119fd7eb063fa66cba
    private static final byte[] PULSE_SAW = decode(
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003" +
            "00000000000000000000000000000000000000000000000000000000000000090000000000000000000000000000001e000000000000001f0000001f003f3f3f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003" +
            "00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000f000f1f5f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003" +
            "0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000400040476f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041" +
            "00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000004000000000000000600000006040606077" +
            "0000000000000000000000000000000000000000000000000000000000004060000000000000004000000040004040700000004040404070406060706070707b" +
            "000040404040406040404060406060784060406060606078607070787078787d607070707070707c7078787c787c7c7e7878787c7c7e7e7f7c7e7f7f7f7f7f7f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000087" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000083" +
            "000000000000000000000000000000000000000000000000000000000000008100000000000000800000008000808080000000800080808080808086808f8f9f" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" +
            "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000808087" +
            "00000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000008000000000000000800000008000808081" +
            "000000000000000000000000000000800000000000000080008080808080808100008080008080808080808080808080808080808080808080808080808083af" +
            "00000000000000000000000000000080000000000000008000000080008080800000008000008080808080808080808080808080808080808080808080808081" +
            "8080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080a0b7" +
            "8080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080a080808080808080a0808080a080a0b0bb" +
            "808080808080808080808080808080b080808080808080b080a0a0b0a0b8b8bd80a0a0a0a0b0b0b8a0b0b0b8b0b8bcbeb0b8b8bcb8bcbcbfbcbebebfbfbfbfbf" +
            "00000000000000800000008000808080008080800080808000808080808080808080808080808080808080808080808080808080808080808080808080808080" +
            "808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080c3" +
            "808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080808080c3" +
            "80808080808080808080808080808080808080808080808080808080808080c1808080808080808080808080808080c0808080c080c0c0c0c0c0c0c0c0c0c3cf" +
            "80808080808080808080808080808080808080808080808080808080808080c0808080808080808080808080808080c080808080808080c0808080c080c0c0c1" +
            "808080808080808080808080808080c080808080808080c0808080c0c0c0c0c0808080c080c0c0c080c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0d7" +
            "808080c080c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0db" +
            "c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0d0c0c0c0c0c0c0c0d0c0c0c0d0c0d0d0ddc0c0c0c0c0c0c0d8c0d0d0d8d0d8d8ded0d8d0dcd8dcdcdfdcdededfdfdfdfdf" +
            "c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0e1" +
            "c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0e0c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0e0c0c0c0c0c0c0c0e0c0e0e0e0e0e0e0e7" +
            "c0c0c0c0c0c0c0c0c0c0c0c0c0c0c0e0c0c0c0c0c0c0c0e0c0c0c0e0c0e0e0e0c0c0c0c0c0c0c0e0c0c0c0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0eb" +
            "e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0ede0e0e0e0e0e0e0e0e0e0e0e0e0e8e8eee0e0e0e8e0ececefe8eceeefefefefef" +
            "e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0f0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0f0e0e0e0e0e0e0e0f0e0f0f0f0f0f0f0f3" +
            "e0e0e0e0e0e0e0f0e0e0e0f0e0f0f0f0e0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f5f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f6f0f0f0f0f0f0f4f7f0f4f4f7f6f7f7f7" +
            "f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f8f0f0f0f0f0f0f0f8f0f0f0f8f8f8f8f9f0f0f0f8f0f8f8f8f8f8f8f8f8f8f8faf8f8f8f8f8f8f8fbf8f8f8fbfafbfbfb" +
            "f8f8f8f8f8f8f8fcf8f8f8fcf8fcfcfcf8fcfcfcfcfcfcfdfcfcfcfdfcfdfdfdfcfcfcfefcfefefefefefefefefefefefeffffffffffffffffffffffffffffff");
}