Skip to Content

Arduino IDE library

Arduino IDE library


Version - 1.0 - 2019

Do you create Arduino project? Arduino library: ESP32/8266, STM32, Arduino boards. Code examples.

Download dimmer library: RBDDimmer

Connection I/O

Dimmer is connected to Arduino controllers via two digital pins. First (Zero) to control the passing of Phase Null of AC, which is used to initiate the interrupt signal. Second (DIM/PSM) to control (dimming) current.  The Zero requires connection to designated microcontroller pins (which are different depending on the model of Uno, Nano, Leonardo, and Mega) since it is tied to microcontroller interrupts.

The voltage of dimmer VCC needs to can be to the same logic level as a microcontroller. 5V for Uno, Nano, Leonardo, and Mega, and 3.3V for STM32, ESP32, ESP8266.

The table of connections:

BoardINPUT Pin
Zero Cross		OUTPUT Pin
LeonardoD7 (NOT CHANGEABLE)D0-D6, D8-D13
MegaD2 (NOT CHANGEABLE)D0-D1, D3-D70
UNO
NANO		D2 (NOT CHANGEABLE)D0-D1, D3-D20
ESP8266D1(GPIO5), D5(GPIO14), D7(GPIO13), D2(GPIO4), D6(GPIO12), D8(GPIO15)D0(GPIO16), D2(GPIO4), D6(GPIO12), D8(GPIO15), D1(GPIO5), D5(GPIO14), D7(GPIO13)
ESP32GPIO: 36, 39, 32, 25, 27, 12, 7, 2, 4, 17, 18, 21, 22, 34, 35, 33, 26, 14, 13, 15, 0, 16, 5, 19, 1, 23GPIO: 32, 25, 27, 12, 15, 0, 16, 5, 19,
3, 22, 33, 26, 14, 13, 2, 4, 17, 18, 21, 1, 23
Arduino M0
Arduino Zero		D7 (NOT CHANGEABLE)D0-D6, D8-D13
Arduino DueD0-D53D0-D53
STM32, Blue Pill (STM32F1), Etc…PA0-PA15, PB0-PB15
PC13-PC15		PA0-PA15, PB0-PB15
PC13-PC15

Library and Functions

In Arduino, the dimmer is controlled with RBDdimmer.h library, which uses external interrupts and process time interrupts. It simplifies the code writing and gives more processing time for the main code. This is why you can control multiple Dimmers from one microcontroller.

Download dimmer library: RBDDimmer 

You can find a few examples in the library. We are constantly updating our library, so we recommend checking for website updates or subscribing to our newsletter.

This library can simplify user code with the following functions:

1. Function dimmerLamp – this function initializes the number of operating pin and is defined by the user

a. dimmerLamp dimmer(4); dimmer output DIM/PSM is initialized on the pin 4 for the bords WITHOUT changable ZERO-CROSS input pin (AVR, Arduino M0/Zero)

b. dimmerLamp dimmer(4, 2); dimmer output DIM/PSM is initialized on the pin 4 and zero-cross initialized on pin 2. Only for boards whith changable zero-cross(ESP32, ESP8266, Arduino Due)

2. Function begin port initialization, timer and external interrupt from zero-cross.

dimmer.begin(NORMAL_MODE, ON/OFF); port initialization, work mode choice, ON/OFF.

Parameter 1: dimmer working modes consist of two choices – NORMAL_MODE and TOGGLE_MODE

  • a. NORMAL_MODE to make dimmer work in defined value from 0 to 100 (%) (integer) Example of this mode located in \RBDdimmer\examples\SimpleDimmer
  • b. TOGGLE_MODE smooth change of dimming value up or down in a defined range. This solutions implies change of dimming values by means of hardware timer, without using the cycle code. Example of this mode located in \RBDdimmer\examples\SimpleToggleDimmer

Parameter 2: ON/OFF.

  • a. ON – turns timer ON, allows to use dimmer.
  • b. OFF – turns timer parameters OFF, prevents the use of dimmer.

3. Function setPower sets dimming value from 0 to 100%

dimmer.setPower(90);

4. Function getPower to display current dimming value

Serial.print(dimmer.getPower()); //Result 0~100 int

5. Function setMode sets and changes the work mode (NORMAL_MODE and TOGGLE_MODE)

dimmer.setMode(NORMAL_MODE/TOGGLE_MODE);

6. Function getMode displays values of current work mode

Serial.print(dimmer.getPower()); //Result 0 (NORMAL_MODE) or 1 (TOGGLE_MODE)

7. Function setState sets dimming state ON/OFF

dimmer.setState(ON); delay(100); dimmer.setState(OFF);

8. Function getState displays current state of the dimmer

Serial.print(dimmer.getState()); //Result 0 (OFF) or 1 (ON)

9. Function changeState changes dimmer state to the opposite one

dimmer.setState(ON); delay(100); dimmer.changeState(); delay(100);

10. Function toggleSettings smooth change of dimming value up or down in a defined range Example located in \RBDdimmer\examples\SimpleToggleDimmer. 

Examples:


Example: Dimming value through the serial port

The following sketch is meant to define the dimming value through the serial port of the controller:

  • using USE_SERIAL.begin;
  • void printSpace() function is used for adding of space after functional data;
  • void loop() serial port evaluator, used to register and define values in dimmer.setPower(outVal);
  1. #include <RBDdimmer.h>//

  3. #define outputPin  12 
  4. #define zerocross  5 // for boards with CHANGEBLE input pins

  6. //dimmerLamp dimmer(outputPin, zerocross); //initialase port for dimmer for ESP8266, ESP32, Arduino due boards
  7. dimmerLamp dimmer(outputPin); //initialase port for dimmer for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero

  9. int buttonRed = 0;

  11. void setup() {
  12.   dimmer.begin(NORMAL_MODE, ON); //dimmer initialisation: name.begin(MODE, STATE) 
  13.   dimmer.setPower(50);
  14.   pinMode(14, INPUT);
  15. }

  17. void loop() {
  18.   button = digitalRead(14);  
  19.   if (button == 1)
  20.   {
  21.     delay(50);
  22.     dimmer.setState(ON); //.setState(ON/OFF);
  23.   }  
  24.   if (button == 0)
  25.   {
  26.     delay(50);
  27.     dimmer.setState(OFF); //.setState(ON/OFF);
  28.   }
  29. }

Example: Power ON/OFF

The following sketch is meant to turn the lamp on/off with a button.

  • pinMode(14, INPUT); the button is connected to pin 14;
  • void loop() ON/OFF button evaluator of dimmer in dim.setState(ON/OFF);
  1. #include <RBDdimmer.h>//

  3. #define outputPin  12 
  4. #define zerocross  5 // for boards with CHANGEBLE input pins

  6. //dimmerLamp dimmer(outputPin, zerocross); //initialase port for dimmer for ESP8266, ESP32, Arduino due boards
  7. dimmerLamp dimmer(outputPin); //initialase port for dimmer for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero

  9. int buttonRed = 0;

  11. void setup() {
  12.   dimmer.begin(NORMAL_MODE, ON); //dimmer initialisation: name.begin(MODE, STATE) 
  13.   dimmer.setPower(50);
  14.   pinMode(14, INPUT);
  15. }

  17. void loop() {
  18.   button = digitalRead(14);  
  19.   if (button == 1)
  20.   {
  21.     delay(50);
  22.     dimmer.setState(ON); //.setState(ON/OFF);
  23.   }  
  24.   if (button == 0)
  25.   {
  26.     delay(50);
  27.     dimmer.setState(OFF); //.setState(ON/OFF);
  28.   }
  29. }

Example: Dimming with a potentiometer

The following sketch is meant to define dimming value through the potentiometer:

  • The potentiometer values are changing in the range from 0 to 1023;
  • potentiometer values are converted through the map function to values from 0 to 100% and saved in dimmer.setPower(outVal);
  1. #include <RBDdimmer.h>//

  3. #define outputPin  12 
  4. #define zerocross  5 // for boards with CHANGEABLE input pins

  6. //dimmerLamp dimmer(outputPin, zerocross); //initialase port for dimmer for ESP8266, ESP32, Arduino due boards
  7. dimmerLamp dimmer(outputPin); //initialase port for dimmer for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero

  9. int outVal = 0;

  11. void setup() 
  12. {
  13.   dimmer.begin(NORMAL_MODE, ON); //dimmer initialisation: name.begin(MODE, STATE) 
  14. }

  16. void loop() 
  17. {
  18.   outVal = map(analogRead(0), 1, 1024, 100, 0); // analogRead(analog_pin), min_analog, max_analog, 100%, 0%);
  19.   dimmer.setPower(outVal); // name.setPower(0%-100%)
  20. }

Example: Toggle Dimming values

The following sketch is meant to define by function the smooth changes of dimming values in a range of defined values.

  • values are defined in a range from 0 to 100%
  1. #include <RBDdimmer.h>//

  3. #define outputPin  12 
  4. #define zerocross  5 // for boards with CHANGEBLE input pins

  6. //dimmerLamp dimmer(outputPin, zerocross); //initialase port for dimmer for ESP8266, ESP32, Arduino due boards
  7. dimmerLamp dimmer(outputPin); //initialase port for dimmer for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero

  9. void setup() {
  10.   dimmer.begin(TOGGLE_MODE, OFF); //dimmer initialisation: name.begin(MODE, STATE) 
  11.   dimmer.toggleSettings(0, 70); //Name.toggleSettings(MIN, MAX);
  12.   dimmer.setState(ON); // state: dimmer1.setState(ON/OFF);
  13. }
  14. void loop() {
  15.   ...
  16.   dimmer.setState(ON); // set power to MAX value
  17.   ...
  18.   dimmer.setState(OFF); // set power to MIN value
  19. }

Example: Smoothly Dimming with buttons action

The following sketch is meant to smoothly turn the dimmer ON after pressing the first button and turn it OFF after pressing a second button.

  1. #include <RBDdimmer.h>

  3. #define outputPin  12 
  4. #define zerocross  5 // for boards with CHANGEABLE input pins

  6. #define LAMPMAXVALUE 100

  8. //dimmerLamp dimmer(outputPin, zerocross); //initialase port for dimmer for ESP8266, ESP32, Arduino due boards
  9. dimmerLamp dimmer(outputPin); //initialase port for dimmer for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero

  11. int stateL = 0, valLamp;
  12. int mainLamp = 0;
  13. int buttonRed = 0; 
  14. int buttonBlue = 0; 
  15. bool setLamp = true;

  17. void setup() {  
  18.   dimmer.begin(NORMAL_MODE, ON); //dimmer initialisation: name.begin(MODE, STATE) 
  19. ....
  20. }

  22. void RiseFallLamp(bool RiseFallInt)
  23. {
  24.   if ((RiseFallInt == true) && (mainLamp < LAMPMAXVALUE)) mainLamp++;
  25.   else if ((RiseFallInt != true) && (mainLamp > 0)) mainLamp--;
  26. }

  28. bool setLampState(int val)
  29. {
  30.   bool ret;
  31.   if (val >= 1) ret = true;
  32.   else ret = false;
  33.   return ret;
  34. }

  36. void readButtonState()
  37. {
  38.   buttonRed = digitalRead(13);
  39.   buttonBlue = digitalRead(15);
  40.   
  41.   if (buttonRed < 1) stateL++;
  42.   if (buttonBlue < 1) stateL--;
  43.   if (stateL < 0) stateL = 0;
  44.   if (stateL > 1) stateL = 1;
  45. }

  47. void loop() {
  48.   readButtonState();
  49.   dimmer.setPower(mainLamp); // setPower(0-100%);
  50.   RiseFallLamp(setLampState(stateL));
  51.   delay(25);
  52. }


Two or more dimmers connection

Z-C (ZeroCross). ZC pin needs only for 1-st dimmer. For the next dimmers don’t need to connect Z-C.

For each dimmer, need to connect the Dim pin.

The code:

  1. #define outputPin1  12  // Dim pin for dimmer 1
  2. #define outputPin2  11  // Dim pin for dimmer 2
  3. #define outputPin3  10  // Dim pin for dimmer 3
  4. #define zerocross  5 // for boards with CHANGEABLE input pin, ESP8266, ESP32, STM32, Arduino due boards

  6. //dimmerLamp dimmer1(outputPin1, zerocross); dimmerLamp dimmer2(outputPin2, zerocross); //initialase port for dimmer for ESP8266, ESP32, STM32, Arduino due boards
  7. dimmerLamp dimmer1(outputPin1); //initialase port for dimmer 1 for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero
  8. dimmerLamp dimmer2(outputPin2); //initialase port for dimmer 2 for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero
  9. dimmerLamp dimmer3(outputPin3); //initialase port for dimmer 3 for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero

  11. void setup() {
  12.   dimmer1.begin(NORMAL_MODE, ON);
  13.   dimmer2.begin(NORMAL_MODE, ON);
  14.   dimmer3.begin(NORMAL_MODE, ON);
  15.     
  16. }
  17. void loop() {
  18. ....
  19.   dimmer1.setPower(outVal1);
  20.   dimmer2.setPower(outVal2);
  21.   dimmer3.setPower(outVal3);
  22. ....  
  23. }

2 and 4-lines dimmers to one-phase AC. Connecting and code. 

The 2 and 4 lines dimmers have 1 ZC and 2-4 Dim pins.

The code:

  1. #define outputPin1  12  // Dim pin for dimmer 1
  2. #define outputPin2  11  // Dim pin for dimmer 2
  3. #define outputPin3  10  // Dim pin for dimmer 3
  4. #define outputPin3  9   // Dim pin for dimmer 4
  5. #define zerocross  5 // for boards with CHANGEABLE input pin

  7. //dimmerLamp dimmer1(outputPin1, zerocross); dimmerLamp dimmer2(outputPin2, zerocross); //initialase port for dimmer for ESP8266, ESP32, Arduino due boards
  8. dimmerLamp dimmer1(outputPin1); //initialase port for dimmer 1 for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero
  9. dimmerLamp dimmer2(outputPin2); //initialase port for dimmer 2 for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero
  10. dimmerLamp dimmer3(outputPin3); //initialase port for dimmer 3 for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero
  11. dimmerLamp dimmer4(outputPin4); //initialase port for dimmer 3 for MEGA, Leonardo, UNO, Arduino M0, Arduino Zero

  13. void setup() {
  14.   dimmer1.begin(NORMAL_MODE, ON);
  15.   dimmer2.begin(NORMAL_MODE, ON);
  16.   dimmer3.begin(NORMAL_MODE, ON);
  17.   dimmer4.begin(NORMAL_MODE, ON);    
  18. }
  19. void loop() {
  20. ....
  21.   dimmer1.setPower(outVal1);
  22.   dimmer2.setPower(outVal2);
  23.   dimmer3.setPower(outVal3);
  24.   dimmer4.setPower(outVal4);  
  25. ....  
  26. }


💡

How many dimmers can connect to the microcontroller: 

The number of dimmers is limited by the available output pins of your microcontroller. For example, ESP32 can connect 22 dimmers.