Guida al montaggio di OpenAMR
AMR open source per magazzini con navigazione LiDAR SLAM e una capacità di 150 kg
Licenza
- CAD, schematics, design files and manufacturing source: CERN-OHL-P 2.0 (permissive)
- documentation: CC BY 4.0
- software and firmware: MIT
Licenza per parte. I CAD originali, gli schemi, i file di progettazione meccanica ed elettrica e i sorgenti di produzione sono CERN-OHL-P-2.0, la documentazione originale è CC BY 4.0, e il software e il firmware originali sono MIT. I file di overlay del firmware derivati da linorobot2 sono Apache-2.0, e i datasheet nel repository restano sotto il copyright dei rispettivi produttori. Verificato il 2 nov 2026.
Guida al montaggio
1. Panoramica e preparazione
1.1 Esamina la documentazione e raccogli i materiali
Leggi il repository dell'hardware, non quello legacy: contiene le distinte base meccaniche ed elettriche, il cablaggio e la piedinatura, le note su alimentazione e sicurezza e i file CAD.
- Il progetto originale non pubblica un manuale di montaggio numerato per questo robot. Pubblica un video di assemblaggio della ruota motrice e cinque immagini senza didascalia, disegni di produzione numerati e file CAD (MMP.*), una distinta base meccanica con una tabella che indica dove va ogni elemento di fissaggio, una distinta base elettrica e un documento per ogni sottosistema elettrico.
- L'ordine di montaggio del telaio non è pubblicato. I passaggi di questa guida quindi elencano i pezzi, i collegamenti e la minuteria che il progetto originale indica; il loro ordine segue la versione precedente di questa guida, non una sequenza del progetto originale.
- Leggi prima di cablare qualsiasi cosa, perché si può danneggiare fisicamente l'hardware: i GPIO del Teensy 4.0 sono a 3,3 V e NON tollerano i 5 V (massimo assoluto ~3,6 V). Applicare un segnale a 5 V a un ingresso del Teensy può distruggere il pin o la scheda. Gli encoder AS5040 vanno alimentati dalla linea a 3,3 V, non a 5 V. Non sono ancora montati né un fusibile né un sezionatore lato batteria.
- Sono documentate due generazioni di hardware. Il robot che è stato cablato, programmato e guidato è il robot esistente, OpenAMRobot v0.0.1, chiamato unità Gate A nei documenti. Questa guida segue quello: Teensy 4.0, Raspberry Pi 5, due driver ZBLD.C20-120L2R, RPLIDAR A1, Raspberry Pi Camera Module 3 NoIR e un'IMU MPU6500.
- OpenAMRobot 2.0 è in sviluppo sul ramo main del repository hardware: un controllore di base STM32H723ZG, un Jetson, un RPLIDAR S3, una telecamera Orbbec Gemini 336L, un'IMU ICM-42688-P, quattro sensori a ultrasuoni MaxBotix MB7060 e due sensori anticaduta Benewake TF-Luna. Il progetto originale precisa che la pagina del suo controllore 2.0 elenca requisiti, non pin, quindi non esiste un documento di cablaggio per il controllore 2.0.
- Il repository originale openAMRobot/openamr è stato spostato nei repository hardware, software e firmware ed è mantenuto principalmente come riferimento storico. Il suo wiki descrive un vecchio stack ROS 1 ed è obsoleto.
- I file CAD binari nel repository hardware (STEP, SLDPRT, SLDASM, SLDDRW, DXF, PDF, zip) sono archiviati con Git LFS; clona con Git LFS installato per scaricare i file reali e non i file puntatore.
- Secondo il progetto originale, una persona può costruire il robot in un giorno se tutti i pezzi sono pronti, e servono conoscenze di base di elettronica, software e meccanica.
1.2 Procurati gli attrezzi necessari
Il progetto originale non pubblica un elenco degli attrezzi; i suoi documenti citano solo il frenafiletti per le viti montate senza rondelle di sicurezza e un multimetro per controllare il colore dei fili prima di collegare i 24 V.
- Le viti montate senza rondelle di sicurezza vanno bloccate con un frenafiletti, per esempio Loxeal 55-03.
- Il colore dei fili su questo robot è solo un'ipotesi: verifica con un multimetro prima di collegare un cavo a 24 V.
- Il repository hardware non indica altri attrezzi.
1.3 Ordina la lavorazione della lamiera
Invia a un fornitore i file PDF e DXF dei pezzi in lamiera: acciaio EN 1.0114 da 0.8, 1.2 e 2,0 mm, coefficiente di piegatura K 0.47, verniciato RAL9016.
- I pezzi in lamiera variano con la produzione. I progetti presuppongono un coefficiente K di 0.47 e un raggio interno R di 1.2 per la lamiera da 0,8 mm, 1.5 per la lamiera da 1,2 mm e 2.4 per la lamiera da 2,0 mm. Comunica questi valori al terzista.
- Spessore per pezzo, tutti in acciaio EN 1.0114 verniciato RAL9016: Front panel MMP.00.00.00.001 e Back panel MMP.00.00.00.002, 2 mm; Side panel MMP.00.00.00.003 (quantità 2), 0,8 mm; Cover MMP.01.00.00.001, 0,8 mm; Cover flange MMP.01.00.00.002 (quantità 2), 0,8 mm; Base MMP.02.00.00.001, 2 mm; Wheel bracket outer MMP.03.00.00.001, Wheel bracket inner MMP.03.00.00.002 e Motor bracket MMP.03.00.00.003 (quantità 2 ciascuno), 2 mm; Center bracket MMP.04.00.00.001, 2 mm; Support MMP.05.00.00.001 e Support MMP.05.00.00.001-01 (quantità 2 ciascuno), 1,2 mm; Lidar support MMP.07.00.00.001, 1,2 mm.
- L'albero motore MMP.03.00.00.004 (quantità 2) è in acciaio 37Cr4 e ha PDF, SLDDRW, SLDPRT e STEP ma nessun DXF. La copertura in plastica MMP.00.00.00.004 è pubblicata solo come SLDPRT e STEP.
- Attenzione alla versione: il ramo main ora contiene i pannelli anteriore e posteriore Revision B per OpenAMRobot 2.0 (nuovi STEP e DXF, file nativi rimossi, disegni PDF ancora Rev A, i DXF sono i contorni delle facce, mancano ancora gli sviluppi in piano). I file originali del robot esistente sono conservati al tag di rilascio v0.0.1 del repository hardware. Ordina dai file v0.0.1 per il robot seguito da questa guida.
1.4 Opzionale: verniciatura dei pezzi del telaio
I pezzi possono essere verniciati dopo la piegatura (l'elenco dei pezzi indica RAL9016); il progetto originale installa i rivetti filettati dopo la verniciatura, e ammette di installarli prima se la filettatura è protetta dal rivestimento.
- Dopo la piegatura, i pezzi possono essere verniciati. Dopo la verniciatura si montano gli inserti filettati a rivetto. È consentito montarli prima della verniciatura, a condizione che la parte filettata degli inserti sia protetta dal rivestimento.
2. Montaggio del telaio
2.1 Installa i rivetti filettati ciechi su tutti i pezzi del telaio
Installa i rivetti filettati ciechi in acciaio inox (M4 x 58, M5 x 48, M6 x 16, M8 x 8) e 16 rivetti ciechi Al/St 4,0x8 DIN 7337 nei pezzi del telaio.
- Gli inserti filettati a rivetto sono Blind Rivet Nut - Round Thin - Stainless Steel. Totali per una piattaforma: M4 58, M5 48, M6 16, M8 8.
- Dove vanno: gruppo Base MMP.02.00.00.000, 26 x M4 e 16 x M6; gruppo Wheel MMP.03.00.00.000 (entrambe le ruote insieme), 8 x M4 e 40 x M5; gruppo Center bracket MMP.04.00.00.000, 8 x M5 e 8 x M8; gruppi Support MMP.05.00.00.000 e MMP.05.00.00.000-01, 10 x M4 ciascuno; gruppo Lidar support MMP.07.00.00.000, 4 x M4.
- Il gruppo Center bracket richiede anche 16 rivetti ciechi Al/St 4,0x8 DIN 7337.
2.2 Assembla la piastra di base
La Base (MMP.02.00.00.001, acciaio da 2 mm) è il pezzo a cui si imbullonano la staffa centrale, i supporti, le ruote pivotanti, i gruppi ruota e il supporto del LiDAR.
- La tabella della minuteria elenca questi collegamenti alla base: Center bracket alla base, gruppi Support alla base, ruote piroettanti per carichi leggeri alla base, gruppi ruota alla base e gruppo Lidar support alla base. Il gruppo Base porta anche inserti filettati a rivetto (26 x M4, 16 x M6).
2.3 Monta la staffa centrale
Fissa il gruppo staffa centrale (MMP.04.00.00.000) alla base con 16 viti M5x20 DIN 912, 16 rondelle 5 DIN 125 e 16 rondelle elastiche di sicurezza 5 DIN 7980.
- La Cover viene poi imbullonata al Center bracket (vedi il passaggio della copertura).
2.4 Installa le strutture di supporto
Fissa alla base i gruppi supporto (MMP.05.00.00.000, quantità 2, e MMP.05.00.00.000-01, quantità 2) con 8 viti M4x16 DIN 912, 8 rondelle elastiche di sicurezza 4 DIN 7980 e 8 rondelle larghe 4 DIN 9021.
- Fissa i gruppi Support (MMP.05.00.00.000, quantità 2, e MMP.05.00.00.000-01, quantità 2) alla base con 8 viti M4x16 DIN 912, 8 rondelle elastiche 4 DIN 7980 e 8 rondelle larghe 4 DIN 9021.
2.5 Fissa i pannelli anteriore e posteriore
Fissa il pannello anteriore (MMP.00.00.00.001) e il pannello posteriore (MMP.00.00.00.002) con viti M4x12 DIN 967 e M4x16 DIN 967.
- La tabella della minuteria elenca Front panel - up: 4 viti M4x12 DIN 967, e Front panel - down: 10 viti M4x16 DIN 967. Non ha una riga separata per il Back panel.
- Il pannello anteriore del robot esistente ospita l'arresto di emergenza e i pulsanti in fori da 22,5 mm. Si tratta dei pannelli Rev A del tag di rilascio v0.0.1; i pannelli Rev B sul ramo main sono per OpenAMRobot 2.0.
2.6 Fissa i pannelli laterali
Fissa i due pannelli laterali (MMP.00.00.00.003, acciaio da 0,8 mm) con 32 viti M4x12 DIN 967.
- Fissa i due Side panel (MMP.00.00.00.003, acciaio da 0,8 mm) con 32 viti M4x12 DIN 967.
2.7 Installa le ruote pivotanti
Fissa alla base quattro ruote pivotanti Blickle LPA-VSTH 35K per carichi leggeri con 16 viti M6x20 DIN 912, 16 rondelle 6 DIN 125 e 16 rondelle elastiche di sicurezza 6 DIN 7980.
- Fissa quattro ruote piroettanti per carichi leggeri Blickle LPA-VSTH 35K alla base con 16 viti M6x20 DIN 912, 16 rondelle 6 DIN 125 e 16 rondelle elastiche 6 DIN 7980.
3. Montaggio della ruota motrice
3.1 Prepara i gruppi staffa delle ruote
Raccogli, per ciascuno dei due moduli ruota, le tre staffe, l'albero motore, la ruota Blickle, due supporti con cuscinetto, due linguette, il motore e i pezzi dell'encoder elencati nella distinta base.
- Il progetto originale pubblica la sequenza per questo modulo solo come video di assemblaggio della ruota e cinque immagini, e dice di assemblare il lato sinistro e il destro nello stesso ordine. Le immagini non hanno didascalie.
- Per ogni modulo ruota: Wheel bracket outer MMP.03.00.00.001, Wheel bracket inner MMP.03.00.00.002, Motor bracket MMP.03.00.00.003, albero motore MMP.03.00.00.004, una ruota motrice per carichi pesanti Blickle GEVN 200/30H7, un supporto flangiato ovale con cuscinetto REXNORD UCFL 205 C 655472 (d25) e uno REXNORD UCFL 206 C 666412 (d30), una linguetta 4x4x25 e una 8x7x28 (DIN 6885-UNI 6604) e un motore Z4BLD60-24GN-30S/4GN 25K.
- Minuteria per i due moduli ruota insieme: 8 viti M5x20 DIN 912, 8 viti M5x70 DIN 912, 8 viti M10x45 DIN 912, 4 viti M3x12 DIN 965, 4 dadi M3 DIN 934, 8 dadi M10 DIN 934, 16 rondelle 5 DIN 125, 12 rondelle 10 DIN 125, 8 rondelle elastiche 10 DIN 7980, più gli inserti filettati a rivetto elencati prima.
- La distinta base non elenca anelli elastici né anelli di sicurezza a C.
3.2 Installa i cuscinetti flangiati sulle staffe delle ruote
Monta su ciascun modulo ruota un supporto con cuscinetto a flangia ovale REXNORD UCFL 205 C (d25) e uno UCFL 206 C (d30).
- La distinta base non indica quale supporto con cuscinetto va su quale staffa; la serie di immagini e il video sono l'unico punto in cui il progetto originale lo mostra. Il foglio di lavoro aggiunge che possono esserci particolarità con i supporti con cuscinetto e che tutti i dettagli sono strettamente collegati tra loro.
3.3 Monta il motore brushless
Monta il motore ZD Z4BLD60-24GN-30S con il suo riduttore 4GN 25K (25:1) sulla staffa motore MMP.03.00.00.003, con le linguette elencate nella distinta base.
- Motore: BLDC trifase, 24 V, 60 W, corrente nominale 3,8 A, 3000 rpm, P=5 (5 coppie polari sulla targhetta), con un riduttore a ingranaggi cilindrici 1:25 (4GN 25K) che dà 120 rpm alla ruota e circa 3,48 N.m di coppia nominale per ruota. Il suffisso -30S è un codice della serie ZD, non il rapporto di riduzione.
- La distinta base elenca le linguette 4x4x25 e 8x7x28 (quantità 2 ciascuna per due ruote), ma nessun testo dice dove va ogni linguetta; ricavalo dalla serie di immagini o dal video.
3.4 Installa l'albero motore e la ruota
Inserisci l'albero motore MMP.03.00.00.004 (acciaio 37Cr4) nei supporti dei cuscinetti e monta su di esso la ruota Blickle GEVN 200/30H7 con la sua linguetta.
- La ruota è una Blickle GEVN 200/30H7: diametro 200 mm, foro da 30 mm H7. L'albero motore è il pezzo che porta l'encoder magnetico all'estremità di uscita (vedi il passaggio dell'encoder).
3.5 Assembla il modulo ruota completo
Assembla i moduli ruota sinistro e destro nello stesso ordine, seguendo le cinque immagini e il video del montaggio delle ruote.
- Il gruppo ruota motrice (motore, riduttore, albero motore e staffe, MMP.03.*) si assembla nella sequenza mostrata nelle cinque immagini. Segui lo stesso ordine a sinistra e a destra. Vedi i disegni di produzione dei singoli pezzi (PDF e DXF) in mechanical/cad/production_files.
3.6 Monta i gruppi ruota sul telaio
Fissa entrambi i gruppi ruota alla base con 16 viti M5x20 DIN 912, 16 rondelle 5 DIN 125 e 16 rondelle elastiche di sicurezza 5 DIN 7980.
- Fissa entrambi i gruppi ruota alla base con 16 viti M5x20 DIN 912, 16 rondelle 5 DIN 125 e 16 rondelle elastiche 5 DIN 7980.
4. Installazione dell'elettronica
4.1 Monta la batteria
Monta un pacco batteria da 24 V di qualsiasi chimica; la versione di riferimento del progetto originale usa due batterie al piombo ermetiche da 12 V 7 Ah (DM12-7S) in serie.
- Il progetto accetta qualsiasi batteria da 24 V: i driver e il convertitore DC-DC vedono solo il bus a 24 V, non la chimica.
- Build di riferimento: 4 batterie al piombo sigillate (AGM) DM12-7S da 12 V 7 Ah, 2 in serie per ottenere 24 V. In pratica si usa una sola coppia, 24 V 7 Ah.
- Per il pacco al piombo di riferimento: rispetta la polarità, non cortocircuitare i morsetti (corrente molto elevata), carica con un caricabatterie adatto al piombo e non scaricarlo mai completamente. LiFePO4 e Li-ion richiedono un proprio BMS, un proprio caricabatterie e propri limiti di tensione.
- Sotto carico la tensione delle batterie cala. Le soglie di tensione a riposo nel passaggio di test valgono per il pacco al piombo di riferimento; adattale per un'altra chimica.
- Il documento sull'alimentazione indica che due coppie possono dare 24 V (coppie in parallelo) o 48 V (coppie in serie). I driver ZBLD.C20-120L2R sono previsti per 24 V più o meno 20 percento, e nessun documento descrive una build a 48 V, quindi questa guida tratta solo i 24 V.
- Dove e come è fissata la batteria nel robot esistente non è documentato.
4.2 Installa la distribuzione principale dell'alimentazione
Collega la sorgente a 24 V a V+ e V- di entrambi i driver e a un convertitore da 24 V a 5 V per il Raspberry Pi, e aggiungi il fusibile e il sezionatore della batteria che il progetto originale indica come mancanti.
- Architettura: la sorgente a 24 V alimenta in parallelo V+ / V- di entrambi i driver e un convertitore DC-DC da 24 V a 5 V che alimenta il Raspberry Pi. Il Teensy è alimentato via USB dal Pi. L'IMU e gli encoder prendono i 3,3 V dal Teensy.
- I colori dei fili di alimentazione su questo robot sono controintuitivi: marrone = V+, blu = V-. Il colore è solo un'ipotesi: verifica con un multimetro prima di collegare un cavo a 24 V.
- Lacuna di sicurezza 1: non c'è un fusibile sulla batteria, e una batteria da 24 V può erogare centinaia di ampere in un cortocircuito. Aggiungi un fusibile o un interruttore automatico sul + della batteria, il più vicino possibile al morsetto. Dimensionamento: 2 motori a 3,8 A nominali fanno circa 7,6 A più il convertitore DC-DC, quindi circa 15-20 A. Questo è superiore alla corrente nominale, non alla corrente di stallo; un motore bloccato assorbe ben più di 3,8 A, quindi verifica la corrente di stallo del motore prima di definire il valore.
- Lacuna di sicurezza 2: non c'è un sezionatore lato batteria; solo la rete ha un interruttore. Aggiungi un interruttore o un sezionatore, idealmente un pulsante a fungo di arresto di emergenza, sul + della batteria. Usa solo arresti di emergenza con contatti ad apertura positiva certificati (IEC 60947-5-5); i cloni non certificati sono sconsigliati per qualsiasi uso. I contatti Schneider XB4-BS542 reggono circa 3 A DC-13 a 24 V, quindi interrompi con i contatti NC la bobina di un contattore e non l'intera corrente dei motori. Si consiglia un arresto di emergenza fisico indipendente da ROS.
- Lacuna di sicurezza 3: una batteria da 24 V e un convertitore AC/DC da 230 V sono collegati in parallelo allo stesso bus. Se sono collegati entrambi contemporaneamente, la sorgente più rigida alimenta a ritroso l'altra. Una sola sorgente alla volta; un selettore di sorgente renderebbe la soluzione sicura.
- I 230 V AC sono potenzialmente letali; circa 30 mA attraverso il corpo sono già pericolosi. Protezioni minime: un interruttore differenziale da 30 mA a monte, tutto il cablaggio a 230 V racchiuso in una scatola chiusa, il telaio metallico del convertitore collegato a terra, un fusibile o un interruttore automatico sull'ingresso di rete e un fermacavo sul cavo di rete. Togli la corrente o stacca la spina prima di toccare qualsiasi cosa sul lato di potenza; non lavorare mai sotto tensione.
4.3 Monta e collega i driver dei motori
Collega ciascuno dei due driver ZBLD.C20-120L2R ai 24 V, al connettore del proprio motore (U, V, W e Hall) e a quattro linee di segnale dalla Teensy; non si usa RS485.
- Driver: ZBLD.C20-120L2R, 24 V più o meno 20 percento, uscita 7,5 A, 120 W, anello aperto o chiuso, 5 ingressi digitali NPN e 2 uscite digitali. Uno per ruota: sinistra = MOTOR1, destra = MOTOR2. La figura del produttore chiede che la potenza nominale dell'alimentatore sia superiore a 2 volte la potenza nominale del motore e raccomanda un cavo tra motore e driver più corto di 1 m.
- Alimentazione del driver: V+ / V- = 24 V DC sui morsetti a vite grandi in basso a destra (contrassegnati 电源DC24V), con fusibile. Marrone = V+, blu = V-; verifica prima con un multimetro.
- Connettore del motore (Molex bianco, 8 pin): U, V, W (fasi), Hu, Hv, Hw (Hall U, V, W), Vcc (alimentazione Hall +5 V), 0V (GND Hall). Il driver commuta il motore in base ai sensori Hall; il Teensy non vede mai U/V/W né i segnali Hall. La figura del produttore indica i colori del cavo del motore: U giallo spesso, V verde spesso, W blu spesso, 5V rosso sottile, Hw blu sottile, Hv verde sottile, Hu giallo sottile, Com nero sottile.
- Morsettiera dei segnali, 12 posizioni, esattamente 4 collegate per driver: VAR/AI2 = riferimento di velocità, analogico 0-5 V (PWM del Teensy a 3 kHz); FWD/DI1 = avanti; REV/DI2 = indietro; COM = massa comune, obbligatoria. Driver sinistro: PWM pin 1, IN_A pin 20, IN_B pin 21. Driver destro: PWM pin 5, IN_A pin 6, IN_B pin 8.
- Morsetti non usati: JOG/DI3, CLR/DI4, BRK/DI5, +5V, ERR/DO1, SPD/DO2 e A+/B- (RS485 non usato). Il COM del driver deve essere collegato al GND del Teensy, altrimenti segnali ed encoder sono disturbati.
- DIP switch, identici su entrambi i driver: SW1 OFF, SW2 ON, SW3 OFF, SW4 ON, SW5 ON, SW6 OFF. SW1 OFF = anello aperto, quindi il PID del Teensy è l'unico regolatore. SW2 ON = sorgente della velocità AI2, l'ingresso esterno 0-5 V dove arriva il PWM del Teensy. SW3 OFF = controllo interno, non controllo RS485. SW6 OFF = nessuna resistenza di terminazione RS485. Con SW2 ON il potenziometro VAR non imposta la velocità.
- Coppie polari: il progetto originale ha impostato SW4 ON e SW5 ON per le 5 coppie polari del motore, lette dalla serigrafia del driver il 2026-06-19, e prima le aveva trovate su OFF/OFF (2 coppie polari). La figura di riferimento del produttore nello stesso repository mostra la corrispondenza opposta (2 coppie polari = SW4 ON, SW5 ON; 5 coppie polari = SW4 OFF, SW5 OFF). L'impostazione si usa solo in anello chiuso, che SW1 OFF evita; controlla la tabella stampata sul tuo driver prima di farci affidamento.
- Ogni driver ha due trimmer che devono coincidere tra sinistra e destra: VAR (in alto) circa 3.5/10 e ACC/DEC (vicino ai DIP switch) 4/10. Con SW2 ON sono impostazioni da lasciare invariate, non manopole di bilanciamento.
- Quando un driver rileva un guasto, ferma il motore e fa lampeggiare un codice sui suoi LED verde e rosso; i guasti restano memorizzati finché i 24 V non vengono spenti e riaccesi. Il codice 10 è sottotensione del bus (24 V troppo bassi). I codici da 7 a 9 sono sovratensione (alimentazione sopra 28,8 V). Il codice 13 è un errore dei sensori Hall e il codice 30 una fase del motore mancante.
- Dove sono fissati i driver ZBLD nel robot esistente non è documentato; il supporto del driver motore stampato in 3D MMP.02.00.00.002 sul ramo main è per il driver ZLAC8015D della 2.0.
4.4 Installa il microcontrollore Teensy
Collega una Teensy 4.0 (non una 4.1) ai due driver, ai due encoder e all'unità di misura inerziale (IMU) con i pin indicati sotto, e collega la sua porta USB al Raspberry Pi.
- Il controllore è un Teensy 4.0 (NXP i.MX RT1062, Cortex-M7 a 600 MHz). La distinta base, il cablaggio, l'ambiente firmware (teensy40) e i documenti di programmazione del progetto originale indicano tutti un Teensy 4.0; il repository del firmware contiene solo una cartella segnaposto vuota per un 4.1.
- Il livello logico è 3,3 V e non tutti i pin tollerano i 5 V. Un segnale a 5 V su un ingresso può distruggere il pin o la scheda.
- Pin: IMU SDA 18, IMU SCL 19. Encoder LEFT (M1) A 14, B 15. Encoder RIGHT (M2) A 11, B 12. Motore LEFT (M1) PWM 1, IN_A/FWD 20, IN_B/REV 21. Motore RIGHT (M2) PWM 5, IN_A/FWD 6, IN_B/REV 8. LED di debug 13. micro-ROS sulla seriale USB nativa a 115200 baud. MOTOR1 è la ruota sinistra e MOTOR2 la destra.
- Il pin 21 non è un pin PWM sul Teensy 4.x, quindi il PWM sinistro è sul pin 1; il progetto originale lo indica come un errore comune.
- Alimentazione: il Teensy è alimentato via USB dal Raspberry Pi (5 V). L'IMU e gli encoder prendono i 3,3 V dalla linea a 3,3 V del Teensy; il pin 5 V (VUSB) non alimenta nulla. Il GND del Teensy va al COM di entrambi i driver.
- USB: seriale nativa, compare come /dev/ttyACM0; il Teensy è il client micro-ROS e l'agent gira sul Pi. Il LED sul pin 13: 3 lampeggi ripetuti indicano un errore di inizializzazione (IMU non riconosciuta, o creazione delle entità ROS non riuscita); acceso fisso indica che è connesso all'agent.
- Nella build di base il Teensy non ha un collegamento RS485. RS485 compare solo come coppia di morsetti non usata sul driver ZBLD (SW6 OFF) e come interfaccia del driver opzionale ZLAC8015D.
- Come è fissato il Teensy non è documentato; i distanziali TFF-M3/25 nella distinta base sono elencati per la telecamera.
4.5 Installa il Raspberry Pi 5
Monta il Raspberry Pi 5 (8 GB) con l'Active Cooler ufficiale, alimentalo a 5 V e 5 A dal convertitore DC-DC e collega via USB la Teensy e il LiDAR e con un cavo piatto CSI la fotocamera.
- Modello: Raspberry Pi 5 Model B Rev 1.1, 8 GB. Monta l'Active Cooler ufficiale del Raspberry Pi 5: il robot validato non lo aveva e il Pi riduceva le prestazioni sotto lo stack del robot, con una temperatura del core di 83,4 gradi C rispetto a un limite assoluto di 85 gradi C e un clock limitato a circa 2,1 GHz invece di 2,4 GHz.
- Il Pi 5 richiede 5 V / 5 A. All'avvio motori, LiDAR e telecamera partono insieme; un picco di corrente può far crollare la linea a 5 V, e il Pi allora si blocca e sparisce dalla rete. Usa un convertitore buck da 5 V in grado di erogare almeno 5 A di picco con un cavo corto e di grossa sezione, e mantieni la batteria a 25 V o più a riposo.
- Collegamenti: Teensy su USB (/dev/ttyACM0); LiDAR su USB tramite il bridge CP2102 (/dev/ttyUSB0); telecamera sul cavo piatto CSI, non su USB. Preferisci i percorsi stabili /dev/serial/by-id, perché i numeri possono cambiare al riavvio.
- Come è fissato il Pi nel telaio non è documentato.
4.6 Installa il convertitore DC-DC
Collega un convertitore buck da 24 V a 5 V da almeno 5 A dal bus a 24 V al solo Raspberry Pi.
- Il convertitore alimenta il Raspberry Pi. Il Teensy non è alimentato da esso.
- La distinta base dell'elettronica elenca un convertitore buck LM2596 (da 24V a 5V, 5 A o più) per il Raspberry Pi. Il robot di riferimento ha un buck generico da circa 300 W 20 A (toroide e 2 trimmer) senza un modello chiaro.
5. Installazione dei sensori
5.1 Monta il sensore LiDAR
Monta l'RPLIDAR A1 sul supporto del LiDAR (MMP.07.00.00.001) con 4 viti M2.5x6 DIN 7985 e collegalo via USB al Raspberry Pi tramite il suo adattatore CP2102.
- Il robot esistente usa uno Slamtec RPLIDAR A1 (A1M8 a giudicare dalla forma; l'etichetta del modello è ancora da confermare). OpenAMRobot 2.0 lo sostituisce con l'RPLIDAR S3 (S3M1-R2).
- LiDAR al gruppo di supporto (tabella della minuteria): 4 viti M2.5x6 DIN 7985, 4 rondelle 2.5 DIN 125, 4 rondelle elastiche 2.5 DIN 7980.
- Posizione misurata sul robot esistente: 33,5 cm davanti all'asse delle ruote, centrato, montato ruotato di 180 gradi. Il suo 0 gradi punta verso il retro; il fronte del robot corrisponde ai 180 gradi del LiDAR (trasformazione statica x 0,335 m, y 0, z 0,18 m, imbardata pi).
- Collegamento: USB al Pi tramite un bridge da USB a UART Silicon Labs CP2102 (10c4:ea60), alimentato via USB. Protocollo: 115200 baud, modalità di scansione Standard. Uscita /scan a circa 7 Hz, campo di misura da 0.15 a 12 m.
- Il telaio del robot stesso genera ritorni ravvicinati in diverse direzioni, quindi uno scan_body_filter deve mascherarli per produrre /scan_filtered per Nav2. Non terminare bruscamente il driver mentre sta eseguendo la scansione: si blocca. Riavvia il nodo una volta e, se non basta, scollega e ricollega l'USB.
5.2 Opzionale: sensori di prossimità e a ultrasuoni (non nella versione base)
Il progetto originale elenca sensori di prossimità a infrarossi E18-D80NK e un sensore a ultrasuoni JSN-SR04T nella distinta base, ma presenta gli anelli a ultrasuoni e a infrarossi come pacchetto di sicurezza aggiuntivo opzionale, non come parte della versione base.
- La distinta base elenca il sensore di prossimità E18-D80NK (quantità 4) e il sensore a ultrasuoni JSN-SR04T (quantità 1). La pagina dell'architettura indica gli anelli di prossimità a ultrasuoni (JSN-SR04) e IR (E18-D80NK) come presenti nello schema ma non parte della base.
- Nessun documento fornisce un cablaggio o un'assegnazione dei pin per questi elementi; la tabella dei pin del Teensy non ha voci per loro.
- OpenAMRobot 2.0 usa invece 4 sensori a ultrasuoni MaxBotix MB7060 XL-MaxSonar-WR (uscita RS232; una UART STM32 ciascuno a 9600 8N1 con inversione in ricezione, più un GPIO di trigger ciascuno) e 2 sensori anticaduta Benewake TF-Luna (una UART ciascuno, pin 5 collegato a 3,3 V). Il progetto originale dichiara: solo rilevamento funzionale: i sensori di prossimità non sono un dispositivo di sicurezza.
5.3 Installa la fotocamera
Monta la Raspberry Pi Camera Module 3 NoIR (IMX708) nel pannello anteriore e collegala al Pi 5 con un cavo piatto CSI a 15 pin e un adattatore CSI da 15 a 22 pin.
- Telecamera: Raspberry Pi Camera Module 3 NoIR (Sony IMX708, senza filtro IR-cut, autofocus). Unità Gate A; sostituita nella 2.0 dalla Orbbec Gemini 336L sul supporto telecamera MMP.01.00.00.003. La distinta base chiama il pezzo Camera Module NVision Assem ed elenca PT1.00.00.032 Camera upper body come pezzo stampato in 3D.
- Interfaccia: CSI (cavo piatto MIPI), non USB. Il cavo piatto FPC a 15 pin richiede un adattatore CSI (da 15 a 22 pin) per il connettore più stretto del Pi 5; il dispositivo è cam1.
- Minuteria tra telecamera e Front panel (tabella della minuteria): 4 viti M3x8 DIN 966, 4 viti M3x12 DIN 967, 4 viti M2x16 DIN 7985, 4 dadi M2 DIN 934, 4 rondelle 2 DIN 125, 4 rondelle elastiche 2 DIN 7980, 4 distanziali filettati TFF-M3/25 e 16 rondelle 3 DIN 125.
5.4 Installa l'unità di misura inerziale (IMU)
Collega la scheda IMU MPU6500 (serigrafia MPU-6050 o GY-521) alla Teensy 4.0 in I2C sul pin 18 (SDA) e sul pin 19 (SCL), alimentata a 3,3 V.
- Cablaggio verificato il 2026-06-19: SDA = pin 18, SCL = pin 19, alimentazione = 3,3 V (misurata), AD0 = GND che dà l'indirizzo 0x68, GND in comune con il Teensy. Il Teensy è il master I2C. Pin non usati: XCL, XDA e INT.
- Il chip è un MPU6500 (WHO_AM_I 0x70), non un MPU6050, e non ha magnetometro. Le resistenze di pull-up della scheda tirano a 3,3 V, quindi SDA e SCL non superano mai 3,3 V.
- L'EKF usa solo la velocità di imbardata del giroscopio (angular_velocity.z). A riposo linear_acceleration.x è circa -2, che il progetto originale interpreta come una leggera inclinazione del montaggio. Dove si trova l'IMU sul robot esistente non è documentato.
- OpenAMRobot 2.0 usa un ICM-42688-P (scheda TDK EV_ICM-42688-P) su un SPI dedicato, Mode 0, clock al massimo 8 MHz, sulla linea mediana.
5.5 Installa gli encoder magnetici
Monta un gruppo encoder magnetico AMS AS5040 (PT1.00.00.240) su ciascuna ruota motrice e alimentalo dalla linea a 3,3 V della Teensy, mai a 5 V.
- Un AS5040 per ruota (magnetico, in quadratura A/B, 1024 impulsi per giro) fornisce al Teensy la velocità delle ruote per il PID e l'odometria. Fanno parte del progetto, elencati con quantità 2.
- Ogni gruppo encoder PT1.00.00.240 ha un adattatore (PT1.00.00.241), una staffa (PT1.00.00.242) e una copertura (PT1.00.00.243) stampati in 3D, fissati con viti M2x8 DIN 7985 e dadi M2 DIN 934 (8 di ciascuno per due encoder).
- È montato sul lato di uscita, in modo che 1024 impulsi corrispondano a un giro della ruota (COUNTS_PER_REV = 1024 per giro della ruota). Il magnete diametrale deve essere ben centrato sul chip: un magnete fuori centro sulla ruota destra faceva serpeggiare il robot, e ricentrarlo ha risolto il problema.
- Tensione di alimentazione: 3,3 V dalla linea a 3,3 V del Teensy, non 5 V. Il livello alto dell'uscita dell'AS5040 è pari alla sua alimentazione, quindi a 5 V le uscite A/B arrivavano a circa 4 V su ingressi del Teensy che non tollerano i 5 V (massimo assoluto ~3,6 V). È previsto per 3.3-5 V tramite un regolatore interno. Il progetto originale dice: non tornare indietro.
- Cablaggio: LEFT (MOTOR1) A al pin 14 e B al pin 15; RIGHT (MOTOR2) A al pin 11 e B al pin 12; GND comune.
- I tre sensori Hall all'interno di ogni motore sono separati: il driver li legge per commutare il motore e il Teensy non li vede mai. Il Teensy legge solo l'AS5040.
6. Montaggio e finitura della copertura
6.1 Installa i moduli LED di segnalazione
Il progetto originale elenca due moduli LED 3 LED RGB Module 0,72W SWP nella distinta base, ma nessun documento dice dove vanno montati né come vanno cablati.
- Il progetto originale elenca nella distinta base due moduli LED 3 LED RGB Module 0,72W SWP, ma nessun documento dice dove sono montati o come sono cablati.
6.2 Installa il gruppo supporto del LiDAR
Fissa alla base il gruppo supporto del LiDAR (MMP.07.00.00.000) con 4 viti M4x16 DIN 7985, 4 rondelle 4 DIN 125 e 4 rondelle elastiche di sicurezza 4 DIN 7980.
- Il supporto del LiDAR ha 4 inserti filettati a rivetto M4. Il piano di scansione del LiDAR sul robot esistente è a 222,0 mm dal pavimento.
6.3 Monta il gruppo copertura
Fissa la copertura MMP.01.00.00.001 alla staffa centrale con 4 viti M8x25 DIN 967 e 4 rondelle 8 DIN 125, e monta le due flange della copertura MMP.01.00.00.002.
- Il gruppo Cover MMP.01.00.00.000 richiede di per sé 10 viti M3x8 DIN 7985, 10 dadi M3 DIN 934, 20 rondelle 3 DIN 125 e 10 rondelle elastiche 3 DIN 7980.
6.4 Installa la copertura in plastica opzionale
La copertura in plastica opzionale MMP.00.00.00.004 è pubblicata solo come file STEP e SLDPRT; il progetto originale non dice come realizzarla.
- La capacità di carico del robot dichiarata dal progetto originale arriva a 150 kg; questo valore non è dichiarato per la copertura in plastica.
7. Configurazione del software
7.1 Installa Ubuntu e ROS2 sul Raspberry Pi
Configura il Raspberry Pi 5 con Ubuntu Server 24.04 LTS e ROS 2 Jazzy, usando CycloneDDS sul dominio 0 e il nome mDNS del robot per SSH.
- Installazione di riferimento: Raspberry Pi 5 Model B Rev 1.1, 8 GB, Ubuntu Server 24.04 LTS (Noble), kernel 6.8.x-raspi, ROS 2 Jazzy (/opt/ros/jazzy). Il progetto originale non pubblica una procedura passo passo per scrivere l'immagine, configurare il Wi-Fi o installare il workspace dell'agent micro-ROS.
- Il Pi è headless. Lavora via SSH da un PC di sviluppo con Ubuntu 24.04 ed esegui RViz sul PC. Usa il nome mDNS, ssh <user>@<robot>.local, mai un IP fisso, perché l'indirizzo viene assegnato via DHCP e cambia.
- Il robot usa CycloneDDS sul dominio 0; un PC usa per impostazione predefinita FastDDS e il dominio 42 e non vede nulla. In ogni terminale sul PC e sul Pi, e in ogni comando SSH non interattivo, esegui: source /opt/ros/jazzy/setup.bash
- export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
- export ROS_DOMAIN_ID=0
- L'utente del Pi fa parte dei gruppi dialout, video e sudo. Workspace sul Pi di riferimento: ~/linorobot2_ws (agent micro-ROS), ~/camera_ws (fork libcamera del Raspberry Pi e camera_ros), ~/sllidar_ws (driver del LiDAR) e ~/openamr-platform-sw/ros2.
- Telecamera: i pacchetti libcamera di apt non supportano l'IMX708 su un Pi 5 (sintomo: camera_node segnala no cameras available). Compila invece il fork del Raspberry Pi. Installa le dipendenze di compilazione: sudo apt install -y g++ cmake meson ninja-build pkg-config libboost-dev libgnutls28-dev openssl libjpeg-dev libpng-dev libtiff-dev python3-yaml python3-ply pybind11-dev python3-colcon-meson libglib2.0-dev libgstreamer-plugins-base1.0-dev libdrm-dev libevent-dev
- Poi esegui: mkdir -p ~/camera_ws/src && cd ~/camera_ws/src, e clona al suo interno da GitHub i repository raspberrypi/libcamera (il fork del Raspberry Pi, che è l'elemento chiave) e christianrauch/camera_ros.
- Poi esegui: cd ~/camera_ws ; source /opt/ros/jazzy/setup.bash ; rosdep install --from-paths src --ignore-src -y ; colcon build --packages-select libcamera camera_ros (circa 6-7 minuti sul Pi 5). L'overlay nasconde la libcamera di apt senza rimuoverla; esegui source ~/camera_ws/install/setup.bash in ogni shell di avvio.
7.2 Carica il firmware sulla Teensy
Compila il firmware per Teensy 4.0 (una sovrapposizione di tre file su linorobot2_hardware, branch jazzy) con l'ambiente PlatformIO teensy40 e caricalo con teensy_loader_cli.
- Il firmware è un overlay sul firmware linorobot2_hardware, ramo jazzy, commit aaf9d59 (30 aprile 2026). In quel checkout copia config/lino_base_config.h, lib/pid/pid.cpp e src/firmware.ino dall'overlay sopra i percorsi corrispondenti. La build usa config/lino_base_config.h, non dev_config.h.
- Compilazione: cd <linorobot2_hardware>/firmware
- ROS_DISTRO=jazzy ~/.platformio/penv/bin/pio run -e teensy40
- Su Ubuntu 24.04 esegui PlatformIO dal suo venv come mostrato, perché un semplice pio potrebbe non funzionare. La prima build richiede circa 5 minuti, le successive circa 8 secondi. L'output è .pio/build/teensy40/firmware.hex.
- Programmazione: installa teensy_loader_cli e le regole udev PJRC (/etc/udev/rules.d/00-teensy.rules). Arresta prima l'agent micro-ROS con: pkill -f "[m]icro_ros_agent"
- HEX=<linorobot2_hardware>/firmware/.pio/build/teensy40/firmware.hex
- sudo teensy_loader_cli --mcu=TEENSY40 -s -w -v "$HEX"
- Il riavvio software -s è instabile nei tempi e può segnalare error writing. In tal caso la scheda è già nel bootloader HalfKay; riprova una volta senza -s: sudo teensy_loader_cli --mcu=TEENSY40 -w -v "$HEX". Il metodo più affidabile è premere il pulsante fisico del Teensy, poi programmare con -w. Scollegare e ricollegare l'USB dopo una programmazione non riuscita avvia l'ultimo firmware funzionante.
- Il firmware si avvia da solo all'accensione; sul Teensy non c'è nulla da lanciare. Quello che avvii sul Pi è l'agent micro-ROS. Il firmware esegue un ciclo a 50 Hz: /cmd_vel in ingresso, un PID per ruota, PWM e direzione in uscita verso i driver, odometria e IMU in uscita.
- Un Teensy non può essere riletto; l'unico backup è il sorgente del firmware. Non caricare un nuovo firmware se non puoi ricaricare una build sicuramente funzionante. Una riprogrammazione riavvia il Teensy e sposta lo zero dell'encoder, quindi esegui di nuovo l'allineamento dell'encoder (vedi il passaggio di test).
7.3 Usa percorsi stabili per i dispositivi seriali
Indica la Teensy e il LiDAR con i loro percorsi /dev/serial/by-id, perché i numeri ttyACM e ttyUSB possono cambiare al riavvio.
- Teensy: /dev/serial/by-id/usb-Teensyduino_USB_Serial_<serial>-if00 (numero di serie dell'unità di riferimento 16778200). LiDAR A1: /dev/serial/by-id/usb-Silicon_Labs_CP2102_USB_to_UART_Bridge_Controller_0001-if00-port0. Questi percorsi sono specifici di ogni robot; su un'altra unità sovrascrivili, per esempio con gli argomenti teensy_port e lidar_port di drivers.launch.py.
- La telecamera è su CSI, non su USB, quindi non ha un percorso seriale.
- Le uniche regole udev nei documenti attuali sono le regole PJRC per programmare il Teensy (00-teensy.rules). Il vecchio wiki descrive regole lino_udev che creano /dev/base e /dev/lidar; appartengono alla configurazione ROS 1 e sono obsolete.
7.4 Compila e avvia lo stack di navigazione ROS 2
Compila il driver del LiDAR e openamr-platform-sw nei workspace colcon sul Pi, controlla la geometria delle ruote nella configurazione del firmware e avvia lo stack con bringup_composed.launch.py.
- La vecchia configurazione Linorobot ROS 1 del wiki legacy (Ubuntu 20.04, ROS Noetic, lino_install con 2wd rplidar) è obsoleta. Il software attuale è openamr-platform-sw: ROS 2 Jazzy, Nav2, AMCL e docking, con micro-ROS verso il Teensy.
- Driver del LiDAR: sllidar_ros2 non ha un pacchetto binario per Jazzy. Esegui: mkdir -p ~/sllidar_ws/src && cd ~/sllidar_ws/src, clona Slamtec/sllidar_ros2 da GitHub, poi: git -C sllidar_ros2 checkout 34300099fadfc772965962dec837bf436706188f
- cd ~/sllidar_ws ; source /opt/ros/jazzy/setup.bash ; rosdep install -y --rosdistro jazzy --ignore-src --from-paths src ; colcon build --cmake-args -DCMAKE_BUILD_TYPE=Release ; source ~/sllidar_ws/install/setup.bash
- Clona openAMRobot/openamr-platform-sw da GitHub. Il workspace colcon è la sottodirectory ros2: cd openamr-platform-sw/ros2 ; source /opt/ros/jazzy/setup.bash ; colcon build --symlink-install ; source install/setup.bash. Il robot reale richiede anche il workspace dell'agent micro-ROS e il workspace della telecamera descritti sopra.
- Geometria delle ruote, dalla configurazione del firmware e misurata fisicamente: WHEEL_DIAMETER 0.2 (200 mm), LR_WHEELS_DISTANCE 0.46 (carreggiata, da centro a centro) e COUNTS_PER_REV 1024, che deve essere riferito a un giro della ruota. Non usare 0,046533 m come raggio della ruota (è l'altezza dell'asse della ruota nell'URDF esportato dal CAD) né 0,4075 m come carreggiata (un artefatto del CAD). Verifica l'odometria: percorri esattamente 1 m e confronta /odom.
- Avvia l'intero stack sul Pi con il profilo composed, quello predefinito per telecamera e docking. Nella stessa shell, esegui source di /opt/ros/jazzy/setup.bash, ~/linorobot2_ws/install/setup.bash, ~/camera_ws/install/setup.bash e ~/openamr-platform-sw/ros2/install/setup.bash, esporta RMW_IMPLEMENTATION=rmw_cyclonedds_cpp e ROS_DOMAIN_ID=0, poi: ros2 launch openamrobot_bringup bringup_composed.launch.py map:=$HOME/maps/<your_map>.yaml
- Serve una mappa: con sim:=false il launch si rifiuta di partire senza una mappa esplicita. La riga del workspace della telecamera non è facoltativa; senza di essa la telecamera fallisce con no cameras available e il docking si interrompe.
- Il 2D Pose Estimate in RViz sul PC è obbligatorio prima che il robot possa vedere o navigare, perché la posa iniziale automatica di AMCL è disattivata. Finché non gli fornisci una posa non esiste la trasformazione da map a odom e le costmap restano vuote. Esegui RViz con la configurazione openamr_nav.rviz, non nav2_view.rviz, e invia 2D Goal Pose invece di Nav2 Goal.
7.5 Installa e configura l'interfaccia web
Esegui la dashboard separata openamrobot-ui, un front end React servito da Flask sulla porta 5050 con rosbridge sulla porta 9090, in Docker sul Raspberry Pi del robot.
- openamrobot-ui è una dashboard nel browser per robot ROS 2: mappatura, guida manuale, obiettivi Nav2, viste delle telecamere, percorsi salvati, programmi visuali, missioni, diagnostica dello stato e registrazioni. Richiede Docker Engine e il plugin Docker Compose, oppure un'installazione manuale con Ubuntu 24.04, ROS 2 Jazzy, Python 3, colcon, Node.js da 18 a 20 e npm.
- Lo stack del robot e la UI sono workspace separati: avvia prima il robot o la simulazione, poi la UI. Docker: docker compose up --build
- Fornisci alla UI le impostazioni DDS del robot, perché per impostazione predefinita usa FastDDS e mostra pannelli connessi ma vuoti: RMW_IMPLEMENTATION=rmw_cyclonedds_cpp ROS_DOMAIN_ID=0 docker compose up
- Eseguila sul Pi, non su un PC via Wi-Fi: sul PC satura il collegamento con topic reliable di grandi dimensioni e blocca la navigazione. Il progetto originale ha segnalato il 2026-07-06 che sul Pi non era ancora installata alcuna UI.
- Il pulsante rosso E-STOP nella dashboard è un arresto software senza ritenuta, non certificato per la sicurezza; tieni vicino a te un arresto di emergenza fisico collaudato ogni volta che usi hardware reale.
7.6 Prova e calibra
Prova i motori con le ruote sollevate da terra, a velocità molto bassa, con una mano sull'interruttore di sgancio dei 24 V, dopo aver controllato la tensione della batteria; non attivare Nav2 né l'aggancio alla base finché movimento manuale, direzione degli encoder, odometria e arresto non sono stati verificati.
- Ruote sollevate da terra per tutti i primi test dei motori. 24 V attivi solo quando serve che le ruote girino; tieni una mano sull'interruttore dei 24 V. Inizia con un massimo di 0,05 m/s lineari e 0.15 rad/s angolari.
- Soglie minime affidabili misurate sul pavimento: circa 0,04 m/s lineari (0,05 m/s senza problemi) e 0.15 rad/s angolari. Mantieni le velocità comandate al di sopra di questi valori.
- Modi per fermarsi: k nella teleoperazione, Ctrl-C sul publisher o l'interruttore dei 24 V. Il firmware ferma i motori se non arriva alcun /cmd_vel per 200 ms, ma questo non sostituisce un arresto di emergenza fisico; nei documenti del firmware non è ancora cablato alcun arresto di emergenza hardware.
- Batteria a riposo prima di qualsiasi test di navigazione: circa 25.5-26 V è carica, circa 24,5 V è accettabile, circa 24 V è al limite, e 23,5 V o meno significa non testare la navigazione. Regola: punta a 25 V o più a riposo. Sotto carico il pacco cala di altri 1-2 V; sotto circa 22 V i driver vanno in protezione per sottotensione del bus (codice di guasto 10).
- Test del motore senza il PID, robot sollevato: ros2 topic pub --rate 15 /debug/openloop geometry_msgs/msg/Vector3 "{x: 100.0}". Il comando viene limitato a circa più o meno 716 PWM e mantenuto per 300 ms, quindi deve essere ripubblicato per continuare a muoversi.
- Tabella di ripple dell'encoder: dopo ogni spegnimento e riaccensione del Teensy (non a ogni launch ROS), con le ruote sollevate, 24 V attivi e una mano sull'interruttore, e l'agent micro-ROS in esecuzione, esegui in <openamr-platform-fw>/tools/encoder-calibration: python3 align_enc_cal.py --arm 250. In caso di successo stampa: table placed -> /debug/enc_cal. Un reset del Teensy cancella la tabella.
- Dopo qualsiasi modifica al firmware o alla configurazione, verifica di nuovo il verso degli encoder e un /cmd_vel a bassa velocità prima di guidare normalmente. Non attivare SLAM, Nav2 o il docking finché movimento manuale, verso degli encoder, odometria e comportamento in arresto non sono tutti validati.
8. Opzionale: configurazione della ricarica wireless
8.1 Installa il ricevitore per la ricarica wireless sul robot
La ricarica wireless non fa parte della versione base; il WCM-300 è solo il caricatore del robot esistente, e il progetto originale indica il TZBOT WCM-500-24 (uscita 28,4 V) come soluzione di ricarica per la versione 2.0.
- Parole del progetto originale: la ricarica wireless TZBOT WCM-500-24 è la soluzione di ricarica della 2.0 e della release 001 (registro CHARGING); il WCM-300 è solo l'unità presente sul robot della release 001 e non fa parte del progetto. Il manuale del WCM-300 è stato rimosso dal repository hardware il 22 Oct 2026 e resta nella sua cronologia Git; il repository legacy ne conserva ancora una copia. La scheda tecnica del WCM-500-24 non è ancora nel repository.
- Dal manuale del WCM-300 (V2.6): il ricevitore wireless (WCM-300R) è fissato sul robot e il trasmettitore (WCM-300T) nell'area di ricarica. Non deve esserci metallo entro 2 cm attorno a trasmettitore e ricevitore (A di almeno 2 cm). Traferro da 0 a 50 mm; scostamento sull'asse X più o meno 30 mm; scostamento sull'asse Y più o meno 30 mm.
- Dove sia fissato il ricevitore sul robot non è indicato nel testo; l'immagine dall'alto del README hardware mostra una zona riservata al caricatore wireless opzionale.
8.2 Configura la stazione di ricarica a terra
Il trasmettitore WCM-300 è fissato nell'area di ricarica e funziona a 220 V AC più o meno 15 percento, monofase 50 Hz, 3 A al massimo.
- Parametri del WCM-300: tensione di ingresso AC220V +/- 15%, monofase 50Hz; corrente di ingresso 3A (massima); tensione di uscita 28,8V; corrente di uscita 7A; grado di protezione IP65; dimensioni 240 (L) x 210 (A) x 65 (P) mm; peso circa 5 kg. Per confronto, i guasti di sovratensione del driver ZBLD (codici da 7 a 9) sono indicati per un'alimentazione superiore a 28,8 V.
- I 230 V AC sono potenzialmente letali; usa le protezioni elencate nel passaggio sull'alimentazione: un interruttore differenziale da 30 mA a monte, cablaggio racchiuso, telaio collegato a terra e un fusibile sull'ingresso di rete.
8.3 Configura l'aggancio autonomo alla base
L'aggancio alla base del progetto originale è una sequenza su un insieme di 3 tag AprilTag avviata da un Bool su /dock_trigger; nessun documento descrive un avvio basato su una soglia della batteria né come viene avviato il caricatore.
- Il docking si attiva con un Bool su /dock_trigger (o con il pulsante dock della UI); l'avvio deve avere use_docking a true oppure essere bringup_composed.launch.py. Con la shell ROS configurata come nel passaggio di avvio: ros2 topic pub --once /dock_trigger std_msgs/msg/Bool "{data: true}"
- Sgancio dal dock: ros2 topic pub --once /undock_robot std_msgs/msg/Bool "{data: true}"
- Sul robot reale il dock è un insieme stampato di 3 tag (famiglia AprilTag 36h11, ID 0, 1 e 2) senza un dock fisico; il tag centrale, ID 1, è il bersaglio del docking.
- Stato del firmware: il modulo battery_monitor non è implementato; non c'è ancora telemetria della tensione della batteria.
- Segnale di avvio del WCM-300, dal suo manuale: il controllore del robot fornisce un livello alto da 3 a 30 VDC sul filo marrone per avviare la ricarica e un livello basso per arrestarla; il giallo è la linea di segnalazione guasti (attiva a livello basso, uscita open collector, corrente massima assorbita 200 mA, tensione sopportata 30 VDC); il blu è la massa del segnale. Come questo sia cablato sul robot esistente non è documentato.