PWM / Circuit control

Use a toggle switch to turn a PWM channel on/off, or just use a regular button (will have to be held pressed unless it is a physically latching button).

void PWMToggle(int row, int column, int PWMChannel)

Example:

A toggle switch on row 4 column 2.
Controlling PWM channel 3.

PWMToggle(4, 2, 3);

Set up a potentiometer to adjust the volume of a PWM channel.

void PWMPot(int analogChannel, int startValue, int endValue, int PWMChannel )

Example:

Potentiometer on analog channel 2.
Using checkValue(2) in 30_switches we've found the range of the potentiometers values to be 0 to 1021.
Controlling PWM channel 3 volume.

PWMPot(2, 0, 1021, 3);

Standard incremental encoder in the rotary2bit category. Rotating CW will give a button pulse, rotating CCW will give a button pulse with a button number 1 value higher.

Holding the modButton will make this encoder adjust the PWM volume up and down by a custom increment.

void rotary2PWM(int row, int column, bool reverse, int8_t PWMChannel, int8_t stepSize)

Example:

Encoder with pins A and B to columns 3 and 4. Common pin to row 2.
Controlling PWM channel 3 volume with increments of 5%.

rotary2PWM(2, 3, false, 3, 5);

The button numbers used is determined by the number written in the block for the A pin. B pin block will not be read. If button number was set to 15, the switch will use buttons 15 and 16. The reverse part of the function will switch the button numbers if set to true.

Standard incremental encoder in the funkyRotary category. Rotating CW will give a button pulse, rotating CCW will give a button pulse with a button number 1 value higher.

Holding the modButton will make this encoder adjust the PWM volume up and down by a custom increment.

void funkyPWM(int Arow, int Acolumn, int Bcol, bool reverse, int8_t PWMChannel, int8_t stepSize)

Example:

Encoder with pins A and B to columns 3 and 4. Common pin to row 2.
Controlling PWM channel 3 volume with increments of 5%.

funkyPWM(2, 3, 4, false, 3, 5);

The button numbers used is determined by the number written in the block for the A pin. B pin block will not be read. If button number was set to 15, the switch will use buttons 15 and 16. The reverse part of the function will switch the button numbers if set to true.

Standard incremental encoder in the PEC11 category. Rotating CW will give a button pulse, rotating CCW will give a button pulse with a button number 1 value higher.

Holding the modButton will make this encoder adjust the PWM volume up and down by a custom increment.

void PEC11PWM(int row, int column, bool reverse, int8_t PWMChannel, int8_t stepSize)

Example:

Encoder with pins A and B to columns 3 and 4. Common pin to row 2.
Controlling PWM channel 3 volume with increments of 5%.

PEC11PWM(2, 3, false, 3, 5);

The button numbers used is determined by the number written in the block for the A pin. B pin block will not be read. If button number was set to 15, the switch will use buttons 15 and 16. The reverse part of the function will switch the button numbers if set to true.

Standard incremental encoder in the rotaryPulse category. Rotating CW will give a button pulse, rotating CCW will give a button pulse with a button number 1 value higher.

Holding the modButton will make this encoder adjust the PWM volume up and down by a custom increment.

void rotaryPulsePWM(int row, int column, bool reverse, int8_t PWMChannel, int8_t stepSize)

Example:

Encoder with pins A and B to columns 3 and 4. Common pin to row 2.
Controlling PWM channel 3 volume with increments of 5%.

rotaryPulsePWM(2, 3, false, 3, 5);

The button numbers used is determined by the number written in the block for the A pin. B pin block will not be read. If button number was set to 15, the switch will use buttons 15 and 16. The reverse part of the function will switch the button numbers if set to true.

12 - position switch. Absolute.

Produces no button presses, but the position of the switch is still detected by the firmware and can be used for conditional coding or rotaryInject. The switch works like a volume knob for a PWM channel.

void rotaryAnalogPWM(int analogChannel, int PWMChannel, int pos1, int pos2, int pos3, int pos4, int pos5, int pos6, int pos7, int pos8, int pos9, int pos10, int pos11, int pos12, bool reverse)

Switch setup with explainations:

rotaryAnalogPWM(

2, <- The analog channel this switch is set up on

2, <- The PWM channel it controls

16, 107, 200, 291, 383, 474, 566, 657, 749, 841, 932, 1023, <- Switch position values

false); <- Direction is not reversed, so CW rotation increasese button number.

This switch has "reverse" set to true, which can be a good idea if it is placed horizontally on the right side. Turning it CCW will now increase the brightness instead of reducing. So typed out in 30_Switches.ino:

rotaryAnalogPWM(2, 2, 16, 107, 200, 291, 383, 474, 566, 657, 749, 841, 932, 1023, false);

This switch will set the volume to 0% in position 1 and 100% in position 12. The positions in between will be a gradual increase from 0 to 100%.

12 - position switch. Absolute.

Works similar to rotaryAnalogSimple(), but with the added feature of producing button presses in each position. To adjust PWM volume you'l have to hold a modButton. Adjustments are with a custom increment.

void rotaryAnalogPWM12(int analogChannel, int PWMChannel, int stepSize, int pos1, int pos2, int pos3, int pos4, int pos5, int pos6, int pos7, int pos8, int pos9, int pos10, int pos11, int pos12, bool reverse)

Switch setup with explainations:

rotaryAnalogPWM12(

2, <- The analog channel this switch is set up on

2, <- The PWM channel it controls

5, <- The increments of volume adjustment

16, 107, 200, 291, 383, 474, 566, 657, 749, 841, 932, 1023, <- Switch position values

false); <- Direction is not reversed, so CW rotation increasese button number.

This switch has "reverse" set to true, which can be a good idea if it is placed horizontally on the right side. Turning it CCW will now increase the brightness instead of reducing. So typed out in 30_Switches.ino:

rotaryAnalogPWM12(2, 2, 5, 16, 107, 200, 291, 383, 474, 566, 657, 749, 841, 932, 1023, false);

PWM / Circuit control

PWMToggle()

PWMPot()

rotary2PWM()

funkyPWM()

PEC11PWM()

rotaryPulsePWM()

rotaryAnalogPWM()

rotaryAnalogPWM12()