Ad Lib Gold Developer Toolkit
A searchable reproduction of the Ad Lib Gold Developer Toolkit, Version 1.01 developer manual — with the complete Ad Lib Gold floppy-disk software preserved, decoded and browsable alongside it.
The Ad Lib Gold 1000/2000 was a 1992 16-bit sound card built around the Yamaha OPL3 (YMF262) FM synthesizer, a MMA digital-audio controller, an optional YM7128 (SP2) surround processor, a MIDI/game port and an optional SCSI interface. This toolkit documents the hardware, the bundled DOS applications, the DOS driver API, and the low-level register interface needed to program the card directly.
How this book is organized
| Section | What it covers |
|---|---|
| Release Notes | v1.01 addenda and driver caveats |
| Introduction | Copyright, licensing, contents |
| Chapter 2 - Quick Start | Installing hardware and software |
| Chapter 3 - Gold Hardware | Card layout, jumpers, connectors, surround module |
| Chapter 4 - Software Applications | Setup, test, mixer, jukebox, instrument/sample makers |
| Chapter 5 - DOS Software Drivers | Control, FM, Wave, Timer and MIDI driver APIs |
| Chapter 6 - Windows DLLs | Announced but not released in v1.01 |
| Chapter 7 - Low-Level Programming | MMA / OPL3 / mixer register reference |
| Appendix: GSS | Gold Sound Standard specification |
| Appendix: SP2 | YM7128 surround processor datasheet |
| Appendix D | List of installed files |
| Appendix E: Program Disks | The v1.00 end-user floppies as shipped — authentic images + files |
| Appendix F: Software (as installed) | The decoded 133-file \GOLD install tree |
| Appendix G: Developer SDK | Driver C/asm source, samples, toolkit + beta floppies |
| Appendix H: "Ad Lib Comp." format | Reverse-engineering the GOLD.CMP codec |
About this reproduction
This edition was produced with ocr.z.ai (GLM-OCR), which performed optical character recognition over the original scanned PDF, then rebuilding the result as an mdBook. The technical content is preserved as written in 1992; only structure and formatting were modernized:
- the six OCR fragments were reassembled into the manual's original chapters;
- OCR mojibake (for example
AdLib®) was repaired; - C function prototypes were placed in code blocks and register listings tidied;
- cross-links were added between the manual and the driver source in this repository.
Because it is a historical document, some names, phone numbers and addresses (such as the Ad Lib Developer Support line) are of purely historical interest. Text recovered by OCR may contain occasional transcription errors; consult the original scan where exactness matters.
The disk archive
Appendices E–H go beyond the manual and preserve the actual Ad Lib Gold software across every known release of 1992–93: the Beta v0.91b (March 1992), the end-user Program Disks v1.00 (1992), this Developer Toolkit v1.01, and the newest artifact — the standalone Windows 3.1 Mixer & Drivers v1.2 (July 1993). See the release timeline. Every file is kept byte-for-byte in its original DOS (CP437 / CRLF) encoding with a UTF-8 rendering alongside; the authentic 720 KB floppy images are included and were boot-sector-verified and malware-scanned before inclusion.
The end-user software shipped in a proprietary compressed container
(GOLD.CMP). Its format and LZ + static-Huffman codec were
reverse-engineered from the installer, so the
complete install trees — 133 files for v1.00 and 130 for the beta — could
be decoded and are browsable as installed. Decoding
is proven correct: the recovered CTRLDRV.EXE is byte-identical to the copy that
ships uncompressed on the disk.
This SDK lives in the
slartibardfast/adlib_goldrepository.