PWM / Circuit control

These functions control PWM channels.

Generally, these functions will adjust the channel volume (0 - 100% within the set PWM range on the channel) or turn the channel on/off (switching between the set volume and outputting 0V on the PWM channel).

PWMToggle()

Description

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).

Example

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);

Requirements

• 1 PWM channel

PWMPot()

Description

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

Example

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);

Requirements

• 1 PWM channel

rotary2PWM()

Description

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.

Example

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.

Requirements

• 2 button numbers

• modButton()

• 1 PWM channel

funkyPWM()

Description

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.

Example

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.

Requirements

• 2 button numbers

• modButton()

• 1 PWM channel

PEC11PWM()

Description

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.

Example

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.

Requirements

• 2 button numbers

• modButton()

• 1 PWM channel

rotaryPulsePWM()

Description

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.

Example

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.

Requirements

• 2 button numbers

• modButton()

• 1 PWM channel

rotaryAnalogPWM()

Description

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.

Example

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%.

Requirements

• 1 PWM channel

rotaryAnalogPWM12()

Description

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.

Example

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);

Requirements

• 12 button numbers

• modButton()

• 1 PWM channel