Files
Sprinter-SDCC/libc/cbl/cbl_close.c
T
snark13 b34997073e libc/cbl: выключение CBL больше не оставляет железо петь одну ноту
cbl_close() не пишет в порт управления ноль: пока gfx_wait_vsync держит
ссылку ради бита луча (в PoP её берёт pop_pace_arm на всю программу),
bit7 остаётся включённым.  А буфер CBL (256 слотов) при включённом bit7
крутится по кругу и не чистится ничем — железо бесконечно поёт хвост
последнего сэмпла, тоном и громкостью по последней мелодии.  Пойман
пользователем на железе: Ctrl+S во время музыки и пропуск заставки
давали ноту до следующего cbl_open.

В MAME не воспроизводится: "немым" кодом частоты был reserved-код 2, у
которого divs[2]==0 и таймер не заводится вовсе.  На железе reserved-коды
не определены, ЦАП тактируется — тишина держалась на свойстве эмулятора,
а не железа.

Теперь тишину даёт СОДЕРЖИМОЕ БУФЕРА:
- _cbl_port_sync() после каждой записи в порт управления зовёт
  _cbl_prime(0x80).  Это закрывает и паузу звука, и включение bit7 ради
  луча на холодном старте (в буфере лежал мусор от прошлой программы), и
  полное выключение — при bit7=0 те же 256 записей уходят прямо в ЦАП
  обычного COVOX и центруют его, снимая щелчок;
- _CBL_VSYNC_FREQ переведён с reserved-кода 2 на документированный 8
  (7,8125 кГц): поведение определено и на железе, и в MAME, прерывания
  по-прежнему выключены (bit4=0), а бит 7 порта 0xFE трамплин смотрит
  только при живом хуке насоса;
- cbl_close() зовёт sync внутри той же DI-скобки, где снимает хук, иначе
  насос долил бы буфер уже после заливки.

Цена: +2 Б программам со звуком, +11 Б графическим (тянется _cbl_prime
следом за gfx_wait_vsync), 256 OUT'ов (~0,3 мс) на редкое событие —
эталоны cblstream/cbltest/cblwav/gfx_dbuf обновлены.  Рост atlas в
size-check к этой правке отношения не имеет (замерен тот же и без неё).

Проверено: кодоген _cbl_port.asm; SprPoP пересобран и прогнан в MAME
(титры → пропуск заставки → уровень 1, пейсинг по лучу жив).  Сам баг
проверяется только на железе.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DSYUpuaQpKr48kBav2iiV4
2026-09-02 10:55:15 +03:00

37 lines
2.2 KiB
C

/*
* cbl_close — выключить CBL, снять хук насоса и отпустить IM2-таблицу.
* Идемпотентно; вызывается и из atexit.
*
* БУФЕР ТИШИНЫ НЕ ОСВОБОЖДАЕТСЯ. Раньше здесь стоял free(_cbl_silence), и
* он один тянул malloc/free в резидент КАЖДОМУ приложению — включая те, что
* cbl_open_silence() не зовут вовсе. Буфер живёт до выхода из программы и
* переиспользуется при повторном открытии (см. cbl_open_silence.c).
*
* Порт 0x004E не гасится напрямую — вместо этого _cbl_port_sync()
* пересчитывает нужное значение: если gfx_wait_vsync() ещё держит
* ссылку (_cbl_port_refs > 0), останется "немой" режим ради бита
* синхронизации; иначе порт гасится полностью. Он же заливает
* аппаратный буфер тишиной — БЕЗ ЭТОГО ЗАКРЫТИЕ CBL НЕ ЗАКРЫВАЕТ ЗВУК:
* пока bit7 держит vsync-ссылка, железо крутит по кругу оставшиеся в
* буфере 256 байт последнего сэмпла и поёт ноту до следующего
* cbl_open() (пойман Ctrl+S во время музыки, 2026-09-02; полный разбор
* — в шапке _cbl.h). В MAME это не воспроизводится.
*
* Порядок обязателен: сначала снять хук (иначе насос долил бы буфер уже
* после заливки), и только потом _cbl_port_sync с заливкой — вся
* скобка под DI, чтобы между снятием хука и тишиной ничего не влезло.
*/
#include "_cbl.h"
#include "../irq/_irq.h"
void cbl_close(void)
{
if (!_irq_cbl_hook) return;
IRQ_DISABLE();
_irq_cbl_hook = 0;
_cbl_port_sync(); /* режим порта + заливка буфера тишиной */
IRQ_ENABLE();
_irq_table_unref();
}