background image

OPEN SOURCE PROJECT 

The Spankulator is an Open Source project that has an Arduino 33 IoT at its core. The code is 
written in C++ and makes use of several public domain code libraries for managing the various 
purchased hardware components such as the display and the FRAM non-volatile memory. 

Because it is Open Source, in addition to being used by musicians and sound designers to 
create new and amazing sounds, the Spankulator can be used by students and entrepreneurs 
to create new, amazing modules. And, of course, the open source community will generally 
improve the product as times goes along. Links to the design repositories can be found on the 
Spankulator web page. 

 

TRIGGER 

The Spankulator is controlled by the user issuing Commands. Commands are initiated by 
pressing the front panel buttons or by using the WiFi or Terminal interfaces. Regardless of the 
source of the command, it will be called either a command or a keypress in this document. 

The various functions that the Spankulator performs are called 

Spanks

 and will be referred to 

as such in this document. 

All of the Spankulator

s functions are activated by a trigger. Triggers can come from various 

sources: 

 

Pushing the Trigger (Adjust) knob. 

 

Receiving a 0 to 5V transition on the Trig In jack. 

 

Receiving a Trigger command from either the Wifi or Terminal interface 

When a Trigger is received, the Spankulator will execute a Spank that sends pulses at the Trig 
Out jack and varying voltage levels at the CV Out jack. When the Spank ends, the Tog Out jack 
will switch polarity from one to zero or vice versa. 

REPEAT MODE  

If Repeat is set to OFF, the Spankulator will remain in whatever condition it was in when the 
Spank ended until it receives another Trigger. 

If Repeat is set to ON, the Spank will continuously repeat. 

In either case, receipt of another Trigger or Command will interrupt the Spank, stopping 
execution until a new Trigger is received. 

Summary of Contents for THE SPANKULATOR

Page 1: ...THE SPANKULATOR USER MANUAL Greenface Labs 2021...

Page 2: ...4 Signals 4 Operation 6 General Operation 6 Open Source Project 7 Trigger 7 Repeat Mode 7 CV Scale 8 Sig In 8 Screen Saver 8 Function Details 9 Up 10 Down 11 Stretch 12 Toggle 13 Maytag 14 LFO 15 Use...

Page 3: ...G VCF Mod Amount 0 Cutoff 200Hz Resonance 50 Attack 5 Decay 10 Sustain Off Frequency 50 Pulse Width 50 VCO Wave Pulse Octave 4 Note 8 SPANKULATOR SET UP Fxn Down use default parameters as shown in ima...

Page 4: ...n richer user experiences with the addition of computer resources like a keyboard display and scripting All settings are stored in Flash memory so that they are retained when power is off Selectable S...

Page 5: ...Figure 1 Front Panel...

Page 6: ...d using the Terminal or Web Interface Operation of each function is triggered by a variety of methods o Pressing the Adjust button o Receiving a low to high transition on the Trig In jack o Terminal u...

Page 7: ...of the source of the command it will be called either a command or a keypress in this document The various functions that the Spankulator performs are called Spanks and will be referred to as such in...

Page 8: ...he O key followed by a number from 0 to 1023 followed by a carriage return Press the screen refresh command to see the effect SIG IN The Signal In jack has a range of 5V to 5V It is used by the Bounce...

Page 9: ...TAILS The Spankulator has ten functions These are listed below with their associated command index Details for each function follow 0 Up 1 Down 2 Stretch 3 Toggle 4 Maytag 5 LFO 6 User 7 Bounce 8 WiFi...

Page 10: ...minimum 5V when the Spank starts and will increase to the maximum 5V when the Spank completes This range can be reduced by using the CV Scale control Parameter Min Max Default End Pulse Len 10 9999 10...

Page 11: ...maximum 5V when the Spank starts and will decrease to the minimum 5V when the Spank completes This range can be reduced by using the CV Scale control Parameter Min Max Default End Pulse Len 10 9999 10...

Page 12: ...CV Scale control Parameter Min Max Default Pulse Length 10 9999 10 Delay 10 9999 100 Num Pulses 2 99 1 Level 1 0 1023 1023 Level 2 0 1023 512 The figure below illustrates a Stretch Spank with the def...

Page 13: ...trol Parameter Min Max Default Delay 1 9999 100 Hi Level 0 1023 1023 Lo Level 0 1023 0 State LO HI Toggle The figure below illustrates a Toggle Spank with the default settings The yellow trace is Trig...

Page 14: ...imum 5V when the Spank starts and will decrease to the minimum 5V when the Spank completes This range can be reduced by using the CV Scale control Parameter Min Max Default End Pulse Len 10 9999 10 St...

Page 15: ...using the CV Scale control The Period is in milliseconds Parameter Min Max Default Period 2 9999 10 Waveform N A N A SINE The figure below illustrates an LFO Spank with the default settings The yellow...

Page 16: ...edited without affecting other User Spanks or the Spank that was the initial source of the parameter data It is important to note that changing an element of the User sequence will overwrite all the...

Page 17: ...a Trigger occurs and then bounces that voltage scaled by the Adj knob to CV Out It also generates a 732Hz PWM signal at Trig Out with the duty cycle proportional to the measurement Mode 0 Duty Cycle...

Page 18: ...bars The signal strength display is shown in every function If the connection fails the Spankulator will give its best explanation of why it failed The Spankulator remembers its connection and will re...

Page 19: ...WEB INTERFACE EXAMPLE Figure 9 Web Interface Example...

Page 20: ...VT 100 mode The Spankulator is set to run at 115200 baud but will adapt to the PuTTY settings Please refer to the table of commands that follows this section TERMINAL EXAMPLE SCREEN Figure 10 Terminal...

Page 21: ...n Name Select Parameter N A px n Click on Param Enter Parameter N A xxxx n Use Param Input Increment Digit Adjust clockwise u Inc Decrement Digit Counter clockwise d Dec Notes All instances n means to...

Page 22: ...pulse lengths are irrelevant but the levels at CV Out will be the same as they would in Internal mode Feed the External Clock signal into Trig In 3 Encoder Type takes the two types of rotary encoder i...

Reviews: