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).

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://192.168.10.101: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 physical stop in reach, and keep the app's Stop button (emergency stop) ready. See Safety.

3. Next steps