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 Acorn Precision Farming Rover

Rover open source a energia solare per l'agricoltura di precisione, con 4WD/4WS e GPS RTK

Licenza

  • mechanical designs, motor controller, encoder and CM4 robot board hardware: CERN-OHL-P 2.0 (permissive)
  • vehicle software and controller firmware: Apache 2.0

Licenza suddivisa per parte. I progetti meccanici e l'hardware del controller dei motori, dell'encoder e della scheda robot CM4 sono CERN-OHL-P, una licenza permissiva per hardware aperto. Il software del veicolo e il firmware dei controller sono Apache-2.0. Alcune parti non indicano alcuna licenza: le cartelle delle schede soft-start, supercondensatori, adattatore GPS e sensore magnetico, il vecchio repository rp2040-motor-controller-firmware e il sorgente della documentazione (robot_docs). Upstream afferma che la licenza dei suoi PDF sullo sterzo è sconosciuta, e uno script della stazione base riporta un'intestazione BSD 3-Clause di un altro autore. Verificato il 2 nov 2026.

Guida al montaggio

1. Leggi prima questo: cosa pubblica la fonte originale

La fonte originale pubblica elenchi delle parti, file di progetto, cablaggio, comandi di avvio del Raspberry Pi e software, ma nessun percorso di fabbricazione o montaggio per il telaio, i gruppi d'angolo o il sistema di alimentazione. Questa guida lo dichiara e non colma la lacuna.

1.1 Cosa il progetto originale pubblica e cosa no

La documentazione del progetto originale copre il cablaggio, una breve distinta base e il software, e dice che le istruzioni per la fabbricazione del telaio non sono ancora disponibili.

  1. Telaio: la pagina Frame Design dice: «Questa pagina ospiterà le istruzioni di fabbricazione per gli elementi del telaio quando queste istruzioni saranno disponibili.» A parte una fotografia, quella frase è l'intera pagina. Le revisioni precedenti del sorgente della documentazione che ho aperto (10 maggio e 21 maggio 2024) non hanno nemmeno loro istruzioni per il telaio, e nemmeno la più recente (1 giugno 2024).
  2. Gruppo d'angolo: la pagina Corner Assembly dice solo: «Il gruppo d'angolo contiene la maggior parte della complessità robotica del sistema.» Ha una fotografia e nessun passaggio.
  3. Meccanica: la pagina Mechanical dice: «A metà 2024 i progetti meccanici sono in forte evoluzione, e la struttura delle cartelle dei progetti meccanici non è stata organizzata. Entro la fine del 2024 i nostri progetti meccanici dovrebbero essere stabilizzati, e verrà creata una release del progetto.» Non ho trovato alcuna release di questo tipo. Il repository dei progetti meccanici contiene un read-me che rimanda al documento Onshape, e la sua ultima modifica è datata 3 febbraio 2021.
  4. Questa guida quindi non contiene passaggi di saldatura, di posizionamento su dima, di montaggio dei cuscinetti o di ingranamento degli ingranaggi. Il progetto originale non ha detto come costruire il telaio o le forcelle d'angolo, quindi non lo dice nemmeno questa guida. Costruisci partendo dal CAD Onshape e chiedi sulla pagina di discussione della community indicata dalla documentazione del progetto originale.
  5. Ciò che il progetto originale pubblica come passaggi è poco: un file di testo per la messa in funzione del Raspberry Pi, un read-me sulla simulazione, la piedinatura del cavo M12, i colori dei fili del motore nel mozzo, e script e codice sorgente per il caricamento del firmware e l'avvio del software. Quelli, e solo quelli, sono i passaggi qui sotto.
  6. La prima pagina della documentazione del progetto originale riporta la nota: «Questo progetto è in fase di sviluppo attivo.»

1.2 Tensione e alimentazione: il progetto originale non fornisce una procedura

Il rover funziona a 45 volt nominali da pannelli solari e un banco di supercondensatori, e il progetto originale non pubblica alcuna procedura di accensione o spegnimento.

  1. La pagina Overview del progetto originale dice: «Il sistema di alimentazione è composto da un sistema di pannelli solari che funziona a 45 volt nominali, una serie di supercondensatori per immagazzinare temporaneamente l'energia, e una semplice elettronica di potenza per proteggere i supercondensatori. Non ci sono batterie: Acorn funziona direttamente con l'energia solare.»
  2. Nessun documento che ho letto indica un ordine per collegare i pannelli, il banco di supercondensatori, la scheda di soft start e i gruppi d'angolo. Nessuno indica un metodo di precarica o di scarica, il valore di un fusibile, o un modo sicuro per lavorare sul banco. Questa guida non ne indica, e nulla nell'ordine delle sue sezioni va interpretato come una sequenza di alimentazione.
  3. Non dare alimentazione sulla base di questa guida. Leggi le sezioni sulla scheda dei supercondensatori, sulla scheda di soft start e sui difetti delle schede registrati dal progetto originale prima di collegare qualsiasi alimentazione.

2. Attrezzi, parti e file di progetto

Ciò che la fonte originale elenca come attrezzi e parti, e dove si trovano i suoi file di progetto. La distinta base originale è breve e non indica misure di elementi di fissaggio, tubi o piastre.

2.1 Attrezzi elencati dal progetto originale

Stampante 3D, saldatrice, taglio al plasma, trapano a colonna, smerigliatrice da banco e tavolo di saldatura sono gli attrezzi principali indicati dal progetto originale.

  1. Attrezzi principali, con i prezzi indicati dal progetto originale: stampante 3D $1000; saldatrice $500; taglio al plasma $8000; trapano a colonna $200; smerigliatrice da banco $200; banco di saldatura $200.
  2. Altri attrezzi utili: lime per metallo, punte da trapano, levigatrice orbitale, cacciaviti, chiavi.
  3. Il progetto originale dice: «le parti tagliate al plasma si impacchettano bene in piano», quindi il taglio al plasma CNC, l'attrezzo più costoso, si potrebbe omettere se si volessero ordinare quelle parti a un'officina esterna.
  4. Il progetto originale dice che con un po' di pratica e uno studio attento dei video tutorial gratuiti sulla saldatura disponibili online, chiunque può imparare la saldatura MIG dell'alluminio. Non indica alcuna procedura di saldatura.

2.2 Distinta base pubblicata dal progetto originale

La pagina Bill of Materials elenca due configurazioni di build e un breve elenco di parti; non indica elementi di fissaggio, dimensioni dei cuscinetti, dimensioni dei tubi né spessori delle piastre.

  1. Configurazioni: il robot si può costruire con un telaio fai da te e quattro gruppi d'angolo, oppure come robot completo con telaio in alluminio.
  2. Robot completo: Solar Panels x 4; Chassis Wiring - data; Chassis Wiring - power; Corner Assemblies x4; Super Capacitors; Motherboard Assembly; GPS Modules x 2; GPS Antennas x 2; Frame Side x 2; Frame Front x 2; Frame solar panel mounts.
  3. Gruppo d'angolo: Motor controller PCB assembly with UI PCB, $100; Induction encoder PCB, $20; Aluminum fork upper weldment; Aluminum fork lower weldment; Thrust bearings; 3D printed steel steering drive gear; Drive motor phase and hall cable; Steering motor phase cable; Induction encoder interface cable.
  4. Motore di trazione: il motore con riduttore per carriola della pagina del fornitore collegata dalla BOM, $275.00. Nota del progetto originale: «Questo motore è in generale piuttosto buono, ma potrebbe non essere abbastanza resistente alle intemperie.» Il progetto originale aggiunge che i fornitori contattati non volevano produrre un motore con lo stesso elevato rapporto di riduzione, che Bafang richiede un ordine di 500 pezzi, e che finora i tentativi tramite Alibaba non hanno avuto successo.
  5. Pneumatici: Carlisle X Trac ATV Bias Tire - 4.80-8, $40.
  6. Motore di sterzo: AM Equipment AMP240-0502, $300. Nota del progetto originale: «Non ci serve più l'encoder integrato, quindi andrebbe trovato un motore sigillato contro le intemperie più economico, oppure andrebbe testato un motore non sigillato più un involucro.» Il progetto originale suggerisce che un motore intorno ai 60 RPM a $45 da un marketplace online potrebbe essere valido, avverte che quei venditori sembrano lenti e inaffidabili, e dice: «Questi motori potrebbero essere sottodimensionati: vanno testati.»
  7. I moduli GPS e le antenne sono elencati con un link al fornitore e senza prezzo.

2.3 Dove si trovano i file di progetto meccanico

Il progetto meccanico è un documento CAD in Onshape e richiede un account Onshape gratuito.

  1. Il read-me del repository dei progetti meccanici dice: «I progetti meccanici di Acorn sono archiviati in onshape.» Dice anche che i progetti sono rilasciati con licenza CERN-OHL-P, e rimanda alla pagina di registrazione gratuita di Onshape per un account gratuito.
  2. La pagina Mechanical dice che la struttura delle cartelle CAD non è stata organizzata e invita i lettori a consultare per ora i file come riferimento.
  3. Il repository non contiene alcuna esportazione CAD. Dimensioni, misure di tubi e piastre, viteria e qualsiasi dettaglio di saldatura si trovano solo nel documento Onshape, che non sono riuscito ad aprire.

3. Telaio e gruppi d'angolo (nessuna istruzione originale)

La fonte originale non pubblica istruzioni di fabbricazione o di montaggio per queste parti. Questa sezione riporta solo ciò che dichiara e rimanda al CAD. Non è un percorso di costruzione.

3.1 Telaio: cosa indica il progetto originale

Due strutture saldate laterali e due strutture saldate anteriore/posteriore sono imbullonate tra loro; la distinta base aggiunge i supporti dei pannelli solari del telaio.

  1. La pagina Frame Design del progetto originale dice che il telaio è composto da due saldati laterali e due saldati anteriore/posteriore imbullonati tra loro, e mostra una fotografia del telaio.
  2. La pagina Mechanical dice che il telaio è in alluminio saldato MIG, costruito con tubi di alluminio e lamiera di alluminio tagliata al plasma CNC.
  3. Ordine di saldatura, posizionamento su dima, puntatura, misure dei tubi, spessori delle lamiere e viteria non sono indicati in nessun documento che ho letto. Ricavali dal CAD Onshape, che secondo il progetto originale è in evoluzione.
  4. Istruzioni di fabbricazione per il telaio: non ancora disponibili. Le parole del progetto originale sono: «quando queste istruzioni saranno disponibili».

3.2 Gruppi d'angolo: cosa indica il progetto originale

Quattro gruppi d'angolo identici contengono ciascuno un motore di trazione e un motore di sterzo in una struttura saldata in alluminio con l'elettronica di supporto, e si imbullonano al telaio.

  1. La pagina Overview del progetto originale dice: «Gran parte della complessità robotica di Acorn è confinata nei quattro gruppi d'angolo modulari identici che gestiscono trazione e sterzo. Questi gruppi si imbullonano al telaio e si collegano al cablaggio del telaio per completare il robot.»
  2. Il paragrafo System Design dice che ogni gruppo d'angolo contiene un motore di trazione e un motore di sterzo in un saldato di alluminio, con altra elettronica di supporto all'interno.
  3. Le parti per un angolo sono nella distinta materiali qui sopra. Il progetto originale non dà istruzioni per unire i saldati della forcella, montare i cuscinetti reggispinta, montare l'ingranaggio di sterzo in acciaio stampato in 3D o farlo ingranare con il motore di sterzo. Non indica alcun valore di coppia di serraggio né istruzioni sul frenafiletti. Non presumere nulla. Attieniti a ciò che mostra il CAD.

4. Circuiti stampati

Il consiglio della fonte originale stessa è di non ordinare ancora le sue schede. Questa sezione riporta quel consiglio, dove si trova ciascun progetto e i difetti che la fonte originale registra nelle sue note.

4.1 Prima di ordinare qualsiasi scheda

Il progetto originale dice che i suoi progetti di schede non sono maturi e sconsiglia di ordinarli.

  1. La pagina Electrical dice: «Chiunque può ordinare i nostri PCB tramite JLCPCB usando i file del nostro github, ma è sconsigliato finché i nostri progetti di PCB non saranno maturi. In futuro pubblicheremo release ufficiali dei PCB, per renderne più facile l'ordine agli utenti.»
  2. Il read-me del controller dei motori riporta questo avviso: «Questi file sono ancora in fase di sviluppo e di test. Anche se aspiriamo a produrre un progetto che altri possano fabbricare facilmente, per ora non consigliamo di realizzarli da soli!» Il progetto originale chiede ai lettori di porre le domande sullo stato delle schede sul suo forum della community.
  3. Il read-me del firmware del controller dei motori dice: «Il nostro sistema è sperimentale e ancora in fase di test. I primi test mostrano buoni risultati, ma al momento non possiamo garantire un funzionamento sicuro o affidabile.»
  4. Secondo i messaggi di commit, i file delle schede nei repository sono stati aggiornati l'ultima volta per ordini effettuati a luglio 2024.

4.2 Dove si trovano i file di progetto di ogni scheda

Ogni scheda ha i file KiCad in uno dei repository di Twisted Fields; il progetto originale indica le cartelle ma non fornisce passaggi di montaggio per nessuna scheda.

  1. Scheda madre (ospita il Raspberry Pi Compute Module 4): la cartella cm4_robot_board del repository acorn-robot-electronics. Il read-me della cartella descrive ancora un progetto precedente che comunica con quattro controller dei motori Odrive via RS-485; la pagina Electrical, più recente, dice che la scheda madre comunica con quattro controller dei motori tramite bus CAN.
  2. Controller dei motori (tre schede: Motor Driver Module, CPU Base, User Interface): il repository rp2040-motor-controller, cartelle driver_module, RP2040_base e user_interface, con una distinta materiali di produzione.
  3. Encoder a induzione: il repository induction_encoder. La pagina Electrical dice che il PCB è in parte generato con uno script python presente in quel repository.
  4. Encoder angolare magnetico: la cartella rp2040_encoder del repository rp2040-motor-controller. Il progetto originale dice che attualmente non è usato sul robot.
  5. PCB del debugger RP2040: la cartella debugger del repository rp2040-motor-controller.
  6. Sensore magnetico: la cartella mag_sensor del repository acorn-robot-electronics. Il progetto originale dice che è disponibile un singolo PCB con sensore analogico di intensità del campo magnetico per il rilevamento di finecorsa personalizzati quando si costruiscono attrezzi o altri macchinari, e che si accoppia al PCB CPU Base del controller dei motori.
  7. Schede adattatore GPS, supercondensatori e soft start: le cartelle gps_adapter, supercap e soft_start del repository acorn-robot-electronics. La pagina Electrical descrive solo la scheda dei supercondensatori, e dice che è ancora in fase di sviluppo. Non cita la scheda di soft start né l'adattatore GPS.
  8. PCB del sistema di telecamere: non realizzato. Il progetto originale dice: «In futuro costruiremo un sistema di telecamere per Acorn.»

4.3 Difetti della scheda madre registrati dal progetto originale

Le note sulla scheda madre del progetto originale elencano un avvio inaffidabile, una marcatura di polarità poco chiara e un valore del quarzo errato; non dicono se la scheda di luglio 2024 li abbia corretti.

  1. board_TODO.txt (ultima modifica gennaio 2022) elenca per la scheda madre: «aggiungere qualcosa al progetto per tenere il CM4 in reset finché l'alimentazione non si è stabilizzata? perché non sempre si avvia all'accensione?» Chiede anche: «qualche interruttore è al contrario?» e dice: «il diodo USB non funziona, immagino serva un diodo ideale per gestire più potenza?»
  2. notes.txt (ultima modifica gennaio 2023), intitolato TODO RECOMMENDATIONS AFTER PRODUCTION, chiede che la polarità di U5, D19, D5, D6, D20, D7, D21 e D18 sia resa chiara, e dice di rendere più chiaro il valore del quarzo del controller CAN: «16mhz, non 12mhz!»
  3. Lo stesso file dice: «l'arresto di emergenza dovrebbe attivarsi se un cavo viene scollegato. - lasciamo perdere, lo fa già.»
  4. Queste sono note del progetto originale. Non indicano quali difetti restano nei file delle schede datati luglio 2024.

4.4 Difetti del controller dei motori registrati dal progetto originale

Le note del progetto originale dopo la produzione del 2023 elencano connettori montati al contrario, condensatori ceramici da 50 V su una scheda prevista per 53 volt e un diodo di ricircolo bruciato.

  1. TODO.txt nel repository del controller dei motori (ultima modifica marzo 2023), intitolato 2023 AFTER PRODUCTION NOTES, dice: «correggere l'orientamento dei connettori - vedere se è possibile correggere l'orientamento di uscita nel file». Aggiunge che il rettangolo serigrafato del connettore non è centrato correttamente e il contorno combacia solo se montato al contrario, il che potrebbe spiegare perché i connettori sono stati montati al contrario.
  2. Lo stesso file dice: «condensatori dei motori - alcuni condensatori ceramici sono solo da 50V!» La pagina Electrical indica per il modulo driver 53 volt nominali.
  3. Dice anche: «diodi di ricircolo dei motori - ho fatto saltare un diodo! serve una capacità di potenza maggiore.» E: «quando faccio girare un motore al massimo e poi lo fermo, sento uno scoppio elettronico sulla scheda (una volta). è un diodo che salta? cosa mi serve per la frenata?»
  4. Il repository è stato aggiornato a luglio 2024 per un nuovo ordine di schede. Nulla dice se questi difetti siano stati corretti in quei file.

5. Elettronica d'angolo

Il controller del motore, il suo firmware, gli indirizzi CAN, i colori dei fili del motore nel mozzo e il sensore dell'angolo di sterzata, per quanto la fonte originale li documenta.

5.1 Schede del controller dei motori

Il controller dei motori è composto da un Motor Driver Module, una CPU Base che ospita due moduli driver e due CPU RP2040, e una scheda User Interface.

  1. Descrizione del progetto originale: «Composto da tre PCB. Motor Driver Module, CPU Base e User Interface. Il modulo driver contiene i MOSFET e la relativa circuiteria di potenza per pilotare un motore. Valori nominali di 53 volt, 20A continui (a seconda delle condizioni termiche), 50A di picco.»
  2. La CPU Base ospita due moduli driver dei motori e contiene due CPU RP2040. Una CPU gestisce tutte le funzioni di pilotaggio dei motori, mentre l'altra gestisce le comunicazioni sul bus CAN e altre funzioni ausiliarie.
  3. Il PCB User Interface si collega al PCB CPU Base e ha diversi pulsanti, interruttori e LED, oltre allo spazio per un display OLED. Il progetto originale dice che serve per controllare il gruppo d'angolo.
  4. La pagina Electrical dice che la scheda madre comunica con quattro controller dei motori, e l'Overview dice che ogni gruppo d'angolo ha un motore di trazione e un motore di sterzo. La CPU Base porta due moduli driver, quindi un controller può pilotare entrambi i motori di un angolo. Il progetto originale non dice quale modulo driver pilota quale motore.

5.2 Firmware del controller dei motori: il flag di compilazione che protegge la scheda

Il firmware si compila con PlatformIO e SimpleFOC, e SIMPLEFOC_PWM_LOWSIDE_ACTIVE_HIGH deve essere false, altrimenti qualcosa potrebbe danneggiarsi.

  1. Il firmware attuale è nel repository rp2040-motor-firmware. Un repository più vecchio, rp2040-motor-controller-firmware (ultima modifica settembre 2022), è indicato nel suo stesso read-me come «lavoro in corso, in fase di test. non usare». Usa quello più recente.
  2. Avviso dal read-me del repository più vecchio, che si applica alla stessa scheda: «Il controller Twisted fields usa la polarità attiva bassa per gli interruttori lato basso. Assicurati di impostare -DSIMPLEFOC_PWM_LOWSIDE_ACTIVE_HIGH=false nella build, altrimenti la scheda non funzionerà correttamente e qualcosa potrebbe danneggiarsi.»
  3. Nel repository attuale, platformio.ini imposta -DSIMPLEFOC_PWM_LOWSIDE_ACTIVE_HIGH=false per gli ambienti motorcontroller, auxiliary-unit ed encoder_verification. L'ambiente canbus non usa il flag.
  4. Il read-me attuale dice che il progetto è configurato per usare PlatformIO, e: «La versione attuale dipende da modifiche non rilasciate alla libreria SimpleFOC. Per compilare questo progetto prima del rilascio di SimpleFOC 2.2.3, clona con git il branch dev di SimpleFOC nella directory lib/ di questo progetto.» Il repository elenca le librerie SimpleFOC come submodule sotto lib/.
  5. Il firmware che si aspetta lo script di caricamento del progetto originale si compila da due ambienti: canbus e motorcontroller. Lo script cerca .pio/build/canbus/firmware.bin e .pio/build/motorcontroller/firmware.bin.
  6. Come si esegue il primo caricamento del firmware non è descritto. platformio.ini imposta debug_tool=cmsis-dap e upload_protocol=cmsis-dap, e la pagina Electrical descrive un PCB debugger RP2040, ma nessun documento indica i passaggi per il primo caricamento. Dopo di che la pagina Electrical dice: «Entrambi i PCB si possono riprogrammare tramite bus CAN usando i nostri script di caricamento del firmware.»

5.3 Indirizzo CAN di ogni controller d'angolo

Il software del veicolo si aspetta i controller agli indirizzi CAN 0x6, 0x7, 0x8 e 0x9, e il firmware legge il proprio indirizzo da tre ingressi sulla scheda.

  1. In vehicle/motors_can.py i quattro angoli sono definiti con questi indirizzi CAN, tutti sull'interfaccia del Raspberry Pi chiamata can1: anteriore sinistro 0x6, anteriore destro 0x7, posteriore sinistro 0x8, posteriore destro 0x9.
  2. Nel firmware CAN del controller (main-canbus.cpp) l'indirizzo è la base 0x5 più un valore a tre bit letto dagli ingressi 0, 1 e 2 di un I/O expander, dove un ingresso basso conta come 1.
  3. Le note del progetto originale sul controller dei motori dicono che era stato considerato un DIP switch per l'indirizzo e che verranno usati jumper SMT per risparmiare spazio. Nessun documento dice quale jumper imposta quale indirizzo. Non ho seguito lo schema elettrico. Finché non l'hai seguito tu, non puoi impostare un indirizzo partendo da questa guida.

5.4 Ricaricare il firmware dei controller via CAN dal veicolo

Lo script flash_firmware_from_host.py del progetto originale copia due binari del firmware sul Raspberry Pi ed esegue can_firmware.py una volta per ogni indirizzo d'angolo.

  1. Queste sono le azioni che eseguono i due script. Il progetto originale non le descrive, e i valori predefiniti degli script sono i percorsi di uno sviluppatore.
  2. flash_firmware_from_host.py ha la cartella del firmware, il nome host del robot e l'elenco degli indirizzi CAN scritti in cima (FIRMWARE_FOLDER, ROBOT_HOSTNAME, CAN_ADDRESSES). I valori predefiniti sono la home directory di uno sviluppatore, il nome host acorn4.local e gli indirizzi 0x6, 0x7, 0x8 e 0x9. Modificali per prima cosa.
  3. Lo script copia i due binari compilati con rsync nella cartella vehicle sul robot, come firmware_can.bin e firmware_motor.bin, con l'account acorn.
  4. Per ogni indirizzo esegue poi, via ssh sul robot, python3 can_firmware.py con tre argomenti: l'indirizzo, se caricare il firmware sulla CPU CAN (0 o 1) e se caricarlo sulla CPU dei motori (0 o 1).
  5. can_firmware.py invia prima l'immagine per la CPU dei motori, poi attende due secondi e invia l'immagine per la CPU CAN, sull'interfaccia can1 usando ISO-TP.

5.5 Colori dei fili del motore di trazione

Il file hubmotor_wiring.txt del progetto originale elenca sei fili etichettati sul motore nel mozzo: H1 giallo, H2 blu, H3 verde, più rosso, meno nero e ST bianco.

  1. Il file riporta: H1 Yellow; H2 Blue; H3 Green; + Red; - Black; ST White.
  2. Il file non dice cosa significano le etichette. La distinta materiali indica il cavo come cavo delle fasi e dei sensori Hall del motore di trazione, e la pagina Electrical non descrive il cablaggio del motore.
  3. Non collegare i fili rosso e nero a un alimentatore o al bus a 45 volt presumendo che siano di alimentazione. Il progetto originale non dice che lo siano. Verifica ogni etichetta con la documentazione di cablaggio del fornitore del motore nel mozzo prima di collegare qualsiasi cosa.

5.6 Sensore dell'angolo di sterzo

Una grande PCB ad anello con encoder induttivo, un chip IPS2200 e otto sensori di campo magnetico legge l'angolo di sterzo e comunica con il controller dei motori via I2C.

  1. Descrizione del progetto originale: un grande PCB ad anello con un particolare disegno di bobina e un chip encoder a induzione IPS2200, più 8 sensori analogici di campo magnetico distribuiti in modo uniforme. Tre ADC I2C ADS1115 leggono questi sensori. Il PCB comunica con il controller dei motori via I2C attraverso le porte encoder del controller dei motori.
  2. La sezione a induzione usa due fasi, e i sensori magnetici rilevano un magnete nell'ingranaggio di sterzo che risolve l'ambiguità tra le fasi.
  3. Il codice del veicolo imposta INDUCTION_STEERING_SENSOR = True in corner_actuator_can.py, e definisce un messaggio SET_STEERING_HOME in motor_controller.py. Nessun documento descrive come posizionare il magnete o impostare la posizione di riferimento dello sterzo.

5.7 Lo script da banco corner_debug.py: cosa fa

corner_debug.py esegue l'homing del motore di sterzo posteriore sinistro a 1.57 e lo porta a una posizione data dalla riga di comando, quindi muove l'hardware appena viene eseguito.

  1. Questo è ricavato dallo script. Il progetto originale non lo descrive.
  2. Lo script è scritto per un solo angolo: il posteriore sinistro, indirizzo CAN 0x8, su can1. Configura il pin di uscita dell'arresto di emergenza, azzera i codici di errore, chiama set_home_position(1.57), e poi esegue un ciclo infinito inviando la posizione che hai passato come primo argomento e stampando l'errore.
  3. Prima porta alta per un secondo l'uscita 0 di un expander I2C sul bus 6 e poi bassa per un secondo; il progetto originale non dice cosa controlla quell'uscita.
  4. Esce subito se l'argomento è maggiore di 8 o minore di -8. Lo script non indica le unità della posizione né il verso di 1.57, e il progetto originale non documenta né l'una né l'altro. Poiché esegue l'homing prima di muoversi, muove l'hardware non appena viene eseguito.

6. Cablaggio del telaio e arresto di emergenza

I cavi dati M12, i cavi di alimentazione e l'arresto di emergenza, come li documenta la fonte originale.

6.1 Cavi dati M12

Ogni angolo è collegato alla scheda madre da un cavo M12 a 8 pin con codifica A che porta due circuiti CAN, l'arresto di emergenza e un'alimentazione isolata a 5 volt.

  1. Il progetto originale descrive un sistema di cavi dati personalizzato con due circuiti bus CAN e uno speciale sistema di arresto di emergenza, più un secondo set di cavi per l'alimentazione. Un circuito bus CAN è usato specificamente per i controller dei motori, mentre l'altro è disponibile per uso generale. La pagina non dice quale circuito sia quale.
  2. «Il sistema di cavi dati usa connettori M12 a 8 pin e cavi comunemente usati nell'ethernet industriale. Usiamo la codifica A invece della codifica X.»
  3. Connettori da PCB: M12A-08PFFR-SF7003. Cavi: qualcosa come M12A08ML-12AML-SD002 o M12A08ML-12AFL-SB002.
  4. Tabella dei pin come la fornisce il progetto originale: 1 ESTOP SWITCH CIRCUIT; 2 CAN 1 HIGH; 3 CAN 1 LOW; 4 ISOLATED GROUND; 5 CAN 0 HIGH; 6 ESTOP SQUARE WAVE; 7 ISOLATED FIVE VOLT; 8 CAN 0 LOW.
  5. Il progetto originale non indica lunghezze dei cavi, ordine di cablaggio, istruzioni di terminazione, né un numero di cavi oltre ai quattro angoli mostrati nel suo schema di cablaggio. Il software del veicolo comunica con i quattro controller d'angolo sull'interfaccia can1 del Raspberry Pi; il progetto originale non dice a quale circuito CAN del telaio corrisponda.

6.2 Cavi di alimentazione

I cavi di alimentazione sono fili da 12 gauge con guaina in silicone, terminati con connettori a crimpare Anderson PP45.

  1. Il progetto originale dice: «I cavi di alimentazione sono in genere fili da 12 gauge con guaina in silicone terminati con connettori a crimpare Anderson PP45.» Collega il filo specifico che usa, una bobina di filo in silicone da 12 gauge con valori nominali di 200 gradi C e 600V.
  2. Il progetto originale non indica lunghezze dei cavi, istruzioni di crimpatura, di instradamento o sui fusibili, né uno schema di cablaggio per i cavi di alimentazione oltre a uno schema a blocchi le cui etichette sono Solar Panels, Solar Power, Chassis Power, Super Capacitors, Motherboard e quattro Corner Assemblies.
  3. Anche la scheda di soft start e le schede dei supercondensatori usano connettori PowerPole PP45 nei loro file di progetto.

6.3 Arresto di emergenza: cosa descrive il progetto originale

L'arresto di emergenza è un circuito a interruttore più un'onda quadra inviata dalla scheda madre sul pin 6 di ogni cavo M12; i controller d'angolo consentono il movimento solo finché l'onda quadra continua a cambiare.

  1. La tabella dei pin M12 del progetto originale ha un ESTOP SWITCH CIRCUIT sul pin 1 e un ESTOP SQUARE WAVE sul pin 6.
  2. Nel codice del veicolo, motors_can.py pilota il pin 6 del Raspberry Pi in numerazione BCM (ESTOP_PIN) con un'onda quadra. Il commento nel codice la indica come approx 100Hz.
  3. Nel firmware della CPU CAN il movimento è consentito solo se l'ingresso dell'onda quadra è cambiato negli ultimi 200 ms (ESTOP_DURATION_MS 200). Il sorgente definisce DISABLE_ESTOP come false. Lascialo false.
  4. Il firmware legge anche un ingresso separato di stato dell'interruttore e lo mostra su un LED di stato: verde quando quell'ingresso è alto, rosso quando è basso.
  5. Le note del progetto originale dicono: «l'arresto di emergenza dovrebbe attivarsi se un cavo viene scollegato. - lasciamo perdere, lo fa già.»
  6. Nessun documento dice che l'arresto di emergenza toglie l'alimentazione ai motori. Ciò che ho letto descrive un segnale che i controller d'angolo sorvegliano. Non presumere che l'arresto di emergenza apra un contattore.

6.4 Bit rate CAN: i documenti non concordano

Il lato Raspberry Pi è configurato per 500K e il firmware del controller inizializza il suo chip CAN a 100KBPS; il progetto originale non li concilia.

  1. bringup/raspberry/80-can.network imposta BitRate=500K per tutte le interfacce chiamate can*. Lo script di messa in funzione lo installa sul Compute Module.
  2. main-canbus.cpp nel firmware del controller chiama CAN0.begin(MCP_STDEXT, CAN_100KBPS, MCP_16MHZ).
  3. Non sono riuscito a capire se si riferiscono allo stesso bus, o se uno dei due non è aggiornato. Non cablare né caricare firmware presumendo che uno dei due sia giusto. Chiedi sul forum della community del progetto originale, oppure confronta entrambi i sorgenti con lo schema elettrico.

7. Avvio della scheda madre e del Raspberry Pi Compute Module

Il file di testo di avvio originale è l'unica procedura scritta completa che la fonte pubblica. Questi passaggi lo seguono insieme agli script che richiama.

7.1 Scheda madre: cosa contiene

La scheda madre ospita il Raspberry Pi Compute Module 4 e comunica con i quattro controller dei motori tramite bus CAN.

  1. Descrizione del progetto originale: «Ospita il computer principale, un Raspberry Pi Compute Module 4, e comunica con i quattro controller dei motori tramite bus CAN. Gestisce anche GPS, wifi, sistema di arresto di emergenza e diverse altre funzioni.»
  2. Il file della distinta materiali della scheda madre (cm4-robot.csv, ultima modifica novembre 2023) elenca, tra gli altri: due controller CAN MCP2515, due bridge UART SC16IS752, un regolatore LM2576HVS-5, un TPS61040, un ISL54222AIUZ, un LTC4412xS6, sette LED WS2812B, un display CC56-12SEKWA con driver ET6226M, e due resistenze da 120R (R34, R35). I file delle schede sono datati luglio 2024, quindi il file potrebbe non corrispondere.
  3. Il progetto originale non dice quale variante del Compute Module 4 (RAM, memoria, wireless) usare. La messa in funzione qui sotto usa rpiboot per montare il modulo come disco.

7.2 Scrivi l'immagine sul Compute Module

Collega il Compute Module in modalità boot, scrivi Raspberry Pi OS Lite 64-bit, poi esegui bringup-cm4.sh con il nome host che vuoi.

  1. Introduzione del progetto originale: «Programmare un compute module e configurarlo per Acorn richiede diversi passaggi da eseguire in sequenza. Inoltre, ogni aggiornamento di Raspberry Pi OS può rompere il processo di messa in funzione.»
  2. Per prima cosa, collega il modulo in modalità boot ed esegui il comando rpiboot con sudo per collegarti al filesystem. (Il file di testo scrive il comando raspiboot; lo script chiama sudo rpiboot.)
  3. Esegui uno strumento di scrittura delle immagini disco per scrivere l'immagine. Il progetto originale indica come ultima versione testata Raspberry Pi OS Lite, data di rilascio 10 ottobre 2023, 64-bit, versione del kernel 6.1, versione Debian 12 (bookworm), dimensione 435MB.
  4. Dopo la scrittura, scollega l'unità e ricollegala.
  5. Ora esegui lo script bringup-cm4 come normale utente non root. Potrebbe esserti chiesta la password di root. Devi passare allo script il nome host desiderato. Per dare al Pi il nome host acorn123, esegui: bash bringup-cm4.sh acorn123
  6. Prendi nota del comando rsync che lo script stampa; lo userai a breve.
  7. Cosa fa lo script, letto dal suo codice: si aspetta che le partizioni boot e root del modulo siano montate sotto /media/<your user>/bootfs e rootfs, esegue sudo rpiboot se non lo sono, e si ferma con un errore se ancora non lo sono. Abilita ssh, copia dt-blob.bin, config.txt e l'overlay dual-sc16is752-spi1, copia le regole udev del GPS, il file di rete CAN, due profili di connessione Wi-Fi e le impostazioni del modulo CAN ISO-TP, crea l'utente acorn con un hash della password memorizzato, imposta il nome host, crea la cartella /home/acorn/acorn, poi smonta entrambe le partizioni.
  8. I profili di connessione Wi-Fi in bringup/raspberry contengono il nome di rete twistedfields e una chiave memorizzata. Il progetto originale non dice come sostituirli con la tua rete.

7.3 Primo avvio e copia del software

Porta l'interruttore di boot su avvio normale, collega l'Ethernet, accedi via ssh come acorn, espandi il filesystem e copia con rsync la cartella del software.

  1. Al termine lo script smonta il modulo. Scollegalo, porta l'interruttore di boot su avvio normale e ricollegalo all'alimentazione.
  2. Collega un cavo ethernet e, dopo circa un minuto, accedi al dispositivo via ssh. La password è acorn.
  3. Facoltativamente copia il tuo ssh id per non dover digitare la password: esegui ssh-copy-id acorn@<hostname>, rispondi yes se richiesto, poi inserisci la password. Ora accedi normalmente via ssh.
  4. L'immagine attuale del Raspberry Pi non sembra espandere automaticamente il filesystem, quindi esegui sudo raspi-config, seleziona advanced options e seleziona expand filesystem. Esci dal menu e riavvia il Compute Module.
  5. A questo punto trasferisci con rsync la cartella del software acorn, usando il comando rsync stampato dallo script di messa in funzione. Il messaggio finale dello script lo riporta come: rsync -aP ../. acorn@<hostname>.local:/home/acorn/acorn/

7.4 Esegui lo script post-flash e compila il container del veicolo

Esegui bringup-post-flash-raspberrypi.sh da /home/acorn/acorn/bringup, poi compila docker-compose-vehicle.yml, operazione che richiede da 10 a 60 minuti.

  1. Accedi di nuovo via ssh al Compute Module, vai in /home/acorn/acorn/bringup ed esegui lo script bringup-post-flash-raspberrypi.sh.
  2. Letto dallo script: copia .bashrc e .profile, imposta il fuso orario su US/Pacific, disattiva due servizi wait-online, abilita systemd-networkd, esegue apt-get update e upgrade, installa can-utils, installa Docker con lo script di comodo di Docker, aggiunge l'utente acorn al gruppo docker, installa vim, libffi-dev, libssl-dev, python3-dev, python3-pip, python3-venv, docker-compose, python3-crccheck, ntpdate e i2c-tools, e installa can-isotp con pip.
  3. Il fuso orario è impostato per la California. Il progetto originale non dice di cambiarlo.
  4. Infine, scendi in /home/acorn/acorn ed esegui: docker-compose -f docker-compose-vehicle.yml build. A seconda della velocità della tua connessione internet ci vorranno da 10 a 60 minuti.

7.5 Avvia il container del veicolo

Esegui ./run_docker_vehicle.sh in /home/acorn/acorn; avvia sessioni tmux per il processo principale, i motori, i LED e il relay delle correzioni RTK.

  1. Il progetto originale: «Se è andato tutto bene, ora dovresti poter eseguire ./run_docker_vehicle.sh e avviare il container docker. La configurazione è completa!»
  2. Letto dagli script: run_docker_vehicle.sh ferma e rimuove qualsiasi container chiamato acorn_vehicle, poi avvia docker-compose-vehicle.yml in background. Il file compose esegue il container in modalità privilegiata, con la rete dell'host e /dev dell'host montato, e lo riavvia a meno che non venga fermato.
  3. Il container esegue autolaunch_vehicle.sh. Dopo una pausa di 5 secondi avvia quattro sessioni tmux: main (vehicle/main_process.py), motors (vehicle/motors_can.py, riavviato in un ciclo se termina), leds (vehicle/led_control.py) e rtcm (bringup/serial/rtcm_bash.sh, anch'esso riavviato in un ciclo). Dopo 60 secondi imposta l'orologio con ntpdate da un server dell'ora su internet.
  4. Il file compose riavvia il container a meno che non venga fermato, e il processo motors parte con esso e, quando la tensione misurata supera 15, si collega ai controller d'angolo. Il progetto originale non indica alcun passaggio per disattivare questo avvio.

8. GPS e RTK

Due ricevitori u-blox ZED-F9P sulla scheda madre forniscono posizione e direzione; la fonte di correzione RTK e la stazione base non sono documentate come procedura.

8.1 Ricevitori e porte seriali

Il codice del veicolo legge due ricevitori su /dev/ttySC0 e /dev/ttySC1 a 921600 baud.

  1. La distinta materiali elenca GPS Modules x 2 e GPS Antennas x 2, ciascuno con un link al fornitore.
  2. In vehicle/gps.py il primo ricevitore viene aperto su /dev/ttySC0, commentato come Center Receiver, e il secondo su /dev/ttySC1, commentato come Rear Receiver, entrambi a 921600 baud. config.txt carica l'overlay dual-sc16is752-spi1.
  3. All'avvio il codice invia a ogni ricevitore CFG_RATE_MEAS = 40 e CFG_RATE_NAV = 2, impostati solo in esecuzione, non salvati in flash.
  4. In vehicle/rtk_process.py l'offset di direzione è VEHICLE_AZIMUTH_OFFSET_DEG = 90 + 45.0.
  5. Il progetto originale non fornisce alcun documento su dove montare le antenne, a quale distanza tra loro, o come collegare i ricevitori alla scheda madre o alla scheda adattatore GPS.

8.2 Configura i nuovi ricevitori con u-center

La nota sul GPS del progetto originale dice che i nuovi ricevitori vanno configurati con u-center, che può girare su Linux con Wine.

  1. La nota sul GPS (datata 15 febbraio 2020) dice: «Assicurati di configurare i nuovi ricevitori GPS con u-center.» Collega una guida di configurazione sul sito RTKLIB Explorer.
  2. Aggiunge che u-center si può eseguire su linux con wine, e che wine crea collegamenti simbolici alle porte seriali esistenti in ~/.wine/dosdevices/.
  3. La nota è del 2020 e dice che Acorn usa RTKLIB. Il codice attuale del veicolo legge direttamente i messaggi u-blox dai ricevitori, quindi questa nota potrebbe essere precedente alla configurazione attuale. Non elenca alcuna impostazione da applicare.

8.3 Correzioni RTK e stazione base

Le correzioni arrivano ai ricevitori da un socket di rete tramite bringup/serial/rtcm_relay.py; il progetto originale non documenta alcuna procedura per la stazione base.

  1. rtcm_relay.py si collega a un server TCP il cui indirizzo è scritto nel file (HOST 192.168.1.50, PORT 130), legge i messaggi RTCM e li scrive su /dev/ttySC2 e /dev/ttySC3. Viene avviato dalla sessione tmux rtcm. Dovresti modificare l'indirizzo; il progetto originale non dice cosa debba girare a quell'indirizzo.
  2. Esistono script per la stazione base: gps_base_station/f9p_basestation.py (di un altro autore, con licenza BSD 3-Clause, scritto per affiancare un caster NTRIP) e gps_base_station/survey_in.py. survey_in.py ha la porta (/dev/ublox9), 9600 baud e un'impostazione di modalità (MODE_SETTING) scritte nel file, quindi va modificato per passare da survey-in a posizione fissa.
  3. Nessun documento descrive dove collocare la stazione base, per quanto tempo eseguire il rilievo, o come inviare le sue correzioni al rover.

8.4 Cosa il software considera un buon fix

Un fix è considerato buono quando la precisione orizzontale è inferiore a 550 mm, il tipo di fix è 3 o superiore e il flag della soluzione differenziale è 1.

  1. In vehicle/gps.py il valore attivo è MAX_ALLOWED_HACC_MM = 550. La riga # MAX_ALLOWED_HACC_MM = 50 è commentata e non ha effetto.
  2. Il test applicato a ogni ricevitore è: hAcc inferiore a MAX_ALLOWED_HACC_MM, fixType 3 o superiore, e difSoln uguale a 1.
  3. Il codice conserva 120 secondi di campioni GPS (TOTAL_HISTORY_SAMPLE_DURATION_S = 120) per i controlli di qualità.
  4. L'autonomia azzera i propri comandi quando l'età RTK supera 20,0 secondi o l'età della soluzione supera 1,0 secondo (_ALLOWED_RTK_AGE_SEC, _ALLOWED_SOLUTION_AGE_SEC in remote_control_process.py).
  5. Il progetto originale non indica alcun obiettivo di precisione che una build debba raggiungere.

9. Sistema di alimentazione: 45 V nominali, supercondensatori, niente batterie

Cosa dice la fonte originale sulle schede di alimentazione, compreso il fatto che la sua scheda di protezione non è finita. Non viene indicato alcun ordine di accensione perché la fonte originale non ne fornisce.

9.1 Scheda di bilanciamento dei supercondensatori e fusibili: ATTENZIONE, in sviluppo

Il progetto originale dice che la scheda che dovrebbe bilanciare i supercondensatori e togliere l'alimentazione in caso di cortocircuito è ancora in sviluppo, quindi non fare affidamento su di essa.

  1. ATTENZIONE. La pagina Electrical dice: «Questo PCB è ancora in fase di sviluppo, ma bilancerà i supercondensatori e fornirà una qualche forma di fusibile di sicurezza o di interruzione dell'alimentazione basata sulla corrente in caso di cortocircuito sui conduttori di alimentazione del sistema. Una versione di quella scheda è qui» (collega la cartella supercap).
  2. Le parole «bilancerà» e «una qualche forma di fusibile di sicurezza» descrivono ciò che la scheda dovrebbe fare, non ciò che fa. Non considerare nessuna versione di questa scheda come una protezione funzionante su un banco di supercondensatori a 45 volt.
  3. Il progetto originale non pubblica alcun progetto sostitutivo: nessun valore del fusibile, nessuna posizione del fusibile e nessuno schema di cablaggio del banco di supercondensatori. Questa guida quindi non può fornirne uno.
  4. Il repository contiene due versioni, supercap e supercap_simple (aggiunta con l'aggiornamento di luglio 2024). Le loro distinte materiali di produzione elencano 20 condensatori da 120F 2.3v in package radiali da 18 mm e 20 diodi zener da 2.4v. Il progetto originale non dice come sono collegati i 20 condensatori, quindi non dedurre la disposizione del banco.
  5. Solo come riferimento, il firmware supercap del repository (main-supercap.cpp nel repository del firmware dei motori) spegne l'uscita quando la corrente di uscita misurata supera 15.0, dopo il primo secondo dall'attivazione, e commuta l'uscita con tre interruttori della scheda. Il progetto originale non descrive questo firmware né dice quale scheda lo esegue.

9.2 Scheda di avvio graduale: nessun documento del progetto originale e un difetto segnalato

Nel repository dell'elettronica esiste una cartella soft_start, nessun documento la descrive e il suo stesso file di issue dice che la disposizione del MOSFET d'ingresso è errata.

  1. La pagina Electrical e la pagina Bill of Materials non citano una scheda di soft start. La cartella è stata modificata l'ultima volta ad aprile 2024, prima dell'aggiornamento di luglio 2024.
  2. Il suo issues.txt dice: «disposizione dei mosfet di ingresso errata», con un riferimento a una nota applicativa di Texas Instruments (slva948); «il rilevamento della corrente non dovrebbe essere unidirezionale almeno per l'alimentazione in ingresso, e bisogna fare attenzione che il rilevamento della corrente in uscita sia nella direzione corretta (sembra ok)». La cartella supercap_simple contiene un issues.txt identico.
  3. Una nota nello schema elettrico dice: BIDIRECTIONAL OR UNIDIRECTIONAL? WHICH DIRECTION ARE WE SENSING?
  4. Nessun documento dice a cosa serve la scheda. Non ho trovato nulla che dica che limita la corrente di spunto. Nei suoi file la scheda ha connettori PowerPole PP45, MOSFET e rilevamento della corrente. Non costruire né montare questa scheda basandoti su questa guida.

9.3 Tensione misurata dal software e limiti che applica

La scheda madre misura la tensione di sistema tramite un partitore da 100k e 5,1k e un ADS1115, e il software usa soglie di 15 V e 25 V.

  1. vehicle/voltage_monitor.py legge un canale ADS1115 attraverso un partitore con R_HIGH = 100 e R_LOW = 5,1 (kiloohm). La scheda madre ha un display a 7 segmenti pilotato da un ET6226M che il software del veicolo usa per mostrare la tensione.
  2. motors_can.py non si collega ai motori finché la tensione misurata non supera _SAFE_STARTUP_VOLTAGE = 15. Registra Input voltage too low e riprova ogni secondo.
  3. remote_control_process.py imposta _VOLTAGE_CUTOFF = 25. Sotto 25 della tensione media azzera i comandi dell'autonomia, e nel ramo del controllo manuale registra LOW VOLTAGE PAUSE e non inoltra i comandi del joystick.
  4. Queste sono soglie software nel codice, non limiti operativi documentati. Il progetto originale non indica una tensione massima per il bus. Il modulo driver è descritto con valori nominali di 53 volt.

10. Server, simulazione e prima corsa autonoma

Il server gira separatamente in Docker. La fonte originale documenta in dettaglio i passaggi della simulazione e il veicolo reale solo tramite script.

10.1 Esegui prima la simulazione

Il read-me della simulazione del progetto originale esegue un server e un veicolo simulato in Docker su un computer Linux, senza hardware.

  1. Il read-me dice che si tratta di una qualità alpha in fase iniziale. Gli script di avvio sono pensati per girare su linux.
  2. Installa Docker, segui i passaggi post-installazione di Docker per permettere agli utenti normali di avviare container, e installa docker-compose.
  3. Clona il repository, entra nella directory ed esegui ./run_docker_simulation.sh. La build del container richiederà un po' di tempo. Sull'host devono essere disponibili diverse porte, tra cui la porta 80, e potresti doverti disconnettere da una VPN.
  4. Apri localhost in un browser. Per caricare un percorso ed eseguire il robot simulato: fai clic su select a path e poi, per esempio, su aaa_test3; fai clic su Load Path a destra (dovrebbe comparire il Loaded Path Name); fai clic su Clear Autonomy Hold; fai clic su Activate Autonomy. Il rover segue il percorso caricato.
  5. Per vedere l'output, esegui ./attach_docker_vehicle.sh, poi tmux a -t main (o tmux a -t motors). Per uscire da tmux premi Ctrl+B e poi D. Non premere Ctrl-C, che termina il processo. Premi Ctrl+D al prompt del container per uscire dal container senza fermarlo.
  6. Ferma la simulazione con ./stop_docker_simulation.sh.

10.2 Computer server

Il container del server esegue Redis, i demoni ZMQ, l'interfaccia web e il system manager su qualsiasi computer in grado di eseguire Docker.

  1. La pagina Software dice che il codice del server viene di solito eseguito su una macchina separata, anche se si può eseguire sul robot.
  2. build_docker.sh compila docker-compose-server.yml. run_docker_server.sh ferma e rimuove qualsiasi container chiamato acorn_server e lo avvia in background.
  3. docker-compose-server.yml pubblica le porte 80, 8123, 5570, 6379 e 6799, ed esegue il container in modalità privilegiata.
  4. server/autolaunch_server.sh avvia sessioni tmux per redis, zmq, zmq_ppq, web e system_manager.
  5. Il progetto originale non ha istruzioni scritte per un server reale oltre a questi script. Il read-me della simulazione descrive l'interfaccia web come un'interfaccia di ingegneria, da migliorare prima di distribuirla agli utenti finali.

10.3 Indica al veicolo dove si trova il server

vehicle/server_config.yaml contiene vehicle_name, server (indirizzo e porta) e site, e il file fornito punta alla rete di uno sviluppatore.

  1. Il file fornito riporta: vehicle_name: acorn1; server: 192.168.1.170:5570 (altri due indirizzi sono commentati); site: twistedfields.
  2. Modifica server con l'indirizzo del tuo computer server. La porta 5570 è una delle porte pubblicate dal container del server.
  3. main_process.py legge il file da /home/acorn/vehicle/server_config.yaml sul Raspberry Pi. Poiché docker-compose-vehicle.yml monta la cartella dell'host /home/acorn/acorn come /home/acorn nel container, si tratta del file vehicle/server_config.yaml nella cartella del software sincronizzata.

10.4 Cosa ferma il rover via software e cosa no

Il software azzera l'autonomia in caso di errore di un motore, tensione bassa, perdita del fix GPS o grande errore di percorso, ma nel codice attuale il controllo del collegamento al server è disattivato.

  1. Letto da remote_control_process.py: i comandi dell'autonomia vengono azzerati quando i motori non sono abilitati, quando la tensione media è sotto 25, quando si perde il fix del doppio GPS, quando l'età RTK supera 20,0 secondi o l'età della soluzione supera 1,0 secondo, e al codice di inseguimento del percorso vengono passati i limiti _MAXIMUM_ALLOWED_DISTANCE_METERS = 2,5 e _MAXIMUM_ALLOWED_ANGLE_ERROR_DEGREES = 120. Non ho verificato cosa succede quando quei limiti vengono superati.
  2. Il controllo del collegamento al server (più di SERVER_COMMUNICATION_DELAY_LIMIT_SEC = 10 secondi dall'ultimo contatto con il server) è racchiuso in IGNORE_SERVER_COMMUNICATIONS_ERRORS == False, e quella costante è impostata su True. Quindi nel codice attuale, perdere il contatto con il server non ferma il rover.
  3. In main_process.py il limite di 60 secondi di interruzione del server (_MAX_ALLOWED_SERVER_COMMS_OUTAGE_SEC) è usato solo in codice commentato.
  4. Il controllo manuale usa un ricevitore SBUS (il codice imposta _USE_SBUS_JOYSTICK = True). Il progetto originale non indica alcun modello di ricevitore o trasmettitore.
  5. Il progetto originale non fornisce alcuna procedura di test sul campo né indicazioni su un'area sicura.

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