Skip to content

LiquidGalaxyLAB/LG-RoboStream

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

82 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿค– RoboStream v1.00

RoboStream Logo

Real-time Robot Sensor Data Streaming for Liquid Galaxy

A comprehensive solution for visualizing robot sensor data on Liquid Galaxy displays

---

๐Ÿ“‹ Table of Contents


๐Ÿš€ Server Setup

First, initialize the server environment. Navigate to the server directory and run:

docker-compose up -d --build

This command uses Docker to build the project's required environment and start all necessary services in the background.

RoboStream Logo

Real-time Robot Sensor Data Streaming for Liquid Galaxy

A comprehensive solution for visualizing robot sensor data on Liquid Galaxy displays


๐Ÿ“ฒ App Installation

  1. Install the APK: Download and install the provided APK file on your Android device
  2. Enable Unknown Sources: You may need to enable "Install from unknown sources" in your device's settings
  3. Launch the App: Open RoboStream after installation
App Installation Installation Process

๐Ÿ”Œ Server Configuration

When you first open the app, you'll see the server configuration screen:

  • Enter Server IP: Input the IP address of the device running the server
  • Port Handling: Don't include the port number - the app automatically uses port 8000
  • Android Emulator: If using the Android Emulator on the same machine, use 10.0.2.2
Server Configuration

๐Ÿค– Robot Configuration (Not implemented yet, just visual)

Configure the IP Address from the Robot:

  • Robot IP Address: Input the IP address of the robot device
  • Development Status: Currently in development - ROS and robot implementation on the server is still in progress
  • Current State: This is a visual demo showing how it will work when fully implemented
Robot Configuration

๐ŸŒŒ Liquid Galaxy Setup

Configure your Liquid Galaxy connection:

Required Information:

  • ๐ŸŒ Main LG IP Address
  • ๐Ÿ‘ค Username
  • ๐Ÿ”’ Password
  • ๐Ÿ“บ Total number of screens

QR Code Configuration:

  • ๐Ÿ“ฑ QR Scanner Button: Tap the QR code button to automatically fill all connection details
  • ๐Ÿ” Quick Setup: Scan a QR code containing all Liquid Galaxy configuration data

QR Code JSON Format Example:

{
  "ip": "192.168.1.100",
  "username": "lg",
  "password": "lglg",
  "screens": "5"
}

Purpose: The QR code scanner allows for quick and error-free configuration by scanning a code that contains all necessary Liquid Galaxy connection parameters, eliminating manual data entry.

Connection Confirmation: When successful, the RoboStream logo will appear on the leftmost screen of the Liquid Galaxy.

Liquid Galaxy Configuration Liquid Galaxy QR Scanner
---

๐Ÿ  Home Screen

The home screen provides easy access to all main features:

Key Elements:

  • โš™๏ธ Settings button for configuration menu
  • ๐Ÿ“Š Sensor cards displaying real-time data
  • ๐ŸŽฎ "Start Streaming" button to begin data transmission
  • ๐Ÿ”ด๐ŸŸข Connection indicators (Server, Robot & Liquid Galaxy)
Home Screen

โš™๏ธ Settings & Configuration

Access the settings menu to modify your connections:

Available Options:

  • ๐Ÿ”ง Change server IP address
  • ๐Ÿงช Test server connection
  • ๐ŸŒŒ Update Liquid Galaxy details
  • ๐Ÿ”„ Relaunch Button
  • ๐Ÿงน Clear all KMLs from display
  • ๐Ÿค– Configure robot IP address
Settings Menu Server Settings LG Settings Robot Settings

๐Ÿ“Š Sensor Data

View detailed information from individual sensors:

  • Real-time Data: All sensor information is displayed and updated every 2 seconds
  • Live Detail Views: Tap any sensor card to see comprehensive data that updates in real-time
  • Live Indicator: Cards show a "LIVE" indicator to confirm real-time updates
  • Server Sync: Data comes directly from the server and matches what's shown on Liquid Galaxy
  • Streaming: When streaming to Liquid Galaxy, data is sent every 5 seconds automatically
Sensor Data 1 Sensor Data 2

๐Ÿ“ก Data Streaming

Start streaming data to Liquid Galaxy:

Streaming Options:

  • ๐Ÿ“ท RGB Camera: Immediate streaming when selected
  • ๐Ÿ”ฌ Other Sensors: Select one or more sensors, then press "Start Streaming"
  • โœ… Multiple Selection: You can select several sensors simultaneously for concurrent data streaming
  • โฑ๏ธ Update Frequency: Data updates every 5 seconds during streaming
Streaming Options Streaming Active

๐Ÿ–ฅ๏ธ Liquid Galaxy Display

How the streaming data appears on Liquid Galaxy screens:

LG Display 1 LG Display 2

โน๏ธ Stop Streaming

To end the streaming session:

Simply press the "Stop Streaming" button to immediately stop all data transmission to Liquid Galaxy.

Stop Streaming

๐Ÿš€ Ready to explore robot data visualization with RoboStream!


๐Ÿ™ Acknowledgements

Thanks to my main mentor Moisรฉs Martรญnez and secondary mentors Andreu Ibaรฑez and kamalimiquel.
And thanks to the team of the Liquid Galaxy LAB Lleida, Headquarters of the Liquid Galaxy project:
Alba, Paula, Josep, Jordi, Oriol, Sharon, Alejandro, Marc, and admin Andreu, for their continuous support on my project.
Info at www.liquidgalaxy.eu

About

Alejandro Bernaldo

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published