Check a driver on hardware
This guide checks a driver on the real synth. You need the synth, a USB
cable, and the command line tool oscyl (from a release, or
cargo run -p oscyl-cli --).
When the check is needed:
- Tier 2 needs no hardware check. The conformance suite against the simulator is enough for a driver to be accepted.
- Tier 1 needs this check for each release, by the driver’s named maintainer. A Tier 1 failure blocks the release.
- A new driver gains from one check before its first review, if you have the synth. Its simulator copies only the faults that you saw, so the real synth can find more.
Supported synths lists each driver’s tier.
Before you start
- Find the synth’s firmware version.
oscyl infoshows it for a driver that reads it. - Choose a few scratch slots: slots whose programs you can lose.
Check the driver
-
Connect the synth, and check that Oscyl finds it:
oscyl ports oscyl info -
Back up the whole synth before any write:
oscyl backup before.oscyllibKeep this file until the check is done. It is your way back.
-
Read the program that the synth plays:
oscyl current -
Make a library with new programs in your scratch slots only. For example, open
before.oscyllibin the desktop app, change the scratch slots, and save it asscratch.oscyllib. -
List the programs that the write will change:
oscyl diff scratch.oscyllibIt prints one line for each program that differs, its position from 0 and its name, then
N of M programs differ. Check that it lists only your scratch slots. If it lists any other slot, stop. -
Write it. Oscyl backs up the whole synth first, then writes only the programs that differ:
oscyl restore scratch.oscyllibIt prints
backup of the synth saved to <path>, the progress, andwrote and saved N programs in <time>. Check that N is the number of programs that the diff listed. -
Compare the synth with the library again. Expect
0 of M programs differ:oscyl diff scratch.oscyllib -
Play a program without storing it, and listen to the synth:
oscyl audition scratch.oscyllib --index 3 -
Put the scratch slots back:
oscyl restore before.oscyllib oscyl diff before.oscyllibThe diff must say that no program differs.
-
In the desktop app, connect the synth and check that it reads every slot. Turn on Live, edit a value, and listen to the change.
Record the result
Write down in the pull request, or in the release’s notes:
- the synth and its firmware version;
- the platform and the app or command that you used;
- which steps passed, and the output of each step that failed.
Never commit the captures or the backups. Keep them in private/, which
git ignores.
A Tier 1 failure blocks the release. Cut a release says where the check fits.