Introduction
The LED Brightness Control is the first module of the Dabble App.
This module allows you to control the output of the digital pins in two ways:
- If the pin is a digital pin with no PWM support, then you can control the HIGH and LOW state of the pin by clicking on the ON/OFF icon present in the center of the module.
LED Brightness module controlling digital pin 13. The current state of LED is set to OFF.
LED Brightness module controlling Digital Pin13. The current state of LED is set to ON. If the digital pin is a PWM pin then you can also vary PWM of that pin in order to get different output voltage at that pin. Potentiometer type knob as seen in the image is used for controlling PWM. Knob range is from 0 to 100 and it is mapped to PWM values. The module is made for activities like controlling LEDs.
How to change the Pin?
To change the pin, you can click on the button showing the Pin (In the above image it is Pin: 13 button).
You can choose the following pins for the corresponding boards:
- evive:
- PWM pins: digital pins 2-13
- Digital pins with no brightness control: digital pins 21-26
- Arduino Uno:
- PWM pins: digital pins 3,5,6,9,10 and 11
- Digital pins with no brightness control: digital pins 2,4,7,8,12 and 13
- Arduino Mega:
- PWM pins: digital pins 2-13 and 44-46
- Digital pins with no brightness control: digital pins 14-43 and 47-53
Arduino IDE Functions
Header
To include the LED Control module in the Arduino program, you have to include the following header:
#define CUSTOM_SETTINGS
#define INCLUDE_LEDCONTROL_MODULE
After defining the above mention headers, you have to include the dabble library:
#include <Dabble.h>
You can download the zip of Arduino Library for
- evive, Uno, Mega, and Nano – Dabble-Arduino
- ESP32 – Dabble-ESP32
depending on the board you are using.
Enabling Bluetooth Communication
To enable Bluetooth communication, you have to initialize serial communication using the following code:
- For evive and Arduino Mega, Uno and Nano
Dabble.begin(Baud_Rate);
Here Baud_Rate is the baud rate set for the Bluetooth module. With evive, you normally get 115200 baud rate modules.
- For ESP32
Dabble.begin("Bluetooth_Name");In place of Bluetooth_Name enter name that you want to keep for Bluetooth of ESP32. The default name given in the library is “MyEsp32”.
Refreshing the data
To refresh the data that the device has got from the mobile app, you have to use the following line of code:
Dabble.processInput();
This function also changes the state and the brightness of the LED automatically and you don’t have to do anything.
Functions
If you want to get the pin number, its state and brightness value of the LED from the module, then these are the functions using which you can do that:
- LedControl.getpinNumber(): This function returns the pin selected for LED Brightness control in the mobile app. The function returns int data type.
- LedControl.getpinState(): The function returns the state of the pin set by the user in the mobile app. This function returns the following output:
- 1 if the state is set to ON
- 0 if the state is set to OFF
- LedControl.readBrightness(): This function returns the brightness value set by the user in the mobile app. It returns int data type with a value ranging between 0 and 100.
PictoBlox (Scratch) Blocks
There is a stacked block named as “ enable LED control” available for this module. Its function is to enable the LED Brightness Control feature of Dabble.
Examples
Here in this example, we are controlling the LED brightness and also displaying the pin number, state, and brightness of the LED on the serial monitor. Either copy the codes are given below as per your selected board or you can also navigate to “Files>>Examples>>Dabble>>” and select Led Brightness Control example as per your board.
eviveYou can enter pin value as 13 in the Dabble app since there is an in-built led present on evive at pin 13.
Arduino Mega, Uno and NanoTo work with onboard led enter pin 13 in the Dabble app.
ESP32
In some ESP32 dev module onboard led comes on gpio pin 2, if your module has onboard led then you can use its corresponding pin to check the functionality of this module or else connect led to any pin and control it through the app.
To access the LED Brightness Control feature for the very first time, you have to upload the following script.
Depending upon your board type choose the corresponding head block. As seen in the example above with evive “when evive starts up” head block is chosen. Similarly, for the Arduino UNO board, you can choose “when Uno starts up” block. Currently, PictoBlox supports evive and Arduino Uno, Nano and Mega boards. Support for the ESP32 board will be added soon.
Projects
