You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+13-56Lines changed: 13 additions & 56 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,17 +6,25 @@
6
6
Authentic sounds from vintage sound chips, on modern hardware!
7
7
8
8
## Introduction
9
-
RetroWave is **originally**a hardware sound board series that uses vintage sound chips and works with modern hardware.
9
+
RetroWave is a hardware sound board series that uses vintage sound chips and works with modern hardware.
10
10
11
11
They **were** in shape of Raspberry HATs, stackable, hackable, can be used on tiny single board computers like the Raspberry Pi / Jetson Nano, and modern desktop computer with USB ports.
12
12
13
13
Since 2022-06, the original RetroWave series are no longer produced. You can read about what happened in [this article](https://telegra.ph/What-happened-to-RetroWave-OPL3-06-21).
The successors of the original RetroWave series is called the **RetroWave Express** series. They are available in discrete boards each with its own USB port. For now, only the [RetroWave OPL3 Express](https://shop.sudomaker.com/products/retrowave-opl3-express) is available.
17
+
The successors of the original RetroWave series is called the **RetroWave Express** series. They are available in discrete boards each with its own USB port. 100% software compatibility of the original RetroWave series is maintained.
18
+
19
+
For now, only the [RetroWave OPL3 Express](https://shop.sudomaker.com/products/retrowave-opl3-express) is available.
18
20
19
21
## Hardware
22
+
For the information of the original RetroWave series, check the history.
23
+
24
+
### Features
25
+
- Minimalistic form factor and convenient USB-C interface
26
+
- Designed with high-grade components for everyday use
27
+
- Ultra-high bandwidth provided by hardware 8080 ports
20
28
21
29
### Boards
22
30
@@ -25,56 +33,13 @@ Available on our official [Shopify Shop](https://shop.sudomaker.com/products/ret
- All control pins & chip registers are directly accessible by software
48
-
- Built-in crystal oscillator, no need to use an MCU
49
-
- Different RetroWave boards can be stacked together, and they use the same pins
50
-
- With a PotatoPi Lite as a USB adapter, the boards can be accessed via 12Mbps full speed USB CDC
51
-
52
-
### In depth look
53
-
54
-
#### Architecture
55
-
There are no abstraction between software and hardware at all.
56
-
57
-
A simple SPI IO expander is used, and all pins of the sound chips can be controlled by software directly.
58
-
59
-
With the PotatoPi Lite as USB adapter, you still have the ability to control all the pins directly. Since it just acts as simple "Serial to SPI" converter.
60
-
61
-
All boards have built-in crystal oscillators. For sound chips that can be used with different clock speeds, programmable oscillators will be used.
62
-
63
-
#### Pin allocation
64
-
Each board uses the same pins on the 40 pin Raspberry header (physical pin numbering):
65
-
- 5V (pin 2 and 4)
66
-
- All GND pins (pin 6, 9, 14, 20, 25, 30, 24, 39)
67
-
- SPI MOSI (pin 19)
68
-
- SPI MISO (pin 21)
69
-
- SPI CLK (pin 23)
70
-
- GPIO6 (pin 31)
71
-
72
-
Yes, the boards are stackable. And yes, different boards can function at the same time.
73
-
74
39
## Software
75
-
We provide a library for accessing the boards, a reference command-line VGM player that uses the library, and a modified DOSBox-X that supports using RetroWave boards for sound output.
40
+
The RetroWave OPL3 (Express) is supported by [DOSBox-X](https://dosbox-x.com/). The support is also ported to 86Box [by community](https://github.com/daemon32/86Box/).
76
41
77
-
The firmware of the USB Adapter is also open sourced: See [here](https://github.com/SudoMaker/RetroWave_USB_Adapter).
42
+
For experienced users, we provide a library for accessing the boards, a reference command-line VGM player that uses the library.
78
43
79
44
All of them are free software.
80
45
@@ -137,18 +102,10 @@ If you are good at Windows APIs, feel free to create a pull request!
137
102
138
103
The conhost.exe terminal is extremely laggy when repainting the whole console window. So, OSD refresh rate is set to 1 second and regmap visualization is disabled by default on Windows. If you want to see the register map visualization properly, try using MinTTY as your terminal.
0 commit comments