blob: ecc2a796150732c05f75b318e400e7628c55cd9e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
# emu8910
This repository contains a `Typescript` implementation of General Instrument's [`AY8910`](https://en.wikipedia.org/wiki/General_Instrument_AY-3-8910) `PSG` (programmable sound generator).
It implements most of the `PSG's` original registers. <br>
The offical datasheet for the `PSG` can be found [`here`](http://map.grauw.nl/resources/sound/generalinstrument_ay-3-8910.pdf).
> **Online Player/Emulator by DrSnuggles** <br>
> [`AYSir`](https://drsnuggles.github.io/AYSir/?engine=lunar)
Sound output is achieved in the browser through an `AudioContext()` hook. <br>
This `emulator` also adds interrupt support (with variable frequency) for updating the `PSG's` registers.
`FIR` filter data generated using:
[`https://www.arc.id.au/FilterDesign.html`](https://www.arc.id.au/FilterDesign.html).
Compile with `tsc emu8910.ts`.
To use simply create a `PSG49` object as follows:
```
var emu8910 = new PSG49(YM_CLOCK_ZX, 50);
```
Which sets the default clock speed (`1.75 MHz`) and interrupt frequency (`50 Hz`).
This exposes a a `PSG` `register file` in the `emu8910.register` object:
```
emu8910.register.A_FINE
emu8910.register.A_COARSE
emu8910.register.B_FINE
emu8910.register.B_COARSE
emu8910.register.C_FINE
emu8910.register.C_COARSE
emu8910.register.NOISE_PERIOD
emu8910.register.MIXER
emu8910.register.A_VOL
emu8910.register.B_VOL
emu8910.register.C_VOL
emu8910.register.ENV_FINE
emu8910.register.ENV_COARSE
emu8910.register.ENV_SHAPE
```
The `register file` is then used to control the `PSG` or extract state information.
To play a FYM module:
```
song = new FYMReader(<BUFFER>);
emu8910.interrupt.routine = <ISR_FUNC>
emu8910.clock.frequency = song.getClockRate()
emu8910.interrupt.frequency = song.getFrameRate()
```
This sets the `ISR` (Interrupt Service Routine) function, `clock` and `interrupt` frequency for a specific module.
To stop playback:
```
emu8910.driver.device.suspend()
emu8910.interrupt.frequency = 0
```
To resume:
```
emu8910.driver.device.resume()
emu8910.interrupt.frequency = song.getFrameRate()
```
> Note: You can access the emulator's internal register file with `emu8910.register`.
These registers need to be updated at the frequency of the `ISR`.
Files:
* `src/emu8910.ts` - `core` emulator implementation.
* `fym.js` - `FYM` `(Fast YM)` format parser.
* `parser.js` - `PSG` register parser.
* `index.html` - `HTML` boilerplate.
To run demo start web server: `python -m http.server 8000` and navigate to `index.html`.
> Note: Click anywhere on the page to start audio output.
|
