Modulo cellulare EM12
Informazioni sul prodotto
Specifiche
- Nome prodotto: Modulo LTE-A serie EM12&EG12&EG18
- Versione: 1.1
- Data: 2024-09-25
- Stato: rilasciato
Istruzioni per l'uso del prodotto
Informazioni sui contatti
Se hai bisogno di assistenza, contatta Quectel
sede legale al seguente indirizzo:
Edificio 5, Shanghai Business Park Fase III (Area B), n.1016
Tianlin Road, distretto di Minhang, Shanghai 200233, Cina
Tel: +86 21 5108 6236
E-mail: info@quectel.com
Supporto tecnico
Per supporto tecnico o per segnalare errori nella documentazione, visitare:
Tecnico
Supporto
E-mail: support@quectel.com
politica sulla riservatezza
La funzionalità del modulo può comportare il caricamento dei dati su Quectel o
server di terze parti. L'elaborazione dei dati è soggetta alle leggi pertinenti
e regolamenti. Prima di condividere i dati con terze parti, riview
le loro politiche sulla privacy.
Disclaimer
Quectel declina ogni responsabilità per eventuali lesioni o danni derivanti
dall'affidamento alle informazioni fornite. L'accuratezza delle informazioni è
non garantito; si consiglia agli utenti di verificare i dettagli
indipendentemente.
Domande frequenti
D: Come posso aggiornare il firmware del mio modulo LTE-A?
A: Le istruzioni per l'aggiornamento del firmware sono dettagliate nel FOTA
Guida all'aggiornamento. Seguire i passaggi descritti nel Capitolo 2 per l'aggiornamento
il firmware.
D: Cosa devo fare se riscontro problemi tecnici con
Modulo LTE-A?
A: Per supporto tecnico, contattare il team di supporto di Quectel tramite
inviare un'e-mail a support@quectel.com o visitare la pagina del supporto tecnico su
il Quectel websito.
Guida all'aggiornamento FOTA serie EM12&EG12&EG18
Serie di moduli LTE-A Versione: 1.1 Data: 2024-09-25 Stato: rilasciato
Serie di moduli LTE-A
In Quectel, il nostro obiettivo è fornire servizi tempestivi e completi ai nostri clienti. Se hai bisogno di assistenza, contatta la nostra sede centrale:
Quectel Wireless Solutions Co., Ltd. Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, Cina Tel: +86 21 5108 6236 Email: info@quectel.com
O i nostri uffici locali. Per ulteriori informazioni, visitare: http://www.quectel.com/support/sales.htm.
Per supporto tecnico o per segnalare errori nella documentazione, visitare: http://www.quectel.com/support/technical.htm. Oppure inviaci un'e-mail a: support@quectel.com.
Note legali
Ti offriamo informazioni come servizio. Le informazioni fornite si basano sulle tue esigenze e facciamo ogni sforzo per garantirne la qualità. Accetti di essere responsabile dell'utilizzo di analisi e valutazioni indipendenti nella progettazione dei prodotti previsti e forniamo progetti di riferimento solo a scopo illustrativo. Prima di utilizzare qualsiasi hardware, software o servizio guidato da questo documento, ti preghiamo di leggere attentamente questa nota informativa. Anche se impieghiamo sforzi ragionevoli dal punto di vista commerciale per fornire la migliore esperienza possibile, con la presente riconosci e accetti che questo documento e i servizi correlati qui di seguito ti vengono forniti "come disponibili". Potremmo rivedere o riformulare questo documento di volta in volta a nostra esclusiva discrezione senza alcun preavviso.
Limitazioni all'uso e alla divulgazione
Accordi di licenza
I documenti e le informazioni da noi forniti saranno mantenuti riservati, a meno che non venga concesso un permesso specifico. Non saranno accessibili o utilizzati per alcuno scopo, salvo quanto espressamente previsto nel presente documento.
Copyright
I nostri prodotti e quelli di terze parti qui di seguito possono contenere materiale protetto da copyright. Tale materiale protetto da copyright non può essere copiato, riprodotto, distribuito, unito, pubblicato, tradotto o modificato senza previo consenso scritto. Noi e terze parti deteniamo diritti esclusivi sul materiale protetto da copyright. Nessuna licenza sarà concessa o trasferita in base a brevetti, copyright, marchi commerciali o diritti sui marchi di servizio. Per evitare ambiguità, si prega di acquistareasing in qualsiasi forma non può essere considerato come una concessione di licenza diversa dalla normale licenza non esclusiva e royalty-free per l'utilizzo del materiale. Ci riserviamo il diritto di intraprendere azioni legali in caso di mancato rispetto dei requisiti sopra menzionati, utilizzo non autorizzato o altro utilizzo illegale o dannoso del materiale.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
1 / 20
Serie di moduli LTE-A
Marchi
Salvo quanto diversamente stabilito nel presente documento, nulla di quanto contenuto nel presente documento deve essere interpretato come conferimento di diritti di utilizzo di marchi, nomi commerciali o denominazioni, abbreviazioni o prodotti contraffatti di proprietà di Quectel o di terze parti in ambito pubblicitario, promozionale o di altro tipo.
Diritti di terzi
Il presente documento può fare riferimento a hardware, software e/o documentazione di proprietà di una o più terze parti ("materiali di terze parti"). L'uso di tali materiali di terze parti sarà disciplinato da tutte le restrizioni e gli obblighi applicabili.
Non forniamo alcuna garanzia o dichiarazione, espressa o implicita, in merito ai materiali di terze parti, incluse, a titolo esemplificativo ma non esaustivo, garanzie implicite o statutarie di commerciabilità o idoneità per uno scopo particolare, godimento pacifico, integrazione di sistema, accuratezza delle informazioni e non violazione di diritti di proprietà intellettuale di terze parti in merito alla tecnologia concessa in licenza o al suo utilizzo. Nulla nel presente documento costituisce una dichiarazione o garanzia da parte nostra di sviluppare, migliorare, modificare, distribuire, commercializzare, vendere, offrire in vendita o altrimenti mantenere la produzione di uno qualsiasi dei nostri prodotti o di qualsiasi altro hardware, software, dispositivo, strumento, informazione o prodotto. Inoltre decliniamo qualsiasi garanzia derivante dal corso di negoziazione o dall'uso commerciale.
politica sulla riservatezza
Per implementare la funzionalità del modulo, alcuni dati del dispositivo vengono caricati sui server di Quectel o di terze parti, inclusi operatori, fornitori di chipset o server designati dal cliente. Quectel, rispettando rigorosamente le leggi e i regolamenti pertinenti, conserverà, utilizzerà, divulgherà o altrimenti elaborerà i dati pertinenti allo scopo di eseguire il servizio solo o come consentito dalle leggi applicabili. Prima dell'interazione dei dati con terze parti, si prega di essere informati della loro politica sulla privacy e sulla sicurezza dei dati.
Disclaimer
a) Non ci assumiamo alcuna responsabilità per eventuali danni o lesioni derivanti dall'affidamento alle informazioni. b) Non ci assumiamo alcuna responsabilità derivante da eventuali inesattezze o omissioni, o dall'uso delle
informazioni contenute nel presente documento. c) Sebbene abbiamo fatto ogni sforzo per garantire che le funzioni e le caratteristiche in fase di sviluppo siano
esenti da errori, è possibile che contengano errori, inesattezze e omissioni. Salvo quanto diversamente previsto da un valido accordo, non forniamo garanzie di alcun tipo, implicite o esplicite, ed escludiamo ogni responsabilità per qualsiasi perdita o danno subito in relazione all'uso di caratteristiche e funzioni in fase di sviluppo, nella misura massima consentita dalla legge, indipendentemente dal fatto che tale perdita o danno potesse essere prevedibile. d) Non siamo responsabili dell'accessibilità, sicurezza, accuratezza, disponibilità, legalità o completezza di informazioni, pubblicità, offerte commerciali, prodotti, servizi e materiali su terze parti websiti e risorse di terze parti.
Copyright © Quectel Wireless Solutions Co., Ltd. 2024. Tutti i diritti riservati.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
2 / 20
Serie di moduli LTE-A
Informazioni sul documento
Cronologia delle revisioni
Data versione
Autore
Descrizione
–
2023-03-21 Monan TIAN Creazione del documento
1.0
2023-05-18 Monan TIAN Primo rilascio ufficiale
1. Aggiornato il nome del documento da "Nota applicativa" a
"Guida all'aggiornamento".
2. Aggiunto il capitolo sull'implementazione e l'utente di FOTA
responsabilità (Capitolo 1.1).
3. Ottimizzato il diagramma di flusso dell'aggiornamento del firmware FOTA per
distinguere tra il lato utente e il lato Quectel
(Figura 1).
4. Ottimizzata la descrizione dell'aggiornamento del firmware FOTA
passaggi e aggiunte note pertinenti per distinguere tra
lato utente e lato Quectel (Capitolo 2).
1.1
2024-09-25 Monan TIAN
5. Aggiornata la dichiarazione del comando AT examples
(Capitolo 3.2).
6. Ottimizzata la spiegazione delURL>
parametro e aggiornato il URL indirizzo e correlati
istruzioni nel comando example (Capitolo 3.3.1).
7. Ottimizzata la spiegazione delURL>
parametro e aggiornato il URL indirizzo e correlati
istruzioni nel comando example (Capitolo 3.3.2).
8. Aggiornata la descrizione e la nota di
AT+QFOTADL=file_nome> (Capitolo 3.3.3).
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
3 / 20
Serie di moduli LTE-A
Contenuto
Informazioni sul documento ……………………………………………………………………………………………………………………….. 3 Contenuto ………………………………………………………………………………………………………………………………………. 4 Indice della tabella ………………………………………………………………………………………………………………………………… 5
1 Introduzione ………………………………………………………………………………………………………………………… 6 1.1. Implementazione FOTA e responsabilità dell'utente ……………………………………………………………….. 6
2 Procedura di aggiornamento del firmware tramite FOTA ……………………………………………………………………………. 7 2.1. Ottieni il pacchetto firmware …………………………………………………………………………………………… 8 2.2. Carica il pacchetto firmware sul server FTP/HTTP(S) ………………………………………………………… 8 2.3. Esegui il comando AT per aggiornare il firmware …………………………………………………………….. 8
3 Descrizione dei comandi AT FOTA ……………………………………………………………………………………. 9 3.1. Introduzione al comando AT ……………………………………………………………………………………………. 9 3.1.1. Definizioni…………………………………………………………………………………………………………. 9 3.1.2. Sintassi del comando AT …………………………………………………………………………………………. 9 3.2. Dichiarazione del comando AT Examples ……………………………………………………………………………… 10 3.3. Aggiornamento firmware AT+QFOTADL tramite FOTA ………………………………………………………………. 10 3.3.1. AT+QFOTADL=URL> Aggiorna il firmware tramite server FTP ………………………. 10 3.3.2. AT+QFOTADL=URL> Aggiorna firmware tramite server HTTP(S) ……………… 12 3.3.3. AT+QFOTADL=file_name> Aggiorna firmware in locale File Sistema ……………… 13
4 Gestione delle eccezioni e precauzioni …………………………………………………………………………………. 16 4.1. Gestione delle eccezioni ………………………………………………………………………………………………. 16 4.2. Precauzioni ………………………………………………………………………………………………………………. 17
5 Riepilogo dei codici di errore …………………………………………………………………………………………………… 18
6 Riferimenti all'appendice ………………………………………………………………………………………………………… 20
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
4 / 20
Serie di moduli LTE-A
Indice delle tabelle
Tabella 1: Tipi di comandi AT ……………………………………………………………………………………………………….. 9 Tabella 2: Riepilogo dei comandi AT Codici ………………………………………………………………………………………. 18 Tabella 3: Riepilogo dei Codici ……………………………………………………………………………………. 18 Tabella 4: Riepilogo dei Codici ……………………………………………………………………………………………………. 18 Tabella 5: Documenti correlati ………………………………………………………………………………………………………. 20 Tabella 6: Termini e abbreviazioni …………………………………………………………………………………………………….. 20
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
5 / 20
Serie di moduli LTE-A
1 Introduzione
I moduli della serie Quectel LTE-A EM12-G, EG12 ed EG18 supportano la funzione FOTA (Firmware Over-The-Air) per aggiornare il firmware di partizioni come modem, sistema e avvio. Con questa funzione, tu (l'utente) puoi aggiornare il firmware del modulo a una nuova versione o ripristinare il firmware a una vecchia versione. Il pacchetto firmware contiene solo la differenza tra la versione firmware originale e la versione firmware di destinazione, con la quantità di trasmissione dati notevolmente ridotta e il tempo di trasmissione notevolmente accorciato.
1.1. Implementazione FOTA e responsabilità dell'utente
Quectel segue le best practice del settore per quanto riguarda gli aggiornamenti firmware per i suoi moduli consentendo agli utenti di offrire aggiornamenti FOTA. Si prega di notare che Quectel non ha la possibilità di inviare unilateralmente gli aggiornamenti ai dispositivi degli utenti. Quectel affida agli utenti il pieno controllo del processo FOTA. Nel processo, Quectel fornisce solo il firmware aggiornato ma non può avviare gli aggiornamenti FOTA sui dispositivi degli utenti. Gli utenti possono determinare quando inviare l'aggiornamento ai moduli Quectel utilizzando il meccanismo FOTA configurando i parametri corrispondenti per l'aggiornamento che gli utenti ospitano sulle proprie infrastrutture.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
6 / 20
Serie di moduli LTE-A
2 Procedura di aggiornamento del firmware
FOTA
Il grafico seguente illustra la procedura di aggiornamento del firmware tramite FOTA quando il pacchetto firmware è archiviato su un server FTP/HTTP(S).
Lato utente
Host dell'utente
2. Caricare il pacchetto firmware dall'host al server FTP/HTTP(S) di proprietà dell'utente
FTP/HTTP(S) di proprietà dell'utente
server
1. Ottenere il pacchetto firmware dal supporto tecnico Quectel.
3. Inviare AT+QFOTADL sull'host per attivare l'aggiornamento automatico del firmware sul modulo.
LTE/WCDMA
Pacchetto firmware Quectel
Lato Quectel
4. Il modulo Quectel scarica automaticamente il pacchetto firmware dal server FTP/HTTP(S) di proprietà dell'utente tramite la rete LTE/WCDMA.
Modulo Quectel
5. Aggiornare automaticamente il firmware del modulo.
Figura 1: Procedura di aggiornamento del firmware tramite FOTA
Come mostrato nella figura sopra, è necessario eseguire i seguenti passaggi per aggiornare il firmware quando il pacchetto firmware è archiviato su un server FTP/HTTP(S):
Fase 1: Ottieni il pacchetto firmware dal supporto tecnico Quectel (vedi Capitolo 2.1 per i dettagli). Fase 2: Carica il pacchetto firmware dall'host al tuo server FTP/HTTP(S) (vedi Capitolo 2.2 per i dettagli).
dettagli).
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
7 / 20
Serie di moduli LTE-A
Passaggio 3: eseguire AT+QFOTADL sull'host per attivare l'aggiornamento automatico del firmware sul modulo (vedere il Capitolo 2.3 per i dettagli).
Fase 4: Il modulo scarica automaticamente il pacchetto firmware dal server FTP/HTTP(S) tramite la rete LTE/WCDMA.
Fase 5: Il modulo esegue internamente il programma di aggiornamento per aggiornare automaticamente il firmware del modulo.
NOTA
Sei responsabile della fornitura e della gestione del server FTP/HTTP(S) per l'aggiornamento del firmware. Quectel non fornisce il server né fornisce assistenza per la sua configurazione.
2.1. Ottieni il pacchetto firmware
Prima di aggiornare il firmware, controllare il nome della versione originale del firmware con ATI e confermare la versione del firmware di destinazione, quindi inviare le due versioni del firmware al supporto tecnico Quectel per ottenere il pacchetto firmware corrispondente.
2.2. Carica il pacchetto firmware sul server FTP/HTTP(S)
Passaggio 1: configurare un server FTP/HTTP(S) prima di utilizzare la funzione FOTA. (Quectel non fornisce tali server.)
Passaggio 2: dopo aver completato la configurazione del server, carica il pacchetto firmware sul server e salva il percorso di archiviazione.
2.3. Eseguire il comando AT per aggiornare il firmware
Dopo aver caricato il pacchetto firmware sul server FTP/HTTP(S), eseguire AT+QFOTADL sull'host per avviare il download automatico over-the-air e l'aggiornamento del pacchetto firmware del modulo. Per maggiori dettagli sui comandi FOTA AT, vedere il Capitolo 3.3.
NOTA
Il modulo supporta gli aggiornamenti del firmware sia tramite il server FTP/HTTP(s) che tramite il server locale file sistema. Per maggiori informazioni sugli aggiornamenti del firmware tramite il sistema locale file sistema, vedere Capitolo 3.3.3.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
8 / 20
Serie di moduli LTE-A
3 Descrizione dei comandi AT FOTA
3.1. Introduzione al comando AT
3.1.1. Definizioni
Carattere di ritorno a capo.
Carattere di avanzamento riga.
<…> […]
Nome del parametro. Le parentesi angolari non compaiono sulla riga di comando. Parametro facoltativo di un comando o parte facoltativa della risposta informativa TA.
Le parentesi quadre non vengono visualizzate nella riga di comando. Quando un parametro facoltativo è
non specificato in un comando, il nuovo valore è uguale al suo valore precedente o al valore predefinito
impostazioni, salvo diversamente specificato.
Sottolineato Impostazione predefinita di un parametro.
3.1.2 Sintassi del comando AT
Tutte le righe di comando devono iniziare con AT o con e terminare con . Le risposte informative e i codici risultato iniziano e finiscono sempre con un carattere di ritorno a capo e un carattere di avanzamento riga: . Nelle tabelle che presentano i comandi e le risposte in questo documento, vengono presentati solo i comandi e le risposte, e e sono volutamente omessi.
Tabella 1: Tipi di comandi AT
Tipo di comando
Sintassi
Descrizione
Comando di prova
A+ =?
Leggi il comando
A+ ?
Verifica l'esistenza del comando corrispondente e restituisci informazioni sul tipo, valore o intervallo del relativo parametro.
Verificare il valore del parametro corrente del comando corrispondente.
Scrivi comando
A+ = [, [, […]]] Imposta il valore del parametro definibile dall'utente.
Comando di esecuzione AT+
Restituisce un parametro di informazione specifico o esegue un'azione specifica.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
9 / 20
Serie di moduli LTE-A
3.2. Dichiarazione del comando AT Examples
Il comando AT esampi le in questo documento sono forniti per aiutarvi ad apprendere l'uso dei comandi AT qui introdotti. L'exampLe, tuttavia, non dovrebbero essere prese come raccomandazioni o suggerimenti di Quectel su come progettare un flusso di programma o su quale stato impostare il modulo. A volte più esampi le possono essere forniti per un comando AT. Tuttavia, ciò non significa che esista una correlazione tra questi examples, o che dovrebbero essere eseguiti in una sequenza data. Il URLs, nomi di dominio, indirizzi IP, nomi utente/account e password (se presenti) nel comando AT es.ampI file sono forniti solo a scopo illustrativo ed esplicativo e devono essere modificati per riflettere l'utilizzo effettivo e le esigenze specifiche.
3.3. Aggiornamento firmware AT+QFOTADL tramite FOTA
Questo comando abilita l'aggiornamento automatico del firmware tramite FOTA. Dopo aver eseguito il comando corrispondente, il modulo scaricherà o caricherà automaticamente il pacchetto firmware dal server FTP/HTTP(S) o locale file sistema. Dopo che il pacchetto è stato scaricato o caricato correttamente, il modulo aggiornerà automaticamente il firmware e poi si riavvierà.
Aggiornamento firmware AT+QFOTADL tramite FOTA
Comando di prova AT+QFOTADL=?
Risposta OK
Tempo di risposta massimo
300 millisecondi
3.3.1. AT+QFOTADL=URL> Aggiorna il firmware tramite server FTP
Se il pacchetto firmware è archiviato su un server FTP, eseguire AT+QFOTADL=URL> per avviare l'aggiornamento automatico del firmware tramite FOTA. Il modulo scaricherà il pacchetto dal server FTP via etere, quindi riavvierà e aggiornerà il firmware automaticamente.
AT+QFOTADL=URL> Aggiorna il firmware tramite server FTP
Scrivi comando AT+QFOTADL=URL>
Risposta OK
+QIND: “FOTA”,”FTPSTART” +QIND: “FOTA”,”FTPEND”, +QIND: “FOTA”,”INIZIO” +QIND: “FOTA”,”AGGIORNAMENTO”, +QIND: “FOTA”,”AGGIORNAMENTO”, … +QIND: “FOTA”,”FINE”,
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
10 / 20
Serie di moduli LTE-A
Caratteristiche del tempo di risposta massimo
Se c'è qualche errore: ERRORE 300 ms
–
Parametro
<FTP_URL>
<serverURL>file_percorso>
Tipo di stringa. URL che il pacchetto firmware è memorizzato sul server FTP.
Dovrebbe iniziare con “ftp://”. La lunghezza massima è 512; Unità: byte.
Per esempioample: “ftp:// : @URL>: /file_percorso>”.
Tipo stringa. Il nome utente per l'autenticazione.
Tipo stringa. La password per l'autenticazione.
Tipo stringa. L'indirizzo del server FTP di tua proprietà e gestito da te.
Tipo intero. La porta del server FTP. Intervallo: 1. Predefinito: 65535.
Tipo di stringa. file nome sul server FTP.
Tipo intero. Il codice di errore FTP.
0
Scaricato correttamente il pacchetto firmware dal server FTP.
Altri Impossibile scaricare il pacchetto firmware dal server FTP.
Vedere il capitolo 5 per i dettagli.
Tipo intero. Avanzamento dell'aggiornamento in percentualetage. Intervallo: 0.
Tipo intero. Codice di errore di aggiornamento.
0
Aggiornato il firmware con successo
Altri Impossibile aggiornare il firmware. Vedere il Capitolo 5 per maggiori dettagli.
Example
//È possibile eseguire l'aggiornamento del firmware dopo aver memorizzato il pacchetto firmware sul server FTP. "ftp://test:test@192.0.2.2:21/Jun/update-v12-to-v13.zip" viene utilizzato come esempioample URL sotto. (Il URL è fornito solo a scopo illustrativo. Si prega di sostituirlo con un valido URL che corrisponde al tuo server FTP e al pacchetto firmware.) Esegui il seguente comando per avviare l'aggiornamento automatico del firmware tramite FOTA. Il modulo scarica il pacchetto firmware e aggiorna automaticamente il firmware. AT+QFOTADL=”ftp://test:test@192.0.2.2:21/Jun/update-v12-to-v13.zip” OK
+QIND: “FOTA”,”FTPSTART” +QIND: “FOTA”,”FTPEND”,0
//Completare il download del pacchetto firmware dal server FTP.
//Il modulo si riavvia automaticamente e la porta USB viene reinizializzata. Se la porta corrente è una porta USB, MCU dovrebbe chiuderla e riaprirla. Dopo che il modulo è stato riavviato, il primo URC dovrebbe essere segnalato entro 90 secondi. Altrimenti, significa che si è verificato un errore sconosciuto. +QIND: “FOTA”,”START” +QIND: “FOTA”,”UPDATING”,1
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
11 / 20
Serie di moduli LTE-A
+QIND: “FOTA”,”AGGIORNAMENTO”,20 … +QIND: “FOTA”,”AGGIORNAMENTO”,100 +QIND: “FOTA”,”END”,0 //Il modulo si riavvia automaticamente per completare l'aggiornamento FOTA.
3.3.2. AT+QFOTADL=URL> Aggiorna il firmware tramite server HTTP(S)
Se il pacchetto firmware è archiviato su un server HTTP(S), eseguire AT+QFOTADL=URL> per avviare l'aggiornamento automatico del firmware tramite FOTA. Il modulo scaricherà il pacchetto dal server HTTP(S) via etere, quindi riavvierà e aggiornerà il firmware automaticamente.
AT+QFOTADL=URL> Aggiorna il firmware tramite server HTTP(S)
Scrivi comando AT+QFOTADL=URL>
Risposta OK
+QIND: “FOTA”,”HTTPSTART” +QIND: “FOTA”,”HTTPEND”, +QIND: “FOTA”,”INIZIO” +QIND: “FOTA”,”AGGIORNAMENTO”, +QIND: “FOTA”,”AGGIORNAMENTO”, … +QIND: “FOTA”,”FINE”,
Caratteristiche del tempo di risposta massimo
Se c'è qualche errore: ERRORE 300 ms
–
Parametro
<HTTP_URL>
<HTTP_server_URL>file_percorso>
Tipo di stringa. URL che il pacchetto firmware è memorizzato su HTTP(S)
server. La lunghezza massima è 512; Unità: byte.
Dovrebbe iniziare con “http(s)://”. Per esempioampon:
"http://URL>: /file_percorso>”.
Tipo stringa. L'indirizzo IP o il nome di dominio del server HTTP(S) di proprietà
e gestito da te.
Tipo intero. La porta del server HTTP(S). Intervallo: 1. Predefinito: 65535.
Tipo di stringa. file nome sul server HTTP(S).
Tipo intero. Codice di errore HTTP(S).
0
Scaricato il pacchetto firmware dal server HTTP(S)
con successo
Altri Impossibile scaricare il pacchetto firmware dal server HTTP(S).
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
12 / 20
Serie di moduli LTE-A
Vedere il capitolo 5 per i dettagli.
Tipo intero. Avanzamento dell'aggiornamento in percentualetage. Intervallo: 0.
Tipo intero. Codice di errore di aggiornamento.
0
Aggiornato il firmware con successo
Altri Impossibile aggiornare il firmware. Vedere il Capitolo 5 per maggiori dettagli.
Example
//È possibile eseguire l'aggiornamento del firmware dopo aver memorizzato il pacchetto firmware sul server HTTP(S). “http://www.example.com:100/update.zip” viene utilizzato come esempioample URL sotto. (Il URL è fornito solo a scopo illustrativo. Si prega di sostituirlo con un valido URL che corrisponde al tuo server HTTP(S) e al pacchetto firmware.) Esegui il seguente comando per avviare l'aggiornamento automatico del firmware tramite FOTA. Il modulo scarica il pacchetto firmware e aggiorna il firmware automaticamente. AT+QFOTADL=”http://www.example.com:100/update.zip” OK
+QIND: “FOTA”,”HTTPSTART” +QIND: “FOTA”,”HTTPEND”,0 //Termina il download del pacchetto firmware dal server HTTP.
//Il modulo si riavvia automaticamente e la porta USB viene reinizializzata. Se la porta corrente è una porta USB, MCU dovrebbe chiuderla e riaprirla. Dopo il riavvio del modulo, il primo URC dovrebbe essere segnalato entro 90 secondi. Altrimenti, significa che si è verificato un errore sconosciuto. +QIND: “FOTA”,”START” +QIND: “FOTA”,”UPDATING”,1 +QIND: “FOTA”,”UPDATING”,2 … +QIND: “FOTA”,”UPDATING”,100 +QIND: “FOTA”,”END”,0 //Il modulo si riavvia automaticamente per completare l'aggiornamento FOTA.
3.3.3. AT+QFOTADL=file_name> Aggiorna firmware in locale File Sistema
Se il pacchetto firmware è già stato memorizzato nel modulo file sistema, esegui AT+QFOTADL=file_name> per avviare l'aggiornamento automatico del firmware tramite FOTA. Quindi il modulo caricherà il pacchetto dal locale file sistema, quindi riavviarlo e aggiornare il firmware automaticamente.
AT+QFOTADL=file_name> Aggiorna firmware in locale File Sistema
Scrivi comando AT+QFOTADL=file_nome>
Risposta OK
+QIND: “FOTA”,”INIZIO” +QIND: “FOTA”,”AGGIORNAMENTO”, +QIND: “FOTA”,”AGGIORNAMENTO”, …
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
13 / 20
Caratteristiche del tempo di risposta massimo
Serie di moduli LTE-A
+QIND: “FOTA”, “FINE”,
Se c'è qualche errore: ERRORE 300 ms –
Parametro
<file_nome>
Tipo stringa. Il percorso degli archivi del pacchetto firmware sul locale file sistema.
La lunghezza massima è 512; Unità: byte. Dovrebbe essere avviato con “/cache/ufs/” in
Unità di elaborazione dati (UFS).
Tipo intero. Avanzamento dell'aggiornamento in percentualetage. Intervallo: 0.
Tipo intero. Codice di errore di aggiornamento.
0
Aggiornato il firmware con successo
Altri Impossibile aggiornare il firmware. Vedere il Capitolo 5 per maggiori dettagli.
NOTA
1. Prima di usare questo comando, assicurati che il pacchetto firmware sia memorizzato nel modulo. Puoi caricare il pacchetto sul modulo tramite AT+QFUPL. Per i dettagli di AT+QFUPL, vedi il documento [1].
2. Prima di procedere con l'aggiornamento FOTA, disconnettere la chiamata dati dell'host, perché quando l'host esegue una chiamata dati con il modulo, il programma di aggiornamento FOTA interno del modulo non è in grado di eseguire la chiamata dati.
3. Il primo APN viene utilizzato per la chiamata dati durante l'aggiornamento FOTA per impostazione predefinita. Se la chiamata dati con il primo APN è occupata da un programma del modulo, il modulo non può utilizzare questo APN per eseguire altre chiamate dati contemporaneamente. Pertanto, il modulo dovrebbe eseguire l'aggiornamento FOTA dopo che il programma disconnette la chiamata dati con questo APN o dopo aver eseguito AT+QFOTAPID per cambiare canale.
4. Se la certificazione Verizon utilizza il primo APN per eseguire chiamate dati, si consiglia di utilizzare AT+QFOTAPID per cambiare canale per l'aggiornamento FOTA.
5. Per i dettagli su AT+QFOTAPID, contattare il supporto tecnico Quectel.
Example
//Aggiorna il firmware quando il pacchetto firmware è archiviato sul disco locale file sistema. AT+QFOTADL="/cache/ufs/update-v12-to-v13.zip" OK
//Il modulo si riavvia automaticamente e la porta USB viene reinizializzata. Se la porta corrente è una porta USB, MCU dovrebbe chiuderla e riaprirla. Dopo che il modulo è stato riavviato, il primo URC dovrebbe essere segnalato entro 90 secondi. Altrimenti, significa che si è verificato un errore sconosciuto. +QIND: “FOTA”,”START”
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
14 / 20
Serie di moduli LTE-A
+QIND: “FOTA”,”AGGIORNAMENTO”,1
+QIND: “FOTA”,”AGGIORNAMENTO”,2
…
+QIND: “FOTA”,”AGGIORNAMENTO”,100
+QIND: “FOTA”, “FINE”,0
//Il modulo si riavvia automaticamente per completare l'aggiornamento FOTA.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
15 / 20
Serie di moduli LTE-A
4 Gestione delle eccezioni e precauzioni
4.1. Gestione delle eccezioni
Per migliorare il tasso di successo dell'aggiornamento, il modulo imposterà il flag di aggiornamento prima di avviare l'aggiornamento. Quando viene segnalato un errore durante l'aggiornamento, il modulo si riavvia automaticamente. Dopo che il flag di aggiornamento viene trovato, il modulo continuerà ad aggiornare. Se l'aggiornamento fallisce per cinque volte consecutive, l'aggiornamento è un fallimento completo e il modulo eliminerà il flag, uscirà e proverà ad avviare il modulo normalmente. L'interfaccia di aggiornamento è la seguente:
+QIND: “FOTA”,”INIZIO” +QIND: “FOTA”,”AGGIORNAMENTO”,20 +QIND: “FOTA”,”FINE”, … //Il modulo si riavvia automaticamente … +QIND: “FOTA”,”START” +QIND: “FOTA”,”UPDATING”,20 +QIND: “FOTA”,”UPDATING”,30 … +QIND: “FOTA”,”END”,0
NOTA I tempi di aggiornamento consecutivi sono validi solo quando viene segnalato un errore di aggiornamento, mentre non c'è limite al numero di aggiornamenti in caso di interruzione di corrente anomala. Se si verifica un'interruzione di corrente anomala durante il processo di aggiornamento del modulo, l'aggiornamento può continuare anche dopo il riavvio del modulo. Dopo che l'aggiornamento è riuscito, anche il flag di aggiornamento verrà eliminato.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
16 / 20
Serie di moduli LTE-A
4.2. Precauzioni
1. Dopo l'esecuzione di AT+QFOTADL, l'host riceve URC +QIND: “FOTA”,”START” che significa che l'aggiornamento inizia, e URC +QIND: “FOTA”,”END”,0 significa che l'aggiornamento è completato. Dopo l'aggiornamento, il modulo si riavvia automaticamente ed entra in modalità normale. Non spegnere il modulo durante l'aggiornamento.
2. Se l'host non riceve alcun URC entro 4 minuti durante il processo di aggiornamento, è possibile riavviare il modulo.
3. Si consiglia di impostare un flag per contrassegnare l'attività di aggiornamento del firmware e di rimuoverlo una volta completato correttamente l'aggiornamento.
NOTA
Si consiglia di non spegnere il modulo durante il processo di aggiornamento FOTA.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
17 / 20
Serie di moduli LTE-A
5 Riepilogo dei codici di errore
Questo capitolo presenta i codici di errore relativi ai moduli Quectel o alla rete. I dettagli su , E sono descritti nelle tabelle seguenti.
Tabella 2: Riepilogo di Codici
Numerico 0 601
Carattere Scaricato correttamente il pacchetto firmware dal server FTP Errore FTP sconosciuto
Tabella 3: Riepilogo di Codici
Numerico 0 701
Carattere Scaricato correttamente il pacchetto firmware dal server HTTP(S) Impossibile scaricare il pacchetto firmware dal server HTTP(S)
Tabella 4: Riepilogo di Codici
Numerico 0 502 504 505 510 511
Carattere
Aggiornato il firmware con successo Il processo di aggiornamento termina a causa di alcuni errori o eccezioni sconosciuti. Il sistema riproverà cinque volte. Formato zip non corretto
Il progetto o la versione del pacchetto non corrispondono al pacchetto firmware file non corrisponde al pacchetto sorgente file del modulo, e deve essere controllato se è sbagliato. Il file il sistema non ha abbastanza spazio per l'aggiornamento.
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
18 / 20
520 530
550
Serie di moduli LTE-A
Aggiornamento del firmware non riuscito. Il modulo si riavvierà e riproverà ad aggiornare il firmware finché l'aggiornamento non avrà esito positivo. Il pacchetto firmware è troppo grande
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
19 / 20
Serie di moduli LTE-A
6 Appendice Riferimenti
Tabella 5: Documenti correlati Nome del documento [1] Quectel_EM12&EG12&EG18_Series_FILE_Nota applicativa
Tabella 6: Termini e abbreviazioni
Abbreviazione FOTA FTP GPRS GSM HTTP(S) IP LTE MCU TA UFS URC URL USB-C
Descrizione Firmware Over-The-Air File Protocollo di trasferimento Servizio radio a pacchetto generale Sistema globale per comunicazioni mobili Protocollo di trasferimento ipertestuale (sicuro/su Secure Socket Layer) Protocollo Internet (evoluzione a lungo termine) uno standard di comunicazioni mobili 4G Unità microcontrollore Adattatore terminale Utente File Sistema Codice risultato non richiesto Localizzatore risorse uniforme/universale Bus seriale universale Codice a banda larga Divisione accesso multiplo
EM12&EG12&EG18_Series_FOTA_Upgrade_Guida
20 / 20
Documenti / Risorse
 | Modulo cellulare EM12 |
Riferimenti
- Manuale d'usomanual.tools