ROS 2 i SDK w robotach humanoidalnych — co sprawdzić przed zakupem

Co realnie daje wsparcie ROS 2 i SDK

Robot humanoidalny bez dostępu programistycznego to demonstrator: chodzi, wykonuje gotowe tryby z aplikacji producenta i nic ponadto. Dopiero natywne SDK (biblioteka w C++ lub Pythonie) oraz interfejs ROS 2 pozwalają czytać dane z czujników, sterować przegubami i budować własne aplikacje. W praktyce liczą się trzy warstwy: API wysokiego poziomu (komendy typu „idź”, „wstań”), API niskiego poziomu (bezpośrednie sterowanie momentem i pozycją każdego przegubu) oraz integracja z symulatorami — MuJoCo lub NVIDIA Isaac — w których trenuje się i testuje polityki sterowania przed wgraniem ich na sprzęt.

Termin „secondary development”, powtarzany w kartach produktów chińskich producentów, oznacza właśnie prawo i narzędzia do programowania własnych funkcji. Jego brak w tabeli specyfikacji to informacja, że kupujesz zamknięte urządzenie. Kupujący powinien zweryfikować cztery rzeczy: czy SDK obejmuje jego wariant robota (nie tylko markę), w jakim języku jest dokumentacja, czy repozytoria są aktywnie utrzymywane i na jakiej licencji udostępniono kod. Pełne zestawienie wariantów prowadzimy w katalogu robotów.

Unitree: dojrzały ekosystem, ale nie w wersjach bazowych

Unitree ma najszerszy publiczny ekosystem deweloperski wśród producentów z naszej bazy. Repozytorium unitree_sdk2 to SDK w C++ na licencji BSD-3-Clause (środowisko referencyjne: Ubuntu 20.04), unitree_sdk2_python dodaje interfejs w Pythonie (wymaga Pythona 3.8+ i cyclonedds 0.10.2), a unitree_ros2 udostępnia komunikaty ROS 2 (Foxy i Humble) oparte o CycloneDDS — README wymienia wprost modele Go2, B2 i H1. Do tego unitree_rl_gym pozwala trenować polityki chodu w Isaac Gym i weryfikować je w MuJoCo dla G1, H1, H1-2 i Go2.

Haczyk: kod na GitHubie nie oznacza, że twój robot z niego skorzysta. Bazowy Unitree G1 za 13 500 USD w ogóle nie wspiera secondary development — SDK dostaje dopiero G1 EDU, którego ceny producent nie ujawnia („contact sales”). Tak samo R1 w wariantach AIR (4 900 USD) i Basic (5 900 USD) nie daje możliwości programowania, a w H2 secondary development ma wyłącznie wersja EDU.

Booster, EngineAI, Fourier — trzy modele otwartości

Booster Robotics publikuje SDK w C++ na licencji Apache 2.0, Pythonowy pakiet boosteros instalowany przez pip (łączy się z fizycznym lub wirtualnym K1 i T1) oraz osobną paczkę interfejsów ROS 2. Otwarte są też narzędzia RL: booster_gym (Isaac Gym, T1), booster_train (Isaac Lab, K1) i booster_deploy, który uruchamia wytrenowane polityki na realnym robocie, w MuJoCo i w Webots. Dokumentacja deweloperska nie uzależnia dostępu do SDK od wariantu robota.

EngineAI udostępnia publicznie Native Control SDK (C++) i środowisko engineai_rl_lab oparte o Isaac Lab, wspierające PM01 i T800. Zastrzeżenia: „secondary development” producent deklaruje tylko dla PM01 w wersji Education i dla T800 od edycji Open Source wzwyż (Basic bez), a część dokumentacji repozytoriów istnieje wyłącznie po chińsku — README engineai_rl_lab wśród punktów „TODO” wymienia dokończenie dokumentacji i samouczków.

Fourier prowadzi publiczne repozytorium Aurora SDK (Python, Apache 2.0) obsługujące GR-1P, GR-2, GR-3 i N1, z integracją symulatora MuJoCo. Wymaga ono jednak firmware komunikacyjnego aktuatorów od 0.3.12.31 i firmware sterownika od 0.2.10.30, a publiczny SDK nie oznacza łatwego zakupu: GR-3 nie jest w otwartej sprzedaży w Europie — strony dystrybutorów prowadzą wyłącznie zapytania ofertowe, bez cennika.

NAO i Reachy Mini: dwa końce spektrum

NAO6 ma najdojrzalszą dokumentację edukacyjną na rynku: graficzne środowisko Choregraphe plus framework NAOqi z API w C++ i Pythonie. Pułapka jest poważna: oficjalny Python SDK dla NAOqi 2.8 wymaga Pythona 2.7, którego wsparcie zakończono 2020-01-01. Integracja ze współczesnymi bibliotekami AI (działającymi na Pythonie 3) wymaga przez to obejść i pośrednich warstw.

Reachy Mini od Pollen Robotics (Hugging Face) to najtańszy realnie otwarty punkt wejścia: SDK w Pythonie na licencji Apache 2.0, symulacja w MuJoCo bez posiadania sprzętu i ponad 50 gotowych aplikacji społeczności instalowanych z Hugging Face. Uczciwe zastrzeżenie: pliki konstrukcyjne sprzętu są na licencji CC BY-SA-NC, czyli z wyłączeniem użytku komercyjnego — „open source” nie obejmuje tu swobodnej komercjalizacji konstrukcji.

Pułapki: „open source” w marketingu a realny dostęp

Deklaracja „wsparcie ROS 2” na stronie producenta bywa w praktyce tylko paczką definicji komunikatów DDS — bez sterowników nawigacji, bez przykładów manipulacji i bez gwarancji zgodności z aktualną dystrybucją ROS. Drugim filtrem powinna być aktywność repozytoriów: unitree_sdk2 ma ok. 1 300 gwiazdek i 380 forków, podczas gdy Aurora SDK Fouriera — 10 gwiazdek i 5 forków (stan na 2026-08-31). Mniejsza społeczność to mniej odpowiedzi na fora, mniej przykładów i wolniejsze łatanie błędów.

• SDK za dopłatą: LimX TRON1 z pełnym SDK kosztuje 25 000 USD (Standard bez: 15 000 USD), a Unitree H2 Edu z SDK — 349 000 zł wobec 199 999 zł za bazowe H2; ceny G1 EDU i R1 EDU pozostają nieujawnione
• Zamknięte API w wersjach konsumenckich: G1 Basic, R1 AIR/Basic i H2 (bez EDU) nie wspierają secondary development
• Dokumentacja: brak materiałów po polsku u wszystkich producentów; u EngineAI część dokumentacji tylko po chińsku, a NAOqi wymaga przestarzałego Pythona 2.7
• Licencje: kod bywa otwarty (BSD-3, Apache 2.0), ale firmware i pliki sprzętowe już nie — u Reachy Mini sprzęt jest na licencji niekomercyjnej CC BY-SA-NC