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 Zeroth Bot

Piattaforma di robot umanoide economica stampata in 3D per l'apprendimento per rinforzo sim-to-real

Licenza

MIT

Il repository zeroth-bot e ksim-gym-zbot sono MIT. Il repository zeroth-robotics/hardware (file PCB) e kos-zbot non hanno un file di licenza, quindi le loro condizioni non sono indicate. Verificato il 2 nov 2026.

Guida al montaggio

1. Leggi prima questo

Cosa pubblica la fonte originale per la costruzione di Zeroth-01, e le due versioni del controller e del software che chi costruisce potrebbe avere.

1.1 Cosa pubblica il progetto originale

Un documento di montaggio basato su immagini, una pagina con la distinta base e i repository del software.

  1. Il progetto originale pubblica un solo documento di assemblaggio, lo Zeroth Bot Assembly Document. È un documento condiviso di 61 pagine, e la maggior parte dei passi è costituita da immagini con accanto il numero di viti.
  2. Questa guida segue quel documento nel suo stesso ordine. Dove il documento non fornisce testo per un passo, questa guida non ne fornisce, e dovete seguire le immagini del documento.
  3. Il documento si apre dicendo che in alcuni passi l'ordine è importante, così come l'attenzione ai dettagli segnalati, e chiede di leggerlo tutto prima di iniziare.
  4. La sezione della distinta base del documento stesso dice 'dettagli da aggiungere in seguito'. L'elenco delle parti di questa guida viene dalla pagina Bill of Materials della documentazione K-Scale.
  5. Il documento non fornisce una mappa degli ID dei servo, né impostazioni di stampa, né passi software. Il software è trattato nell'ultima sezione a partire dai repository pubblicati dal progetto originale.

1.2 Controlla quale controller hai

Il documento di montaggio usa una scheda Milk-V; l'attuale repository del software documenta un Raspberry Pi 4B.

  1. Il documento di assemblaggio costruisce l'elettronica attorno a una scheda Milk su un Milk hat, e la sua immagine di panoramica dell'elettronica etichetta il controller 'Brain (MilkV)'.
  2. L'attuale repository software, kos-zbot, indica come prerequisiti Raspberry Pi 4B e Raspberry Pi OS 64-bit. Non menziona la scheda Milk-V né il Milk hat.
  3. Il progetto originale non pubblica alcun documento che colleghi l'hardware Milk-V del documento di assemblaggio all'attuale software kos-zbot.
  4. Le costruzioni fatte tra novembre 2024 e febbraio 2025 usavano un percorso Milk-V: un'immagine OpenLCH su una scheda SD e la libreria Python openlch. Quel percorso più vecchio è descritto nella sezione software ed è indicato come versione precedente.
  5. Stabilite quale controller avete prima di seguire uno dei due percorsi software.

2. Attrezzi e parti

Gli attrezzi richiesti dal documento di montaggio, le parti e gli elementi di fissaggio della distinta base K-Scale e le parti stampate.

2.1 Raccogli gli attrezzi

Cacciaviti esagonali da 2,5 mm e 1,5 mm, un saldatore e un modo per rimuovere i supporti.

  1. Procuratevi un set di chiavi esagonali. Il documento dice che i kit di riparazione sono ottimi per questo.
  2. Inserto esagonale da 2,5 mm, per viti M3 a testa cava, con buona lunghezza (idealmente 15 mm o più).
  3. Inserto esagonale da 1,5 mm, per viti M3 a testa cava, con buona lunghezza (idealmente 15 mm o più).
  4. Idealmente anche un avvitatore automatico.
  5. Attrezzi per staccare i supporti dalle parti.
  6. Un saldatore, per inserire a caldo gli inserti nelle parti in plastica.

2.2 Raccogli elettronica e servo

16 servo STS3250, il controller Milk-V, la scheda driver dei servo e i sensori e i componenti audio elencati.

  1. Servo a bus seriale: x16, STS3250 50KG. La distinta base dice che i servo STS3215 da 45RPM non sono più sufficienti per i requisiti di velocità delle gambe, e di usare gli STS3250.
  2. Controller: Milk-V, x1 (la distinta base rimanda al Duo S).
  3. Scheda driver dei servo: Waveshare Bus Servo Adapter, x1.
  4. Unità di misura inerziale (IMU) con LCD: scheda MCU RP2040, x1.
  5. IMU: IMU a 9 gradi di libertà, x1.
  6. Fotocamera: Milk-V CAM-GC2083, x1.
  7. Batteria: LiPo per RC, x1 (l'inserzione collegata è un pacco da 1200mAh).
  8. Da 12V a 5V: convertitore da 12V a 5V, capacità 3 ampere (potrebbero servire connettori), x1.
  9. Microfono: microfono a elettrete, x1. Altoparlante: altoparlante da 3 Watt, x1. Amplificatore: amplificatore audio mono LM386, x1.
  10. L'elenco del documento di assemblaggio cita anche PCB personalizzati e cavi: 2 x da 150 mm, 3 pin, passo PH-2 mm, e i cavi dei servomotori inclusi, con le linee dati e di alimentazione intrecciate.

2.3 Raccogli gli elementi di fissaggio

Viti M3 e M2 a testa bombata e a testa cilindrica e inserti filettati a caldo, nelle quantità indicate dal progetto originale.

  1. Vite a testa bombata con esagono incassato, M3, lunghezza 10 mm, quantità 14, per i giunti strutturali.
  2. Vite a testa bombata con esagono incassato, M3, lunghezza 4,5 mm, quantità 129, per le uscite e gli assi dei motori.
  3. Vite a testa bombata con esagono incassato, M2, lunghezza 5 mm, quantità 80, per i corpi dei motori.
  4. Vite a testa cilindrica con esagono incassato, M2, lunghezza 5 mm, quantità 12, per il fissaggio delle schede.
  5. Inserto filettato a caldo, M3, quantità 13, per il torso e altre parti.
  6. Inserto filettato a caldo, M2, quantità 14, per il supporto dell'elettronica.
  7. La distinta base dice che si usano viti M3 per tutte le uscite dei motori e viti M2 per tutti i corpi dei motori, con passo grosso standard.
  8. Il documento di assemblaggio richiede anche rondelle elastiche spaccate e viti M2 x 4, M2 x 6 e M3 x 5. Queste misure non sono nella distinta base; vedere la nota sui conflitti.
  9. Per i collegamenti a vite metallo su metallo la distinta base consiglia un frenafiletti removibile a bassa resistenza (Loctite Purple). Dice che una resistenza media può creare problemi allo smontaggio perché la minuteria è piccola, e che va evitata la resistenza alta.
  10. I conteggi sopra presuppongono servo STS3250 con corpo in alluminio. Con i servo STS3215, che hanno un corpo in plastica, la maggior parte dei fori non è prefilettata; le viti autofilettanti facilitano l'assemblaggio, e la vite dell'asse sul lato non motore non sarà filettata.

2.4 Procurati le parti stampate

Le parti stampate derivano dal modello CAD; il documento di montaggio dice che sono stampate tramite piatti di stampa Bambu.

  1. Il documento di assemblaggio elenca le parti stampate come 'via bambu build plates' e non fornisce impostazioni di stampa.
  2. La pagina Links della documentazione K-Scale rimanda a un documento CAD su OnShape.
  3. Un documento più vecchio del progetto originale (dicembre 2024) fornisce impostazioni di stampa per stampanti Bambu: processo 0,16mm, 5 perimetri, supporti ad albero (auto). Elenca anche le parti per nome, tra cui hip_yaw, hip_roll, knee_pitch, ankle_pitch, foot, torso, electronics mount, head, neck e mounting back plate. Queste impostazioni vengono da una versione precedente e il documento attuale non le riporta.
  4. Le parti destre e sinistre sono diverse. Il documento di assemblaggio raccomanda di fare attenzione a quale lato è quale.

3. Preparazione delle parti stampate

Rimuovi i supporti e inserisci gli inserti filettati a caldo prima di montare qualsiasi motore.

3.1 Rimuovi i supporti

Togli i supporti da ogni parte stampata, soprattutto dagli alloggiamenti dei motori e dalle sedi dei rotori.

  1. Rimuovete i supporti da tutte le parti.
  2. Prestate particolare attenzione agli alloggiamenti interni in cui entra il motore e al punto in cui si collega il rotore (mostrato nell'immagine a destra del documento).

3.2 Monta gli inserti filettati a caldo

Inserisci a caldo gli inserti M3 nel torso, nel collo e nelle anche e gli inserti M2 nel supporto dell'elettronica, nell'adattatore del collo e nel guscio della testa.

  1. Usate il saldatore per inserire a caldo gli inserti nelle parti in plastica.
  2. Torso: inserti M3 a caldo (quantità non indicata nel documento).
  3. Collo: 'headset M3' come scritto nel documento (quantità non indicata).
  4. Inserti a caldo dell'anca: 4 x M3. Il documento dice che devono essere il più perpendicolari possibile, e che più avanti questo sarà molto importante.
  5. Supporto dell'elettronica: 14 x M2.
  6. Adattatore del collo: 4 x M2.
  7. Guscio della testa: 4 x M2.
  8. La distinta base conta in totale 13 inserti M3 e 14 inserti M2. Gli inserti M2 nel documento arrivano a 22; vedere la nota sui conflitti.

4. Come si assemblano i motori

La panoramica del documento su servo, piastre del rotore e custodia, su cui si basano tutti i passaggi successivi.

4.1 Leggi la panoramica dei motori

Viste anteriore, laterale e posteriore del servo, con le piastre del rotore in alluminio e le posizioni dei connettori dei cavi.

  1. Parte anteriore del rotore: sono montate le piastre del rotore in alluminio.
  2. Vista laterale: sul davanti c'è un'interfaccia dentata con il rotore, e sul retro un'interfaccia a scorrimento con la piastra del rotore.
  3. Vista posteriore: il documento indica dove si trovano le prese dei cavi.
  4. Montare il rotore significa fissare le due piastre metalliche che vanno ai due lati dell'albero motore.
  5. Il documento tratta poi l'assemblaggio dei gusci solo con immagini.

5. Gambe

Imbardata dell'anca, anca, ginocchia, cosce, stinchi e piedi, nell'ordine indicato dal documento. Il documento definisce questi i passaggi più critici quanto all'ordine.

5.1 Collega i motori nei componenti di imbardata dell'anca

Parti di imbardata dell'anca, un motore in ciascuna, due piastre del rotore, un cavo lungo intrecciato e un cavo corto standard.

  1. Inserite il motore in ciascuna parte di imbardata dell'anca come mostrato nelle immagini del documento.
  2. Montate il lato 1 del rotore, poi il lato 2.
  3. Collegate i cavi: usate uno per tipo dei cavi lunghi intrecciati e un cavo corto standard.

5.2 Collega all'anca

La parte dell'anca, i cavi dei motori e quattro viti M2 con rondelle spaccate.

  1. Prendete la parte dell'anca.
  2. Fate passare i cavi attraverso le anche, con il cavo lungo che passa dall'alto e i cavi più corti dai lati.
  3. Mettete i motori nei loro alloggiamenti. Dovrebbero entrare facilmente.
  4. Eseguite un fissaggio standard del guscio: 4 x viti M2 con rondelle elastiche spaccate.
  5. Avvertenza del documento: raggiungere la M2 in alto a sinistra è probabilmente la parte più difficile dell'assemblaggio. La M2 deve passare da questi fori ed entrare nel corpo del motore.

5.3 Ginocchia

Parti del ginocchio con entrambi i lati del rotore fissati e due cavi corti aggiunti.

  1. Prendete le ginocchia.
  2. Fissate entrambi i lati del rotore.
  3. Aggiungete 2 x cavi corti.
  4. Verificate di avere ora le parti assemblate mostrate nell'immagine del documento.

5.4 Cosce

Parti della coscia, la parte del ginocchio e viti M2: 2 dall'alto e 4 dal basso.

  1. Prendete le parti delle cosce. Destra e sinistra contano. Si riconoscono dal testo in alto: il numero di versione che si legge in avanti indica la destra del robot, quello che si legge al contrario la sinistra.
  2. Fate scorrere la parte del ginocchio nel guscio della coscia, facendo uscire un solo cavo dal retro e tirando un cavo fuori dal lato. Il documento precisa che la sua foto mostra per errore entrambi i cavi passati dal retro.
  3. Attenzione, dal documento: assicuratevi che il ginocchio destro sia collegato alla coscia destra.
  4. Fissate il motore nel corpo con 2 x viti M2 dall'alto e 4 x viti M2 dal basso.
  5. Il documento dice che i passi da 1 a 4 sono i più critici per l'ordine di assemblaggio. Il resto si può montare senza badare all'ordine, ma consiglia comunque di seguire l'ordine indicato.

5.5 Tibie

Parti della tibia, due motori, viti M2: 8 davanti e 4 dietro, e un cavo tra i motori.

  1. Prendete le parti degli stinchi. Hanno la stessa forma delle staffe delle braccia ma non la stessa lunghezza. Se non riuscite a leggere la parola SHIN sulla parte, entrambi gli stinchi sono più lunghi delle staffe delle braccia.
  2. Montate due motori, uno per lato.
  3. Davanti: fissate 8 x viti M2.
  4. Dietro: fissate 4 viti. Il documento riporta '4 X Ms' e non indica la misura.
  5. Collegate un cavo tra i due motori. Ignorate i rotori nell'immagine; vengono aggiunti nel passo successivo.
  6. Prima di proseguire, verificate di avere le parti mostrate nell'immagine del documento.

5.6 Piedi

Parti del piede, con i rotori fissati alla parte inferiore del blocco della tibia.

  1. Prendete i piedi.
  2. Come per tutte le parti, il connettore del rotore più grande è all'interno.
  3. Assicuratevi che i rotori siano montati sulla parte inferiore del blocco dello stinco.
  4. Inserite il blocco dello stinco e fatelo scorrere in posizione.
  5. Le immagini mostrano il collegamento del rotore all'interno e all'esterno.

5.7 Collega il blocco tibia e piede al blocco del ginocchio

Il blocco tibia e piede unito al blocco del ginocchio; il documento fornisce solo immagini.

  1. Unite il blocco stinco e piede al blocco del ginocchio come mostrato per il Blocco 1 e il Blocco 2.
  2. Le immagini mostrano il collegamento del rotore all'esterno e all'interno.
  3. Il documento non fornisce altro testo oltre a queste didascalie.

5.8 Motore nel guscio di imbardata dell'anca

Un motore inserito nel guscio di imbardata dell'anca, con viti M2: 4 davanti e 2 dietro.

  1. Fate scorrere il motore nel guscio di imbardata dell'anca.
  2. Fissaggio al guscio del motore: davanti 4 x viti M2, dietro 2 x viti M2.

5.9 Fissa il motore di imbardata dell'anca nei blocchi delle gambe

Il blocco del torso e i due blocchi delle gambe, con un rotore montato davanti e dietro su ciascun lato.

  1. Unite il blocco del torso, il blocco gamba 1 e il blocco gamba 2 come in figura.
  2. Su ciascun lato, montate il rotore davanti e il rotore dietro.
  3. Inserite tutti i cavi fino ad avere due catene di cavi, una per gamba.
  4. A questo punto il documento indica le gambe come complete.

6. Busto

Fissa il busto alle anche e inserisci i motori delle spalle.

6.1 Fissa il torso alle anche

Il torso sulle anche, i cavi fatti passare nella base e quattro viti nel supporto nero dell'anca.

  1. Prendete il torso.
  2. Fissatelo alle anche in modo che il bordo del torso sporga sopra la parte anteriore delle anche.
  3. Tirate i cavi attraverso la base.
  4. Attenzione, dal documento: usate 4 x M10 per il fissaggio al supporto nero dell'anca, attraverso la parte superiore della cavità del corpo. Il documento scrive 'M10's'; vedere la nota sui conflitti.

6.2 Fissa i motori delle spalle al torso

Motori delle spalle inseriti senza rotori anteriori o posteriori, poi un rotore sulla faccia esterna e viti M2.

  1. Inserite il motore senza il rotore anteriore né quello posteriore.
  2. Aggiungete un rotore solo sulla faccia rivolta verso l'esterno.
  3. Fissaggio al guscio del corpo: 4 x viti M2 e 2 x viti M2 sul retro.
  4. Vista dall'alto: nei punti segnati con riquadri gialli potete mettere una rondella tra il guscio superiore e il motore. C'è spazio perché questo motore si inserisce dall'alto.

7. Braccia e mani

Parti delle spalle, staffe dei gomiti, mani e braccia. Il documento riporta questi passaggi nell'ordine 12, 13, 15, 14 e questa guida mantiene quell'ordine.

7.1 Fissa le parti delle spalle al torso

Parti delle spalle sul torso con le tacche del rotore rivolte verso la parte anteriore del robot.

  1. Montate le parti delle spalle sul torso come in figura.
  2. Nota del documento: le tacche attorno all'interfaccia del rotore sono rivolte verso l'esterno, verso la parte anteriore del robot.
  3. Collegamento del rotore del motore: un solo lato.

7.2 Monta le staffe del gomito

Staffe del gomito con viti M2: 8 davanti e 4 dietro.

  1. Davanti: fissate 8 x viti M2.
  2. Dietro: fissate 4 viti. Il documento riporta '4 X Ms' e non indica la misura.
  3. Verificate che il risultato corrisponda all'immagine del documento.

7.3 Fissa le mani alle staffe del gomito

Mano sinistra e mano destra montate sulle staffe del gomito, con rotori davanti e dietro.

  1. Montate le mani sulle staffe dei gomiti, sinistra e destra come in figura.
  2. Le immagini mostrano il collegamento del rotore davanti e dietro.

7.4 Fissa le braccia alle spalle

Le braccia finite unite alle spalle, con collegamenti dei rotori davanti e dietro.

  1. Unite le braccia alle spalle come mostrato per il Blocco 1 e il Blocco 2.
  2. Le immagini mostrano il collegamento del rotore davanti e dietro.
  3. Il documento mostra poi un'immagine di come dovrebbe apparire il robot.

8. Elettronica

Elettronica del corpo sul supporto dell'elettronica, elettronica della testa, poi la batteria e il montaggio finale.

8.1 Leggi la panoramica dell'elettronica

Cosa mostra l'immagine di panoramica del documento sulla testa, sulla cavità del torso e sul Milk hat.

  1. La testa ospita la fotocamera, una scheda etichettata 'PCB 1: 5 V IMU + Display' con il microfono, e l'altoparlante.
  2. La cavità del torso ospita il Milk board hat ('PCB 2: Milk Board Hat'), che porta il Brain (MilkV) e, disegnati tratteggiati, un elevatore da 12 a 5 e un amplificatore. Ospita anche il driver dei motori, una '3,3 V IMU' e la batteria.
  3. Il Milk hat è disegnato con una fila di sei connettori per servo. L'immagine etichetta la coppia di sinistra e quella di destra 'To any 2/4 servo chains (recommended an arm and leg)', e i connettori centrali 'Servo connection cables to servo driver'. Il testo non spiega il '2/4'.
  4. L'hat mostra anche due collegamenti I2C etichettati alimentazione 5 V e logica 3,3 V, un collegamento I2C etichettato alimentazione 3,3 V e logica 3,3 V, connettori logici della scheda motori marcati TX, RX e GND, un ingresso microfono, un connettore per l'altoparlante, un trimmer del volume e una presa per la fotocamera.
  5. Il documento non fornisce testo sul collegamento o sulla polarità della batteria; seguite le sue immagini.

8.2 Elettronica del corpo

Scheda Milk, Milk hat, driver dei servo e altoparlante sul supporto dell'elettronica con viti M2 x 4 e rondelle spaccate.

  1. Prendete il Milk hat, la scheda Milk, il driver dei servo, l'altoparlante e il supporto dell'elettronica.
  2. Avvitate solo la scheda Milk al supporto dell'elettronica con viti M2 x 4 e rondelle elastiche spaccate.
  3. Montate il Milk hat con viti M2 x 4 e rondelle elastiche spaccate.
  4. Fissate la scheda dei servo motore con viti M2 x 4 e rondelle elastiche spaccate.
  5. Fissate l'altoparlante, rivolto verso l'alto, con 2 x viti M2 x 4.
  6. Collegate il cavo logico tra il connettore etichettato 'motor connection cable' sul Milk hat e i pin logici della scheda che il documento chiama 'wavestride'. Seguite lo schema di collegamento del documento.
  7. Confrontate con le immagini della vista laterale e frontale del documento.

8.3 Elettronica della testa

L'IMU del display, il microfono, i cavi PH-2 a 3 e 4 pin, la telecamera e la piastra di supporto della testa.

  1. Prendete l'IMU con display, il microfono e i cavi PH-2 a 3 e 4 pin.
  2. Collegateli come mostrato nell'immagine del documento.
  3. Fate passare i cavi attraverso il foro passacavi.
  4. Fissate l'elettronica alla piastra di montaggio della testa con viti M2 x 4 e rondelle elastiche spaccate: il supporto dell'IMU con i suoi cavi e la fotocamera con i suoi cavi.

8.4 Unisci i componenti della testa

Testa montata sul collo con una vite M3 x 5 e una rondella spaccata, e copertura della testa fissata con quattro viti M2 x 6.

  1. Fissate la testa al collo con 1 x (vite M3 x 5 con rondella elastica spaccata).
  2. Fate scorrere la copertura della testa.
  3. Fissatela sul retro con 4 x viti M2 x 6 con rondelle elastiche spaccate.

8.5 Elettronica nel corpo

Batteria nella cavità del corpo, poi il supporto dell'elettronica fissato con due viti M3 x 10.

  1. Mettete la batteria nella cavità del corpo. Nota del documento: devono restare esposti 4 cavi dei servo, non due.
  2. Fate passare i cavi lungo il percorso lungo sul lato interno destro del corpo.
  3. Fissate il supporto dell'elettronica nel corpo con 2 x viti (M3 x 10).
  4. Avvicinate l'assieme della testa e collegate tutti i cavi.
  5. Avvitate il collo.
  6. Avvitate lo zaino.
  7. Le ultime tre azioni sono titoli del documento accompagnati solo da immagini.

9. Software

Due percorsi software pubblicati dalla fonte originale: l'attuale kos-zbot per Raspberry Pi 4B e il più vecchio percorso Milk-V. Usa quello che corrisponde al tuo controller.

9.1 Percorso attuale: installa kos-zbot su un Raspberry Pi 4B

Ambiente Python 3.12 e kos-zbot installati su Raspberry Pi OS 64-bit. Non vale per un controller Milk-V.

  1. Prerequisiti: Raspberry Pi 4B, Raspberry Pi OS 64-bit, Python 3.12 o successivo (consigliati Miniforge o Miniconda). L'hardware richiesto comprende servo Feetech, IMU BNO055, audio I2S e così via.
  2. Installate le dipendenze di sistema: sudo apt install portaudio19-dev python3-dev
  3. Installate Rust per kinfer: sudo apt install rustc -y, poi rustup default stable
  4. Facoltativamente installate Miniforge e create un ambiente: conda create -n kos python=3.12 -y, poi conda activate kos
  5. Installate kos-zbot: cd ~, git clone https://github.com/kscalelabs/kos-zbot, cd kos-zbot, pip install -e ., pip install -r requirements.txt

9.2 Percorso attuale: configura il Raspberry Pi

Python in tempo reale, gruppi utente, configurazione di avvio e rete USB gadget, come indicato in Installation.md.

  1. Consentite le priorità realtime di Python: sudo setcap cap_sys_nice=eip $(readlink -f $(which python))
  2. Controllate gli interrupt con watch -n 0.2 cat /proc/interrupts e verificate che uart_pl011 sia sull'IRQ 36.
  3. Assegnate l'IRQ di uart_pl011 a cpu1, perché anche il ciclo di controllo dei servo è assegnato a cpu1: sudo sh -c 'echo 2 > /proc/irq/36/smp_affinity'
  4. Per renderlo permanente, aggiungete una regola udev in /etc/udev/rules.d/80-irq-affinity.rules: ACTION=="add", SUBSYSTEM=="irq", KERNEL=="36", ATTR{smp_affinity}="2"
  5. Ricaricate udev con sudo udevadm control --reload, poi verificate con cat /proc/irq/36/smp_affinity.
  6. Aggiungete il vostro utente ai gruppi dialout, i2c, audio e video con sudo usermod -aG, poi disconnettetevi e accedete di nuovo.
  7. Modificate /boot/firmware/config.txt sotto [all] e aggiungete o verificate le righe indicate in Installation.md per la modalità gadget (dtoverlay=dwc2), il display SPI (dtparam=spi=on), l'IMU (dtparam=i2c_arm=on, dtparam=i2c_arm_baudrate=400000, dtoverlay=i2c6,pins_22_23), l'audio (dtparam=i2s=on, dtparam=audio=on, dtoverlay=max98357a, gpio=26=op,dh, gpio=16=op,dl), la fotocamera (camera_auto_detect=1, display_auto_detect=1, dtoverlay=imx219), il microfono (dtoverlay=googlevoicehat-soundcard, gpio=24=op,dh), la retroilluminazione del display (gpio=17=op,dh) e il controller dei servo (enable_uart=1, auto_initramfs=1, dtoverlay=vc4-kms-v3d, max_framebuffers=2, dtoverlay=disable-bt, dtoverlay=uart5,txd5_pin=12,rxd5_pin=13, disable_fw_kms_setup=1, arm_64bit=1, disable_overscan=1, arm_boost=1).
  8. Per la modalità gadget Ethernet via USB, aggiungete modules-load=dwc2,g_ether alla riga di comando del kernel in /boot/firmware/cmdline.txt (tutto su una riga).
  9. Create /etc/systemd/network/usb0.network con Name=usb0 sotto [Match] e Address=192.168.42.1/24 sotto [Network], poi sudo systemctl enable systemd-networkd e sudo systemctl start systemd-networkd.
  10. Installa dnsmasq e scrivi interface=usb0 e dhcp-range=192.168.42.2,192.168.42.20,255.255.255.0,24h in /etc/dnsmasq.d/usb0.conf, poi esegui sudo systemctl restart dnsmasq.
  11. WiFi: nmcli connection show, poi sudo nmcli device wifi connect "SSID" password "PASSWORD"
  12. Altoparlante e microfono usano la 'Google voiceHat soundcard'. Controlla che compaia con aplay -l e prova la riproduzione con aplay -D hw:sndrpigooglevoi filename.wav
  13. Telecamera: attivala tramite raspi-config e installa i pacchetti Gstreamer elencati in Installation.md.
  14. Display (SPI): sui sistemi Bookworm attuali, installa lgpio come indicato in Installation.md.

9.3 Percorso attuale: avvia il servizio KOS e muovi i servo

Comandi kos service, status, torque, zero e move dal README di kos-zbot.

  1. Avvia sempre un servizio prima di qualsiasi comando di attuatore, policy o test. Esegui kos zbot per il servizio specifico del robot (imposta i guadagni dei servo e applica i limiti di posizione e velocità dai metadati del robot), o kos service per il servizio generico (guadagni predefiniti, nessun limite).
  2. I nomi dei robot devono corrispondere ai metadati dei robot disponibili. Usa kscale robot list per vedere i robot disponibili.
  3. Mostra lo stato in tempo reale: kos status
  4. Attiva o disattiva la coppia: kos actuator torque enable 11,12,13
  5. Azzera gli attuatori: kos actuator zero all
  6. Muovi gli attuatori: kos actuator move --id 11,12 --pos 45 --vel 30. Quando sono caricati i metadati del robot, i comandi che superano i limiti vengono limitati.
  7. Esegui un modello: kos zbot infer --model ./trained_policy.kinfer --action-scale 0.2. La scala delle azioni predefinita è 0.1 e il dispositivo seriale predefinito è /dev/ttyAMA5 a baudrate 1000000.

9.4 Percorso attuale: ID dei servo

Esiste uno strumento per cambiare l'ID di un servo Feetech, ma il progetto originale non pubblica né una mappa degli ID né un passaggio per farlo.

  1. Il repository include kos_zbot/tools/feetech_change_id.py. Accetta --device (predefinito /dev/ttyAMA5), --baudrate (predefinito 1000000), --current-id e --new-id (da 0 a 253).
  2. Il README non spiega come eseguire questo strumento e non dà un elenco di quale ID appartenga a quale giunto. I suoi esempi usano ID come 11, 12, 13 e 21.
  3. Il documento di montaggio non ha un passaggio per l'impostazione degli ID.

9.5 Addestramento di una policy

I comandi ksim-gym-zbot per addestrare e convertire una policy.

  1. Installa git-lfs, crea un repository dal template, clonalo e usa Python 3.11 o successivo.
  2. Installa con pip install -r requirements.txt e, su una macchina con GPU, con pip install 'jax[cuda12]'.
  3. Addestra una policy: python -m train
  4. Converti il checkpoint in un modello kinfer: python -m convert /path/to/ckpt.bin /path/to/model.kinfer
  5. Il comando di visualizzazione del README chiama il robot kbot, non zbot; vedi la nota sulle incongruenze.

9.6 Percorso precedente (da novembre 2024 a febbraio 2025): Milk-V con OpenLCH

Un'immagine OpenLCH su una scheda microSD, SSH via USB e la libreria openlch. Usalo solo se hai una build Milk-V di quel periodo.

  1. Questo percorso viene da una versione precedente. L'attuale kos-zbot non lo documenta.
  2. Scarica l'immagine OpenLCH dalla pagina delle release del repository OpenLCH-buildroot (la sua ultima release, v0.7.1, è datata 18 febbraio 2025) e scrivila sulla scheda SD con balenaEtcher o un altro strumento di scrittura. Al termine rimuovi e reinserisci la scheda SD.
  3. Per impostare il WiFi all'avvio, create nella cartella boot della scheda SD un file chiamato wpa_supplicant.conf con ctrl_interface=/var/run/wpa_supplicant, ap_scan=1, update_config=1 e un blocco network con il vostro ssid, psk e key_mgmt=WPA-PSK.
  4. Via USB la scheda è all'indirizzo IP 192.168.42.1, nome utente root, password milkv: ssh [email protected]. Se c'è un problema con la chiave, eseguite ssh-keygen -R 192.168.42.1.
  5. Sul vostro computer eseguite pip install openlch. Impostate il WiFi con openlch set-wifi <ssid> <password>, riavviate il robot e leggetene l'indirizzo con openlch get-ip.
  6. Per eseguire il modello dimostrativo: git clone --recursive https://github.com/zeroth-robotics/zeroth-bot, create un ambiente conda con python=3.12 (la documentazione precedente lo chiama humanoid-os), pip install -r experiments/requirements.txt, ping 192.168.42.1 per verificare la connessione, poi python experiments/run.py. La cartella experiments esiste solo nei commit più vecchi di quel repository, ad esempio 195cb066.
  7. I documenti precedenti avvertono che la distribuzione delle policy sul robot era ancora in pieno sviluppo. La cartella experiments non esiste più nel repository attuale.

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