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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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)'.
- 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.
- Il progetto originale non pubblica alcun documento che colleghi l'hardware Milk-V del documento di assemblaggio all'attuale software kos-zbot.
- 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.
- 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.
- Procuratevi un set di chiavi esagonali. Il documento dice che i kit di riparazione sono ottimi per questo.
- Inserto esagonale da 2,5 mm, per viti M3 a testa cava, con buona lunghezza (idealmente 15 mm o più).
- Inserto esagonale da 1,5 mm, per viti M3 a testa cava, con buona lunghezza (idealmente 15 mm o più).
- Idealmente anche un avvitatore automatico.
- Attrezzi per staccare i supporti dalle parti.
- 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.
- 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.
- Controller: Milk-V, x1 (la distinta base rimanda al Duo S).
- Scheda driver dei servo: Waveshare Bus Servo Adapter, x1.
- Unità di misura inerziale (IMU) con LCD: scheda MCU RP2040, x1.
- IMU: IMU a 9 gradi di libertà, x1.
- Fotocamera: Milk-V CAM-GC2083, x1.
- Batteria: LiPo per RC, x1 (l'inserzione collegata è un pacco da 1200mAh).
- Da 12V a 5V: convertitore da 12V a 5V, capacità 3 ampere (potrebbero servire connettori), x1.
- Microfono: microfono a elettrete, x1. Altoparlante: altoparlante da 3 Watt, x1. Amplificatore: amplificatore audio mono LM386, x1.
- 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.
- Vite a testa bombata con esagono incassato, M3, lunghezza 10 mm, quantità 14, per i giunti strutturali.
- Vite a testa bombata con esagono incassato, M3, lunghezza 4,5 mm, quantità 129, per le uscite e gli assi dei motori.
- Vite a testa bombata con esagono incassato, M2, lunghezza 5 mm, quantità 80, per i corpi dei motori.
- Vite a testa cilindrica con esagono incassato, M2, lunghezza 5 mm, quantità 12, per il fissaggio delle schede.
- Inserto filettato a caldo, M3, quantità 13, per il torso e altre parti.
- Inserto filettato a caldo, M2, quantità 14, per il supporto dell'elettronica.
- 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.
- 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.
- 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.
- 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.
- Il documento di assemblaggio elenca le parti stampate come 'via bambu build plates' e non fornisce impostazioni di stampa.
- La pagina Links della documentazione K-Scale rimanda a un documento CAD su OnShape.
- 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.
- 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.
- Rimuovete i supporti da tutte le parti.
- 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.
- Usate il saldatore per inserire a caldo gli inserti nelle parti in plastica.
- Torso: inserti M3 a caldo (quantità non indicata nel documento).
- Collo: 'headset M3' come scritto nel documento (quantità non indicata).
- 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.
- Supporto dell'elettronica: 14 x M2.
- Adattatore del collo: 4 x M2.
- Guscio della testa: 4 x M2.
- 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.
- Parte anteriore del rotore: sono montate le piastre del rotore in alluminio.
- Vista laterale: sul davanti c'è un'interfaccia dentata con il rotore, e sul retro un'interfaccia a scorrimento con la piastra del rotore.
- Vista posteriore: il documento indica dove si trovano le prese dei cavi.
- Montare il rotore significa fissare le due piastre metalliche che vanno ai due lati dell'albero motore.
- 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.
- Inserite il motore in ciascuna parte di imbardata dell'anca come mostrato nelle immagini del documento.
- Montate il lato 1 del rotore, poi il lato 2.
- 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.
- Prendete la parte dell'anca.
- Fate passare i cavi attraverso le anche, con il cavo lungo che passa dall'alto e i cavi più corti dai lati.
- Mettete i motori nei loro alloggiamenti. Dovrebbero entrare facilmente.
- Eseguite un fissaggio standard del guscio: 4 x viti M2 con rondelle elastiche spaccate.
- 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.
- Prendete le ginocchia.
- Fissate entrambi i lati del rotore.
- Aggiungete 2 x cavi corti.
- 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.
- 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.
- 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.
- Attenzione, dal documento: assicuratevi che il ginocchio destro sia collegato alla coscia destra.
- Fissate il motore nel corpo con 2 x viti M2 dall'alto e 4 x viti M2 dal basso.
- 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.
- 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.
- Montate due motori, uno per lato.
- Davanti: fissate 8 x viti M2.
- Dietro: fissate 4 viti. Il documento riporta '4 X Ms' e non indica la misura.
- Collegate un cavo tra i due motori. Ignorate i rotori nell'immagine; vengono aggiunti nel passo successivo.
- 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.
- Prendete i piedi.
- Come per tutte le parti, il connettore del rotore più grande è all'interno.
- Assicuratevi che i rotori siano montati sulla parte inferiore del blocco dello stinco.
- Inserite il blocco dello stinco e fatelo scorrere in posizione.
- 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.
- Unite il blocco stinco e piede al blocco del ginocchio come mostrato per il Blocco 1 e il Blocco 2.
- Le immagini mostrano il collegamento del rotore all'esterno e all'interno.
- 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.
- Fate scorrere il motore nel guscio di imbardata dell'anca.
- 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.
- Unite il blocco del torso, il blocco gamba 1 e il blocco gamba 2 come in figura.
- Su ciascun lato, montate il rotore davanti e il rotore dietro.
- Inserite tutti i cavi fino ad avere due catene di cavi, una per gamba.
- 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.
- Prendete il torso.
- Fissatelo alle anche in modo che il bordo del torso sporga sopra la parte anteriore delle anche.
- Tirate i cavi attraverso la base.
- 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.
- Inserite il motore senza il rotore anteriore né quello posteriore.
- Aggiungete un rotore solo sulla faccia rivolta verso l'esterno.
- Fissaggio al guscio del corpo: 4 x viti M2 e 2 x viti M2 sul retro.
- 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.
- Montate le parti delle spalle sul torso come in figura.
- Nota del documento: le tacche attorno all'interfaccia del rotore sono rivolte verso l'esterno, verso la parte anteriore del robot.
- 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.
- Davanti: fissate 8 x viti M2.
- Dietro: fissate 4 viti. Il documento riporta '4 X Ms' e non indica la misura.
- 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.
- Montate le mani sulle staffe dei gomiti, sinistra e destra come in figura.
- 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.
- Unite le braccia alle spalle come mostrato per il Blocco 1 e il Blocco 2.
- Le immagini mostrano il collegamento del rotore davanti e dietro.
- 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.
- La testa ospita la fotocamera, una scheda etichettata 'PCB 1: 5 V IMU + Display' con il microfono, e l'altoparlante.
- 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.
- 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'.
- 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.
- 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.
- Prendete il Milk hat, la scheda Milk, il driver dei servo, l'altoparlante e il supporto dell'elettronica.
- Avvitate solo la scheda Milk al supporto dell'elettronica con viti M2 x 4 e rondelle elastiche spaccate.
- Montate il Milk hat con viti M2 x 4 e rondelle elastiche spaccate.
- Fissate la scheda dei servo motore con viti M2 x 4 e rondelle elastiche spaccate.
- Fissate l'altoparlante, rivolto verso l'alto, con 2 x viti M2 x 4.
- 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.
- 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.
- Prendete l'IMU con display, il microfono e i cavi PH-2 a 3 e 4 pin.
- Collegateli come mostrato nell'immagine del documento.
- Fate passare i cavi attraverso il foro passacavi.
- 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.
- Fissate la testa al collo con 1 x (vite M3 x 5 con rondella elastica spaccata).
- Fate scorrere la copertura della testa.
- 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.
- Mettete la batteria nella cavità del corpo. Nota del documento: devono restare esposti 4 cavi dei servo, non due.
- Fate passare i cavi lungo il percorso lungo sul lato interno destro del corpo.
- Fissate il supporto dell'elettronica nel corpo con 2 x viti (M3 x 10).
- Avvicinate l'assieme della testa e collegate tutti i cavi.
- Avvitate il collo.
- Avvitate lo zaino.
- 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.
- 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.
- Installate le dipendenze di sistema: sudo apt install portaudio19-dev python3-dev
- Installate Rust per kinfer: sudo apt install rustc -y, poi rustup default stable
- Facoltativamente installate Miniforge e create un ambiente: conda create -n kos python=3.12 -y, poi conda activate kos
- 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.
- Consentite le priorità realtime di Python: sudo setcap cap_sys_nice=eip $(readlink -f $(which python))
- Controllate gli interrupt con watch -n 0.2 cat /proc/interrupts e verificate che uart_pl011 sia sull'IRQ 36.
- 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'
- 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"
- Ricaricate udev con sudo udevadm control --reload, poi verificate con cat /proc/irq/36/smp_affinity.
- Aggiungete il vostro utente ai gruppi dialout, i2c, audio e video con sudo usermod -aG, poi disconnettetevi e accedete di nuovo.
- 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).
- 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).
- 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.
- 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.
- WiFi: nmcli connection show, poi sudo nmcli device wifi connect "SSID" password "PASSWORD"
- 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
- Telecamera: attivala tramite raspi-config e installa i pacchetti Gstreamer elencati in Installation.md.
- 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.
- 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).
- I nomi dei robot devono corrispondere ai metadati dei robot disponibili. Usa kscale robot list per vedere i robot disponibili.
- Mostra lo stato in tempo reale: kos status
- Attiva o disattiva la coppia: kos actuator torque enable 11,12,13
- Azzera gli attuatori: kos actuator zero all
- 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.
- 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.
- 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).
- 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.
- 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.
- Installa git-lfs, crea un repository dal template, clonalo e usa Python 3.11 o successivo.
- Installa con pip install -r requirements.txt e, su una macchina con GPU, con pip install 'jax[cuda12]'.
- Addestra una policy: python -m train
- Converti il checkpoint in un modello kinfer: python -m convert /path/to/ckpt.bin /path/to/model.kinfer
- 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.
- Questo percorso viene da una versione precedente. L'attuale kos-zbot non lo documenta.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.