USSOI-CAM

⚠️ Important Note:

• See https://github.com/nikipoatgit/USSOI-CAM for Android Client
• See https://github.com/nikipoatgit/GS_For_USSOI for Host Implementation
• See https://github.com/nikipoatgit/FlightController_H743 if want make ur own FC

Future Updates

• Ability to Change UART Tunnel IP/URL
• Support for Multiple BT Modules (1-3)
• P2P Connection Support (via NAT Traversal)
• camers2appi High FPS video Stream
• Auto Quality Adjustment and Network usage Priority

Purpose

• USSOI-CAM provides an affordable alternative to dedicated digital camera and telemetry systems. It enables live camera feed and telemetry forwarding from Android devices to ground server, delivering the core functionality required for lightweight UAS/CAM deployments.This project prioritizes cost-effectiveness and simplicity .it may not include all features available in commercial products. See the documentation for known limitations and configuration options.

The Back Story (why I built this)

Digital FPV cameras + radio kits easily run $150–300 — way too much for pocket money.

but a cheap second-hand Android - (Android 7+) around ₹2000–5000 (~$25–45) will do the job with added benifits of : state-of-the-art camera (whose full API is usually hidden behind NDAs), built-in GPS, actually-good cellular/WiFi modem, and enough processing power to handle real-time streaming + telemetry forwarding.

📑 Table of Contents

• Documentation
• System Architecture
• App Features
• API Endpoints
• Getting Started

---

System Architecture

APP Features

• Background Operation: The service runs persistently in the background, even when the screen is off. A persistent notification is required by Android to maintain this functionality.
• Authentication: Credentials must be configured via the GS login interface before the application can establish WebSocket connections to the Ground Server. ( Default values roomId : nikipo, roomPwd : nikipo ).

API Endpoints

HTTP

• Endpoint: http://<host>/authentication
• Method: POST
• Description: Client login — returns a long-lived sessionKey required for WebSocket connections.
• Example response:

{"sessionKey":"<non-empty-string>"}

WebSocket

• Endpoint: ws://<host>/uartunnel> for UART Tunnel
• Endpoint: ws://<host>/control/client?sessionKey=<sessionKey>
• Description: Connect using the sessionKey query parameter (alternatively send the sessionKey as the first message after connecting).
• After connecting the client sends periodic telemetry messages (every 5 seconds).
• Example message:

{"type":"clientStats","hex":"0000320000C841FFABFFE5FF000023B95B4040585B4100889E3B69DB43D5C21F35404BCD1E6805C353409A9959408E66F13DCDCCCCCCCC2474400"}

see Documentation for more details

Get Started

• Install Application From Release or Clone repo in Android Studios Code : https://github.com/nikipoatgit/USSOI-CAM.git

• Select Buttons according to use Case :

  

• Illustration:
  

end of file