Open Source Robotics

Una raccolta curata di progetti, strumenti e software di robotica open source di alta qualità per la comunità della robotica.

Guida al montaggio di TienKung 3.0

Piattaforma umanoide open source a grandezza naturale di X-Humanoid con controllo avanzato del corpo intero.

Licenza

  • TienKung_URDF and TienKung_Docs: OpenAtom Open Hardware License 1.0
  • TienKung-Lab and Deploy_Tienkung: BSD 3-Clause
  • xhumanoid_sdk: Apache 2.0

Licenza suddivisa per repository. TienKung_URDF (file URDF, mesh e link CAD) e TienKung_Docs (manuali e documenti dell'SDK) sono soggetti alla OpenAtom Open Hardware License v1.0: quando li si distribuisce bisogna trasmettere la licenza, mantenere gli avvisi e segnalare le proprie modifiche. TienKung-Lab e Deploy_Tienkung sono BSD-3-Clause e xhumanoid_sdk è Apache-2.0. TienKung-Lab richiede NVIDIA Isaac Sim, che ha una propria licenza. Verificato il 2 nov 2026.

Guida al montaggio

1. Cosa pubblica la fonte originale e quale robot copre

La fonte originale vende TienKung montato, in un flight case, con un manuale utente. Non pubblica istruzioni per costruire il robot a partire dalle parti. Questa guida riporta quindi ciò che riporta il manuale: disimballaggio, accensione, posizione eretta, arresti di emergenza, spegnimento e manutenzione. I manuali descrivono il Lite (20 gradi di libertà) e il Pro (42 gradi di libertà), entrambi datati maggio 2025. Non nominano un TienKung 3.0, e nei repository originali non è stato trovato alcun manuale utente della 3.0. Le sezioni da 2 a 7 seguono il manuale del Lite, la sezione 8 indica le differenze del Pro e la sezione 9 è la configurazione facoltativa della simulazione.

1.1 Sappi che il robot è fornito montato e non va smontato

Il manuale della Lite elenca un corpo del robot montato con il suo alimentatore, il radiocomando, la fune di sicurezza e il manuale del prodotto, e vieta lo smontaggio non autorizzato.

  1. La distinta di imballaggio indica: corpo del robot x1, adattatore di alimentazione x1, telecomando x1, fune di sicurezza x1, manuale del prodotto x1.
  2. Il manuale dice che, se serve una riparazione, occorre contattare l'assistenza post-vendita ufficiale, e sconsiglia agli utenti di smontare da soli il robot.
  3. Il manuale dice: non modificate né smontate il robot o le sue parti senza autorizzazione.
  4. La sezione sulla garanzia dice che, se l'utente modifica, smonta o ripara il robot senza autorizzazione, la garanzia si considera decaduta, e che il fornitore non autorizza terzi a ripararlo.
  5. Il manuale non ha un capitolo di assemblaggio. Il repository TienKung_URDF del progetto originale descrive un disegno d'assieme completo in formato STEP per la Lite (file TG10-00) e la Pro (file TG11-00), scaricabile dal sito del progetto originale. Quei file pesano circa 453 MB e 824 MB e non sono stati letti. Il progetto originale non pubblica un elenco di passi per l'assemblaggio a partire da essi.

1.2 Sappi quale robot descrivono questi documenti

I documenti riguardano TienKung Lite e Pro; gli esempi dell'SDK 3.0 del progetto originale sono una piattaforma separata.

  1. Lite, secondo il manuale della Lite: altezza 1630mm, peso netto 43kg, 20 giunti integrati (4 per braccio x2, 6 per gamba x2), computer di controllo del movimento Intel x86, 2 telecamere RGBD (testa, petto), ROS 1 su Ubuntu22.04.4 LTS.
  2. Pro, secondo il manuale della Pro: altezza 1630mm, peso netto 56kg, 42 gradi di libertà in totale, 4 telecamere RGBD (testa, petto, vita, schiena), 2 computer di sviluppo Orin AGX 64, ROS 1 su Ubuntu22.04.4 LTS.
  3. Il repository xhumanoid_sdk del progetto originale riguarda il robot che chiama Embodied TienKung 3.0 (Thor). Richiede Ubuntu 24.04 e ROS 2 Jazzy sul robot, accede con ssh [email protected] ed elenca come hardware standard un esempio di nuvola di punti con LiDAR Livox. È un repository di esempi dell'SDK e non fornisce passi di disimballaggio o accensione.
  4. Non date per scontato che i passi delle sezioni da 2 a 8 valgano per un robot 3.0. Sono ricavati solo dai manuali della Lite e della Pro.

2. Regole di sicurezza dal manuale del Lite

Leggile prima di sollevare il robot fuori dalla sua custodia. Sono le regole del manuale stesso, con la loro numerazione.

2.1 Segui le regole su chi può usare il robot e come

Il manuale pone limiti su utenti, condizioni di lavoro e movimentazione, e dice di tenere le persone fuori dalla portata delle braccia e delle gambe.

  1. Il robot è destinato esclusivamente a persone di almeno 18 anni.
  2. Il manuale sconsiglia che utenti con capacità sensoriali o cognitive ridotte, o senza esperienza, usino il robot da soli senza l'aiuto di altri.
  3. Usate correttamente le parti e gli accessori del robot. Non modificateli né smontateli senza autorizzazione.
  4. Tenete dita, capelli e indumenti lontani dai giunti, dalle fessure e dalle parti in movimento, per evitare schiacciamenti e impigliamenti.
  5. Non toccate le superfici dei motori mentre il robot è in funzione, per evitare ustioni.
  6. Non coprite le zone dei sensori (torso, testa e così via), per non compromettere la percezione e il controllo.
  7. Evitate di usare il robot in luoghi umidi, caldi o con forti campi magnetici. La sezione 2.2 indica una temperatura di lavoro normale da 0 a 30 gradi C e un'umidità inferiore all'80% RH. La sezione 6.2.1 indica una temperatura di lavoro da 0 a 40 gradi C e un'umidità relativa dal 25 all'80% RH. Il manuale non concilia i due dati.
  8. Non trasportate il robot mentre è acceso o prima che la batteria sia entrata in stato di sospensione.
  9. Mentre il robot esegue un movimento, le persone devono mantenere la distanza e restare fuori dalla portata di braccia e gambe, per evitare lesioni da urto.
  10. Per spostare il robot usate l'apposita macchina di movimentazione. Una sola persona non deve mai trasportarlo o trascinarlo a mano.

2.2 Sappi quali azioni possono far cadere il robot senza telaio di protezione

Quattro azioni del radiocomando e dei pulsanti possono far cadere e danneggiare il robot se non è sostenuto dal telaio di protezione.

  1. Senza un telaio di protezione che sostenga il robot, fate attenzione con queste azioni, altrimenti il robot potrebbe cadere e danneggiarsi: premere il tasto 'A' per metterlo in piedi in modalità di marcia; premere il tasto 'D' per riportarlo a zero; abbassare la leva 'E' e premere il tasto 'B' per disattivare i giunti; premere il pulsante di arresto di emergenza.
  2. Prima di lasciare il robot in standby a lungo, fissatelo al telaio di protezione, in modo che uno spegnimento automatico per batteria scarica non lo faccia cadere.
  3. Quando la batteria è molto scarica, fermate e spegnete il robot per tempo, per evitare cadute e danni.

2.3 Segui le regole di ricarica

Il manuale dà otto regole per la ricarica, tra cui usare solo il caricatore originale e cosa fare se fuma.

  1. Spegnete il robot prima di caricarlo e assicuratevi che sia disalimentato.
  2. Scollegate subito il caricabatterie quando la batteria è carica. Non lasciatelo collegato a lungo.
  3. L'ambiente di ricarica deve essere tra 0 e 45 gradi C, con umidità inferiore al 75% RH.
  4. Caricate solo con il caricabatterie originale dedicato fornito dal fornitore. È vietato usare apparecchiature di alimentazione di terzi.
  5. Il manuale consiglia di iniziare la ricarica solo dopo che il robot si è raffreddato a temperatura ambiente.
  6. Se durante la ricarica compaiono fumo, odori strani, surriscaldamento o deformazioni, scollegate subito il caricabatterie e smettete di usare il robot.
  7. Se l'elettrolita entra negli occhi, sciacquateli subito con acqua pulita e rivolgetevi tempestivamente a un medico.
  8. La ricarica richiede 4 ore (specifiche della Lite, sezione 5.1). Il testo del manuale non dice dove si trova la presa di ricarica.

3. Controlla la custodia e solleva il robot

Il robot viaggia in un flight case. Le immagini di disimballaggio del manuale mostrano un Lite di prima produzione, ma il manuale dice che la procedura è identica.

3.1 Ispeziona la valigia e controlla il contenuto

Apri le due chiusure quadrate sul lato della valigia da trasporto e confronta il contenuto con la distinta di imballaggio.

  1. Il robot è imballato in un flight case.
  2. Quando il robot arriva presso di voi, verificate che la cassa sia integra. Se è danneggiata, contattate tempestivamente la società di logistica e il vostro fornitore regionale.
  3. Se è integra, ruotate le chiusure a farfalla per aprire le due serrature quadrate sul lato.
  4. Aprite la cassa e verificatene il contenuto con la distinta di imballaggio: corpo del robot x1, adattatore di alimentazione x1, telecomando x1, fune di sicurezza x1, manuale del prodotto x1. Se manca qualcosa, contattate tempestivamente l'assistenza post-vendita perché ve lo invii.

3.2 Tieni pronto un telaio di protezione

Il progetto originale non fornisce un telaio di protezione, ma consiglia di procurartene uno, e i passaggi seguenti ne hanno bisogno.

  1. La nota del manuale dice, tradotta: si consiglia di dotare autonomamente il robot di un telaio di protezione. Fornisce un link a un negozio, che qui non viene riportato.
  2. I passi successivi appendono il robot al telaio di protezione tramite la fune di sicurezza, e il manuale richiede più volte che il robot sia fissato al telaio prima di determinate azioni.

3.3 Solleva il robot dalla valigia

Aggancia la fune di sicurezza all'anello sotto la parte posteriore del collo, solleva il telaio, appoggia i piedi sul bordo della valigia e allontana la valigia.

  1. Agganciate il moschettone della fune di sicurezza all'anello di fissaggio sotto la parte posteriore del collo del robot, e collegate la fune di sicurezza al telaio di protezione.
  2. Comandate il telaio di protezione in modo che salga lentamente e sollevi il robot.
  3. Appoggiate a mano i piedi del robot sul bordo del flight case.
  4. Spingete delicatamente in avanti la cassa, in modo che il robot venga sollevato dolcemente sul telaio di protezione.
  5. Non buttate la cassa di trasporto dopo aver estratto il robot. È fatta per trasportare il robot e i suoi accessori.

4. Prepara il luogo e controlla il robot

Controlla il pavimento, la stanza, il robot e il telecomando prima di dare alimentazione.

4.1 Controlla il luogo

Il pavimento deve essere piano e asciutto con almeno 4m di spazio libero, e nell'ambiente non devono esserci liquidi o gas infiammabili né forti interferenze.

  1. Il pavimento deve essere in piano e non scivoloso. Il manuale sconsiglia l'uso su terreno irregolare, pendenze ripide, fango, materiale sciolto o superfici scivolose. Consiglia almeno 4m di spazio libero tutto intorno.
  2. Ambiente: temperatura di lavoro da 0 a 40 gradi C e umidità relativa dal 25 all'80% RH (vedere la sezione 2 per il dato diverso indicato nella sezione 2.2).
  3. Non devono esserci liquidi o gas infiammabili o corrosivi. Nelle vicinanze non devono esserci forti sorgenti di disturbi elettronici o campi magnetici.

4.2 Controlla il robot e il radiocomando

Verifica che il robot sia appeso al telaio, controlla che non ci siano parti allentate o danneggiate, poi accendi il radiocomando e leggi le spie della sua batteria.

  1. Verifica che il robot sia appeso al telaio.
  2. Controlla che nessuna parte sia allentata o danneggiata, e che il movimento sia libero e senza impuntamenti.
  3. Per verificare che la batteria del robot sia sufficientemente carica, prima assicuratevi che il robot sia acceso (vedere i passi di accensione nella sezione 5), poi leggete il livello della batteria in alto a destra nella pagina di stato del robot, la 7.1 della pagina web di diagnostica. Il testo del manuale non fornisce l'indirizzo della pagina web.
  4. Accendete il telecomando: premete brevemente il tasto di accensione, poi tenetelo premuto a lungo. Le spie in basso al centro del telecomando si accendono da sinistra a destra per indicarne la batteria. Le spie 1, 2, 3 e 4 accese indicano 25%, 50%, 75% e 100%.

5. Accendi, collegati e avvia i programmi

Questi passaggi sono per il Lite. La password di accesso non è nel manuale: il manuale dice di chiederla al servizio clienti.

5.1 Accendi il robot

Premi l'interruttore della batteria, premi una volta l'interruttore di controllo principale, poi ruota il pulsante di arresto di emergenza in senso orario finché non scatta in fuori.

  1. Premete il tasto dell'interruttore della batteria. La spia dell'interruttore della batteria diventa rossa e la spia dell'interruttore di controllo principale diventa blu.
  2. Premete brevemente una volta il tasto dell'interruttore di controllo principale. La spia dell'interruttore di controllo principale diventa rossa.
  3. Ruotate in senso orario il pulsante di arresto di emergenza finché non scatta verso l'alto. La spia dell'interruttore di controllo principale diventa verde.

5.2 Collegati al computer di controllo del movimento e configura il Wi-Fi

Collega la porta Ethernet di debug sul retro del robot al tuo computer, imposta il computer su 192.168.41.xx e accedi con ssh [email protected].

  1. Nota del manuale: le password di accesso di questo capitolo vanno richieste al servizio clienti.
  2. Il robot ha fino a tre schede di controllo principali. Predefinita: controllo del movimento x86, nome utente ubuntu, indirizzo fisso 192.168.41.1. Opzionale: Orin per i modelli di grandi dimensioni, nome utente nvidia, indirizzo 192.168.41.2. Opzionale: Orin per la navigazione, nome utente nvidia, indirizzo 192.168.41.3. Ciascuna ha il proprio Wi-Fi, che si può configurare separatamente. I passi seguenti usano l'x86.
  3. Collegate un cavo Ethernet tra la porta Ethernet di debug sul retro del robot e il vostro computer.
  4. Impostate l'indirizzo Ethernet del computer su 192.168.41.xx con maschera di sottorete 255.255.255.0.
  5. In un terminale, digitate ping 192.168.41.1. Se c'è risposta, la connessione di rete con l'x86 funziona.
  6. Digitate ssh [email protected], poi yes, poi la password di accesso.
  7. Elencate gli hotspot Wi-Fi disponibili e annotate l'SSID a cui collegarvi: sudo nmcli device wifi list
  8. Collegatevi alla rete Wi-Fi: sudo nmcli device wifi connect 'Wi-Fi SSID' password 'Wi-Fi password'
  9. Controllate lo stato dell'interfaccia wireless con ifconfig. Una volta connessi, la configurazione del Wi-Fi è completa e potete scollegare il cavo. Il documento SDK della Lite usa iwconfig per questo controllo.
  10. Una volta configurato il Wi-Fi, nei giorni successivi eseguite ifconfig sul robot per leggere l'indirizzo IP dell'interfaccia 'wlan0/wlp2s0', poi digitate ssh [email protected] dal vostro computer, poi yes e la password.

5.3 Avvia il driver del corpo e il programma di controllo del movimento

Esegui due programmi in due terminali e digita 1 solo quando ogni valore current pos è inferiore a 1 in valore assoluto.

  1. Nel primo terminale avviate il programma driver del corpo, in quest'ordine: cd rosws; sudo -s (inserite la password); source install_isolated/setup.bash; roslaunch body_control motion_simple.launch
  2. In un secondo terminale avviate il programma di controllo del movimento: cd rosws; source install_isolated/setup.bash; roslaunch rl_control_new rl.launch
  3. Al prompt (enter 1:), digitate 1 solo dopo aver verificato che il valore assoluto di ogni current pos sia inferiore a 1.
  4. Se un parametro current pos di un servo ha valore assoluto superiore a 1, premete control+C per terminare il programma e verificate se l'errore di posizione di un motore è troppo grande.
  5. Se il file di configurazione della directory .ros è stato cancellato per errore e il robot si muove in modo anomalo, copiate di nuovo il file di configurazione rl_0426_4nets_opt.pt dalla directory /home/ubuntu/rosws/data/.

6. In piedi, cammina, corri e fermati

Usa il robot sul telaio di protezione. Le lettere dei tasti si riferiscono al telecomando del Lite.

6.1 Metti il robot in piedi a terra

Azzera il robot sul telaio con D, abbassalo, attendi 30 secondi, poi premi A con la leva F in posizione centrale.

  1. Premete il tasto 'D' sul telecomando per riportare il robot allo stato iniziale. Il robot deve essere fissato al telaio di protezione prima di premere il tasto 'D'.
  2. Abbassate lentamente il telaio di protezione in modo che il robot appoggi a terra, e tenetelo in posizione verticale per 30 secondi.
  3. Con la leva F del telecomando nella posizione iniziale di zero centrale, premete il tasto 'A' per far alzare il robot. Quando è in piedi, controllate che sia in equilibrio, senza tremolii e senza inclinarsi in avanti o indietro. Se non è in equilibrio, ripetete i passi precedenti.

6.2 Cammina sul posto, corri, spostati e gira

Abbassa la leva F per il passo sul posto e sposta la leva H a destra per la corsa sul posto.

  1. Il manuale consiglia di usare il robot sostenuto dal telaio di protezione.
  2. Per avviare la modalità a passi: verificate che il robot sia in piedi, poi abbassate la leva F. Il robot cammina sul posto.
  3. Per passare alla modalità di corsa: mentre il robot cammina stabilmente, spostate la leva H verso destra. Il robot corre sul posto.
  4. In modalità a passi o di corsa le levette spostano e ruotano il robot, e l'ampiezza del movimento ne regola la velocità. Levetta sinistra su o giù: avanti o indietro. Levetta sinistra a sinistra o a destra: di lato. Levetta destra a sinistra o a destra: rotazione antioraria o oraria.

6.3 Fermati e torna in posizione eretta

Riporta la leva F al centro e premi A, ma mai direttamente dalla modalità di corsa.

  1. In modalità a passi: riportate la leva F nella posizione di zero centrale e premete il tasto 'A'. Il robot smette di muoversi e torna in piedi.
  2. In modalità di corsa: prima abbassate la leva F per tornare alla modalità a passi, poi riportate la leva F nella posizione di zero centrale e premete il tasto 'A'.
  3. Avvertenza del manuale: in modalità di corsa non riportate mai direttamente la leva F nella posizione di zero centrale per poi premere il tasto 'A'.

6.4 Conosci i tasti del radiocomando

Il manuale indica dieci funzioni per il radiocomando della Lite.

  1. 1 Ritorno a zero: D.
  2. 2 Blocco (arresto rigido): C.
  3. 3 Modalità di controllo cmd_vel: leva F in alto.
  4. 4 In piedi: leva F al centro, più A.
  5. 5 Camminata: leva F in basso.
  6. 6 Corsa: leva H a destra.
  7. 7 Spostamento a sinistra e a destra: X1, levetta sinistra a sinistra e a destra.
  8. 8 Spostamento avanti e indietro: Y1, levetta sinistra su e giù.
  9. 9 Rotazione oraria o antioraria: X2, levetta destra a sinistra e a destra.
  10. 10 Disattivazione dei giunti: leva E in basso più B.
  11. Il documento SDK della Lite aggiunge che il robot segue cmd_vel solo quando la leva F è in alto; altrimenti è sotto il controllo del telecomando.

7. Arresti di emergenza, spegnimento, manutenzione e guasti

Esistono tre tipi di arresto di emergenza, ciascuno con un effetto diverso. Imparali prima di mettere il robot in piedi a terra.

7.1 Usa l'arresto di emergenza giusto

C blocca i giunti, E giù più B toglie l'alimentazione ai giunti e il pulsante rosso sul retro toglie l'alimentazione.

  1. Se il robot va fuori controllo, premete subito il tasto 'C' sul telecomando, in modo che tutti i giunti si irrigidiscano, e prendete al più presto misure di protezione. Se ciò non ha effetto in tempo, premete rapidamente il pulsante di arresto di emergenza sulla schiena del robot per togliere l'alimentazione.
  2. Blocco, tasto 'C': premetelo subito se il robot si muove in modo anomalo, ad esempio con velocità o direzione errate, o se si prevede un rischio, ad esempio il robot sta per raggiungere un ostacolo o delle persone e non può fermarsi in tempo. Tutti i giunti si bloccano all'istante e il corpo non riesce a mantenere l'equilibrio, quindi serve una protezione anticaduta e dovete sostenere il robot il prima possibile.
  3. Disattivazione dei giunti, leva 'E' in basso e tasto 'B' insieme: per un guasto improvviso, come un guasto a un sensore o a un componente elettronico che potrebbe causare ulteriori danni, o una postura instabile in una posizione o un angolo non sicuri. I giunti perdono alimentazione e il robot si affloscia e cade all'istante. Il robot deve essere fissato al telaio di protezione prima di eseguire questa operazione.
  4. Pulsante di arresto di emergenza sulla schiena del robot: premetelo subito, poi premete l'interruttore di controllo principale e l'interruttore di alimentazione per togliere tutta l'alimentazione, e contattate l'assistenza post-vendita del fornitore. Usatelo in caso di fumo o odore di bruciato; acqua o corpi estranei nel robot; perdita di controllo che non si riesce a fermare con il telecomando o in altro modo; danni che potrebbero causare ulteriori pericoli; manovre di emergenza, ad esempio perdita di controllo in quota o in un luogo pericoloso; e un cambiamento improvviso dell'ambiente come un terremoto o un incendio. Il robot non riesce a mantenere alcuna postura e si affloscia e cade all'istante. Il robot deve essere fissato al telaio di protezione prima di premere il pulsante.

7.2 Spegni il robot

Arresta i programmi in ordine, esegui poweroff, poi procedi con gli interruttori e il radiocomando.

  1. Verificate che il robot si sia fermato e sia tornato in piedi.
  2. Premete il tasto 'C' sul telecomando per bloccare il robot.
  3. Fissate il robot al telaio e sollevatelo.
  4. Nei terminali aperti per i programmi, premete control+C per fermare prima il programma di controllo del movimento, poi premete control+C per fermare il programma driver del corpo.
  5. Quando entrambi i programmi si sono fermati, digitate il comando poweroff nel terminale del programma driver del corpo.
  6. Premete il pulsante di arresto di emergenza. La spia dell'interruttore di controllo principale diventa rossa.
  7. Tenete premuto per 6 secondi il tasto dell'interruttore di controllo principale. La spia dell'interruttore di controllo principale diventa blu. Il successivo documento SDK della Lite dice solo 'premete il tasto dell'interruttore di controllo principale' e non indica un tempo.
  8. Premete il tasto dell'interruttore della batteria.
  9. Sul telecomando, premete brevemente il tasto di accensione, poi tenetelo premuto a lungo, per spegnere il telecomando.

7.3 Esegui i controlli giornalieri, lo spostamento e la pulizia

Controlla scocca, connettori della batteria, sensori, motori, luci e radiocomando; sposta e pulisci il robot solo quando è spento.

  1. Controllo quotidiano: la scocca, per danni, deformazioni o allentamenti; la batteria e i suoi connettori, per la tenuta; i sensori, per la pulizia; i motori, per un funzionamento normale senza tremolii o rumori anomali; che le spie restino accese; e che il telecomando funzioni correttamente.
  2. Spostamento: il robot si trasporta nel flight case su misura realizzato per esso e per i suoi accessori. Prima di spostare il robot, spegnetelo completamente e togliete l'alimentazione, e verificate che il pulsante di arresto di emergenza sia sollevato. I giunti possono schiacciare dita e altre parti del corpo o impigliare indumenti larghi e capelli lunghi, quindi fate molta attenzione.
  3. Pulizia: prima spegnete completamente e togliete l'alimentazione, verificate che il pulsante di arresto di emergenza sia sollevato e che il caricabatterie non sia collegato. Non lasciate che spray, soluzioni a base di alcol o getti d'acqua tocchino direttamente il robot. Pulite la scocca e le zone dei sensori, in particolare le telecamere, con un panno morbido e asciutto.

7.4 Cura la batteria e riponi il robot

Evita sovraccarica e scarica eccessiva, conserva la batteria al 50% di carica e ricaricala ogni 3 mesi.

  1. Evitate sovraccarica e scarica eccessiva. Togliete subito l'alimentazione dopo l'uso. Non è consigliabile lasciare a lungo collegato il caricabatterie.
  2. Per lunghi periodi di inutilizzo, conservate la batteria al 50% di carica e ricaricatela ogni 3 mesi, per evitare la scarica profonda, che fa calare rapidamente la capacità e accorcia la vita in cicli.
  3. Se la batteria invecchia, si gonfia o l'autonomia cala bruscamente, contattate tempestivamente l'assistenza tecnica per la sostituzione.
  4. Conservate in un luogo asciutto, ventilato e senza polvere. La temperatura consigliata è da -4 a 45 gradi C. Tenete lontano da gas corrosivi, oggetti infiammabili e forti sorgenti elettromagnetiche. Si consiglia di conservarlo nella sua cassa di trasporto originale.

7.5 Recupera da una postura instabile e conosci le condizioni di garanzia

Una postura eretta instabile richiede un ribilanciamento dell'IMU: blocca, solleva, azzera, attendi 2 minuti in posizione verticale, rimettiti in piedi.

  1. Il robot non si accende: la batteria potrebbe essere scarica, quindi controllatene la carica.
  2. Il robot sta in piedi o cammina in modo instabile (i dati integrali dell'IMU richiedono una correzione dell'equilibrio): premete 'C' per bloccarlo; alzate il telaio di protezione per sollevare il robot; premete 'D' per riportarlo a zero; abbassate il telaio in modo che il robot appoggi a terra e tenetelo in posizione verticale per 2 minuti per riportare in equilibrio i dati dell'IMU; riportate la leva F nella posizione di zero centrale e premete 'A' per farlo alzare, e verificate se l'equilibrio è tornato. In caso contrario, ripetete.
  3. La postura di zero non è corretta (dati di calibrazione dello zero persi, oppure un urto durante il funzionamento o lo spostamento ha spostato lo zero): contattate un tecnico dell'assistenza post-vendita per la calibrazione dello zero.
  4. Garanzia: decorre dalla data di ricevimento e copre solo guasti di funzionamento non causati dall'uomo. Il robot principale e le sue parti, i motori dei giunti, la batteria e l'adattatore di alimentazione sono coperti per 1 anno. Le parti protettive come la scocca non sono coperte. I danni da uso improprio, errori di manovra, cadute, acqua o urti, e da smontaggio o riparazione non autorizzati, sono esclusi dalla garanzia. In caso di reso le spese di spedizione sono a carico dell'utente. La riparazione può comportare la perdita di dati, quindi fatene prima un backup.

8. Se hai il Pro: le differenze

Il manuale del Pro segue la procedura del Lite con le modifiche indicate sotto. Le sue immagini di disimballaggio sono del Lite, e dice che la procedura è identica. Dove il manuale del Pro e il documento dell'SDK del Pro non concordano su una lettera di tasto, questa guida segue il manuale, il cui telecomando non ha il tasto C.

8.1 Conosci il radiocomando della Pro e i suoi limiti

Il radiocomando della Pro usa A per l'azzeramento, B per il blocco, X per stare in piedi e Y per camminare.

  1. Tasti del telecomando della Pro: 1 ritorno a zero, A; 2 blocco (arresto rigido), B; 3 in piedi, X; 4 camminata, Y; 5 spostamento avanti, indietro, a sinistra e a destra, levetta sinistra; 6 rotazione oraria o antioraria, levetta destra.
  2. Robot fuori controllo: premete subito il tasto 'B' per bloccare tutti i giunti e prendete misure di protezione. Se ciò non ha effetto in tempo, premete il pulsante di arresto di emergenza sulla schiena del robot.
  3. Senza un telaio di protezione, fate attenzione quando premete il tasto 'A' per il ritorno a zero e quando premete il pulsante di arresto di emergenza, altrimenti il robot potrebbe cadere e danneggiarsi. L'elenco del manuale della Pro non prevede un'azione di disattivazione dei giunti.
  4. Il manuale della Pro ripete le regole della Lite per l'uso e per la ricarica (almeno 18 anni, da 0 a 45 gradi C e umidità inferiore al 75% RH durante la ricarica, solo caricabatterie originale), e la stessa distinta di imballaggio.

8.2 Conosci la batteria della Pro

Il manuale della Pro riporta una tabella della batteria: 48V nominali, intervallo di funzionamento da 39 a 54,6V, 15Ah.

  1. Tipo: litio ternario. Tensione nominale 48V. Intervallo di tensione di lavoro da 39 a 54,6V, dove 39V e 54,6V sono le tensioni di fine scarica e di fine carica. Capacità nominale 15Ah.
  2. Modalità di carica CC/CV (corrente costante, tensione costante). Corrente di carica da 2 a 10A. Corrente di scarica massima 60A continua, con un picco di 90A per 1 secondo.
  3. Peso circa 3,1kg. Temperatura di carica da 0 a 45 gradi C. Temperatura di scarica da -20 a 60 gradi C.
  4. Temperatura di conservazione: 1 mese da -20 a 60 gradi C; 3 mesi da -20 a 40 gradi C; 1 anno da -20 a 25 gradi C. Vita in cicli superiore a 250. Resistenza interna inferiore a 160 milliohm.

8.3 Controlla la batteria della Pro con l'app SMART BMS e accendi il radiocomando

La batteria della Pro si legge via Bluetooth nell'app SMART BMS, non nella pagina di diagnosi.

  1. Verificate che il robot sia appeso al telaio, e controllate che nessuna parte sia allentata o danneggiata e che il movimento sia libero.
  2. Robot acceso (l'accensione della Pro è descritta più sotto): scaricate l'app SMART BMS e attivate il Bluetooth del telefono. Aprite l'app, toccate 'local monitoring', poi 'single group'. Individuate il numero della batteria sul corpo del robot, trovatelo nell'elenco e toccate '+' per collegarvi. Aprite la batteria collegata: il valore sotto il quadrante è la carica. Per leggere un'altra batteria, toccate prima '-' per scollegarvi.
  3. Telecomando in carica da spento: la spia Home pulsa a colori: rosso da 0 a 25%, arancione da 25 a 50%, giallo da 50 a 75%, verde da 75 a 90%, verde che si spegne dopo 2 secondi da 90 a 100%. Premete il tasto Home per 1-3 secondi per accenderlo.

8.4 Accendi la Pro e apri la piastra posteriore per raggiungere la porta di rete

Premi l'interruttore della batteria, poi l'interruttore di controllo principale, poi sblocca l'arresto di emergenza; il manuale della Pro fa togliere sei viti dalla piastra posteriore per usare la porta Ethernet di debug.

  1. Premete il tasto dell'interruttore della batteria. Premete il tasto dell'interruttore di controllo principale. Ruotate in senso orario il pulsante di arresto di emergenza finché non scatta verso l'alto.
  2. Schede di controllo principali: controllo del movimento x86 (ubuntu, 192.168.41.1), Orin per i modelli di grandi dimensioni (nvidia, 192.168.41.2), Orin per la navigazione (nvidia, 192.168.41.3). Il manuale della Pro dice che la password di accesso va richiesta al servizio clienti.
  3. Per configurare il Wi-Fi, il manuale della Pro indica di svitare le sei viti della piastra posteriore del robot e rimuoverla, poi seguire i passi di rete della Lite (cavo alla porta Ethernet di debug, computer impostato su 192.168.41.xx / 255.255.255.0, ping, ssh, nmcli, ifconfig). È l'unico punto in cui il manuale chiede di aprire il robot.

8.5 Avvia i tre programmi della Pro

La Pro esegue il driver del corpo, un driver delle braccia e il programma di controllo del movimento, ciascuno nel proprio terminale.

  1. Primo terminale, driver del corpo: cd rosws; sudo -s (inserite la password); source install_isolated/setup.bash; roslaunch body_control motion_evt.launch
  2. Secondo terminale, driver delle braccia: cd catkin_ws; sudo -s (inserite la password); source install_isolated/setup.bash; roslaunch aubo_dev_plugin aubo_dev_all.launch
  3. Terzo terminale, programma di controllo del movimento: cd rosws; source install_isolated/setup.bash; roslaunch motion_control motion.launch
  4. Nel terzo terminale, verificate che il valore assoluto di ogni current pos sia inferiore a 1 prima di digitare 1 al prompt (enter 1:). Se un current pos ha valore assoluto superiore a 1, premete control+C per terminare il programma e verificate se l'errore di posizione di un motore è troppo grande.

8.6 Metti in piedi, fai camminare, ferma e spegni la Pro

Azzera con A sul telaio, metti in piedi con X, cammina con Y, blocca con B; spegni nell'ordine previsto per la Pro.

  1. Premete il tasto 'A' per tornare allo stato iniziale. Il robot deve essere fissato al telaio di protezione prima di premere il tasto 'A'. Abbassate il telaio, tenete il robot in posizione verticale per 30 secondi, poi premete 'X' per farlo alzare e controllate che non tremi o non si inclini. Se non è in equilibrio, ripetete.
  2. Camminata: con il robot in piedi, premete 'Y' e camminerà sul posto. Levetta sinistra su o giù: avanti o indietro. Levetta sinistra a sinistra o a destra: di lato. Levetta destra a sinistra o a destra: rotazione antioraria o oraria. Premete 'X' per fermarlo e farlo tornare in piedi.
  3. Pulsante di arresto di emergenza: usatelo in caso di fumo o odore di bruciato, acqua o corpi estranei, perdita di controllo, danni, manovre di emergenza o un cambiamento improvviso dell'ambiente, poi premete gli interruttori di controllo principale e di alimentazione e contattate l'assistenza post-vendita. Prima il robot deve essere sul telaio.
  4. Spegnimento: verificate che il robot sia in piedi; premete 'B' per bloccarlo; fissatelo al telaio e sollevatelo; premete control+C per fermare il programma di controllo del movimento, poi il driver delle braccia, poi il driver del corpo; quando tutti e tre si sono fermati digitate poweroff nel terminale del driver del corpo; premete il pulsante di arresto di emergenza; premete il tasto dell'interruttore di controllo principale; premete il tasto dell'interruttore della batteria; tenete premuto il tasto Home per 5 secondi per spegnere il telecomando.
  5. Posizione in piedi instabile: premete 'B', sollevate il robot, premete 'A' per lo zero, abbassatelo e tenetelo in posizione verticale per 2 minuti, poi premete 'X' per farlo alzare.

9. Facoltativo: la configurazione della simulazione in TienKung-Lab

Questa parte non richiede il robot. È il flusso di lavoro di apprendimento per rinforzo originale per TienKung e richiede Isaac Sim, che è il prodotto Omniverse di NVIDIA.

9.1 Installa TienKung-Lab e controlla che funzioni

Installa Isaac Lab, clona TienKung-Lab fuori da esso, installa entrambi i pacchetti con pip ed esegui un breve addestramento di camminata.

  1. TienKung-Lab è costruito con IsaacSim 4.5.0 e IsaacLab 2.1.0.
  2. Installate Isaac Lab seguendo la sua guida di installazione. Il progetto originale consiglia l'installazione con conda perché semplifica l'esecuzione degli script Python dal terminale.
  3. Clonate questo repository separatamente dall'installazione di Isaac Lab, fuori dalla directory IsaacLab.
  4. Con un interprete Python in cui è installato Isaac Lab, eseguite: cd TienKung-Lab, poi pip install -e .
  5. Installate la libreria rsl-rl: cd TienKung-Lab/rsl_rl, poi pip install -e .
  6. Verificate l'installazione: python legged_lab/scripts/train.py --task=walk --logger=tensorboard --headless --num_envs=64
  7. I badge del progetto originale indicano Python 3.10, Ubuntu 22.04 su piattaforma Linux e RSL_RL 2.3.1.

9.2 Rispetta l'avvertenza del progetto originale prima di provare su un robot reale

Il progetto originale dice che una policy addestrata può causare movimenti inattesi o violenti.

  1. L'avviso di sicurezza del progetto originale, con le sue parole: i test sul robot reale sono rischiosi. La policy RL può causare movimenti inattesi o violenti, quindi assicuratevi di avere un'assicurazione contro gli infortuni e che l'arresto di emergenza funzioni.
  2. Il README rimanda al repository Deploy_Tienkung per la distribuzione. Quel repository indica Ubuntu 22.04 LTS e ROS2 Humble, mentre i manuali di maggio 2025 descrivono ROS 1. Il progetto originale non dice su quali robot sia stato validato il repository di distribuzione, quindi questa guida non fornisce passi di distribuzione.

Questo sito richiede JavaScript. Attiva JavaScript per esplorare i nostri progetti di robotica open source.