Just Friends: Version Four

A final form

Get it with all the instructions & info at the GitHub release page.

Just Friends: Version Three point Two

It's new, but mostly not. Expand your friends' digital literacy

Upon first release, Just Friends was finished. There was considered to be no path toward 'firmware upgrades' and a bootloader was very nearly left off the module altogether. But for one thing, Just Type, a digital communication layer between Just Friends and monome's Teletype. After a failed attempt to shoe-horn in the functionality, and the whole RUN-jack ordeal in late 2016, rewriting the software (along w changes to the hardware) didn't seem such a bad idea.

The main thing one will notice on first use is that the CURVE control has been switched around – sine and square waves have switched sides. The driving force here was to improve the transition into the square shape; a much more natural fit with the fast-rising logarithmic shape. Many smoother flavours of PWM are thus available.

While Just Type is admittedly aimed at a small userbase of scripting Eurorack users, the broader benefit is that the synthesis engine has been brought into a new RUN mode. SIFT has been removed (it's mostly accessible from SHIFT) and SPILL moved, thus now FLOOM mode can be present. This new mode provides an internal modulation oscillator on every channel. Thus each voice is a 2-operator FM voice. The ratio of the oscillators can be set via RUN voltage, and modulation amount via the FM knob & cv input.

A prior bug in STRATA mode has been remedied, and a hardware calibration mode has been added (though remains mostly unnecessary). Otherwise Just Friends remains largely the same.



JF v3.2.a6

See the JF Firmware Update Instructions for how to complete the update.



v3.2.a6: 2020-07-07

v3.2.a4: 2020-06-29 (Support in Crow v2.0)

v3.1.2: 2018-11-26

v3.1.1: 2018-08-13

v3.0.5: 2018-04-18




General functionality:

RUN modes:

Herein Just Type is explained to some extensive degree.


Calibration Procedure

You shouldn't need this, but just in case! Furthermore, if things go awry you can perform a 'factory reset' to return to the pretty-damn-accurate default settings (see below below).

Calibration mode is launched at startup similarly to the bootloader, but with all knobs fully CW (maximum pots, sound, cycle, RUN jack inserted). Calibration settings are saved on-chip, so you'll only have to do this once.

  1. Turn off your synthesizer & set controls: all pots fully CW, sound, cycle, cable in RUN
  2. Turn on the power. You should only see IDENTITY lit, signaling calibration mode
  3. Connect your tuning voltage source to TIME. Set it to 0V output
  4. Switch to shape mode. 2N will light
  5. Set your voltage source to 2V
  6. Switch to sustain mode. 3N will light
  7. Switch back to cycle mode. 4N will light after a small delay while settings are saved
  8. Switch to sound mode. Just Friends will restart with your new settings.

Now each time you run JF it will use your custom calibrated values. Of course you can set different voltage offsets & tuning for truly weird behaviour. If JF is too fast, you could calibrate it to 1V & 3V to shift the pitch range down by an octave with no cable attached. Or calibrate to 2.4V for buchla standard 1.2V/octave. You probably just want to do it as outlined above though..

nb: The calibration settings will be retained even when re-flashing the firmware, so no need to re-do it each time you update.

nb: If you make a mistake with the switches in calibration mode it will just exit and use the existing setup. You can rerun the procedure as many times as you need.


Factory Reset

If you need to return to the factory tuning settings, follow the below steps:

  1. Turn off your synth & set the calibration mode settings (All knobs fully CW, sound, cycle, cable in RUN)
  2. Turn on & you'll be in calibration mode. IDENTITY will be lit
  3. Turn all knobs fully CCW
  4. Switch to shape. The module will pause for a brief moment while it overwrites the custom tuning, then restart as normal.

That's it!