Remote Control a nodeMCU with RemoteXY

In this post I describe a simple and intuitive way to remotely control a nodeMCU through a mobile application from iOS and Android devices.

More in detail I will show how to remotely pilot a led through the RemoteXY application

RemoteXY

RemoteXY includes:

a Web application to easily design and build a graphical interface and to generate the necessary source code for the controlling board (ESP8266, Arduino, ...)

a Mobile app for iOS and Android to remotely control over Bluetooth or WiFi the remote boardImage may be NSFW.
Clik here to view.

In order to create a complete application with RemoteXY it is necessary to follow 4 simple steps::

Step #1 : Graphical Interface

Building a graphical interface with a simple drag&drop editor available here

Image may be NSFW.
Clik here to view.

Step #2: Source Code Configuration

Configure and generate the sketch source code to be uploaded on the control board (ESP8266, Arduino)

Image may be NSFW.
Clik here to view.

Step #3: Upload Sketch

Compile and upload of the generated sketch on the control board (ESP8266,Arduino) through the Arduino IDE (or other supported IDE)

Step #4: Download Mobile App

Download the mobile app and install it on your client device (iOS, Android)

Image may be NSFW.
Clik here to view.

Configuration

After the design of the graphical interface it is necessary to configure the tool in order to generate the proper source code.

Image may be NSFW.
Clik here to view.

There are 4 different aspects to configure:

Connection

Four (4) type of connections are supported

Image may be NSFW.
Clik here to view.

Note: the iOS app only supports Bluetooth Low Energy aka BLE

Device (the control board)

The following platforms are supported

Image may be NSFW.
Clik here to view.

Communication Module

The following communication modules, to be paired with the control board, are supported:

Image may be NSFW.
Clik here to view.

Here some example of supported scenarios: Arduino Uno with Bluetooth HC-05 module, Arduino with ESP8266 or nodeMCU with ESP8266

IDE environment

Three (3) different development environment are supported:

Image may be NSFW.
Clik here to view.

LED control with nodeMCU

Let's now implement a simple use case: remotely control a LED through a mobile app and nodeMCU

GUI

Use the online editor to design a simple user interface by adding a label and a switch as depicted below

Image may be NSFW.
Clik here to view.

Now selecting the switch (ON/OFF) it is possible to configure some simple parameters in the Element section

Image may be NSFW.
Clik here to view.

For the sake of simplicity let's stick to the default parameters

Configuration

Now let's configure the code generator in the following way

Image may be NSFW.
Clik here to view.

This way we are telling to RemoteXY that we want to use a nodeMCU board as controller and the on-board ESP8266 as communication module and that our programming environment is Arduino.

The Connection is set to WiFi Access Point (AP) hence we are telling to RemoteXY that we want our nodeMCU to behave as a WiFi Access Point.

In such case it is necessary to configure the Module Interface section by specifying the SSID which will be broadcasted by the nodeMCU AP.

Let's also specify the TCP port on which the nodeMCU server will be listening for incoming connections.

Again for sake of simplicity let's check Open point meaning that we want an open WiFi network with no authentication.

Image may be NSFW.
Clik here to view.

Source Code

Now press the following button

Image may be NSFW.
Clik here to view.

RemoteXY will redirect us to a new page in which the generated source code is available for the user.
The source code and the RemoteXY library are available for download as zip files.

Image may be NSFW.
Clik here to view.

Let's now download the RemoteXY library and install it on Arduino IDE through the proper menu.
The download the source code

Image may be NSFW.
Clik here to view.

As we can see in the generated code some information from the previous config phase are present:

SSID of AP WiFI
Listening port

The RemoteXY_CONF[] section contains a description of the graphic interface. It will be transfer to the requesting mobile app once a connection with the nodeMCU is established.