RemoteXY

1. Introduction

Framework to design a graphical interface to control Arduino via Anrdoid or iOS based smartphone or tablet.

2. Prerequisites

• Arduino IDE has been installed
• Espressif board package has been added
• ESP32C3 has been connected to the development computer
• ESP32C3 has been selected as board on the development computer

3. Getting Started

3.1 Prepare Arduino IDE

Add RemoteXY library:

1. Open Sketch → Include Library → Manage Libraries
2. Enter RemoteXY in the field “Filter your search …”
3. Select RemoteXY by Evgeny Shemanuev, RemoteXY
4. Click INSTALL

3.2 Create a User Interface

1. Open the RemoteXY editor on the web: https://remotexy.com/editor/
2. Configure properties:
   • Connection: Bluetooth
   • Board: ESP32 based board
   • Module: Integrated Bluetooth
   • IDE: Arduino IDE
3. Set connection settings (board name and password)
4. Design interface, e.g.:
   • Add controls
   • Add indication
5. Download source code via Get source code button

3.3 Test Generated Source Code

1. Check the value of the following two defines in the source code
   • REMOTEXY_BLUETOOTH_NAME: your board’s Bluetooth name
   • REMOTEXY_ACCESS_PASSWORD: your board’s access password
2. Click Upload
3. Wait for upload to finish
4. Install RemoteXY on your Smartphone
5. Connect RemoteXY app to your board
   • A Bluetooth LE device with the name you configured in the RemoteXY editor should appear
   • To connect the password configured in the RemoteXY editor is required
6. The RemoteXY app should show the configured user interface

3.4 Adapt Generated Source Code

The generated source code consists of three sections:

1. RemoteXY configuration
2. void setup() function
3. void loop() function

//////////////////////////////////////////////
//        RemoteXY include library          //
//////////////////////////////////////////////
...
/////////////////////////////////////////////
//           END RemoteXY include          //
/////////////////////////////////////////////

void setup() 
{
  ...
}

void loop()
{
  ...
}

3.4.1 RemoteXY Configuration

This section contains

1. the user interface configuration
2. the stucture holding the user interface inputs, outputs and status variables

3.4.2 void setup()

https://www.arduino.cc/reference/de/language/structure/sketch/setup/

3.4.3. void loop()

https://www.arduino.cc/reference/de/language/structure/sketch/loop/

4. Examples

4.1 App-Only

• Hardware version: ESPresso32: Rev 7 12/23
• Source code: RemoteXY_Example_AppOnly/RemoteXY_Example_AppOnly.ino
• User interface: RemoteXY___Example_AppOnly/RemoteXY_-_Example_AppOnly.png

4.2 ADC

• Hardware version: ESPresso32: Rev 7 12/23
• Source code: RemoteXY_-Example_ADC/RemoteXY-_Example_ADC.ino
• User interface: RemoteXY_-Example_ADC/RemoteXY-_Example_ADC.png
• Note: a potentiometer should be connected to the “Poti” connector of the ESPresso32

4.3 Motor

• Hardware version:
  • ESPresso32: Rev 7 12/23
  • H bridge: QIFEI L9110 (rote Platine)
  • Motor: “Roboterbausatz”
• Source code: RemoteXY_Example_Motor/RemoteXY_Example_Motor.ino
• User interface: RemoteXY___Example_Motor/RemoteXY_-_Example_Motor.png
• Notes:
  • Motor connected to ports -, + of OB1, OA1 h bridge
  • H bridge ports
    • VCC, GND connected to 5V, GND
    • IB1, IA1 connected to GPIO10, GND