Skip to content

Commit

Permalink
Merge branch 'v2' of https://github.com/hemmer/Befaco into v2
Browse files Browse the repository at this point in the history
  • Loading branch information
hemmer committed Apr 23, 2024
2 parents 3fe096d + 5bc5663 commit bd1d36f
Show file tree
Hide file tree
Showing 26 changed files with 12,501 additions and 203 deletions.
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,5 @@
/plugin.dylib
/plugin.dll
/plugin.so
.DS_Store
.DS_Store
/.vscode
25 changes: 25 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,30 @@
# Change Log


## v2.7.0
* Midi Thing 2
* Initial release
* Octaves
* Better default oversampling setting (x4)


## v2.6.0
* Octaves
* Initial release
* Misc
* Better default values for ADSR and Burst


## v2.5.0
* Burst
* Initial release
* Voltio
* Initial release
* PonyVCO
* Now polyphonic
* Misc
* Fix trigger inputs to follow Rack voltage standards (Kickall, Muxlicer, Rampage)

## v2.4.1
* Rampage
* Fix SIMD bug
Expand Down
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,4 +28,6 @@ We have tried to make the VCV implementations as authentic as possible, however
* to limit the pulsewidth from 5% to 95% (hardware is full range)
* to remove DC from the pulse waveform output (hardware contains DC for non-50% duty cycles)

* MotionMTR optionally doesn't use the 10V normalling on inputs if in audio mode to avoid acidentally adding unwanted DC to audio signals, see context menu. E.g. if you temporarily unpatch an audio source whilst using it it mixer mode, you get 10V DC suddenly and a nasty pop.
* MotionMTR optionally doesn't use the 10V normalling on inputs if in audio mode to avoid acidentally adding unwanted DC to audio signals, see context menu. E.g. if you temporarily unpatch an audio source whilst using it it mixer mode, you get 10V DC suddenly and a nasty pop.

* Burst hardware version version can also set the tempo by tapping the encoder, this is not possible in the VCV version.
28 changes: 28 additions & 0 deletions docs/MIDIThingV2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# MIDI Thing v2

The original MIDI Thing v2 hardware unit is described as follows:

> Midi Thing v2 is a flexible MIDI to CV converter. Allowing polyphonic notes handling, envelope and LFO generation as well as all available MIDI messages to be converted into CV. This is a huge upgrade from our previous beloved MIDI Thing, which adds a screen for easy configuration,12 assignable ports, TRS, USB Host and Device, MIDI merge OUT, a web configuration tool, and a VCV rack Bridge counterpart.
The VCV counterpart is designed to allow users to quickly get up and running with their hardware, i.e. sending CV from VCV to the hardware unit.

## Setup

To use, first ensure the MIDI Thing v2 is plugged into your computer, and visible as a MIDI device. Then select it, either from the top of the module, or the right click context menu. Then click "SYNC" - this puts the MIDI Thing into a preset designed to work with VCV Rack, and syncronises settings/voltage ranges etc. Note that for now, sync is one-way (VCV to hardware).

![MIDI Thing Config](img/MidiThingV2.png "MIDI Thing v2 Setup")

## Usage

To use, simply wire CV which you wish to send to the hardware to the matching input on the VCV module. Note that you will need to select the range, which can be done by right-clicking on the matching box (see below). Options are 0/10v, -5/5v, -10/0v, 0/8v, 0/5v. Note that the module is **not** designed to work with audio rate signals, just CV.

![MIDI Thing Voltage Range](img/VoltageRange.png "MIDI Thing v2 Voltage Range")

## Update Rate

Midi Thing v2 VCV allows the user to configure the update rate at which data is sent over MIDI. This must be shared between the channels, so if we set the hardware to update at 1 kHz, 1 active channel will update at 1 kHz, 2 active channels will update at 500 Hz, 4 active channels at 250 Hz and so on. The total update rate (to be shared between channels) is set from the context menu, noting that higher update rates will use more CPU. The effect of the update rate on a 90 Hz saw (blue trace) can be seen in the bottom image, specifically that the temporal resolution of the reconstructed signal (red traces) improves as the update rate is increased from 500 Hz to 1000 Hz to 2000 Hz.

![MIDI Thing Update Rates](img/UpdateRate.png "MIDI Thing v2 Update Ranges Menu")
![MIDI Thing Update Rates](img/UpdateRatesScope.png "MIDI Thing v2 Update Ranges Menu")


Binary file added docs/img/MidiThingV2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/UpdateRate.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/UpdateRatesScope.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/VoltageRange.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
53 changes: 51 additions & 2 deletions plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"slug": "Befaco",
"version": "2.4.1",
"version": "2.7.0",
"license": "GPL-3.0-or-later",
"name": "Befaco",
"brand": "Befaco",
Expand Down Expand Up @@ -267,6 +267,7 @@
"Hardware clone",
"Low-frequency oscillator",
"Oscillator",
"Polyphonic",
"Waveshaper"
]
},
Expand All @@ -282,6 +283,54 @@
"Mixer",
"Visual"
]
},
{
"slug": "Burst",
"name": "Burst",
"description": "Trigger processor and generator, designed to add an organic chain of events",
"manualUrl": "https://www.befaco.org/burst-2/",
"modularGridUrl": "https://www.modulargrid.net/e/befaco-burst-",
"tags": [
"Clock generator",
"Clock modulator",
"Hardware clone"
]
},
{
"slug": "MidiThingV2",
"name": "MIDI Thing V2",
"description": "Hardware MIDI Thing v2 is a flexible MIDI to CV converter, this module acts as a bridge from VCV",
"manualUrl": "https://github.com/VCVRack/Befaco/blob/v2/docs/MIDIThingV2.md",
"modularGridUrl": "https://www.modulargrid.net/e/befaco-midi-thing-v2",
"tags": [
"External",
"MIDI",
"Hardware clone"
]
},
{
"slug": "Voltio",
"name": "Voltio",
"description": "An accurate voltage source and precision adder.",
"manualUrl": "https://www.befaco.org/voltio/",
"modularGridUrl": "https://www.modulargrid.net/e/befaco-voltio",
"tags": [
"Hardware clone",
"Polyphonic",
"Utility"
]
},
{
"slug": "Octaves",
"name": "Octaves",
"description": "A harsh and funky take of an additive Oscillator.",
"manualUrl": "https://www.befaco.org/octaves-vco/",
"modularGridUrl": "https://www.modulargrid.net/e/befaco-octaves-vco",
"tags": [
"Hardware clone",
"Oscillator",
"Polyphonic"
]
}
]
}
}
Loading

0 comments on commit bd1d36f

Please sign in to comment.