- ๐ Server Setup
- ๐ฒ App Installation
- ๐ Server Configuration
- ๐ Liquid Galaxy Setup
- ๐ Home Screen
- โ๏ธ Settings & Configuration
- ๐ Sensor Data
- ๐ก Data Streaming
- โน๏ธ Stop Streaming
- ๐ Acknowledgements
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.
- Install the APK: Download and install the provided APK file on your Android device
- Enable Unknown Sources: You may need to enable "Install from unknown sources" in your device's settings
- Launch the App: Open RoboStream after installation
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
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
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.
---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)
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
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
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
How the streaming data appears on Liquid Galaxy screens:
To end the streaming session:
Simply press the "Stop Streaming" button to immediately stop all data transmission to Liquid Galaxy.
๐ Ready to explore robot data visualization with RoboStream!
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