From 7e56655c040fbf3b308d1fb87e391ce7ec1ccb9e Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sat, 31 Oct 2026 21:57:58 +0700 Subject: [PATCH 1/2] fix(windows): enable native ASIO backend in Standalone and verify device factory in smoke tests --- CMakeLists.txt | 11 +++++++++++ docs/WINDOWS-QUICKSTART.md | 10 ++++++++++ tests/PluginSmoke.cpp | 20 ++++++++++++++++++++ 3 files changed, 41 insertions(+) diff --git a/CMakeLists.txt b/CMakeLists.txt index b1d0637..1dcfd84 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -4,6 +4,10 @@ set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) option(ARSON_BUILD_PLUGIN "Build VST3 and standalone" ON) option(ARSON_SANITIZE "Enable address/undefined sanitizers for engine tests" OFF) +# JUCE defaults JUCE_ASIO=0. Native Maono PS22 / professional ASIO drivers +# are otherwise absent from the Windows Standalone "Options" device list. +# Keep switch explicit so third-party ASIO SDK licensing can be audited. +option(ARSON_WINDOWS_ASIO "Enable native ASIO devices for Windows Standalone" ON) add_library(arson_engine STATIC engine/Compressor.cpp) set_target_properties(arson_engine PROPERTIES POSITION_INDEPENDENT_CODE ON) target_include_directories(arson_engine PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/engine) @@ -61,6 +65,13 @@ if(ARSON_BUILD_PLUGIN) endif() target_compile_definitions(ArSonComp PUBLIC JUCE_WEB_BROWSER=0 JUCE_USE_CURL=0 JUCE_VST3_CAN_REPLACE_VST2=0) + if(WIN32 AND ARSON_WINDOWS_ASIO) + # PUBLIC propagates to the generated Standalone wrapper and plugin smoke. + # Uses JUCE's bundled Steinberg ASIO headers (JUCE_ASIO_USE_EXTERNAL_SDK=0). + # VST3 still uses the host-selected driver; this affects Standalone only. + target_compile_definitions(ArSonComp PUBLIC JUCE_ASIO=1 + JUCE_ASIO_USE_EXTERNAL_SDK=0) + endif() target_link_libraries(ArSonComp PRIVATE arson_engine ArSonCompKnobAssets juce::juce_audio_utils PUBLIC juce::juce_recommended_config_flags juce::juce_recommended_lto_flags) if(BUILD_TESTING) diff --git a/docs/WINDOWS-QUICKSTART.md b/docs/WINDOWS-QUICKSTART.md index 00f3584..62fe87c 100644 --- a/docs/WINDOWS-QUICKSTART.md +++ b/docs/WINDOWS-QUICKSTART.md @@ -58,3 +58,13 @@ All rotary knobs retain their coral sector behind the black brushed-metal face a ### Premium brushed-metal and glass UI The updated full editor should now have a horizontally brushed grey metal background and a recessed jet-black LCD for the dynamics history/transfer graph and segmented IN/GR/OUT meters. The knob area is shorter, leaving more room for the screen. Range/Hold/Mix/Link/HP/LP rails have a deep shadowed well sized to the original metallic thumb; all toggle captions appear on the left of their switches, including ACTIVE/BYPASS in the header. Both DYNAMICS and SIDECHAIN pages, MINI, old presets/automation and all audio routes continue working. No plugin audio processing or added algorithmic sample delay has changed. + +## Windows interface crackle diagnostic — native ASIO (PS22 and similar) + +The standard JUCE `juce_audio_devices` build defaults `JUCE_ASIO=0`. ArSonComp Windows builds now enable `ARSON_WINDOWS_ASIO=ON` (and `JUCE_ASIO=1`) so **Standalone Options → Audio Settings** can list the system's native ASIO devices. This only enables the backend; install your interface manufacturer's official driver separately. **VST3 uses the audio driver selected by its DAW/host**, not the plug-in. + +For MAONO PS22, install the official [PS22 Windows driver and routing tool](https://faq.maono.com/docs/PS22-FAQs); in the application choose **ASIO** and the device named **Maono ASIO** (name may vary by driver version). Set input and output to PS22, start with **48 kHz, 512 samples**, then test 256 / 128 / 64 only if stable. Close other apps using the ASIO interface, use a direct motherboard USB connection, and disable PS22 direct monitoring if monitoring its software-processed audio to avoid doubled sound. MAONO specifically documents the Maono ASIO driver for its interfaces at https://faq.maono.com/docs/TrueRTA-REW-Software-Configuration-Guide . + +**Isolate the fault before claiming a fix:** (A) PS22 direct monitor (analog baseline, no ArSonComp), (B) unprocessed Windows/DAW input/output, (C) VST3 or Standalone with compressor host-bypassed, (D) compressor active with identical gain and routing. If A has crackles suspect input/cable/hardware; if B/C also crackle suspect driver, buffer, USB or operating-system scheduling; if only D crackles investigate DSP/automation and capture a digital audio recording. A single Task Manager CPU/GPU/memory snapshot is not an xrun measurement. Report driver name, sample rate, buffer, whether Standalone or VST3, and whether bypass removes crackles. A real audio-device test is required. + +`ARSON_WINDOWS_ASIO=OFF` can be used by downstream builders who cannot accept the Steinberg ASIO SDK's third-party licensing terms; review distribution compliance before a public release. Enabling ASIO does **not** ensure zero hardware latency or prevent all crackles. diff --git a/tests/PluginSmoke.cpp b/tests/PluginSmoke.cpp index 8bf8ed8..a21fc92 100644 --- a/tests/PluginSmoke.cpp +++ b/tests/PluginSmoke.cpp @@ -10,6 +10,26 @@ #include int main(int argc,char** argv) { juce::ScopedJuceInitialiser_GUI gui; +#if JUCE_WINDOWS + // The standalone must offer native low-latency ASIO (e.g. Maono PS22) + // in Options, rather than silently hiding it behind Windows Audio. + // Only the *backend* is checked on CI, not a physical connected device. +#if !JUCE_ASIO +#error "Windows Standalone ASIO backend was disabled in this build" +#endif + { + juce::AudioDeviceManager deviceManager; + bool hasNativeAsio=false; + for(auto* type:deviceManager.getAvailableDeviceTypes()) + if(type && type->getTypeName().equalsIgnoreCase("ASIO")) + hasNativeAsio=true; + if(!hasNativeAsio) { + std::cerr<<"STANDALONE_ASIO_BACKEND_MISSING\n"; + return 81; + } + std::cout<<"PASS: native Windows ASIO device backend is registered\n"; + } +#endif // Quantitative edge-dissolve contract: endpoints transparent, the // central ~73% clearly visible, symmetric fades and stable RGB. { From 91194ce555dd21eba3fa328f80fd28696bc45122 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sat, 31 Oct 2026 22:06:22 +0700 Subject: [PATCH 2/2] test: include JUCE audio-device API for native ASIO backend assertion --- tests/PluginSmoke.cpp | 1 + 1 file changed, 1 insertion(+) diff --git a/tests/PluginSmoke.cpp b/tests/PluginSmoke.cpp index a21fc92..e75e9fe 100644 --- a/tests/PluginSmoke.cpp +++ b/tests/PluginSmoke.cpp @@ -6,6 +6,7 @@ #include "../plugin/SurfacePaint.h" #include "BinaryData.h" #include +#include #include #include int main(int argc,char** argv) {