From 1bd2ea3a6b6c0ccac44a1e896b94bcc262273c97 Mon Sep 17 00:00:00 2001 From: Electric Keet Date: Wed, 18 Jun 2025 16:03:46 -0700 Subject: [PATCH] Docs for new PC Speaker exports. --- doc/2-interface/export.md | 9 +++++++-- doc/7-systems/pcspkr.md | 11 +++++++++++ 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/doc/2-interface/export.md b/doc/2-interface/export.md index fafc77454..62d4ffdc1 100644 --- a/doc/2-interface/export.md +++ b/doc/2-interface/export.md @@ -53,6 +53,9 @@ the following settings exist: - **chips to export**: select which chips are going to be exported. - due to VGM format limitations, you can only select up to two of each chip type. - some chips will not be available, either because VGM doesn't support these yet, or because you selected an old format version. +- **speed drift compensation**: + - **none**: normal export. + - **DeadFish VgmPlay (1.02×)**: adjusts speed to account for inaccuracy in [VgmPlay](https://www.mjsstuf.x10host.com/pages/vgmPlay/vgmPlay.htm), the Sega Genesis VGM player by DeadFish. ## ZSM @@ -72,8 +75,10 @@ the following settings are available: depending on the system, this option may appear to allow you to export your song to a working ROM image or code that can be built into one. export options are explained in the system's accompanying documentation. -currently, only one system can be exported this way: -- [Atari 2600 (TIunA)](../7-systems/tia.md) +the following formats and systems are supported: +- TIunA assembly, using [Atari 2600 (with software pitch driver)](../7-systems/tia.md). +- iPod .tone alarm, using [PC Speaker](../7-systems/pcspkr.md). +- GRUB_INIT_TUNE, using [PC Speaker](../7-systems/pcspkr.md). ## text diff --git a/doc/7-systems/pcspkr.md b/doc/7-systems/pcspkr.md index 7cee6b609..a70fb461f 100644 --- a/doc/7-systems/pcspkr.md +++ b/doc/7-systems/pcspkr.md @@ -34,6 +34,17 @@ ha! effects... this chip uses the [Beeper](../4-instrument/beeper.md) instrument editor. +## ROM export + +two ROM export options exist: + +- **iPod .tone alarm**: with the iPod _in disk mode,_ drag the export file into the `iPod_Control/Tones` folder. +- **GRUB_INIT_TUNE**: use with the GRUB bootloader. + - into the file `etc/default/grub` add the following line with the text output copied and pasted where `text` is:\ + `GRUB_INIT_TUNE="text"`\ + then run `sudo update-grub2`. + - **export binary file**: creates a binary file instead of text. in either the GRUB shell or the GRUB config file, use the `play` command followed by the filename of the export. + ## chip config the following options are available in the Chip Manager window: