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()
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);
1 PWM channel
PWMAdjustButton()
Use a button to increase/decrease the volume of a PWM channel.
When holding a modButton() it will affect the PWM channel, when not it will work like a normal button.
void PWMAdjustButton(int row, int column, int increment, int PWMChannel, bool loop)
Example:
A button on row 4 column 2.
Controlling PWM channel 3.
Decreases volume by -5% on press
loopset totrue, which means if the channel volume goes below 0 it will loop back up to 100.
PWMAdjustButton(4, 2, -5, 3, true);
1 PWM channel
1 button number
modButton
PWMAdjustButtonSolo()
Use a button to increase/decrease the volume of a PWM channel.
This button does not output any button press.
void PWMAdjustButtonSolo(int row, int column, int increment, int PWMChannel, bool loop)
Example:
A button on row 4 column 2.
Controlling PWM channel 3.
Decreases volume by -5% on press
loopset totrue, which means if the channel volume goes below 0 it will loop back up to 100.
PWMAdjustButtonSolo(4, 2, -5, 3, true);
1 PWM channel
PWMPot()
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);
1 PWM channel
rotary2PWM()
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.
2 button numbers
modButton()
1 PWM channel
funkyPWM()
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.
2 button numbers
modButton()
1 PWM channel
PEC11PWM()
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.
2 button numbers
modButton()
1 PWM channel
rotaryPulsePWM()
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.
2 button numbers
modButton()
1 PWM channel
rotaryAnalogPWM()
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%.
1 PWM channel
rotaryAnalogPWM12()
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);
12 button numbers
modButton()
1 PWM channel
Last updated