Action - Reaction

The LED toggle application with a button is the most used project for simple input/output project example. This project allows the user to control the RGB LED Module with the Button Module by simply toggling an LED.

Project Key Components

1. SMD

   The SMD acts as a bridge between the script and the modules. It is responsible for interpreting the commands sent by the script and translating them into actions that read input from the button module and toggle the RGB LED Module.

2. RGB LED Module

   The RGB LED Module is designed to emit different colors, allowing users to experiment with different lighting effects.

3. Button Module

   The Button Module is the physical interface for receiving input from the user. The input can be used to trigger the script in an encoded way.

4. SMD Libraries

   The SMD library is at the heart of the application. It communicates with the SMD using a specific communication protocol, sending commands to read the Button Module and toggle the LED on the RGB LED Module.

Project Key Features

• A Basic Physical Interaction

  The application supports a toggle functionality, allowing the user to press the button to toggle the LED. This provides a simple physical interaction with project.

• Visualizing the Input

  The RGB LED Module serves as a visual indicator of the current state of the Button Module. When the button is pressed, the LED turns on; when the button is not pressed, the LED turns off.

Project Wiring Diagram

Getting Started

1. Hardware Setup

   • Connect the SMD to the PC or Arduino board using USB Gateway Module or Arduino Gateway Module.

   • Connect the RGB LED Module and the Button Module to the SMD using an RJ-45 cable.

   • Make sure that the SMD is powered and all connections are correct.

2. Run the Script

   • Run the script on your computer. This will establish communication with the SMD and initiate control of the Button Module and RGB LED Module.

3. Toggle LED State

   • Press the button on the Button Module to toggle the RGB LED. Observe the visual feedback of the LED.

Project Codes

Python Code

from smd.red import *

SerialPort = "COM3"     # Serial port of the USB gateway module
baudrate = 115200       # Baud rate of communication
ID = 0                  # ID of the SMD
rgb_module_id = 1       # ID of the RGB LED module
button_module_id = 1    # ID of the button module

master = Master(SerialPort, baudrate)       # Defines the USB gateway module
master.attach(Red(ID))                      # Gives acces to the SMD of specified ID
master.scan_modules(ID)                     # Scans and identifies the modules that are connected to the SMD

while True:
    button_state = master.get_button(ID, button_module_id)

    if button_state == 1:
        master.set_rgb(ID, rgb_module_id, 255, 0, 0)        # Numbers are correspond to the R - G - B color values
    
    else:
        master.set_rgb(ID, rgb_module_id, 0, 0, 0)          # Sets all colors to zero, meaning turning the RGB LED off

Arduino Code

#include <Acrome-SMD.h>

#define ID        0           // ID of the SMD
#define BAUDRATE  115200      // Baud rate of the communication

Red master(ID, Serial, BAUDRATE);    // Defines the Arduino gateway module

int rgb_module_id = 1;              // ID of the RGB LED module
int button_module_id = 1;           // ID of the button module

int button_state = 0;               // Variable to store the button state

void setup() {
    master.begin();                 // Starts the communication
    master.scanModules();           // Scans for the connected modules
}

void loop() {
    button_state = master.getButton(button_module_id);      // Getting the button state and storing it
    
    if (button_state == 1) {
        master.setRGB(rgb_module_id, 255, 0, 0);    // Numbers are correspond to the R - G - B color values
    }

    else {
        master.setRGB(rgb_module_id, 0, 0, 0);      // Sets all colors to zero, meaning turning the RGB LED off
    }
}