88 lines
3.9 KiB
C++
88 lines
3.9 KiB
C++
// native_bridge/include/SharedMemoryIPC.h
|
|
#pragma once
|
|
#include <cstdint>
|
|
#include <cstddef>
|
|
|
|
#ifdef _WIN32
|
|
#include <windows.h>
|
|
#endif
|
|
|
|
#define AUDIO_BLOCK_SIZE 256
|
|
|
|
// WARNING: volatile is NOT a sync primitive. Real impl should use an
|
|
// interlocked/index-flag pair or a Win32 event (SetEvent) signalled by the
|
|
// writer. This struct follows the spec layout so Rust/JS mapping stays in sync.
|
|
struct SharedAudioBufferIPC {
|
|
// Synchronization Flags
|
|
volatile uint32_t clientReadIndex;
|
|
volatile uint32_t bridgeWriteIndex;
|
|
|
|
// PCM Float32 Audio Buffers
|
|
float masterLeft[AUDIO_BLOCK_SIZE];
|
|
float masterRight[AUDIO_BLOCK_SIZE];
|
|
|
|
// Latency probe: bridge stamps every rendered block (QueryPerformanceCounter)
|
|
volatile uint64_t blockTimestamp;
|
|
|
|
// MIDI Event Exchange Queue
|
|
struct MidiEventIPC {
|
|
uint8_t command; // 0x9 note on / 0x8 note off / 0xB CC / 0xC program / 0xE pitch bend
|
|
uint8_t channel;
|
|
uint8_t pitch; // note number (0x9/0x8) or CC number (0xB)
|
|
uint8_t velocity; // 0-127 (0x9 + vel=0 == note off)
|
|
uint8_t data2; // CC value / program number / PB LSB
|
|
uint8_t data3; // PB MSB (0xE only)
|
|
uint8_t reserved[2]; // reserved[0]: live flag (1 = live input, bypass transportStopped guard); reserved[1]: 0 — keeps C/Rust layout stable
|
|
uint32_t sampleOffset;
|
|
} midiQueue[64];
|
|
|
|
volatile uint32_t midiQueueCount;
|
|
|
|
// Transport / Control (added vs spec: Stop/Play flush, instrument switch)
|
|
struct ControlEventIPC {
|
|
uint32_t type; // 0 = NONE, 1 = PANIC/ALL_NOTES_OFF, 2 = LOAD_INSTRUMENT,
|
|
// 3 = TRANSPORT, 4 = OPEN_GUI
|
|
uint32_t arg0; // LOAD: instrument type (InstrumentType);
|
|
// TRANSPORT: 0=STOP, 1=PLAY, 2=SET_POSITION
|
|
uint32_t arg1; // LOAD: string length (bytes) of path;
|
|
// TRANSPORT: playheadSamples (for timeline sync)
|
|
uint32_t channel; // LOAD: MIDI channel to assign instrument to (A10)
|
|
char arg2[1024]; // LOAD: UTF-8 path
|
|
} controlQueue[8];
|
|
volatile uint32_t controlQueueCount;
|
|
|
|
// G0.3: set by the bridge while an openGUI attach job is in flight
|
|
// (reload/attachView on a ChannelWorker). The Tauri watchdog reads this
|
|
// to extend its stall deadline — a long Nexus attach must not look like
|
|
// a dead bridge. Append-only field: existing offsets stay stable.
|
|
volatile uint32_t attachInFlight;
|
|
|
|
// G3.1: dedicated heartbeat, incremented every 100ms by a bridge-side
|
|
// thread INDEPENDENT of the audio loop. The Tauri watchdog keys bridge
|
|
// liveness on this, so a slow (but alive) audio loop no longer looks dead.
|
|
// Append-only field: existing offsets stay stable.
|
|
volatile uint32_t heartbeat;
|
|
};
|
|
|
|
// G4.3: per-plugin sandbox SHM — double-buffered audio handoff.
|
|
// The child renders into the slot it is NOT publishing (writeSlot flips),
|
|
// then publishes; the bridge reads the published slot. A stale slot is safe
|
|
// to read (bridge keeps last block), so a slow child never tears audio.
|
|
struct SandboxHostIPC {
|
|
SharedAudioBufferIPC base; // MIDI/control/heartbeat, offsets unchanged
|
|
volatile uint32_t writeSlot; // 0 or 1: slot the child finished writing
|
|
float audioLeft[2][AUDIO_BLOCK_SIZE]; // 2 full blocks
|
|
float audioRight[2][AUDIO_BLOCK_SIZE];
|
|
};
|
|
|
|
// Shared-memory helpers (impl in SharedMemoryIPC.cpp).
|
|
struct ShmHandle;
|
|
ShmHandle* shm_open(const char* name, size_t size = sizeof(SharedAudioBufferIPC));
|
|
ShmHandle* shm_create(const char* name, size_t size = sizeof(SharedAudioBufferIPC));
|
|
SharedAudioBufferIPC* shm_ptr(ShmHandle* h);
|
|
SandboxHostIPC* shm_sandbox_ptr(ShmHandle* h);
|
|
void shm_close(ShmHandle* h);
|
|
bool shm_write_midi(ShmHandle* h, uint8_t cmd, uint8_t channel, uint8_t pitch,
|
|
uint8_t velocity, uint32_t sampleOffset, uint8_t data2 = 0,
|
|
uint8_t data3 = 0);
|