Skip to content

Quickstart

Connect to the robot and make it take a first step. This assumes the Gateway is running on the robot (mock mode is fine and completely safe).

For IT, technicians and integration partners

Technical reference for IT departments, URG technicians and trained partners. It is not written as operating instructions for end users.

1. Same network

Cable the robot to the office router. Put your phone/tablet/PC on the same router's Wi-Fi. The Gateway is reachable at <robot-ip>:8765.

2a. With the app

  1. Open the Robotics Group App.
  2. Connect to Robot → Connect via IP → enter the robot's IP → Connect.
  3. The control screen opens and shows live status (battery, mode).
  4. Slide to enter PREP, place the robot on the ground, switch to WALK, and use the joysticks.

See the Mobile App guide for the full flow.

2b. From code

import asyncio, json, websockets

async def main():
    async with websockets.connect("ws://<ROBOT-IP>:8765/ws") as ws:
        # bring the robot up
        await ws.send(json.dumps({"type": "mode", "mode": "prep"}))
        await asyncio.sleep(1)
        await ws.send(json.dumps({"type": "mode", "mode": "walk"}))
        # step forward briefly
        await ws.send(json.dumps({"type": "move", "vx": 0.3, "vy": 0, "wz": 0}))
        await asyncio.sleep(1)
        await ws.send(json.dumps({"type": "move", "vx": 0, "vy": 0, "wz": 0}))
        # read a few status frames
        for _ in range(3):
            print(json.loads(await ws.recv()))

asyncio.run(main())

Before a real run

In mock mode nothing moves — perfect for first tests. For a live run on the real robot, have a person at the robot with the emergency stop on the robot in reach, and keep the app's STOP button ready. See Safety.

3. Next steps