This simple tutorial will introduce you to program the Time Manipulator effect pedal.
Basic notions of C programming are needed to understand the code. There are great tutorials in Youtube to learn how to code basic C, but don't expect to learn it in 30 minutes.

We are going to start with a simple Delay Effect:





1. First of all, you need to know how all the resources are connected to the microcontroller (ATMEGA328P-PU), you can have a look at the schematic or check the image below.




Pin Definitions:
The first part of the code will always be to define the pins of the microcontroller:Where DELAY1/2 are the PWM signals that will control the delay time on the PT2399 chips, SWA/B/C/D are the analog switches (from the CD4066), LED1/2_G/R are the leds 1 and 2 and the Green and Red lines, ENC_A/B/GND/PUSH are the encoder related lines (+ the push button which is integrated on the encoder itself), the BYPASS_DETECT will detect the True Bypass foot-switch and the TAP_DETECT will detect the TAP foot-switch.


Variables:
Then we have the variables defined, they will be later used in the code. All of them are used in the read_encoder function. The read_encoder function is also declared here:

Setup:
The setup part of the code will be executed only one time, we would need to define here the pins as INPUTS or OUTPUTS and the initial value for them:*NOTE: some of the INPUTS have also a PULLUP. You can learn about pull-ups and pull-downs here. Basically, pull-up inputs here will be HIGH by default.


Loop:
Right After the Setup, the main Loop is executed, this loop will run endlessly:
Let's check instruction by instruction:

• while((digitalRead(BYPASS_DETECT) == LOW)) 
    {
    digitalWrite(LED1_R,LOW);digitalWrite(LED2_R,LOW);digitalWrite(LED1_G,LOW);digitalWrite(LED2_G,LOW); 
    }

  If the BYPASS_DETECT footswitch is pressed, the code goes into a loop that only switch off all the LEDs, the code will be doing nothing until the footswitch goes into ON mode.

• read_encoder();

  This funtcion will read the value of the encoder (labelled as "MASTER" with the stickers), the read_encoder function looks like this:

  void read_encoder(void)
  {
   ENC_aState = digitalRead(ENC_A); // Reads the "current" state
     if (ENC_aState != ENC_aLastState)
     {    
       if (digitalRead(ENC_B) != ENC_aState) 
            {if(ENC_counter>50)ENC_counter-=5;}
       else 
            {if(ENC_counter<230)ENC_counter+=5;}   
     } 
  ENC_aLastState = ENC_aState; // Updates the prev. state  
  }

  This function was taken from here: playground.arduino.cc/Main/RotaryEncoders it will update the ENC_counter (meaning "ENCODER counter") from 230 (maximum value) to 50 (minimum value). In increments of 5, why? because if the increment is 1 by one it takes too many turns to go from minimum to maximum. You can experiment with the increment value. The reason of 230 and 50 as max and min will be explained in the next points.

• //update the delay value based on the encoder reading
  analogWrite(DELAY1, ENC_counter);
  analogWrite(DELAY2, ENC_counter);

This is a key instruction in the code, writing an analog value in the DELAY1 and DELAY2 pins will adjust the amount of delay that the PT2399 chips will use. With the 230=minimum delay and 50=maximum delay.
In theory we can use the

function with values from 0 to 255 (8 bits). With the Time Manipulator pedal, its better to limit the values from 50 to 230. If we use the 0 or the 255 value, the PT2399 chips (the chips that control the delay of the signal) will be working in their limits, it will not damage the chips but the sound will break, creating distortion.

//update the LED colors
digitalWrite(LED1_G,HIGH); digitalWrite(LED2_G,HIGH);digitalWrite(LED1_R,LOW);  digitalWrite(LED2_R,LOW); 
This 4 instructions will set the LED colors. The pedal uses two bicolor LEDs, you can light each one in green, red or orange (red + green).
This especific instructions set the two Green leds to HIGH (on), you can experiment with different colors.

//set the audio relay
digitalWrite(SWA, LOW);digitalWrite(SWB, HIGH);digitalWrite(SWC, HIGH);digitalWrite(SWD, LOW);

The pedal has 4 analog switches (SWA, SWB, SWC, SWD) with this 4 instructions you can set the audio path as you like. The one used in this code (SWA=off, SWB=on, SWC=on, SWD=off) is a

You can see all the possible configurations of the pedal in this image:

And that is all!, in a code like this the typical variations you can easily try are:

• Modify the audio relays to create different sounds. (digitalWrite(SWA/B/C/D, HIGH/LOW) operation)
• Change the amount of delay (analogWrite(DELAY1/DELAY2, time_value) the time_value goes from 50 max delay to 230 min delay)
• Change the encoder increment vale, so the pot will get faster/slower from minimum to maximum value. The default is 5, but you can change it by 1, 4, 10, etc... (if(ENC_counter>50)ENC_counter-=5);

The complete Delay code is in the DELAY TOPIC.


Next Steps?:

• Once you have understood how the basics of a program works, you can go though the complete list on the "How to Start Programming the Time Manipulator" topic.
• After modding o creating your own code, have a look to the "How to Reprogram the Time Manipulator" topic, you will learn to load your new code into the microcontroller.

Ray , I want to ask a simple question , if i buy a preprogrammed ic from your shop,that means I dont need to do anything about hardware right ? I only need to put it right ?

The preprogrammed IC that we have in the store does not need any programming or coding from the user point of view.
It is literally "plug and play".

PS: But If you want to do it yourself you just need to get an ATMEGAP-PU from Amazon/Mouser/Farnell/eBay and follow this www.electrosmash.com/forum/time-manipula...-manipulator?lang=en