Dabble Modules

Camera (Coming Soon)

Oscilloscope (Coming Soon)

IoT (Coming Soon)

Touch Tune (Coming Soon)

Projects (Coming Soon)

Game Pad Module

This module provides the controller layout in three different modes:

Digital Mode: This mode is the standard mode with 10 buttons namely
Up, Down, Right, Left, Triangle, Circle, Cross, Square, Select, and Start.
Joystick Mode: In this mode, the Up, Down, Right, and Left buttons are replaced by the Joystick which sends data in polar coordinates. The radius varies from 0-7 and the angle varies from 0°- 360° in steps of 15°.
Accelerometer Mode: This mode is similar to the joystick mode. Instead of sliding the button on the screen, you must tilt your Smartphone to make it move.

The GamePad Module is one of the input modules, using which user can give commands to the device using buttons and potentiometer present in different layouts:

Digital Mode
Joystick Mode
Accelerometer Mode

You can toggle between the different modes using setting option present on the top right corner of the module.

Digital Mode

The digital mode is the default mode when the module opens. It has 10 digital buttons whose data is sent to the device when they are pressed or released.

Up
Down
Left
Right
Triangle
Cross
Square
Circle
Select
Start

Only the digital state of each button is sent to the device, whether it is pressed or not.

Joystick Mode

The joystick mode has both button and joystick in the layout.

The joystick is present on the left side of the layout. It sends 4 data to the device:

X value: The value of the x position (on the horizontal axis) of the white dot in the joystick. It is an integer value and varies from -7 to 7. At the center, the value is 0.
Y value: The value of the y position (on the verticle axis) of the white dot in the joystick. It is an integer value and varies from -7 to 7. At the center, the value is 0.
Radial value: The distance from the center of the joystick. This value varies from 0 to 7. At the center, the value is 0 and on the perimeter of the joystick, the value is 7.
Angle: The angle is the angle between the positive x-axis and the line joining the center and the current position of the dot. It varies from 0 to 360 at a step of 15 degrees.

The buttons work same as the digital mode. Only 6 digital buttons are present in the joystick Mode:

Triangle
Cross
Square
Circle
Select
Start

Accelerometer Mode

The accelerometer mode is pretty same as the analog mode, the only difference is that the joystick present in this mode is controlled with the accelerometer sensor present in the phone.

The values given to the hardware device is the same as the joystick: 4 analog values and 6 digital values.

Programming the boards for the Module

Choose Your Preferred programming language

Scratch

Arduino

Scratch

Digital Mode

To use GamePad in digital mode, you will need a boolean block is () pressed on gamepad? block.

You just have to choose a button from the dropdown i.e Up, Down, Left, Right, Triangle, Circle, Cross, Square, Start or Select.

Note: When you are using this module with Arduino Uno, Mega, and Nano, you have to set the Bluetooth baud rate to the baud rate of the Bluetooth module to have proper communication between the board and the module. To set the baud rate you have to use set Bluetooth baud rate to () block.

In this example, we are controlling a robot using the digital mode. The robot is same as we build the one in this project: https://thestempedia.com/project/smartphone-controlled-mobile-robot/

Given below is the full script of the same:

You can download the PictoBlox program from here:

evive: Smartphone Controlled Robot with Dabble
Arduino Uno: Smartphone Controlled Robot with Dabble for Arduino Uno

Joystick & Accelerometer Mode:

To use GamePad as a regular Joystick, you have to use a reporter block “get () from Gamepad”.

In its drop-down, you will find 4 things i.e. X Value, Y Value, Angle and Radial Distance. Using these 4 values, you can develop a logic to control the left side of Gamepad and rest 6 digital controls will work similar to digital mode.

evive

In this example, we are displaying all the parameters on the evive Display

You can download the Scratch Program from here: Gamepad Module Analog value Display evive

Arduino

Header

To include the GamePad module in the Arduino program, you have to include the following header:

#define CUSTOM_SETTINGS

#define INCLUDE_GAMEPAD_MODULE

After defining the above mention headers, you have to include the dabble library:

#include <Dabble.h>

You can download the library from here:

Enabling Bluetooth Communication

To enable Bluetooth communication, you have to initialize serial communication using the following code:

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.

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

Functions

Following are the function available for the GamePad module:

Function	Return Type	Function Brief Decription	Returning Value
isUpPressed()	Boolean	The function tells whether the Up button is pressed or not.	1 when Up button is pressed; 0 when Up button is not pressed.
isDownPressed()	Boolean	The function tells whether the Down button is pressed or not.	1 when Down button is pressed; 0 when Down button is not pressed.
isLeftPressed()	Boolean	The function tells whether the Left button is pressed or not.	1 when Left button is pressed; 0 when Left button is not pressed.
isRightPressed()	Boolean	The function tells whether the Right button is pressed or not.	1 when Right button is pressed; 0 when Right button is not pressed.
isTrianglePressed()	Boolean	The function tells whether the Triangle button is pressed or not.	1 when Triangle button is pressed; 0 when Triangle button is not pressed.
isCirclePressed()	Boolean	The function tells whether the Circle button is pressed or not.	1 when Circle button is pressed; 0 when Circle button is not pressed.
isCrossPressed()	Boolean	The function tells whether the Cross button is pressed or not.	1 when Cross button is pressed; 0 when Cross button is not pressed.
isSquarePressed()	Boolean	The function tells whether the Square button is pressed or not.	1 when Square button is pressed; 0 when Square button is not pressed.
isStartPressed()	Boolean	The function tells whether the Start button is pressed or not.	1 when Start button is pressed; 0 when Start button is not pressed.
isSelectPressed()	Boolean	The function tells whether the Select button is pressed or not.	1 when Select button is pressed; 0 when Select button is not pressed.
getAngle()	Integer	This function returns the angle value between the x-axis and the line joining the dot and the center of the joystick.	The value varies form 0 to 360 degrees with a step of 15 degrees.
getRadius()	Integer	The function returns the distance between the center of the joystick and the dot.	The value varies from 0 to 7.
getx_axis()	float	The fuction returns the x postion of the dot on the joystick.	The value varies from -7 to 7.
gety_axis()	float	The fuction returns the y postion of the dot on the joystick.	The value varies from -7 to 7.

Controlling a Robot using Digital Mode

We are using the robot we have made in this project: https://thestempedia.com/project/smartphone-controlled-mobile-robot/

Controlling a Robot using Analog or Accelerometer Mode

We are using the same robot for this code also.

Debug code for GamePad

This code can be used to debug the joystick and accelerometer mode analog values. It displays the values received from the app on TFT display.

Game Pad Module

Digital Mode

Joystick Mode