furnace/doc/7-systems/pcspkr.md

36 lines
1.8 KiB
Markdown
Raw Normal View History

2022-03-22 05:58:07 +00:00
# PC Speaker
2023-09-10 06:44:29 +00:00
40 years of one square beep - and still going! single channel, no volume control...
2022-03-22 05:58:07 +00:00
2023-09-11 00:34:13 +00:00
## real output
2022-06-03 06:32:56 +00:00
2022-10-16 05:53:05 +00:00
so far this is the only chip in Furnace which has a real hardware output option.
to enable it, select file > configure chip... > PC Speaker > Use system beeper.
2022-06-03 06:32:56 +00:00
be noted that this will only work on Linux as Windows does not provide any user-space APIs to address the PC speaker directly!
you may configure the output method by going in Settings > Emulation > PC Speaker strategy:
- `evdev SND_TONE`: uses input events to control the beeper.
- requires write permission to `/dev/input/by-path/platform-pcspkr-event-spkr`.
- is not 100% frequency-accurate as `SND_TONE` demands frequencies, but Furnace uses raw timer periods...
- `KIOCSOUND on /dev/tty1`: sends the `KIOCSOUND` ioctl to control the beeper.
- may require running Furnace as root.
- `/dev/port`: writes to `/dev/port` to control the beeper.
- requires read/write permission to `/dev/port`.
- `KIOCSOUND on standard output`: sends the `KIOCSOUND` ioctl to control the beeper.
- requires running Furnace on a TTY.
- `outb()`: uses the low-level kernel port API to control the beeper.
- requires running Furnace as root, or granting it `CAP_SYS_RAWIO` to the Furnace executable: `sudo setcap cap_sys_rawio=ep ./furnace`.
real hardware output only works on BIOS/UEFI (non-Mac) x86-based machines! attempting to do this under any other device **will not work**, or may even brick the device (if using `/dev/port` or `outb()`)!
oh, and of course you also need the beeper to be present in your machine. some laptops connect the beeper output to the built-in speakers (or the audio output jack), and some other don't do this at all.
2023-09-11 00:34:13 +00:00
## effects
2022-03-22 05:58:07 +00:00
ha! effects...
2023-09-11 00:34:13 +00:00
## info
this chip uses the [Beeper](../4-instrument/beeper.md) instrument editor.