Flash Synth

git clone https://git.mitxela.com/flash-synth.git

* c759feb (HEAD -> master) | mitxela 2022-07-28 19:09 | update readme | * 4511a81 | mitxela 2022-04-30 14:05 | update readme | * 7e5a4e7 | mitxela 2022-04-10 14:15 | Add detailed compilation instructions | * 488814c | mitxela 2022-04-10 14:15 | assert xxd is installed | * 3d5c23b | mitxela 2021-01-26 19:41 | Add info about dev board | * a0ac05b | mitxela 2021-01-11 00:27 | Add readme | * 6e47d05 | mitxela 2021-01-11 00:17 | Make targets phony | * ff5c4fb | mitxela 2021-01-11 00:09 | Cleanup, add correct pinout image | * 92fc2d2 (tag: firmware-v6) | mitxela 2020-11-04 15:20 | Increase version number to 6 | * 389bfc1 | mitxela 2020-11-04 14:24 | Give PWM depth its own CC | * 1ab6acf | mitxela 2020-10-24 17:57 | Add some subtractive patches | * af9be85 | mitxela 2020-10-24 14:31 | Allow disabling of oscillators in algo3 mono | * 3f335e8 | mitxela 2020-10-24 12:43 | PWM for algo 3 using fm_depth | * 75496f6 |\ mitxela 2020-10-22 18:21 | | Merge branch 'bleps' | | | * 907bc26 | | mitxela 2020-10-22 18:12 | | A not very pretty, but slightly more reliable way of doing the square/saw switch | | | * 4f3994a | | mitxela 2020-10-22 18:01 | | Mute algo3mono above fs/4 | | | * f09db95 | | mitxela 2020-10-22 04:06 | | Move algo3 into template format | | | * 42b136d | | mitxela 2020-10-22 02:39 | | Interim checkin on algo3 mono | | | * 09578d4 | | mitxela 2020-10-13 12:23 | | Implement filter envelope | | | * e4c1e7c | | mitxela 2020-10-12 15:00 | | New envelope routine that doesn't compromise on crispness | | | * 98ca178 | | mitxela 2020-05-04 02:00 | | Localize state with questionable clarity | | | * 38fc20a | | mitxela 2020-05-03 18:53 | | Pulse/saw transition and normalize pulse dc offset | | | * d7ecc3c | | mitxela 2020-05-03 15:00 | | fix blepsaw recalc | | | * 4399934 | | mitxela 2020-05-03 14:32 | | Interim checkin for blepsaw | | | * 82c674a | | mitxela 2020-05-02 14:39 | | Filter algorithm with handwavy pitch tracking | | | * 2c77234 | | mitxela 2020-04-25 16:21 | | Solve concurency problems by not using bitfields | | | * 82e7263 | | mitxela 2020-04-25 12:37 | | Cleanup | | | * cb5c873 | | mitxela 2020-04-25 01:05 | | Blepstate recalc working | | | * 42a63ba | | mitxela 2020-04-24 20:20 | | A not-quite-sufficient fix for recalculating blepstate | | | * 67a8199 | | mitxela 2020-04-24 16:18 | | bleps via state machine | | | * df18b61 | | mitxela 2020-04-24 15:21 | | still slightly voodoo blepsquare | | | * 7fb6572 | | mitxela 2020-04-23 17:12 | | algo3 poly 9 | | | * 7fe511b | | mitxela 2020-04-23 17:03 | | Experiments with blep lookup tables | | | * 3d7098f | | mitxela 2020-04-22 19:08 | | Polyblep square and saw algo | | | * 2aef36d | | mitxela 2020-04-22 14:55 | | Add fake sync waveforms | | | * f1f30bd | | mitxela 2020-04-05 17:45 | | Better implementation of antialias filter | | * | d755b78 (tag: firmware-v5) | | mitxela 2020-10-10 15:56 | | Version number to 5 | | * | 95e7439 | | mitxela 2020-10-10 15:56 | | Auto-select tuning tables per channel on startup | | * | efbe375 |/ mitxela 2020-10-10 15:50 | Remove old files | * 7b55cfb (tag: firmware-v4) | mitxela 2020-03-18 11:06 | fixup! Add table names and config area to flash, enable channel masking | * 298d045 | mitxela 2020-03-17 21:41 | Align flash section to page boundary (pages are 2k) | * a76c07d | mitxela 2020-03-15 11:12 | Increase version number to 4 | * f94fe10 | mitxela 2020-03-15 11:10 | Potentially fix patch change on some systems | * 7929699 | mitxela 2020-03-15 11:10 | Implement all-notes-off, all-sound-off CC messages | * ec23d26 | mitxela 2020-03-15 11:09 | Add table names and config area to flash, enable channel masking | * f242791 | mitxela 2020-01-09 12:49 | update all-channels tuning behaviour, add 0xFF reset | * f2b5668 | mitxela 2020-01-09 12:47 | Update patch names | * f93a177 | mitxela 2020-01-02 13:41 | fix version.sh permission again | * 6990d40 | mitxela 2019-12-29 21:38 | Binary mangling depends on version.sh in makefile | * fe10429 | mitxela 2019-12-29 21:09 | Ignore midi system real-time | * d56d9a1 | mitxela 2019-11-29 16:20 | Patch names | * 3aad8d7 | mitxela 2019-11-27 16:23 | Made a start on naming patches | * a334212 | mitxela 2019-11-27 16:22 | Incr version number, reset on fault | * 478d673 | mitxela 2019-11-27 16:21 | Output gain as part of patch, zero defaults to 1 | * c62ba78 | mitxela 2019-11-27 01:11 | Populate tuning tables with final freqs | * 139d814 | mitxela 2019-11-20 14:28 | Fix FM overflow | * 91dc456 | mitxela 2019-11-12 13:17 | Patches | * 54cab9b | mitxela 2019-10-07 19:02 | Output gain control | * 5192b27 | mitxela 2019-09-23 18:16 | Wave loading cancel checks | * 7e5da39 | mitxela 2019-09-23 16:59 | Reasonably effective waveform normalization | * babb4cd | mitxela 2019-09-23 15:49 | Load modulation from patch | * 0b57aec | mitxela 2019-09-20 23:41 | Patches enum WIP | * 87436f1 | mitxela 2019-09-20 22:20 | Solution to get portamento before LFO | * 7ad1c2a | mitxela 2019-09-20 20:13 | Normalize FM attack rate against depth | * 388f7da | mitxela 2019-09-20 19:26 | Unify switch statement style | * 11b216e | mitxela 2019-09-20 19:11 | Rewrite hammond wave loading, slower but avoids loud buzz noise | * 7091962 | mitxela 2019-09-20 16:25 | Algo 2 quad | * c2a5343 | mitxela 2019-09-20 15:55 | Quad oscillators | * 5ae3dd6 | mitxela 2019-09-19 16:47 | Variable saw/triangle waveform | * b286bfa | mitxela 2019-09-19 15:14 | Cleanly empty the notestack when switching algorithms | * 82bbcf3 | mitxela 2019-09-19 01:24 | Waveform params: hammond harmonics and pulse duty | * dd2aec4 | mitxela 2019-09-18 17:24 | Finally configure wobble on max LFO | * 37e7d99 | mitxela 2019-09-17 00:32 | Dubious improvements to code readability | * f9de741 | mitxela 2019-09-16 23:19 | Fix monophonic algorithms | * 5472adc | mitxela 2019-09-16 17:34 | Simple defense against out-of-bounds notes | * ec8f6eb | mitxela 2019-09-16 16:34 | Flag to reset on fault conditions | * 2c23946 | mitxela 2019-09-16 15:37 | Stop FM attack being a function of frequency | * 1ac63d4 | mitxela 2019-07-31 14:15 | Fix fm depth attack glitch | * 256ee5b | mitxela 2019-07-25 23:38 | Overlay version number and commit hash/timestamp onto reserved interrupt vectors | * fd475d5 | mitxela 2019-07-25 16:21 | Fix note theft envelope stuff | * 95fbc8a | mitxela 2019-07-23 16:53 | pre-env attack, algo2 stereo, waveform restructure | * 4f590bd | mitxela 2019-07-20 20:40 | Multiple monophonic algorithms | * 2c21f5a | mitxela 2019-07-20 13:46 | Fix status channel logic | * 2bb6917 | mitxela 2019-07-20 02:05 | Arpeggiator to store channel of each note | * 881ebf0 | mitxela 2019-07-20 00:48 | More waveforms and tuning tables | * 58ca939 | mitxela 2019-07-13 19:56 | Alter behaviour when arpeg speed is zero | * 236039a | mitxela 2019-07-13 15:37 | Portamento | * cf36a2e | mitxela 2019-07-13 14:44 | Arpeggiator sustain pedal | * de52f5e | mitxela 2019-07-13 02:36 | Subtle change to arpeg behaviour | * 9cae825 | mitxela 2019-07-12 13:04 | Further improvements to arpeggiator | * a65f071 | mitxela 2019-07-12 12:27 | Improvements to arpeggiator | * c1c46a0 | mitxela 2019-07-11 16:47 | Arpeggiator | * 5b60b72 | mitxela 2019-07-11 13:20 | Rework algorithm framework and add monophonic algo | * ee7d671 | mitxela 2019-07-07 22:45 | Steps towards graceful theft, still skips attack occasionally | * 077b6ca | mitxela 2019-07-07 03:31 | Cleanup function pointers and revert note-stealing | * 2bb3825 | mitxela 2019-07-06 19:57 | Suppress maybe-uninitialized warning (related to -O3 ?) | * d7ac68e | mitxela 2019-07-06 18:12 | Makefile to generate pgm image | * 49007f2 | mitxela 2019-07-06 17:29 | Expand note stealing to favour same notenumber | * e2bf08e | mitxela 2019-07-06 16:55 | Reset envelope when stealing notes | * 885b350 | mitxela 2019-07-06 14:06 | Fix clicking noise in algorithm 2 | * 4036da5 | mitxela 2019-07-06 00:10 | Invert inputs for attack/release times | * a10448b | mitxela 2019-05-18 20:20 | Optimize envelope code ready for ADSR | * 51483a1 | mitxela 2019-05-17 13:00 | Make detune symmetrical | * ee2ddec | mitxela 2019-05-16 15:49 | un-inline phase delta calculation | * 053dd1c | mitxela 2019-05-12 19:26 | Fix loops for dual oscillators | * db956ca | mitxela 2019-05-12 18:51 | Functional dual-oscillator stereo mode | * 5dc1448 | mitxela 2019-05-12 02:13 | remove volatile keyword | * 72ca404 |\ mitxela 2019-05-11 21:57 | | Merge remote-tracking branch 'origin/fix-makefile' | | | * 66230ec | | mitxela 2019-05-11 18:33 | | Fix makefile to generate correct .d files | | | * 9f5abef | | mitxela 2019-03-04 21:16 | | Add support for https://github.com/texane/stlink | | * | 22931f8 |/ mitxela 2019-05-11 14:04 | Add patches header file | * df82a8e | mitxela 2019-05-11 01:33 | Experiments with operator order | * c343f92 | mitxela 2019-05-10 18:34 | Patch loading | * e487098 | mitxela 2019-05-10 17:05 | Edit makefile to explicitly depend on the header files | * 686cfdb | mitxela 2019-05-10 15:51 | Load waveforms asynchronously, start on patch system | * f9c6d5b | mitxela 2019-05-10 14:40 | Experiments with different waveforms | * c1470c2 | mitxela 2019-03-25 17:05 | Update tuning table selection logic | * d7bebea | mitxela 2019-03-25 16:48 | Add stm32loader.py to repo | * 266369a | mitxela 2019-03-24 12:51 | A possible solution for pitchbend + LFO + tuning tables | * 79924d0 | mitxela 2019-03-24 12:18 | Update oscillators to wrap at 8192 | * 2dc4e08 | mitxela 2019-03-21 16:39 | Tuning tables on CC114 | * 7ff27e9 | mitxela 2019-03-21 03:21 | Split tuning tables over multiple lines | * db1ac13 | mitxela 2019-03-21 03:21 | Normalize wobble pitch | * 8cff960 | mitxela 2019-02-26 00:27 | Example/test of oscillator algorithm switching | * 94e7114 | mitxela 2019-02-26 00:09 | Move lookup table into fixed area of flash | * f2bc8dc | mitxela 2019-01-11 16:51 | Link velocity to FM depth | * e231629 | mitxela 2018-12-08 19:53 | simple velocity | * 64322a9 | mitxela 2018-12-08 17:57 | Makefile to output readable asm | * c65f271 | mitxela 2018-07-24 14:23 | Experiments with generated lookup tables | * 4180e22 | mitxela 2018-07-23 21:55 | Don't let aftertouch cancel out modulation | * c47acae | mitxela 2018-07-23 21:30 | Reduce risk of DAC channels starting out of sync | * 72a8866 | root 2018-07-23 19:46 | Stereo output from single buffer | * 24f7cad | root 2018-07-23 15:35 | Changes neccessary to build for STM32L432xx | * fd2c989 | root 2018-07-10 16:03 | Use channel aftertouch to control lfo depth | * 820c94a | root 2018-07-10 15:38 | Change make flash to be compatible with WSL | * 3e17e14 | mitxela 2018-07-09 14:30 | Pinout image | * 9bdab7b | mitxela 2018-06-18 17:40 | Use macro for different clock freqs | * 6d28466 | mitxela 2018-06-18 15:19 | rng and attempt at power equalization | * e5bb9e8 | mitxela 2018-04-15 13:59 | Add LFO, fm depth compensation, defaults | * 2c6301d | mitxela 2018-04-15 11:47 | Fix sustain note-stealing | * b9a6aa7 | mitxela 2018-04-15 11:20 | Simple FM synth | * be4adc8 | mitxela 2018-04-15 01:10 | Sine LUT | * 724dc21 | mitxela 2018-04-12 00:30 | Fix envelope clickyness | * 034f366 | mitxela 2018-04-11 17:18 | Use lookup tables for frequency calculation | * 5f2368d | mitxela 2018-04-11 15:33 | Timestamp based note-stealing | * 8ca1df2 | mitxela 2018-03-11 19:04 | Sustain pedal | * 99b5915 | mitxela 2018-02-15 16:58 | fix hung notes on release | * c9bb795 | mitxela 2018-02-15 14:26 | simple envelope | * e9a63d6 | mitxela 2018-02-15 13:48 | Poly pitchbend sensitivity. Tuned 440Hz | * 5388ff5 | mitxela 2018-02-14 18:30 | channel-specific pitchbend |

Flash Synth

About

This source code is offered to allow users to modify and share custom firmware versions for use exclusively with the FLASH synthesizer, manufactured by and sold by H-Pi Instruments. The code is not intended for use with any other hardware (clones or derivatives remain forbidden). We offer this code with no warranties or guarantees, and with no technical support concerning firmware programming. Use at your own risk. To share your modified compiled firmware file with other users, use the function within UTE to convert the .bin file into a .uboothex file (see the latest version of the FLASH synth documentation for instructions on how to do this). The .uboothex file can then be sent to H-Pi Instruments for inclusion in an online user firmware archive.

Summary

Background reading: https://mitxela.com/projects/flash_synth

The processor is an STM32L432KC, running at 64MHz (determined experimentally to give the best performance when powered by MIDI). The chip has 256kB of flash memory and 64kB of RAM.

MIDI input on USART1, interrupting on every byte, no buffer.

Timer6 and DMA are used to feed samples to the 12-bit DAC, interrupts at half-transfer and transfer-complete are where samples are generated. Switching between stereo and mono sound output requires reinitializing the DMA.

HAL functions are used for some of the setup, there is a small runtime overhead associated with HAL, a future task is to rewrite this using register access or the LL functions.

Wavetables are 8192 samples long. All oscillator phases are normalized from 0 to 8192.0, even the algorithms which don't use tables.

12-bit DAC means 4096 output levels, at a polyphony of 16 this means a maximum amplitude of ±128.

Pretty much everything that can be cached, is cached. MIDI data says a certain parameter must be X, and we need X*K in the algorithm, then multiply by K at the moment it arrives. RAM is much cheaper than processor cycles.

Envelopes are all optimised by caching their deltas, so the per-sample code only consists of an addition. This means they must be quantised to the buffer size. This is done in the inlined envelope functions.

Defines for POLYPHONY and BUFFERSIZE are there for clarity only, things will break if they are changed.

Notes on FM algorithms

In algorithms 1 and 2, for the sake of extreme optimisation, no interpolation at all is done between samples. Instead, the wavetables are just about big enough to let us pre-process them with an antialiasing filter, making a nearest-neighbour interpolation viable. There is some loss of bit-depth at the low end, which can be heard, but the benefit is we save at least two multiply-accumulates per oscillator per sample. I wasn't sure if I was going to get away with this, but so far no-one has complained.

Similarly there is no explicit antialiasing at the top end, only the pre-processing of the wavetables. The FM effect depth is reduced with higher pitches to limit aliasing.

For reduced-polyphony algorithms, variables of the "unused" voices are re-used for various things. Clarity could potentially be improved by using macros for some of this.

Notes on Algo 3

The bleps-via-state-machine has the same output as a 2-sample polyblep, but with a fraction of the overhead. Looking through the commit history may help to explain how it works.

The constant for filter tracking was determined experimentally, and may not be correct (or even linear).

Compiling

Note: I have now added more detailed instructions towards the end of this page.

arm-gcc and a posix environment are needed to compile. An ST-link utility is needed to flash the dev board. make flash assumes a WSL environment, use make flash-stl on linux. The makefile could be updated to detect OS.

xxd (command line hex editor) is needed by version.sh (post-build step)

It's possible to attach GDB for debugging, some effort would be required to get this to work with an IDE.

In the build folder, a .pgm file is generated which gives a visual overview of program memory usage.

File descriptions

• Src/main.c is the main source code, including entry point, usart and DMA interrupts

• Src/algo3_mono.h and Src/algo3_poly16.h are template files for algorithm 3. They are included repeatedly with different defines to limit the amount of code repetition without adding overhead. This method of doing it was settled on after much debate.

• Src/system_stm32l4xx.c, Src/stm32l4xx_hal_msp.c, Src/stm32l4xx_it.c, and the contents of Inc/ are part of the generated setup code, do not add new interrupts into _it files, stick them in main.c. These files could potentially be removed/merged into main.c.

• Src/lookupTables.h contains the main lookup tables and constants data. Some of the tables have javascript snippets which were used to generate them. Anything with a section attribute has a specific place it needs to be in memory, to be updated with the bootloader/programming software, in many cases the data itself is just a placeholder.

• Src/defaultPatches.h contains more constants data related to the patches and a config section. The config section could potentially be formatted better, there isn't a pleasant way to stick individual variables at specific locations in gcc.

• version.sh is invoked by the makefile and inserts the version number into the compiled binary. The location is amidst the interrupt vectors (labelled as "reserved area" in startup_stm32l432xx.s). Having this as a separate file makes it easier to keep track of. It also inserts a commit hash if the working tree is clean or a timestamp otherwise.

Potential optimisations / improvements

• Remove remaining HAL code

• SysTick is not used, should be stripped out if there's no HAL function left depending on it

• RAM usage, we're OK for RAM at the moment but several chunks are only used in certain modes, if we get short of RAM these should be unionised. The cleanest way of doing this I can think of is to use macros.

• For clarity, more of the repeated code relating to algorithms 1 and 2 should be moved to the newer template format.

• FM depth adjustment in realtime, implement similarly to how the filter in algo 3 is done.

• (daydreaming) For a potentially enormous performance increase, move all executed code to RAM, and replace all function pointer stuff with assembled code segments. This will require re-writing a vast amount of the synth code. There may be some benefits of moving interrupts into RAM regardless, this is not difficult to do, but hard to profile.

Known problems

• bitfield concurrency issues. Some further investigation of the preemption priority levels is needed to see what's interrupting what, but it's become apparent that bitfields under gcc are not thread-safe. The only thing still using bitfields is the envelope state. The effect is that very occasionally, an envelope skips its attack phase. It should be possible to fiddle with things so that problems never happen. Worst case scenario, use an entire byte for every boolean, but there should be a simpler solution than that.

• bootloader distortion problem with original 150 units

Detailed compilation instructions

Compiling on Linux (Debian / Ubuntu)

1. Install, update and upgrade apt.

   sudo apt install
   sudo apt update
   sudo apt upgrade
   

2. Install the ARM GCC toolchain. On Ubuntu and Debian, the package name is gcc-arm-none-eabi

   sudo apt-get install gcc-arm-none-eabi
   

3. If you don't already have it, install make which will be part of the essential build tools (build-essential on Debian, base-devel on Arch).

   sudo apt install make
   

4. Clone the repo, cd into it and run make to compile.

   git clone https://github.com/mitxela/flash-synth
   cd flash-synth
   make
   

If everything worked, you should now have a build folder, containing flash-synth.bin, along with flash-synth.pgm (the memory preview image) and a whole load of intermediate build files.

The file named flash-synth.bin is the compiled firmware file.

If using WSL2, see the extra step below for copying the binary file from the virtual machine to your Windows file system.

Compiling on Arch Linux

Infuriatingly, the ARM GCC toolchain is inconsistently named in different places. On Arch, the package name is arm-none-eabi-gcc.

You will also need to install git and xxd (which is normally packaged as part of Vim, but on Arch it's also available standalone in the AUR). If you don't already have it, install make which will be part of the essential build tools (build-essential on Debian, base-devel on Arch).

sudo pacman -S base-devel arm-none-eabi-gcc git vim

Then clone the repo, cd into it and run make to compile.

Compiling on Windows (WSL)

WSL gives you a Linux installation on windows. Currently by default this means Ubuntu.

There are two versions of WSL, the instructions are the same for either version. The main differences between the versions are file handling and speed. WSL2 is installed by default using the instructions below.

Do a Windows search for "command prompt" (you must do this to run as administrator). Right-click on the result and choose "Run as administrator", then type:

wsl --install

Once installed, the compilation instructions are identical to building on Linux (see above Compiling on Debian / Ubuntu).

If you want to work with this file under Windows, you will need to copy the binary from the virtual machine to your Windows file system. Note that this is not done in WSL/Linux, it is done using Windows PowerShell or command prompt. Below, we copy the file to the desktop.

Open a command prompt as Administrator again then type:

copy \\$wsl\Ubuntu\home\<your-wsl-linux-username>\flash-synth\build\flash-synth.bin C:\Users\<your-windows-username>\Desktop

Note: if you are using WSL 1, the drives are mounted within the environment, the C: drive is at /mnt/c/ so to do the above in a WSL 1 terminal:

cp build/flash-synth.bin /mnt/c/Users/<username>/Desktop

However, if using WSL 1 I would recommend simply cloning into a folder on the C: drive to begin with, e.g.

cd /mnt/c/Users/<username>/Documents
git clone https://github.com/mitxela/flash-synth
cd flash-synth
make

Compiling on Windows (MSYS2)

If you're not interested in WSL then the best way to compile is probably MSYS2. I really like MSYS2, it uses pacman (as in Arch Linux) and generally works very well. Here's some step-by-step instructions:

1. Start by heading to https://www.msys2.org/ and follow the installation instructions, which means downloading and running the installer, then running pacman -Syu etc. After installing, you may want to go to the options (right click the title bar) and under Keys, select Ctrl+Shift+letter shortcuts. This lets you paste by pressing ctrl+shift+V.

2. In the MSYS terminal, install the necessary software by running:

   pacman -S base-devel git vim mingw-w64-x86_64-arm-none-eabi-gcc
   

   (the xxd package is bundled with vim)

   2.5 Extra step: On my MSYS install, the tools were installed to somewhere that wasn't included in PATH. Try running arm-none-eabi-gcc on its own - if you get "fatal error: no input files" then it's working. If you get "command not found" then you need to add it to your PATH. The simplest way is to run this command once:

   echo 'export PATH=/mingw64/bin:$PATH' >> ~/.bashrc
   

   and then restart the MSYS terminal.

3. Clone this repo. MSYS puts the C: drive at /c/ (Whereas WSL puts the C: drive at /mnt/c/) but you can just clone into the msys home directory if you prefer, which is wherever you installed it (e.g. C:\msys64\home\User)

   git clone https://github.com/mitxela/flash-synth.git
   

4. Enter the directory by typing

   cd flash-synth
   

5. Compile the code by typing

   make
   

If everything worked, you should now have a build folder, containing flash-synth.bin, along with flash-synth.pgm (the memory preview image) and a whole load of intermediate build files.

Updating

If the code is updated and you want to download the latest version and compile it, within the flash-synth directory run:

git pull

and then

make

It will only re-compile the bits needed. If you want to recompile from scratch, run make clean first.