# On the robot (aarch64)
pip install wheels/ff_sdk-0.1.0a2-cp310-cp310-linux_aarch64.whl

# On a Linux dev machine (x86_64)
pip install wheels/ff_sdk-0.1.0a2-cp310-cp310-linux_x86_64.whl

python -c "import ff_sdk; print(ff_sdk.__version__)"

import asyncio, ff_sdk

async def main():
    async with await ff_sdk.connect("X2-DEMO") as robot:
        print(robot.diagnose())                  # health check: is the motion channel online
        print(robot.capabilities())

        battery = await robot.state.battery()
        print(f"battery {battery.percent:.0%}")   # ⚠️ currently returns placeholder 0 — BMS decode pending on real robot

        status = await robot.state.status()
        print(f"status {status}")

        # play a previously uploaded motion package (name = <key>_<version>)
        res = await robot.motion.do_preset("mydance_v1")
        print(res)

asyncio.run(main())

from ff_sdk import Config

cfg = Config.from_env()
cfg.extra["x2_motion_proxy_url"] = "http://192.168.1.50:5000"
robot = await ff_sdk.connect("X2-DEMO", config=cfg)

async with await ff_sdk.connect("X2-DEMO") as robot:
    ...
# auto close()

# Path A: package uploaded before → play directly by name
await robot.motion.do_preset("mydance_v1")

# Path B: new package → upload and play
# ⚠️ experimental: multipart upload field name not yet confirmed on a real robot
await robot.motion.do_preset_uploaded(
    key="mydance", version="v2",
    file_path="./works/mydance_v2.bin",
    motion_type="foundation",
)

# stop
await robot.motion.stop()

import ff_sdk
from ff_sdk.core.exceptions import CapabilityNotSupported

async def play_latest(robot, key: str, versions: list[str]):
    """Try playing from newest to oldest version; the first success wins."""
    for ver in versions:
        try:
            res = await robot.motion.do_preset(f"{key}_{ver}")
            if res.success:
                return res
        except CapabilityNotSupported:
            continue
    raise RuntimeError(f"package {key} has no playable version")

battery = await robot.state.battery()
if battery.percent < 0.3:
    print("Battery below 30%; charge before whole-body actions")
else:
    await robot.motion.do_preset("mydance_v1")

from ff_sdk import skills

# skills auto-selects an available implementation path on Master,
# returning {"ok": False, "message": ...} instead of crashing when unavailable
result = await skills.wave(robot)
print(result)   # {"ok": ..., "platform": "x2", ...}

res = await robot.motion.do_preset("mydance_v1")
if not res.success:
    print(f"playback failed: {res.message}")
    print(res.details)        # server-returned details, for troubleshooting