macOS Notes

System Requirements:

• macOS 10.9 through 10.14, macOS 11.0 or later
• Intel x86 processor or Apple M processor
• USB 2 or USB 3

Due to a bug in HID Driver in macOS 10.15 Catalina which prevents full-duplex communications for HID devices, NSDSP-1 and NSDSP-2 will not work with macOS 10.15 Catalina. There is no workaround. We have reported the bug to Apple. The bug is partially fixed in macOS 11.0 Big Sur. NSDSP software contains a workaround which allows NSDSP to work on macOS 11.0 Big Sur and later versions of macOS, but with USB communication speeds reduced by 10 to 15%.

The library is called nsdspif.dylib

Mac dynamic libraries are identified by library ids. The library id specifies how to find the library during run time. The library id within NSDSP interface library is nsdspif.dylib (without a path specified). Which means that the loader will look for the library in current directory and also in standard directories - /usr/lib and /usr/local/lib. If the library is located elsewhere, it won't be found.

If you want to install into a system folder, use /usr/local/lib. Check if the library is already installed. Overwrite the installed library only if the version of the library you are about to install is higher than the version of the already installed library.

If you want to add the library to a bundle, the standard way is to include it into a special Frameworks folder inside the bundle, as follows:

YourApp.App/
      Contents/
            Info.plist
      MacOS/
            your_app
      Frameworks/
            nsdspif.dylib
      Resources/

In this case, the library will not be found at run-time. Therefore, you will need to edit your executable to specify the library location. This can be done with the following command:

install_name_tool your_app -change nsdspif.dylib location

where the location specifies where to find the library. In the above example, the location would be:

@executable_path/../Frameworks/nsdspif.dylib