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 OpenMower

Progetto open source che trasforma rasaerba commerciali in robot autonomi guidati da GPS RTK

Licenza

GPL-3.0

Guida al montaggio

1. Verifica la compatibilità

Verifica che il modello del tuo robot tosaerba sia compatibile con la conversione OpenMower prima di acquistare qualsiasi parte

1.1 Verifica il modello di rasaerba

Prima di acquistare qualsiasi parte, verifica che il tuo robot rasaerba sia compatibile con il progetto OpenMower. Lo YardForce Classic 500/500B è il modello meglio supportato, con guide fotografiche dedicate. SABO MOWit 500F e John Deere Tango E5 (Series I & II) hanno carrier board dedicate. Il progetto originale afferma che in teoria ogni modello YardForce con telaio Core + Outer Frame (linee SA, SC, LUV, N e NX) costruito dal 2019 in poi ha un'elettronica sostituibile con una scheda madre OpenMower, e che la maggior parte dei rasaerba Husqvarna e Gardena ha un hardware noto per essere compatibile con la scheda madre universale; per il tuo modello esatto, chiedi su Discord. Modelli come Amiro, Compact, EasyMow, MowBest, XPower e la serie MB NON sono compatibili perché la scheda madre non ci entra.

  1. Confronta il modello del tuo tosaerba con l'elenco ufficiale su openmower.de
  2. Per il supporto migliore, verifica che il tuo modello sia YardForce Classic 500/500B, SABO MOWit 500F o John Deere Tango E5
  3. Per le linee YardForce SA/SC/LUV/N/NX, verifica che sia un modello del 2019 o più recente
  4. Verifica che la tensione della batteria sia tra 18,5V e 29,6V (pacchi al litio 5S-8S)
  5. Se il tuo modello non è in elenco, chiedi sul Discord di OpenMower prima di acquistare le parti
  6. Questa guida costruisce l'hardware OpenMower v2 (scheda principale con xCore e Raspberry Pi Compute Module 4, più una scheda carrier per il vostro tosaerba). Avete l'hardware v1, non v2, se usate un Raspberry Pi standard o se la vostra scheda madre riporta la versione v0.xx. Se avete l'hardware v1, seguite invece i documenti archiviati della versione 1.0.2 del progetto originale, perché con l'hardware v1 dovrete anche modificare la stazione di ricarica.
  7. Se avete un YardForce Classic 500(B), prima di iniziare confrontate la versione della vostra scheda carrier con le foto di identificazione del progetto originale. Il progetto originale ha una guida per le schede carrier da 1.x a 1.1.0-beta (prima della v1.2.0) e un'altra per la scheda carrier 1.2.0 e successive. I passi seguenti che valgono solo per una delle due lo indicano.

1.2 Raccogli gli attrezzi necessari

Procurati tutti gli attrezzi e i componenti prima di iniziare la costruzione. Ti serviranno il kit hardware OpenMower v2 (scheda madre che include il caricatore LiPo, la scheda xCore e 3x controller motore xESC), un Raspberry Pi Compute Module 4, un modulo GPS con antenna, un rasaerba compatibile e semplici utensili manuali. Avere tutto pronto evita interruzioni a metà costruzione e garantisce una conversione senza intoppi.

  1. Procurati il kit hardware OpenMower v2. Il progetto originale lo indica come scheda madre (che include il caricatore LiPo), scheda xCore e 3x ESC, e dice di contattare @Apehaenger su Discord per l'hardware.
  2. Procurati un GPS Ardusimple RTK2B con antenna o un modulo WitMotion UM9xx
  3. Procurati un Raspberry Pi Compute Module 4 con WiFi: 2GB+ di RAM per eseguire il software (4GB+ per lo sviluppo) e 16GB+ di memoria, eMMC o scheda micro SD. Un CM4 Lite non ha eMMC e usa una scheda micro SD di almeno 16GB; il progetto originale dice che 32GB è meglio.
  4. Prepara alcuni cacciaviti di base per lo smontaggio e il montaggio. Per SABO MOWiT 500F e John Deere Tango E5, il progetto originale elenca un cricchetto M10 per la copertura, una chiave a brugola da 5mm per la lama, un Torx T30 per il supporto della scheda madre e un Torx T20 per la scheda madre.
  5. Procurati un set di connettori XH e alcuni fili (servono solo per la carrier board YardForce precedente alla v1.2.0, per crimpare i connettori dell'arresto di emergenza e della Cover UI).
  6. Per la modifica della stazione di ricarica servono un multimetro, un saldatore e lo stagno; la modifica riguarda solo l'hardware v1 (vedi la sezione Docking Station Modification).
  7. Scarica la lista della spesa da openmower.de per avere l'elenco completo delle parti

2. Prepara il GPS

Aggiorna il firmware e configura il modulo GPS ArduSimple prima dell'installazione

2.1 Installa il software u-center

Il modulo GPS va configurato con il software u-center di u-blox su un PC Windows. Questo software comunica con la scheda Ardusimple F9P per aggiornare il firmware e caricare la configurazione specifica di OpenMower. Devi usare u-center v1, non v2, perché la versione più recente ha problemi di compatibilità con la procedura di configurazione.

  1. Scarica u-center v1 (non v2) dal sito di u-blox su un PC Windows
  2. Installa u-center e avvia l'applicazione
  3. Collega la scheda Ardusimple tramite la presa micro-USB 'Power+GPS'
  4. Verifica che sulla scheda Ardusimple si accendano i LED blu
  5. In u-center, vai in Receiver > Connection e seleziona la porta COM corretta

2.2 Aggiorna il firmware del GPS

Il modulo GPS Ardusimple F9P deve avere il firmware versione HPG 1.51 perché OpenMower funzioni correttamente. Questo firmware abilita il posizionamento RTK ad alta precisione su cui il rasaerba si basa per una navigazione precisa al centimetro. Prima di caricarlo, verifica che la variante della tua scheda sia ZED-F9P-02B, 04B o 05B.

  1. Verifica che la tua scheda riporti la dicitura ZED-F9P-02B, ZED-F9P-04B o ZED-F9P-05B
  2. Scarica il file del firmware UBX_F9_100_HPG151_ZED_F9P (ZED-F9P HPG 1.51) con il link della pagina Prepare the GPS del progetto originale, che rimanda a u-blox.
  3. Il firmware indicato è solo per la versione L1 + L2. Se il vostro chip è una variante diversa, non usatelo; procuratevi il firmware direttamente da u-blox.
  4. Segui la guida di aggiornamento del firmware di Ardusimple per caricare HPG 1.51
  5. Dopo l'aggiornamento, verifica che in u-center la versione del firmware sia 'ZED-F9P HPG 1.51'
  6. Per i moduli WitMotion UM9xx: collegate il cavo USB-C fornito, aprite un terminale seriale a 115200 baud con terminazione di riga CR/LF, inviate CONFIG per verificare la connessione, poi inviate FRESET seguito da CONFIG COM1 921600 (dopo FRESET il modulo potrebbe impiegare qualche secondo a rispondere).

2.3 Carica la configurazione del robot

Carica il file di configurazione GPS specifico di OpenMower, che imposta le costellazioni satellitari, le frequenze di aggiornamento e i protocolli di comunicazione corretti. Per l'Ardusimple F9P si fa con lo strumento di configurazione del ricevitore di u-center. Per i moduli UM9xx la configurazione si applica con comandi da terminale seriale.

  1. Scarica il file di configurazione robot-fw-1_51.txt dal repository OpenMower
  2. In u-center, apri Tools > Receiver Configuration
  3. Fate clic sul pulsante ... e aprite il file robot-fw-1_51.txt
  4. Fai clic su 'Transfer File > GNSS' per caricare la configurazione
  5. Attendi che il trasferimento termini senza errori
  6. Per WitMotion UM9xx: inviate questi comandi una riga alla volta: MODE ROVER UAV, GPGSV COM1 2, GPRMC COM1 1, GPGSA COM1 1, GPVTG COM1 1, GPGST COM1 1, GPGGA COM1 0.2. Poi inviate SAVECONFIG come nel passo successivo.

2.4 Salva la configurazione nella flash

Dopo aver caricato la configurazione, devi salvarla nella memoria flash non volatile del modulo GPS. Senza questo passaggio la configurazione va persa a ogni spegnimento e il GPS torna alle impostazioni di fabbrica, compromettendo il posizionamento di OpenMower.

  1. In u-center, vai in View > Configuration View
  2. Seleziona 'CFG (Configuration)' nella barra laterale sinistra
  3. Attiva la casella 'Save current configuration'
  4. Verifica che siano selezionate entrambe le destinazioni di memoria '0 - BBR' e '1 - FLASH'
  5. Fai clic sul pulsante 'Send' nella barra degli strumenti in basso
  6. Conferma che il timer mostri '0s', segno che il salvataggio è riuscito
  7. Per UM9xx: invia il comando SAVECONFIG per mantenere le impostazioni dopo lo spegnimento

3. Prepara la scheda SD

Scrivi l'immagine di OpenMowerOS sulla scheda microSD

3.1 Scarica l'immagine OpenMowerOS

OpenMowerOS è un'immagine personalizzata del sistema operativo per Raspberry Pi che include Docker, la configurazione di rete, la creazione automatica di un hotspot Wi-Fi, un terminale nel browser e lo stack software completo di OpenMower. Scarica l'ultima release da GitHub: non serve decomprimere l'immagine prima di scriverla.

  1. Se il vostro CM4 ha una eMMC integrata, saltate questa sezione. Secondo il progetto originale un CM4 di questo tipo si può programmare una volta acceso il tosaerba; i passi sono elencati alla fine di questo passo.
  2. Solo eMMC, dopo aver acceso il tosaerba: tenete premuto il pulsante Rpi Boot sulla scheda xCore (il sinistro dei due pulsanti, con l'etichetta stampata sotto lo slot del CM4), alimentate la scheda xCore o collegate un cavo micro USB dalla scheda xCore al computer, poi rilasciate il pulsante. Il CM4 è ora in modalità di avvio da USB.
  3. Sul vostro computer eseguite rpiboot. Linux: sudo apt install rpiboot, poi sudo rpiboot. Windows: installatelo dalle release di usbboot, riavviate, poi aprite rpiboot - Mass Storage Gadget. macOS: compilate rpiboot dai sorgenti ed eseguite rpiboot -d mass-storage-gadget64. Se il dispositivo non viene riconosciuto, evitate gli hub USB e collegate il cavo micro USB direttamente al computer.
  4. Scrivete l'immagine OpenMowerOS sull'unità eMMC con Raspberry Pi Imager, scegliendo la eMMC come destinazione. Poi scollegate il cavo micro USB e spegnete e riaccendete la scheda; il CM4 si avvia dalla nuova immagine.
  5. Vai su github.com/ClemensElflein/OpenMowerOS/releases
  6. Scarica l'immagine OpenMowerOS più recente dalla sezione Assets
  7. Non decomprimere né estrarre il file immagine scaricato
  8. Scarica e installa Raspberry Pi Imager da raspberrypi.com/software

3.2 Scrivi l'immagine sulla scheda SD

Usa Raspberry Pi Imager per scrivere l'immagine OpenMowerOS sulla tua scheda micro SD. Questa operazione cancella tutti i dati sulla scheda. La dimensione minima della scheda è 16GB; sono consigliati 32GB per l'archiviazione dei log e gli aggiornamenti. L'account utente predefinito è 'openmower', indipendentemente dalle impostazioni di Imager.

  1. Inserisci una scheda micro SD da 16GB+ nel lettore di schede
  2. Avvia Raspberry Pi Imager e seleziona 'Raspberry Pi 4' come dispositivo
  3. Scegli 'Use Custom' e seleziona il file immagine OpenMowerOS scaricato
  4. Seleziona la tua scheda SD dall'elenco dei dispositivi: tutti i dati verranno cancellati
  5. Fai clic su WRITE e conferma l'operazione quando richiesto
  6. Inserisci le credenziali di amministratore se il sistema operativo le richiede

3.3 Verifica la scrittura

Al termine della scrittura, verifica che la scheda SD sia stata scritta correttamente. Il progetto originale dice di attendere che Raspberry Pi Imager finisca e poi togliere la scheda SD dal computer. Una scrittura corrotta impedisce l'avvio del rasaerba e può causare problemi difficili da diagnosticare più avanti nella costruzione.

  1. Attendi che Raspberry Pi Imager finisca
  2. Conferma che l'output di Imager non riporti errori
  3. Espelli in sicurezza la scheda SD dal computer
  4. Metti da parte la scheda SD: la inserirai nel CM4 durante la preparazione della scheda madre

4. Prepara la scheda madre

Monta tutti i moduli elettronici sulla scheda madre OpenMower prima di installarla nel tosaerba

4.1 Monta il CM4 sulla scheda xCore

Il Raspberry Pi CM4 si monta sulla scheda xCore tramite due connettori board-to-board ad alta densità. Allineamento e inserimento corretti sono fondamentali: un CM4 inserito male non si avvia o causa problemi di connettività intermittenti. Se usi un dissipatore, installa i distanziali da 1,7mm sui due fori di montaggio inferiori prima di premere il CM4 in posizione.

  1. Se usi un dissipatore, metti i distanziali da 1,7mm solo sui due fori di montaggio inferiori del CM4
  2. NON mettere distanziali sui due fori di montaggio superiori
  3. Allinea il modulo CM4 ai connettori della scheda xCore
  4. Appoggia due dita sopra entrambi i connettori scheda-scheda
  5. Premi delicatamente verso il basso finché senti e avverti lo scatto di entrambi i connettori in sede
  6. Verifica che il CM4 appoggi a filo e in piano sulla scheda xCore

4.2 Installa il dissipatore (facoltativo)

Per il CM4 si consiglia un dissipatore, per evitare il thermal throttling durante calcoli pesanti come l'elaborazione ROS e la pianificazione del percorso. Il dissipatore usa pad termici a cui vanno tolte le pellicole protettive su entrambi i lati. Fissa il dissipatore solo con le due viti inferiori: i fori superiori restano vuoti.

  1. Fissate i distanziali ai punti di montaggio dell'assieme del dissipatore
  2. Applica i pad termici sul processore e sui chip di memoria del CM4
  3. Rimuovi la pellicola di plastica trasparente dalla parte superiore di ogni pad termico
  4. Allinea il dissipatore ai fori di montaggio del CM4
  5. Fissalo con due viti solo sui punti di montaggio inferiori
  6. NON avvitare nei due fori superiori: causa problemi di montaggio
  7. Premete il distanziale stampato in 3D tra il CM4 e la scheda xCore come mostrato nell'immagine del progetto originale. Il progetto originale dice di usare distanziali tra i PCB, altrimenti le viti esercitano una pressione eccessiva sui connettori.

4.3 Inserisci la scheda SD

Inserisci la scheda SD con OpenMowerOS nello slot micro SD del CM4 PRIMA di montare l'xCore sulla scheda madre. Una volta fissato l'xCore alla scheda madre, lo slot della scheda SD diventa molto difficile da raggiungere. Questo passaggio vale solo per i moduli CM4 Lite: le varianti CM4 con eMMC integrata non usano una scheda SD.

  1. Individua lo slot per la scheda micro SD sul lato inferiore del modulo CM4
  2. Inserisci con decisione la scheda SD OpenMowerOS finché non scatta in sede
  3. Verifica che la scheda sia inserita completamente e non sporga
  4. Salta questo passaggio se il tuo CM4 ha una memoria eMMC integrata

4.4 Installa i controller motore xESC

Tre controller motore xESC si innestano sulla scheda madre per azionare i due motori delle ruote e il motore della lama. Ogni xESC si collega tramite pin header sulla scheda madre. Nota che alcuni pin degli xESC non hanno un connettore corrispondente sulla scheda madre: questi pin inutilizzati servono solo per il primo caricamento del firmware ed è normale.

  1. Individua i tre slot xESC sulla scheda madre (trazione sinistra, trazione destra, lama di taglio)
  2. Allinea il connettore a pettine di ogni xESC con il connettore corrispondente della scheda madre
  3. Premi con decisione ogni xESC nel suo slot finché non è inserito completamente
  4. Nota: alcuni pin senza connettore corrispondente servono solo per caricare il firmware; è normale
  5. Verifica che tutti e tre gli xESC siano in piano e ben fissati nei loro slot

4.5 Installa il modulo GPS

Monta il modulo GPS sulla scheda madre nello slot previsto. Per le schede Ardusimple il modulo si collega tramite pin header. Per i moduli UM9xx collega il cavo IPEX/SMA in dotazione tra il modulo e la carrier board. Il modulo GPS deve essere inserito correttamente per una comunicazione affidabile con i satelliti.

  1. Allinea i pin del modulo GPS con il connettore GPS della scheda madre
  2. Premi con decisione il modulo GPS nello slot della scheda madre
  3. Verifica che il modulo GPS sia inserito saldamente e che il connettore dell'antenna sia accessibile

4.6 Monta il gruppo xCore sulla scheda madre

  1. Inserisci la scheda xCore con un angolo di 45 gradi nello slot della scheda madre
  2. Spingi la xCore verso il basso finché è in piano, assicurandoti che i bracci laterali si aggancino bene su entrambi i lati
  3. Fissa la xCore con due viti: NON usare distanziali sotto
  4. Prima di proseguire, verifica che tutti i moduli (CM4, GPS, xESC) siano inseriti saldamente

5. Smonta il tosaerba

Apri lo YardForce Classic 500 e rimuovi l'elettronica originale per preparare la conversione OpenMower

5.1 Rimuovi le viti del coperchio superiore

Il coperchio superiore dello YardForce Classic 500/500B è tenuto da diverse viti che vanno rimosse in sequenza. Prima di iniziare imposta l'altezza di taglio al minimo (20mm), perché facilita la rimozione del coperchio. Ci sono 7 viti principali del coperchio più 3 viti aggiuntive, e piccole viti accanto al meccanismo di chiusura facili da non notare.

  1. Imposta l'altezza di taglio del tosaerba sulla posizione minima (20mm)
  2. Rimuovi le 7 viti principali della copertura dal guscio superiore
  3. Rimuovi le 3 viti aggiuntive lungo il perimetro
  4. Individua e rimuovi le viti piccole accanto al meccanismo del fermo
  5. Tieni in ordine tutte le viti: le riutilizzerai durante il rimontaggio
  6. Per SABO/John Deere: capovolgi il tosaerba e rimuovi invece 6x viti esagonali da 10mm

5.2 Apri il coperchio

Dopo aver tolto tutte le viti, il coperchio è ancora trattenuto da meccanismi a scatto che vanno sbloccati. Premi lo sblocco nero per liberare gli scatti laterali, poi spingi con il dito lo scatto inferiore sollevando con cautela il coperchio. Non forzarlo: viti o cavi nascosti possono causare danni.

  1. Premi la parte nera di sblocco del fermo per sbloccare i fermi laterali
  2. Spingi il fermo inferiore verso l'interno con il dito
  3. Solleva la copertura lentamente e con attenzione: sotto ci sono ancora cavi collegati
  4. Sostieni la copertura in modo che non resti appesa ai cavi
  5. Per SABO: rimetti il tosaerba diritto tenendo unito l'alloggiamento, apri leggermente la parte posteriore

5.3 Scollega i cavi del coperchio

Tre cavi collegano il coperchio al corpo del rasaerba e vanno scollegati prima di poter rimuovere completamente il coperchio. Sono due fili sottili che vanno ai sensori di sollevamento delle ruote nella parte anteriore e un cavo piatto largo dalla scheda madre alla scheda cover UI. Maneggia i connettori con delicatezza: tirando i fili invece dei corpi dei connettori si possono rompere.

  1. Scollega i 2 fili piccoli sul davanti che vanno ai sensori di sollevamento delle ruote
  2. Scollega il cavo piatto largo (1) che va dalla scheda madre alla scheda Cover UI
  3. Tira i connettori afferrandoli dall'involucro: non tirare mai i fili
  4. Metti da parte la copertura in un luogo sicuro
  5. Per SABO: usa una torcia per individuare e scollegare attraverso la fessura i cavi piatti del display

5.4 Rimuovi la scheda madre originale

Scollega tutti i cavi rimanenti dalla scheda madre di serie, poi estraila dal telaio. Prima di scollegare annota la posizione e il percorso dei cavi: le foto sono utili come riferimento. La scheda madre di serie non verrà riutilizzata, ma conservala come riferimento per identificare i cavi.

  1. Fotografa tutti i collegamenti dei cavi prima di scollegare qualsiasi cosa
  2. Scollega il cavo largo della scheda madre dalla parte posteriore
  3. Scollega i cavi dei sensori delle ruote e toglili dai passacavi
  4. Rimuovi tutti i cavi rimasti dalla scheda madre di serie
  5. Svita e rimuovi dal telaio la scheda madre di serie
  6. Conserva al sicuro la scheda madre di serie nel caso ti serva come riferimento

5.5 Rimuovi la PCB del sensore anteriore

Il sensore di perimetro originale è una PCB sottile montata nella parte anteriore del rasaerba. Va rimossa per fare spazio al supporto dell'antenna GPS. Conserva le 3 viti di fissaggio: le riutilizzerai per montare il supporto dell'antenna GPS o la staffa dell'antenna Wi-Fi negli stessi fori.

  1. Individua il sottile PCB del sensore di perimetro nella parte anteriore del tosaerba
  2. Rimuovi le 3 viti che fissano il PCB del sensore anteriore
  3. Conserva queste 3 viti: si riutilizzano per il montaggio dell'antenna GPS o WiFi
  4. Rimuovi dal telaio il PCB del sensore anteriore

5.6 Rimuovi la scheda Cover UI

Solo carrier board precedenti alla v1.2.0 (da 1.x a 1.1.0-beta). La guida del progetto originale per la carrier board 1.2.0 e successive non la rimuove e collega invece la scheda CoverUI originale; con quella carrier board salta questo passaggio. La scheda Cover UI di serie nel coperchio gestisce display, pulsanti e sensori dell'arresto di emergenza. Il progetto originale presuppone che tu la sostituisca completamente con una scheda personalizzata; se invece riusi la scheda di serie caricandoci un firmware personalizzato, lasciala al suo posto. Rimuovila con cura, conservando la guarnizione protettiva in gomma e le viti di fissaggio per riutilizzarle. Se hai una scheda CoverUI OpenMower personalizzata, la monterai più avanti nella stessa posizione.

  1. Scollega dalla scheda Cover UI i fili del sensore del pulsante di stop
  2. Scollega il cavo della scheda madre, il cavo del sensore di emergenza e il sensore pioggia
  3. Svita le viti di fissaggio e conservale per la scheda sostitutiva
  4. Rimuovi la scheda Cover UI dal coperchio
  5. Rimuovi la guarnizione protettiva in gomma e conservala per riutilizzarla

5.7 Rimuovi il cablaggio di serie

Con la carrier board 1.2.0 e successive rimuovi solo la scheda madre di serie e il sensore perimetrale (il PCB sottile nella parte anteriore del robot). Con le carrier board precedenti alla v1.2.0 rimuovi anche tutti i cavi nel coperchio arancione (arresto di emergenza). La batteria deve restare installata: alimenta l'elettronica OpenMower. Rimuovi solo il cablaggio elettronico di controllo, non i cavi di alimentazione dei motori o i collegamenti della batteria.

  1. Rimuovi il fascio di cavi dell'arresto di emergenza con la guaina arancione
  2. Rimuovi tutto il cablaggio del sensore di perimetro
  3. Lascia la batteria installata: OpenMower la riutilizza
  4. Lascia al loro posto i cavi di alimentazione dei motori: si collegano alla nuova scheda madre
  5. Lascia accessibili i fili dei contatti di ricarica per ricollegarli
  6. Verifica che il telaio sia pulito e pronto per la nuova elettronica

6. Piccole preparazioni

Prepara i punti di fissaggio e crimpa i nuovi connettori prima di installare l'elettronica OpenMower

6.1 Taglia le linguette di plastica nel coperchio

Solo per la carrier board precedente alla v1.2.0 (da 1.x a 1.1.0-beta). Alcuni modelli YardForce Classic 500 hanno all'interno del coperchio delle linguette di plastica che interferiscono con la nuova scheda madre o con il passaggio dei cavi. Queste linguette vanno rimosse prima di installare l'elettronica OpenMower. Non tutti i modelli hanno queste linguette: controlla il tuo coperchio prima di tagliare.

  1. Controlla se all'interno del coperchio del tosaerba ci sono linguette di plastica sporgenti
  2. Se non ci sono linguette, salta questo passaggio
  3. Usa un tronchesino o un Dremel per tagliare a filo le linguette d'ingombro
  4. Rifinisci eventuali bordi ruvidi dopo il taglio
  5. Verifica che l'interno del coperchio sia libero per l'inserimento della nuova scheda madre

6.2 Monta il supporto dell'antenna GPS

Il supporto dell'antenna GPS stampato in 3D monta l'antenna RTK sopra il rasaerba per una vista libera del cielo. Si aggancia nei fori lasciati dalle fascette rimosse nella parte anteriore del rasaerba e si fissa con una vite M4x16. Un buon posizionamento dell'antenna GPS è fondamentale per un fix RTK affidabile.

  1. Procurati il supporto dell'antenna GPS stampato in 3D e la vite M4x16
  2. Fissa l'antenna GPS al supporto con 2x viti M2.5x20
  3. Verifica che l'antenna sia ben salda sul supporto e non oscilli
  4. Per SABO: pratica invece un foro da 6.5-7mm nella copertura nel punto indicato

6.3 Ricrimpa i cavi dell'arresto di emergenza

Solo per la carrier board precedente alla v1.2.0 (da 1.x a 1.1.0-beta). Il sistema di arresto di emergenza di serie usa un unico grande connettore per tutti i pulsanti. Per OpenMower devi tagliare questo connettore e realizzare quattro cavi separati con singoli connettori XH, uno per ogni sensore di emergenza. Fai molta attenzione alla piedinatura, perché nel connettore originale c'è un incrocio che va mantenuto.

  1. Taglia il cavo dell'arresto di emergenza molto vicino al grande connettore originale
  2. Separa i fili in quattro gruppi di cavi distinti (uno per sensore)
  3. Controlla con attenzione la piedinatura: nel cablaggio del connettore c'è un incrocio
  4. Crimpa i pin dei connettori XH su ogni estremità dei fili
  5. Inserisci i pin crimpati negli involucri XH rispettando la piedinatura corretta
  6. Verifica ogni cavo con una prova di continuità con il multimetro
  7. Etichetta ogni cavo in base alla posizione: coperchio sinistro, coperchio destro e due sensori del corpo

6.4 Crea il cavo CoverUI

Solo carrier board precedenti alla v1.2.0 (da 1.x a 1.1.0-beta). Se installi una scheda CoverUI OpenMower personalizzata, devi realizzare un cavo diretto con connettori XH a entrambe le estremità. Questo cavo a 4 fili collega la scheda madre alla scheda cover UI sostitutiva nel coperchio. Il cablaggio è diretto: pin 1 su pin 1, senza incroci.

  1. Taglia 4 fili lunghi circa 20cm ciascuno
  2. Crimpa i pin dei connettori XH su entrambe le estremità di ogni filo
  3. Inserisci tutti e 4 i pin in un involucro XH su un'estremità: pin 1 su pin 1, collegamento diretto
  4. Inserisci tutti e 4 i pin in un involucro XH sull'altra estremità, nello stesso ordine
  5. Verifica la continuità di ogni filo con un multimetro
  6. Etichetta il cavo come 'CoverUI' per evitare confusione durante l'installazione

7. Installa l'elettronica OpenMower

Installa la scheda madre OpenMower assemblata e collega tutti i cavi al tosaerba

7.1 Installa la scheda madre

Metti la scheda madre OpenMower assemblata (con xCore, CM4, GPS e xESC già montati) nel telaio del rasaerba nella stessa posizione della scheda originale. Il lato posteriore si inserisce tra le linguette di allineamento in plastica e quello anteriore si fissa con due viti. Assicurati che la scheda sia in piano e stabile prima di collegare qualsiasi cavo.

  1. Posiziona la scheda madre nel telaio dove era installata la scheda originale
  2. Allinea la parte posteriore della scheda tra le linguette di allineamento in plastica
  3. Fissa la parte anteriore della scheda con due viti di montaggio
  4. Verifica che la scheda sia in piano e non si fletta quando la premi
  5. Conferma che tutti i connettori della scheda madre siano accessibili per il passaggio dei cavi

7.2 Monta il supporto dell'antenna GPS

Installa il gruppo supporto dell'antenna GPS sulla parte anteriore del rasaerba, dove è stato rimosso il sensore perimetrale. Il supporto si aggancia nei fori lasciati dalle due fascette in plastica bianca e si fissa con una vite M4x16. L'antenna deve avere una vista libera del cielo per un posizionamento RTK affidabile.

  1. Rimuovi le due fascette bianche in plastica sul davanti tirandole verso l'alto
  2. Inserisci le gambe del supporto dell'antenna GPS nei fori corrispondenti
  3. Fissa il supporto con una vite M4x16
  4. Verifica che l'antenna sporga sopra la linea della copertura per avere una vista libera del cielo
  5. Per SABO: installa la prolunga SMA attraverso il foro praticato nella copertura e sigillalo con silicone

7.3 Collega i cavi dei motori e dell'alimentazione

Collega alla scheda madre OpenMower i cavi dei motori di trazione, il cavo del motore di taglio, i cavi dei sensori dei motori e il connettore di alimentazione principale. Sono i cavi di sezione maggiore del sistema e portano una corrente notevole. Assicurati che i connettori siano inseriti a fondo: un collegamento del motore lento può causare un funzionamento intermittente o danneggiare i controller xESC.

  1. Collega il cavo del sensore del motore di taglio alla porta sensori della scheda madre
  2. Collega alla scheda madre il connettore principale dei motori (trazione + motore di taglio + sensori)
  3. Collega il connettore di alimentazione all'ingresso di alimentazione della scheda madre
  4. Verifica che ogni connettore scatti completamente nella sua presa
  5. Disponi i cavi in modo ordinato per evitare che vengano schiacciati quando chiudi la copertura

7.4 Collega la ricarica e l'arresto di emergenza

Solo carrier board precedenti alla v1.2.0 (da 1.x a 1.1.0-beta). Collega il cavo dei contatti di ricarica e i quattro cavi ricrimpati dell'arresto di emergenza alle rispettive porte della scheda madre (l'elenco del progetto originale indica i due pulsanti di arresto di emergenza nel coperchio; sinistro o destro non importa). Con la carrier board 1.2.0 e successive collega solo i contatti di ricarica e la scheda CoverUI originale (sensori di emergenza, sensore di pioggia, LED, pulsanti). Assicurati che ogni connettore sia inserito a fondo.

  1. Collega il cavo dei contatti di ricarica alla porta di ricarica della scheda madre
  2. Collega il cavo dell'arresto di emergenza del coperchio sinistro al suo connettore etichettato sulla scheda madre
  3. Collega il cavo dell'arresto di emergenza del coperchio destro al suo connettore etichettato sulla scheda madre
  4. Collega i due cavi dell'arresto di emergenza del corpo ai loro connettori sulla scheda madre
  5. Verifica con una leggera trazione che tutti i connettori XH siano inseriti completamente

7.5 Collega USB e Cover UI

Collega il cavo USB dalla porta USB posteriore del robot alla scheda madre per l'accesso esterno, e collega il cavo CoverUI dalla scheda madre alla scheda UI sostitutiva del coperchio. La porta USB serve per collegare il gamepad e per l'accesso di debug.

  1. Collega il cavo USB dalla parte posteriore del robot alla porta USB della scheda madre
  2. Fai passare il cavo CoverUI dalla scheda madre fino alla copertura
  3. Collega il cavo CoverUI alla scheda Cover UI sostitutiva nel coperchio
  4. Verifica che entrambi i collegamenti siano saldi e che i cavi abbiano gioco sufficiente per l'apertura della copertura
  5. Scheda carrier 1.2.0 e successive: non c'è un cavo CoverUI personalizzato; collegate la scheda CoverUI originale (sensori di emergenza, sensore di pioggia, LED, pulsanti) alla scheda madre.

7.6 Collega l'antenna GPS e i sensori di sollevamento

Solo carrier board precedenti alla v1.2.0 (da 1.x a 1.1.0-beta). Collega il cavo coassiale dell'antenna GPS al modulo GPS sulla scheda madre e collega entrambi i cavi dei sensori di sollevamento. I sensori di sollevamento rilevano quando il rasaerba viene sollevato (attivando un arresto di emergenza). I sensori di sollevamento sinistro e destro sono intercambiabili: ognuno può andare in una qualsiasi delle due porte.

  1. Collega il cavo SMA/IPEX dell'antenna GPS al connettore del modulo GPS
  2. Collega un cavo del sensore di sollevamento alla prima porta per sensore di sollevamento della scheda madre
  3. Collega l'altro cavo del sensore di sollevamento alla seconda porta per sensore di sollevamento
  4. I sensori di sollevamento sinistro e destro sono intercambiabili: l'ordine non conta
  5. Verifica che il cavo dell'antenna GPS non sia piegato né schiacciato

7.7 Installa l'antenna Wi-Fi (facoltativo)

Per migliorare la copertura Wi-Fi, installa un'antenna Wi-Fi esterna con un supporto stampato in 3D che si fissa dove è stato rimosso il PCB del sensore anteriore. Questa sostituisce l'antenna interna del CM4 con un'antenna esterna a guadagno più alto. Dopo l'installazione fisica serve una modifica di configurazione software in /boot/firmware/config.txt per passare dall'antenna interna a quella esterna.

  1. Monta l'antenna WiFi esterna sul supporto stampato in 3D
  2. Fissa il supporto al tosaerba con 2 viti del sensore anteriore rimosso
  3. Collega il cavo dell'antenna al connettore per antenna esterna del CM4
  4. Fissa il cavo all'angolo del PCB con una fascetta per evitare che si impigli
  5. La configurazione software per passare dall'antenna interna a quella esterna si farà nella Sezione 10 (Software Setup) dopo il primo avvio

7.8 Chiudi il rasaerba

Chiudi con cura il coperchio del rasaerba, assicurandoti che nessun cavo resti schiacciato tra coperchio e telaio. Prima di chiudere verifica che tutti i collegamenti dei cavi siano sicuri e che i cavi passino correttamente. Rimetti tutte le viti del coperchio nell'ordine inverso a quello di rimozione. NON installare ancora la lama: la lama si installa dopo la calibrazione dei motori.

  1. Verifica che tutti i cavi passino lontano dal percorso di chiusura della copertura
  2. Abbassa lentamente la copertura guidando i cavi nei loro canali di passaggio
  3. Aggancia i meccanismi del fermo su entrambi i lati
  4. Rimonta tutte le viti della copertura nelle posizioni originali
  5. Per SABO: capovolgi il tosaerba, rimonta le 6x viti esagonali da 10mm, avvita l'antenna GPS
  6. NON montare ancora la lama di taglio: va tolta durante la calibrazione dei motori

8. Modifica della stazione di ricarica (solo hardware v1)

Solo hardware v1. Hai l'hardware v1 se usi un Raspberry Pi di dimensioni standard o se la tua scheda madre riporta la versione v0.xx. Non eseguire questa sezione sull'hardware v2. L'attuale guida YardForce originale per l'hardware v2 dice: per l'hardware v1 dovrai anche modificare la stazione di ricarica, e i suoi passaggi per v2 non contengono alcuna modifica della stazione di ricarica (il primo passaggio di avvio colloca il tosaerba nella stazione di ricarica). Fonte di questa sezione: i documenti archiviati della versione 1.0.2 originale. Aggiunge alla stazione di ricarica un modulo a corrente costante / tensione costante, su un PCB di supporto con un fusibile, in modo che possa caricare la batteria LiPo.

8.1 Smonta la stazione di ricarica

Solo hardware v1. Hai l'hardware v1 se usi un Raspberry Pi di dimensioni standard o se la tua scheda madre riporta la versione v0.xx. Avvertenze del progetto originale per questa sezione (versione archiviata 1.0.2): non usare la stazione di ricarica non modificata con la scheda madre OpenMower! Errori in questo passaggio possono danneggiare la batteria o persino causare incendi. Non dedurre la polarità del cavo YardForce originale dai colori, usa un multimetro. La pagina introduttiva v1 del progetto originale aggiunge: NON usare il caricabatterie di serie con la scheda madre OpenMower. La modifica aggiunge un modulo a corrente costante / tensione costante (CC/CV) che carica la batteria LiPo; un carrier PCB ospita il modulo e aggiunge un fusibile che lo protegge dalle sovracorrenti. Inizia capovolgendo l'intera stazione di ricarica.

  1. Capovolgi la stazione di ricarica
  2. Rimuovi le 6 viti (rosse) che fissano la parte di aggancio alla base
  3. Rimuovi le 5 viti (gialle) che fissano la piastra inferiore
  4. L'unità di aggancio dovrebbe ora staccarsi dalla piastra inferiore con 2 fili verdi ancora collegati
  5. Metti da parte le viti in ordine per il rimontaggio

8.2 Apri la stazione di ricarica

Separa il guscio della stazione di ricarica sganciando le linguette di plastica e togliendo le viti aggiuntive. La stazione ha sul retro 2 linguette di plastica da sganciare con un attrezzo piatto, poi un elemento di copertura in plastica arancione e 7 viti sul pannello posteriore. Lavora con attenzione per non rompere le clip di plastica.

  1. Individua le 2 linguette di plastica sul retro dell'unità di ricarica
  2. Premi ogni linguetta verso il basso con una leva di plastica finché scatta e si sgancia
  3. Rimuovi la parte superiore in plastica in corrispondenza di ogni linguetta
  4. Premi con le dita sul pezzo di plastica arancione e rimuovilo
  5. Rimuovi le 7 viti dal retro dell'unità di ricarica
  6. Separa le parti dell'unità di ricarica per accedere all'interno

8.3 Popola la PCB della stazione di ricarica

Il kit OpenMower comprende una piccola PCB di supporto che alloggia il modulo CC/CV e aggiunge la protezione con fusibile. Prima di montare il modulo CC/CV, salda i componenti necessari sulla PCB di supporto. La resistenza da 3,3k e il pin header facoltativi abilitano il LED sul retro della base, che indica quando l'alimentazione è disponibile.

  1. Salda il fusibile sul PCB carrier nella posizione indicata
  2. Salda il morsetto a vite sul PCB carrier
  3. Facoltativamente, salda il connettore a pettine sul retro della scheda per il supporto dei LED
  4. Facoltativamente, salda la resistenza da 3,3k per il funzionamento del LED di alimentazione
  5. Controlla tutte le saldature per individuare saldature fredde o ponti
  6. Controllate il colore del PCB della vostra stazione di ricarica; il progetto originale dà istruzioni separate per la scheda rossa 0.13 e per quella verde 0.10. Rossa 0.13: saltate la dissaldatura del modulo CC/CV, montatelo sul PCB della stazione con viti da 3mm, collegatelo con dei fili (in alternativa saldate direttamente i morsetti CC/CV nei fori) e saldate gli altri componenti. Verde 0.10: seguite i passi seguenti.

8.4 Monta il modulo CC/CV sul PCB

Solo PCB della stazione verde 0.10: i morsetti a vite originali del modulo CC/CV vanno dissaldati per poterlo montare sul carrier PCB; usa molto calore e nessuna forza per non danneggiare i collegamenti passanti, e libera i fori con una pompetta dissaldante. Sul PCB della stazione rosso 0.13 salta la dissaldatura. Monta il modulo sul carrier PCB con viti da 3mm (il kit non include distanziali per il modulo CC/CV), senza stringere troppo, in modo che la serigrafia resti intatta.

  1. Solo Green 0.10: dissaldate i morsetti a vite dal modulo CC/CV usando molto calore e nessuna forza
  2. Solo Green 0.10: liberate i fori passanti con una pompetta dissaldante
  3. Allinea il modulo CC/CV sulla posizione di montaggio del PCB carrier
  4. Fissate con viti da 3mm, senza stringerle troppo, in modo che la serigrafia resti intatta
  5. Se avete dei distanziali, potete usarli. Verde 0.10: se non avete distanziali né fili, potete collegare il PCB con un normale pin header e usare dei dadi come distanziali (oppure nessun distanziale)

8.5 Imposta la tensione di carica

Solo hardware v1. Hai l'hardware v1 se usi un Raspberry Pi di dimensioni standard o se la tua scheda madre riporta la versione v0.xx. Monta il gruppo carrier PCB popolato dentro la stazione di ricarica e collega il modulo come mostrato nell'immagine del progetto originale. Prima controlla con un multimetro la polarità dei cavi nei morsetti: il progetto originale avverte che molti la sbagliano. Poi imposta la tensione a 29,2V e la corrente al minimo ruotando fino in fondo in senso antiorario, cosa importante per il passaggio successivo.

  1. Collega un multimetro come mostrato nell'immagine del progetto originale e collega l'alimentatore
  2. Imposta la tensione a 29,2V
  3. Impostate la corrente al minimo girando il potenziometro della corrente tutto in senso antiorario (è importante per il passo successivo). Dovreste sentire un clic appena raggiunto il limite; in caso contrario, giratelo di almeno 20 giri
  4. Quando il potenziometro della corrente è tutto in senso antiorario, anche la tensione è limitata. Dopo averlo girato completamente, dategli un piccolo colpetto in senso orario, in modo da poter ancora misurare con precisione la tensione.
  5. Scollegate l'alimentatore.
  6. Verifica la polarità con un multimetro prima del collegamento definitivo: non dedurla mai dal colore dei fili

8.6 Rimonta la stazione di ricarica

Solo hardware v1. Hai l'hardware v1 se usi un Raspberry Pi di dimensioni standard o se la tua scheda madre riporta la versione v0.xx. Rimonta la stazione di ricarica solo dopo aver impostato sia la tensione sia la corrente di carica (la corrente si imposta nel passaggio Calibrate Charging Current, che richiede il rasaerba finito). Poi rimonta in ordine inverso e tieni i cavi lontano dai fori delle viti e dalle parti in movimento. Non dimenticare di collegare il terminale positivo che era stato scollegato.

  1. Non dimenticate di collegare il filo del terminale di ricarica positivo che era stato scollegato durante l'impostazione della corrente
  2. Fai passare tutti i fili lontano dai fori delle viti e dai punti di schiacciamento
  3. Rimonta le due metà dell'unità di ricarica e rimetti le 7 viti posteriori
  4. Rimetti la copertura in plastica arancione e riaggancia le 2 linguette di plastica
  5. Rimonta la piastra inferiore con 5 viti e la parte di aggancio con 6 viti
  6. Accendi brevemente e verifica che il LED indicatore funzioni (se hai installato la resistenza)

9. Primo avvio e verifica

Accendi il tosaerba per la prima volta e verifica che tutti i componenti funzionino

9.1 Accensione e controllo di sicurezza

La prima accensione è un momento critico per la sicurezza. Attiva l'interruttore di alimentazione sul retro del robot e osserva e annusa subito per cogliere eventuali segni di problemi. Se vedi fumo o fuoco, senti odore di elettronica surriscaldata o noti fusibili bruciati, spegni l'interruttore IMMEDIATAMENTE. Tieni il robot acceso per almeno cinque minuti per permettere al CM4 di completare il primo avvio e la configurazione iniziale.

  1. Assicurati che la lama di taglio NON sia montata prima dell'accensione
  2. Aziona l'interruttore di alimentazione sul retro del robot
  3. Osserva attentamente se compaiono fumo, scintille o comportamenti insoliti
  4. Fai attenzione all'odore di elettronica bruciata: se lo senti, spegni subito
  5. Se qualcosa non va, spegni IMMEDIATAMENTE e controlla tutti i collegamenti
  6. Alcuni pacchi batteria non tollerano la corrente di spunto e si spengono subito. Se succede, spegnete e riaccendete e dovrebbe funzionare.

9.2 Attendi la sequenza di avvio

Il CM4 esegue la configurazione del primo avvio, che comprende l'espansione del filesystem, l'inizializzazione dei container Docker e la configurazione di rete. Al primo avvio richiede diversi minuti. Durante questa fase metti il robot nella stazione di ricarica per evitare che la batteria si scarichi, anche se la ricarica non funzionerà finché più avanti non verrà installato il firmware.

  1. Tieni il robot acceso per almeno 5 minuti per la configurazione del primo avvio
  2. Metti il tosaerba nella stazione di ricarica per non consumare la batteria durante la configurazione
  3. Non spegnere e riaccendere durante il primo avvio: lascialo terminare completamente
  4. In questo stato la batteria non si carica, perché la scheda xCore non ha ancora il firmware corretto, ma la tensione della stazione di ricarica viene comunque usata per alimentare l'elettronica, quindi la batteria non si scarica. La ricarica funziona dopo l'installazione del firmware nella configurazione software.

9.3 Verifica i LED indicatori

Dopo un avvio riuscito, i LED devono lampeggiare sugli xESC, sul modulo GPS, sulla scheda xCore e sulla scheda madre. Questi schemi di lampeggio confermano che tutti i componenti principali sono alimentati e comunicano. LED assenti o che non lampeggiano indicano un problema di collegamento da risolvere prima di proseguire.

  1. Verifica che i LED lampeggino su tutti e 3 i controller dei motori xESC
  2. Verifica che il LED del modulo GPS lampeggi (modalità di ricerca dei satelliti)
  3. Verifica che il LED della scheda xCore sia attivo
  4. Verifica che il LED di alimentazione della scheda madre sia acceso
  5. Se manca qualche LED, spegni e ricontrolla il collegamento di quel componente
  6. Attendi circa 10 secondi che tutti i LED e l'LCD si attivino completamente
  7. Se tutto sembra in ordine, proseguite con la configurazione software. Altrimenti fermatevi qui e chiedete aiuto sul server Discord.

9.4 Calibra la corrente di carica (solo hardware v1)

Solo hardware v1. Hai l'hardware v1 se usi un Raspberry Pi di dimensioni standard o se la tua scheda madre riporta la versione v0.xx. Avvertenze del progetto originale per questo passaggio: scollega l'alimentatore prima di modificare i collegamenti; la corrente del modulo non si può impostare cortocircuitandolo con il multimetro, perché alcuni moduli non funzionano bene in cortocircuito; come carico si usa la batteria del robot, ed è per questo che prima la corrente di carica va impostata il più bassa possibile. Il progetto originale cerca una corrente costante di 1A (in alternativa si può usare un carico elettronico).

  1. Scollega temporaneamente il filo del terminale di ricarica positivo dal PCB della stazione di ricarica
  2. Ricollega l'alimentatore e inserisci il tosaerba acceso nella stazione di ricarica (il tosaerba deve essere acceso perché il modulo possa caricare la batteria)
  3. Ruota lentamente in senso orario il potenziometro della corrente, osservando il multimetro
  4. Aumenta finché la corrente indica circa 1,2A, poi riduci a 1,0A
  5. La maggior parte dei moduli segnala la modalità di limitazione della corrente accendendo un LED rosso
  6. Una volta impostata la corrente, spegni il tosaerba e scollega l'alimentatore
  7. Poi rimontate la stazione di ricarica (vedere Reassemble Docking Station) e non dimenticate di collegare il terminale positivo scollegato in precedenza
  8. Se non riuscite a raggiungere 1,2A di corrente di carica, la batteria è troppo carica. Scollegate il tosaerba e lasciatelo funzionare per un'ora per scaricare un po' di più la batteria, poi riprovate. Ricordatevi di abbassare la corrente prima di riprovare.

10. Configurazione del software

Configura Wi-Fi, ambiente, firmware, controller dei motori e ROS

10.1 Connettiti al Wi-Fi

All'accensione, OpenMower crea un hotspot Wi-Fi chiamato 'OpenMower-xxxx' a cui ti colleghi dal telefono o dal laptop. Tramite un captive portal su http://10.41.0.1/ selezioni la tua rete Wi-Fi di casa e ne inserisci la password. Il rasaerba si collega quindi alla rete di casa e l'hotspot scompare.

  1. Accendi il tosaerba e cerca le reti WiFi con il telefono o il portatile
  2. Connettiti alla rete hotspot 'OpenMower-xxxx'
  3. Se non vieni reindirizzato automaticamente, apri http://10.41.0.1/ nel browser
  4. Seleziona dall'elenco la tua rete WiFi di casa
  5. Inserisci la password del WiFi e conferma
  6. Il tosaerba si disconnetterà dal suo hotspot e si collegherà alla tua rete di casa

10.2 Verifica l'accesso alla rete

Dopo la connessione Wi-Fi, verifica di poter raggiungere il rasaerba sulla rete locale tramite il suo hostname 'openmower.local'. Le credenziali SSH predefinite sono nome utente 'openmower' e password 'openmower'. Sulla porta 7681 è disponibile anche un terminale nel browser per chi preferisce non usare SSH.

  1. Da un computer sulla stessa rete, esegui: ping openmower.local
  2. Verifica di ricevere le risposte al ping (conferma la connettività di rete)
  3. Accedi al tosaerba via SSH: ssh [email protected] (password: openmower)
  4. In alternativa, apri http://openmower.local:7681/ per un terminale nel browser
  5. Esegui 'df -h /' per controllare il filesystem: se è quasi pieno, espandilo con sudo raspi-config
  6. Esegui 'sudo openmower update-self' per aggiornare lo strumento di gestione openmower

10.3 Attiva l'antenna Wi-Fi esterna (se installata)

  1. Se nel passaggio 7.7 non hai installato un'antenna WiFi esterna, salta questo passaggio
  2. Accedi al tosaerba via SSH: ssh [email protected] (password: openmower)
  3. Modifica la configurazione di avvio: sudo nano /boot/firmware/config.txt
  4. Scorri fino alla sezione [cm4], commenta dtparam=ant1 (antenna interna) e togli il commento a dtparam=ant2 (antenna esterna)
  5. Salva con Ctrl+O, Invio, poi esci con Ctrl+X
  6. Riavvia con 'sudo reboot' per attivare l'antenna esterna

10.4 Configura le variabili d'ambiente

Le variabili d'ambiente configurano il tuo modello di rasaerba, il tipo di batteria, le impostazioni dei motori e altri parametri specifici dell'hardware. Esegui lo strumento di configurazione interattivo, che apre un editor di testo in cui regoli i valori in base ai commenti in linea. Dopo il salvataggio, lo strumento scarica la versione di ROS selezionata: il download richiede circa 30 minuti.

  1. Accedi al tosaerba via SSH o usa il terminale nel browser
  2. Esegui: openmower configure env
  3. Quando richiesto, scegli un editor di testo (per i principianti si consiglia nano)
  4. Controlla e modifica le variabili d'ambiente seguendo i commenti nel file
  5. Salva con Ctrl+O, Invio, poi esci con Ctrl+X
  6. Attendi circa 30 minuti che il download della versione ROS termini

10.5 Carica il firmware

Carica il firmware OpenMower sulla scheda xCore tramite Ethernet. Il comando 'openmower update-firmware' legge le variabili d'ambiente, scarica il binario del firmware corretto e lo carica sull'xCore. Se ricevi errori di timeout, aggiorna prima il bootloader: le prime schede xCore hanno un bug noto del bootloader.

  1. Esegui: openmower update-firmware
  2. Attendi che il download e il caricamento del firmware terminino
  3. Se compaiono errori di timeout, esegui prima: openmower update-bootloader
  4. Dopo l'aggiornamento del bootloader, riprova: openmower update-firmware
  5. Verifica che il caricamento del firmware termini senza errori

10.6 Configura il motore di trazione sinistro (xESC)

Ciascuno dei tre controller dei motori xESC va configurato con VESC Tool su un computer separato. Installa VESC Tool su un computer Windows o Linux. I controller vengono esposti uno alla volta via TCP con il comando 'openmower expose-xesc', che resta attivo finché non premi Ctrl+C. I file XML di configurazione per il tuo modello di rasaerba sono nel repository GitHub di OpenMower in configs/xESC. CRITICO: rimuovi la lama del rasaerba prima della calibrazione dei motori; il motore della lama è potente e pericoloso.

  1. RIMUOVI LA LAMA DI TAGLIO prima di iniziare: è un requisito critico per la sicurezza
  2. Solleva la parte posteriore del tosaerba in modo che le ruote motrici possano girare liberamente
  3. Alimentate il tosaerba con la sua batteria, non con la stazione di ricarica, e assicuratevi che la batteria sia sufficientemente carica
  4. Accedi via SSH ed esegui: openmower stop (arresta ROS per evitare interferenze)
  5. Eseguite: openmower expose-xesc left (il controller sinistro è quindi raggiungibile nella vostra rete locale su openmower:65102 finché non premete Ctrl+C)
  6. Sul computer, apri VESC Tool, scegli Connection > TCP, inserisci come indirizzo l'indirizzo IP del tuo tosaerba oppure openmower, imposta la porta su 65102 e fai clic su Connect (l'avviso sulla versione del firmware si può ignorare)
  7. Caricate la configurazione XML del motore (File > Load Motor Configuration XML, poi Write Motor configuration), poi caricate la configurazione XML dell'app (File > Load App Configuration XML, poi Write App configuration); se compare il messaggio sulla versione, ignoratelo. Prendete i file per il vostro modello di tosaerba da configs/xESC nel repository OpenMower: il file dell'app è lo stesso per tutti e tre i controller, i motori di trazione sinistro e destro condividono un file motore e il motore di taglio ha il suo
  8. Premete Ctrl+C nel terminale di openmower per smettere di esporre il controller prima di passare al successivo.

10.7 Configura il motore di trazione destro (xESC)

  1. Eseguite: openmower expose-xesc right (raggiungibile su openmower:65102 dopo aver fermato il precedente con Ctrl+C)
  2. In VESC Tool, connettiti via TCP all'host 'openmower' sulla porta 65102
  3. Premete Ctrl+C nel terminale di openmower per smettere di esporre il controller.
  4. Carica e scrivi la configurazione XML del motore per il tuo modello di tosaerba
  5. Carica e scrivi la configurazione XML dell'app per il tuo modello di tosaerba

10.8 Configura il motore di taglio (lama) (xESC)

  1. Conferma che la lama di taglio NON sia montata: ricontrolla prima di proseguire
  2. Esegui: openmower expose-xesc mower (raggiungibile su openmower:65102 dopo aver fermato il precedente con Ctrl+C)
  3. In VESC Tool, connettiti via TCP all'host 'openmower' sulla porta 65102
  4. Premete Ctrl+C nel terminale di openmower per smettere di esporre il controller.
  5. Carica e scrivi la configurazione XML del motore per il motore di taglio
  6. Carica e scrivi la configurazione XML dell'app per il motore di taglio
  7. Dopo aver configurato tutti e tre i motori, eseguite: openmower start (per riprendere ROS)

10.9 Configura ROS

Configura i parametri di ROS (Robot Operating System), tra cui il baud rate del GPS, il protocollo GPS, le coordinate del datum per la tua posizione e le impostazioni della stazione base NTRIP per le correzioni RTK. Le coordinate del datum devono essere vicine alla posizione della stazione di ricarica: usa il clic destro di Google Maps per ottenere le coordinate. Basta una precisione di qualche metro.

  1. Esegui: openmower configure ros
  2. Imposta gps/baud_rate su 921600 per Ardusimple (valore predefinito, di solito invariato)
  3. Imposta gps/protocol su UBX per Ardusimple (valore predefinito, di solito invariato)
  4. Imposta gps/datum_lat e gps/datum_long su coordinate vicine alla tua stazione di ricarica
  5. In Google Maps fai clic destro sulla posizione della base per copiare le coordinate
  6. Configura i parametri di ntrip_client per la tua stazione base RTK o il tuo servizio NTRIP
  7. Salva ed esci: la maggior parte degli altri parametri può inizialmente restare ai valori predefiniti

11. Calibrazione e primo utilizzo

Verifica il GPS, calibra l'orientamento, registra le aree di taglio e avvia il taglio autonomo

11.1 Verifica il fix RTK del GPS

Prima di qualsiasi registrazione della mappa o funzionamento autonomo, il GPS deve raggiungere lo stato RTK Fixed per un posizionamento preciso al centimetro. Apri la web app di OpenMower su http://openmower.local:8080 e controlla l'indicatore di qualità del GPS. Il rasaerba deve essere all'aperto con il cielo libero. Il primo fix RTK può richiedere fino a 30 minuti a seconda della visibilità dei satelliti e della qualità della connessione NTRIP.

  1. Metti il tosaerba all'aperto con vista libera del cielo, senza alberi o edifici sporgenti
  2. Apri http://openmower.local:8080 nel browser
  3. Controlla l'indicatore di qualità del GPS nell'interfaccia dell'app
  4. Attendi che lo stato mostri 'RTK Fixed': può richiedere fino a 30 minuti
  5. Apri una shell nel container ROS con: openmower shell. Poi esegui: rostopic echo --clear -w 5 /ll/position/gps. Nella riga flags, 3 significa RTK fixed, 5 significa float e 0 significa single (GPS normale senza RTK)
  6. Non proseguire finché non ottieni RTK Fixed: la modalità float o single non basta

11.2 Inizializza l'orientamento

Guida il rasaerba a mano con il joystick a schermo della web app o con un gamepad USB (tieni premuto il pulsante A) per inizializzare il sistema di orientamento. Devi percorrere almeno 50 metri, comprese linee rette e percorsi a otto. Il sistema usa questi dati di movimento per allineare la direzione del GPS con la direzione fisica. Una volta inizializzato, NON sollevare il rasaerba, altrimenti l'orientamento va perso.

  1. Usa il joystick sullo schermo in http://openmower.local:8080 o un gamepad USB (tieni premuto il pulsante A)
  2. Guida lungo alcune linee rette
  3. Guida tracciando degli otto per aiutare il sistema a calibrare le curve
  4. Continua a guidare finché la distanza totale supera i 50 metri
  5. Verifica: quando guidi in linea retta, anche la visualizzazione procede dritta, senza salti
  6. Verifica: quando ruota sul posto, la visualizzazione resta ferma, senza salti
  7. NON sollevare il tosaerba dopo l'inizializzazione: l'orientamento andrebbe perso

11.3 Registra le aree di taglio

Registra il contorno di ogni area che vuoi far tagliare al rasaerba guidandolo lungo il perimetro in senso antiorario mentre l'app registra i waypoint GPS. Puoi anche registrare zone di esclusione (ostacoli, aiuole) guidandolo lungo il loro perimetro in senso orario. Ogni area di taglio ha un contorno e zone di esclusione facoltative. Il contorno diventa verde quando è completo e le esclusioni diventano rosse.

  1. Nell'app, entra in modalità Recording
  2. Posiziona il tosaerba su un bordo del perimetro, rivolto in senso antiorario
  3. Premi 'Start Recording' e percorri l'intero perimetro dell'area di taglio
  4. Premi 'Stop Recording' quando torni al punto di partenza: il contorno diventa verde
  5. Per le zone di esclusione: posizionati rivolto in senso orario e registra il perimetro dell'ostacolo
  6. I contorni di esclusione diventano rossi quando sono completi
  7. Fai clic su 'Finish Area' e seleziona 'Mowing' per salvare l'area

11.4 Registra le aree di navigazione

Le aree di navigazione sono percorsi su cui il rasaerba può muoversi ma NON taglia. Usale per collegare aree di taglio separate, per esempio un vialetto tra il giardino davanti e quello dietro casa. Registra le aree di navigazione come le aree di taglio (perimetro in senso antiorario), ma indicale come 'Navigation' al salvataggio. Sulla mappa compaiono in bianco.

  1. Posiziona il tosaerba sul bordo di un percorso di collegamento tra aree di taglio
  2. Premi 'Start Recording' e percorri il perimetro in senso antiorario
  3. Premi 'Stop Recording' quando il contorno del percorso è completo
  4. Fai clic su 'Finish Area' e seleziona 'Navigation' per salvare
  5. Le aree di navigazione appaiono bianche sulla mappa (le aree di taglio sono verdi)
  6. Ripeti per ogni percorso di collegamento necessario tra le aree di taglio

11.5 Registra la posizione della stazione di ricarica

Registra la posizione della stazione di ricarica guidando fino a due punti precisi: prima a circa 2 metri davanti alla stazione, poi sul bordo della stazione con le ruote anteriori allineate. Questa registrazione a due punti indica al sistema sia la posizione sia l'angolo di avvicinamento per l'aggancio autonomo. La stazione di ricarica deve trovarsi all'interno di un'area di taglio o di navigazione, o accanto a essa.

  1. Guida il tosaerba fino a circa 2 metri davanti alla stazione di ricarica
  2. Assicurati che il fix GPS sia stabile (stato RTK Fixed)
  3. Premi 'Record Docking' nell'app
  4. Avanza finché le ruote anteriori sono sul bordo della stazione di ricarica
  5. NON entrare completamente nella stazione: fermati sul bordo
  6. Premi di nuovo 'Record Docking' con un fix GPS stabile
  7. Verifica che l'icona della casa si sposti sulla posizione della stazione di ricarica sulla mappa
  8. L'app dovrebbe ora spostare l'icona della base sulla vostra posizione attuale; potete quindi entrare completamente nella stazione di ricarica. Se usate un gamepad, la pagina del gamepad del progetto originale dice di portarvi a circa 1,5 m davanti alla stazione di ricarica e premere X, poi avanzare finché le ruote anteriori non sono proprio sul bordo e premere di nuovo X.

11.6 Primo taglio autonomo

Con tutte le aree registrate e la posizione della stazione di ricarica impostata, esci dalla modalità di registrazione per mettere il rasaerba nello stato IDLE. Premi 'Start' per avviare la prima sessione di taglio autonomo. Sorveglia attentamente il rasaerba per tutta la prima sessione: resta vicino per usare l'arresto di emergenza se il rasaerba si comporta in modo imprevisto o si avvicina ai confini in modo scorretto.

  1. Premi 'Exit Recording' per passare dalla modalità di registrazione a IDLE
  2. Verifica che tutte le aree di taglio, le aree di navigazione e la posizione della base compaiano sulla mappa
  3. Premi 'Start' per avviare la prima sessione di taglio autonomo
  4. Sorveglia attentamente il tosaerba per tutto il primo ciclo
  5. Resta sempre a portata del pulsante di arresto di emergenza
  6. Controlla che pianificazione del percorso, inseguimento dei confini ed evitamento degli ostacoli funzionino correttamente
  7. Al termine, verifica che il tosaerba torni alla stazione e vi si agganci

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