EM12 cellulært modul

Produktinformation

Specifikationer

• Produktnavn: EM12&EG12&EG18 Series LTE-A-modul
• Version: 1.1
• Dato: 2024-09-25
• Status: Udgivet

Produktbrugsvejledning

Kontaktoplysninger

Hvis du har brug for hjælp, bedes du kontakte Quectel
hovedkvarter på følgende adresse:

Bygning 5, Shanghai Business Park fase III (område B), nr. 1016
Tianlin Road, Minhang District, Shanghai 200233, Kina

Tlf.: +86 21 5108 6236

E-mail: info@quectel.com

Teknisk support

For teknisk support eller for at rapportere dokumentationsfejl, besøg:
Teknisk
Støtte

E-mail: support@quectel.com

Privatlivspolitik

Modulfunktionalitet kan involvere dataupload til Quectels eller
tredjeparts servere. Databehandling er underlagt relevant lovgivning
og regler. Før deling af data med tredjeparter, vedrview
deres privatlivspolitikker.

Ansvarsfraskrivelse

Quectel fraskriver sig ansvar for skader eller skader, der opstår
fra tillid til de oplyste oplysninger. Nøjagtigheden af ​​oplysninger er
ikke garanteret; brugere rådes til at verificere detaljer
selvstændigt.

FAQ

Sp: Hvordan kan jeg opdatere firmwaren på mit LTE-A-modul?

A: Firmwareopgraderingsinstruktioner er beskrevet i FOTA
Opgraderingsvejledning. Følg trinene beskrevet i kapitel 2 for at opgradere
firmwaren.

Q: Hvad skal jeg gøre, hvis jeg støder på tekniske problemer med
LTE-A modul?

A: For teknisk support, kontakt Quectels supportteam via
e-mail på support@quectel.com eller besøg den tekniske supportside på
Quectel webwebsted.

EM12&EG12&EG18 Series FOTA-opgraderingsvejledning
LTE-A Module Series Version: 1.1 Dato: 2024-09-25 Status: Frigivet

LTE-A-modulserien
Hos Quectel er vores mål at levere rettidig og omfattende service til vores kunder. Hvis du har brug for hjælp, bedes du kontakte vores hovedkvarter:
Quectel Wireless Solutions Co., Ltd. Bygning 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, Kina Tlf.: +86 21 5108 6236 E-mail: info@quectel.com
Eller vores lokale kontorer. For mere information, besøg venligst: http://www.quectel.com/support/sales.htm.
For teknisk support eller for at rapportere dokumentationsfejl, besøg venligst: http://www.quectel.com/support/technical.htm. Eller e-mail os på: support@quectel.com.
Juridiske meddelelser
Vi tilbyder information som en service til dig. De angivne oplysninger er baseret på dine krav, og vi gør alt for at sikre kvaliteten. Du accepterer, at du er ansvarlig for at bruge uafhængig analyse og evaluering til at designe påtænkte produkter, og vi leverer referencedesigns kun til illustrative formål. Før du bruger hardware, software eller service, der er styret af dette dokument, bedes du læse denne meddelelse omhyggeligt. Selvom vi anvender kommercielt rimelige bestræbelser på at give den bedst mulige oplevelse, anerkender og accepterer du hermed, at dette dokument og relaterede tjenester herunder leveres til dig på en "som tilgængelig" basis. Vi kan revidere eller gentage dette dokument fra tid til anden efter eget skøn uden forudgående varsel til dig.
Brugs- og offentliggørelsesbegrænsninger
Licensaftaler
Dokumenter og oplysninger leveret af os skal holdes fortrolige, medmindre der gives specifik tilladelse. De må ikke tilgås eller bruges til noget formål, undtagen som udtrykkeligt angivet heri.
Copyright
Vores og tredjepartsprodukter herunder kan indeholde ophavsretligt beskyttet materiale. Sådant ophavsretligt beskyttet materiale må ikke kopieres, reproduceres, distribueres, flettes sammen, offentliggøres, oversættes eller ændres uden forudgående skriftlig tilladelse. Vi og tredjeparten har eksklusive rettigheder over ophavsretligt beskyttet materiale. Ingen licens må gives eller overdrages under nogen patenter, ophavsrettigheder, varemærker eller servicemærkerettigheder. For at undgå tvetydigheder, købasing i nogen form kan ikke anses for at give en anden licens end den normale ikke-eksklusive, royaltyfrie licens til at bruge materialet. Vi forbeholder os retten til at anlægge sag ved manglende overholdelse af ovennævnte krav, uautoriseret brug eller anden ulovlig eller ondsindet brug af materialet.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

1/20

LTE-A-modulserien

Varemærker
Medmindre andet er angivet heri, skal intet i dette dokument fortolkes som at give nogen rettigheder til at bruge et varemærke, handelsnavn eller navn, forkortelse eller forfalsket produkt deraf, der ejes af Quectel eller nogen tredjepart i reklamer, reklame eller andre aspekter.
Tredjeparts rettigheder
Dette dokument kan henvise til hardware, software og/eller dokumentation ejet af en eller flere tredjeparter ("tredjepartsmaterialer"). Brug af sådanne tredjepartsmaterialer er underlagt alle restriktioner og forpligtelser, der gælder herfor.
Vi giver ingen garanti eller repræsentation, hverken udtrykkelig eller underforstået, vedrørende tredjepartsmaterialer, inklusive men ikke begrænset til underforståede eller lovbestemte, garantier for salgbarhed eller egnethed til et bestemt formål, stille nydelse, systemintegration, informationsnøjagtighed og ikke - krænkelse af tredjeparts intellektuelle ejendomsrettigheder med hensyn til den licenserede teknologi eller brugen heraf. Intet heri udgør en repræsentation eller garanti fra os for hverken at udvikle, forbedre, ændre, distribuere, markedsføre, sælge, udbyde til salg eller på anden måde opretholde produktionen af ​​vores produkter eller anden hardware, software, enhed, værktøj, information eller produkt . Vi fraskriver os desuden enhver garanti, der opstår i forbindelse med handel eller brug af handel.
Privatlivspolitik
For at implementere modulfunktionalitet uploades visse enhedsdata til Quectels eller tredjeparts servere, herunder transportører, chipsetleverandører eller kundeudpegede servere. Quectel skal nøje overholde de relevante love og regler, opbevare, bruge, videregive eller på anden måde behandle relevante data med det formål kun at udføre tjenesten eller som tilladt i henhold til gældende love. Før datainteraktion med tredjeparter, bedes du informeres om deres privatlivs- og datasikkerhedspolitik.
Ansvarsfraskrivelse
a) Vi anerkender intet ansvar for skader eller skader, der opstår som følge af tilliden til oplysningerne. b) Vi påtager os intet ansvar som følge af unøjagtigheder eller udeladelser eller fra brugen af
information indeholdt heri. c) Mens vi har gjort alt for at sikre, at de funktioner og funktioner, der er under udvikling
fri for fejl, er det muligt, at de kan indeholde fejl, unøjagtigheder og udeladelser. Medmindre andet er angivet i en gyldig aftale, giver vi ingen garantier af nogen art, hverken underforståede eller udtrykkelige, og udelukker ethvert ansvar for tab eller skade, der er lidt i forbindelse med brugen af ​​funktioner og funktioner under udvikling, i det maksimale omfang, loven tillader, uanset om et sådant tab eller skade måtte have været forudsigelig. d) Vi er ikke ansvarlige for tilgængeligheden, sikkerheden, nøjagtigheden, tilgængeligheden, lovligheden eller fuldstændigheden af ​​oplysninger, reklamer, kommercielle tilbud, produkter, tjenester og materialer på tredjepart webwebsteder og tredjepartsressourcer.
Copyright © Quectel Wireless Solutions Co., Ltd. 2024. Alle rettigheder forbeholdes.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

2/20

LTE-A-modulserien

Om dokumentet

Revisionshistorie

Versionsdato

Forfatter

Beskrivelse

–

2023-03-21 Monan TIAN Oprettelse af dokumentet

1.0

2023-05-18 Monan TIAN Første officielle frigivet

1. Opdaterede dokumentnavnet fra "Application Note" til

"Opgraderingsvejledning".

2. Tilføjet kapitlet om FOTA implementering og bruger

ansvar (kapitel 1.1).

3. Optimerede flowchartet til FOTA firmwareopgradering til

skelne mellem brugersiden og Quectel-siden

(Figur 1).

4. Optimeret beskrivelsen af ​​FOTA-firmwareopgraderingen

trin og tilføjede relevante noter til at skelne imellem

brugersiden og Quectel-siden (kapitel 2).

1.1

2024-09-25 Monan TIAN

5. Opdaterede erklæringen om AT-kommando examples

(Kapitel 3.2).

6. Optimeret forklaringen afURL>

parameter og opdateret URL adresse og relaterede

instruktioner i kommandoen example (kapitel 3.3.1).

7. Optimeret forklaringen afURL>

parameter og opdateret URL adresse og relaterede

instruktioner i kommandoen example (kapitel 3.3.2).

8. Opdateret beskrivelse og note af

AT+QFOTADL=file_navn> (Kapitel 3.3.3).

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

3/20

LTE-A-modulserien
Indhold
Om dokumentet ………………………………………………………………………………………………………………………………….. 3 Indhold …………………………………………………………………………………………………………………………………………………………. 4 Tabelindeks……………………………………………………………………………………………………………………………………………………… 5
1 Indledning ………………………………………………………………………………………………………………………………………… 6 1.1. FOTA-implementering og brugeransvar ……………………………………………………………………….. 6
2 Firmwareopgraderingsprocedure over FOTA …………………………………………………………………………………………. 7 2.1. Hent firmwarepakke ………………………………………………………………………………………………………… 8 2.2. Upload firmwarepakke til FTP/HTTP(S)-server ………………………………………………………………… 8 2.3. Udfør AT-kommando for at opgradere firmwaren ………………………………………………………………….. 8
3 Beskrivelse af FOTA AT-kommandoer …………………………………………………………………………………………………. 9 3.1. AT Command Introduktion …………………………………………………………………………………………………………. 9 3.1.1. Definitioner………………………………………………………………………………………………………………………. 9 3.1.2. AT-kommandosyntaks …………………………………………………………………………………………………………. 9 3.2. Erklæring fra AT-kommando Eksamples ………………………………………………………………………………… 10 3.3. AT+QFOTADL-firmwareopgradering via FOTA ………………………………………………………………………. 10 3.3.1. AT+QFOTADL=URL> Opgrader firmware over FTP-server ………………………. 10 3.3.2. AT+QFOTADL=URL> Opgrader firmware over HTTP(S)-server ……………… 12 3.3.3. AT+QFOTADL=file_name> Opgrader firmware over lokal File System ………… 13
4 Undtagelseshåndtering og forholdsregler …………………………………………………………………………………………………. 16 4.1. Undtagelseshåndtering …………………………………………………………………………………………………………………. 16 4.2. Forholdsregler ………………………………………………………………………………………………………………. 17
5 Oversigt over fejlkoder ………………………………………………………………………………………………………………… 18
6 Bilag Referencer ………………………………………………………………………………………………………………… 20

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

4/20

LTE-A-modulserien
Tabelindeks
Tabel 1: Typer af AT-kommandoer ………………………………………………………………………………………………………….. 9 Tabel 2: Sammenfatning af Koder ………………………………………………………………………………………………. 18 Tabel 3: Sammenfatning af Koder …………………………………………………………………………………………………. 18 Tabel 4: Sammenfatning af Koder ………………………………………………………………………………………………………. 18 Tabel 5: Relaterede dokumenter ………………………………………………………………………………………………………………………. 20 Tabel 6: Udtryk og forkortelser ……………………………………………………………………………………………………………….. 20

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

5/20

LTE-A-modulserien
1 Indledning
Quectel LTE-A EM12-G-, EG12- og EG18-seriens moduler understøtter FOTA-funktionen (Firmware Over-The-Air) til at opgradere firmwaren på partitioner såsom modem, system og boot. Med denne funktion kan du (brugeren) opgradere modulets firmware til en ny version eller gendanne firmwaren til en gammel version. Firmwarepakken indeholder kun forskellen mellem den originale firmwareversion og målfirmwareversionen, med mængden af ​​datatransmission stærkt reduceret og transmissionstiden stærkt forkortet.
1.1. FOTA Implementering og Brugeransvar
Quectel følger industriens bedste praksis med hensyn til firmwareopdateringer til sine moduler ved at gøre det muligt for brugere at tilbyde FOTA-opdateringer. Bemærk venligst, at Quectel ikke har mulighed for ensidigt at skubbe opdateringer til brugernes enheder. Quectel giver brugerne fuld kontrol over FOTA-processen. I processen leverer Quectel udelukkende den opdaterede firmware, men kan ikke starte FOTA-opdateringer på brugernes enheder. Brugere kan bestemme, hvornår de skal skubbe opdateringen til Quectel-modulerne ved hjælp af FOTA-mekanismen ved at konfigurere tilsvarende parametre for den opdatering, som brugerne hoster på deres egen infrastruktur.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

6/20

LTE-A-modulserien

2 Firmwareopgraderingsprocedure overstået
FOTA

Følgende diagram illustrerer firmwareopgraderingsproceduren via FOTA, når firmwarepakken er gemt på en FTP/HTTP(S)-server.

Brugerside

Brugerens vært

2. Upload firmwarepakken fra værten til den brugerejede FTP/HTTP(S)-server

Brugerejet FTP/HTTP(S)
server

1. Hent firmwarepakken fra Quectels tekniske support.

3. Send AT+QFOTADL på værten for at udløse automatisk firmwareopgradering på modulet.

LTE/WCDMA

Quectel firmwarepakke
Quectel Side

4. Quectel-modulet downloader automatisk firmwarepakken fra den brugerejede FTP/HTTP(S)-server via LTE/WCDMA-netværk.
Quectel modul
5. Opgrader automatisk modulets firmware.

Figur 1: Firmwareopgraderingsprocedure via FOTA
Som vist i ovenstående figur skal følgende trin udføres for at opdatere firmwaren, når firmwarepakken er gemt på en FTP/HTTP(S)-server:
Trin 1: Hent firmwarepakken fra Quectels tekniske support (se kapitel 2.1 for detaljer). Trin 2: Upload firmwarepakken fra værten til din FTP/HTTP(S)-server (se kapitel 2.2 for
detaljer).

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

7/20

LTE-A-modulserien
Trin 3: Udfør AT+QFOTADL på værten for at udløse automatisk firmwareopgradering på modulet (se kapitel 2.3 for detaljer).
Trin 4: Modulet downloader automatisk firmwarepakken fra din FTP/HTTP(S)-server via LTE/WCDMA-netværk.
Trin 5: Modulet kører internt opdateringsprogrammet for automatisk at opgradere modulets firmware.
NOTE
Du er ansvarlig for at levere og administrere FTP/HTTP(S)-serveren til firmwareopgraderingen. Quectel leverer ikke serveren eller hjælper med opsætningen af ​​den.
2.1. Hent firmwarepakke
Før firmwareopgradering, skal du kontrollere det originale firmwareversionsnavn med ATI og bekræfte den ønskede firmwareversion, og derefter sende de to firmwareversioner til Quectel Technical Support for at få den tilsvarende firmwarepakke.
2.2. Upload firmwarepakke til FTP/HTTP(S)-server
Trin 1: Konfigurer venligst en FTP/HTTP(S)-server, før du bruger FOTA-funktionen. (Quectel leverer ikke sådanne servere.)
Trin 2: Når du har fuldført serveropsætningen, skal du uploade firmwarepakken til din server og gemme lagerstien.
2.3. Udfør AT-kommando for at opgradere firmwaren
Efter upload af firmwarepakken til FTP/HTTP(S)-serveren skal du udføre AT+QFOTADL på værten for at starte den automatiske over-the-air download og opgradering af modulets firmwarepakke. For flere detaljer om FOTA AT-kommandoer, se kapitel 3.3.
NOTE
Modulet understøtter firmwareopgraderinger via både FTP/HTTP(r)-serveren og den lokale file system. For mere information om firmwareopgraderingerne via den lokale file system, se kapitel 3.3.3.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

8/20

LTE-A-modulserien

3 Beskrivelse af FOTA AT-kommandoer

3.1. AT-kommando introduktion

3.1.1. Definitioner

Karakter for returvogn.

Linjefremføringstegn.

<…> […]

Parameternavn. Vinkelparenteser vises ikke på kommandolinjen. Valgfri parameter for en kommando eller en valgfri del af TA-informationssvar.

Firkantede parenteser vises ikke på kommandolinjen. Når en valgfri parameter er

ikke givet i en kommando, er den nye værdi lig med dens tidligere værdi eller standardværdien

indstillinger, medmindre andet er angivet.

Understreget Standardindstilling af en parameter.

3.1.2. AT kommandosyntaks
Alle kommandolinjer skal starte med AT eller ved og slutte med . Informationssvar og resultatkoder starter og slutter altid med et vognreturtegn og et linjeskifttegn: . I tabeller, der præsenterer kommandoer og svar i hele dette dokument, er kun kommandoerne og svarene præsenteret, og og er bevidst udeladt.

Tabel 1: Typer af AT-kommandoer

Kommandotype

Syntaks

Beskrivelse

Test kommando

AT+ =?

Læs kommando

AT+ ?

Test eksistensen af ​​den tilsvarende kommando og returner information om typen, værdien eller området for dens parameter.
Kontroller den aktuelle parameterværdi for den tilsvarende kommando.

Skriv kommando

AT+ = [, [, […]]] Indstil brugerdefinerbar parameterværdi.

Udførelseskommando AT+

Returner en specifik informationsparameter eller udfør en specifik handling.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

9/20

LTE-A-modulserien
3.2. Erklæring fra AT-kommando Eksamples
AT-kommandoen exampfilerne i dette dokument er tilvejebragt for at hjælpe dig med at lære om brugen af ​​AT-kommandoer introduceret heri. Eksamples skal dog ikke opfattes som Quectels anbefalinger eller forslag til, hvordan man designer et programflow eller hvilken status man skal sætte modulet i. Nogle gange flere examples kan leveres til én AT-kommando. Det betyder dog ikke, at der er en sammenhæng mellem disse examples, eller at de skal udføres i en given rækkefølge. De URLs, domænenavne, IP-adresser, brugernavne/konti og adgangskoder (hvis nogen) i AT-kommandoen f.eks.ampfiler er kun givet til illustrative og forklarende formål, og de bør modificeres, så de afspejler dit faktiske brug og specifikke behov.

3.3. AT+QFOTADL Firmwareopgradering via FOTA

Denne kommando aktiverer automatisk firmwareopgradering via FOTA. Efter at have udført den tilsvarende kommando, vil modulet automatisk downloade eller indlæse firmwarepakken fra FTP/HTTP(S) server eller lokal file system. Efter at pakken er blevet downloadet eller indlæst, opgraderer modulet automatisk firmwaren og genstarter derefter.

AT+QFOTADL Firmwareopgradering via FOTA

Test kommando AT+QFOTADL=?

Svar OK

Maksimal responstid

300 ms

3.3.1. AT+QFOTADL=URL> Opgrader firmware over FTP-server

Hvis firmwarepakken er gemt på en FTP-server, skal du udføre AT+QFOTADL=URL> for at starte automatisk firmwareopgradering via FOTA. Modulet vil downloade pakken fra FTP-serveren trådløst og derefter genstarte og opgradere firmwaren automatisk.

AT+QFOTADL=URL> Opgrader firmware over FTP-server

Skriv kommando AT+QFOTADL=URL>

Svar OK

+QIND: "FOTA","FTPSTART" +QIND: "FOTA","FTPEND", +QIND: "FOTA","START" +QIND: "FOTA","OPDATERING", +QIND: "FOTA","OPDATERING", … +QIND: “FOTA”,,”END”,

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

10/20

LTE-A-modulserien

Karakteristika for maksimal responstid

Hvis der er nogen fejl: FEJL 300 ms
–

Parameter

<FTP_URL>
<serverURL>file_sti>

String type. De URL at firmwarepakken er gemt på FTP-serveren.

Det skal startes med "ftp://". Den maksimale længde er 512; Enhed: byte.

F.eksample: "ftp:// : @URL>: /file_sti>".

String type. Brugernavnet til godkendelse.

String type. Adgangskoden til godkendelse.

String type. Adressen på den FTP-server, der ejes og drives af dig.

Heltalstype. Porten på FTP-serveren. Rækkevidde: 1. Standard: 65535.

String type. De file navn på FTP-server.

Heltalstype. FTP-fejlkoden.

0

Downloadede firmwarepakken fra FTP-serveren med succes.

Andre Kunne ikke downloade firmwarepakken fra FTP-serveren.

Se kapitel 5 for detaljer.

Heltalstype. Opgraderingen fremskridt i procenttage. Rækkevidde: 0.

Heltalstype. Fejlkode ved opgradering.

0

Opgraderet firmwaren med succes

Andre Kunne ikke opgradere firmwaren. Se kapitel 5 for flere detaljer.

Example

//Du kan udføre firmwareopgraderingen efter at have gemt firmwarepakken på din FTP-server. "ftp://test:test@192.0.2.2:21/Jun/update-v12-to-v13.zip" bruges som eks.ample URL under. (De URL er kun givet til illustrative formål. Udskift det med en gyldig URL der svarer til din FTP-server og firmwarepakke.) Udfør følgende kommando for at starte automatisk firmwareopgradering via FOTA. Modulet downloader firmwarepakken og opgraderer firmwaren automatisk. AT+QFOTADL=”ftp://test:test@192.0.2.2:21/Jun/update-v12-to-v13.zip” OK

+QIND: “FOTA”,,”FTPSTART” +QIND: “FOTA”,,”FTPEND”,0

//Afslut download af firmwarepakken fra FTP-serveren.

//Modulet genstarter automatisk, og USB-porten geninitialiseres. Hvis den aktuelle port er USB-port, bør MCU lukke og genåbne den. Efter at modulet er genstartet, skal den første URC rapporteres inden for 90 sekunder. Ellers betyder det, at der opstår en ukendt fejl. +QIND: “FOTA”,,”START” +QIND: “FOTA”,,”OPDATERING”,1

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

11/20

LTE-A-modulserien
+QIND: “FOTA”,,”UPDATING”,20 … +QIND: “FOTA”,,”UPDATING”,100 +QIND: “FOTA”,,”END”,0 //Modulet genstarter automatisk for at fuldføre FOTA-opgraderingen.

3.3.2. AT+QFOTADL=URL> Opgrader firmware over HTTP(S)-server

Hvis firmwarepakken er gemt på en HTTP(S)-server, skal du udføre AT+QFOTADL=URL> for at starte automatisk firmwareopgradering via FOTA. Modulet vil downloade pakken fra HTTP(S)-serveren trådløst og derefter genstarte og opgradere firmwaren automatisk.

AT+QFOTADL=URL> Opgrader firmware over HTTP(S)-server

Skriv kommando AT+QFOTADL=URL>

Svar OK

+QIND: "FOTA","HTTPSTART" +QIND: "FOTA","HTTPEND", +QIND: "FOTA","START" +QIND: "FOTA","OPDATERING", +QIND: "FOTA","OPDATERING", … +QIND: “FOTA”,,”END”,

Karakteristika for maksimal responstid

Hvis der er nogen fejl: FEJL 300 ms
–

Parameter

<HTTP_URL>
<HTTP_server_URL>file_sti>

String type. De URL at firmwarepakken gemt på HTTP(S)

server. Den maksimale længde er 512; Enhed: byte.

Det skal startes med "http(s)://". F.eksampdet:

"http(s)://URL>: /file_sti>".

String type. IP-adressen eller domænenavnet på den HTTP(S)-server, der ejes

og drives af dig.

Heltalstype. Porten på HTTP(S)-serveren. Rækkevidde: 1. Standard: 65535.

String type. De file navn på HTTP(S)-serveren.

Heltalstype. HTTP(S) fejlkoden.

0

Downloadede firmwarepakken fra HTTP(S)-serveren

med succes

Andre Kunne ikke downloade firmwarepakken fra HTTP(S)-serveren.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

12/20

LTE-A-modulserien

Se kapitel 5 for detaljer.

Heltalstype. Opgraderingen fremskridt i procenttage. Rækkevidde: 0.

Heltalstype. Fejlkode ved opgradering.

0

Opgraderet firmwaren med succes

Andre Kunne ikke opgradere firmwaren. Se kapitel 5 for flere detaljer.

Example
//Du kan udføre firmwareopgraderingen efter at have gemt firmwarepakken på din HTTP(S)-server. "http://www.example.com:100/update.zip” bruges som example URL under. (De URL er kun givet til illustrative formål. Udskift det med en gyldig URL der svarer til din HTTP(S)-server og firmwarepakke.) Udfør følgende kommando for at starte automatisk firmwareopgradering via FOTA. Modulet downloader firmwarepakken og opgraderer firmwaren automatisk. AT+QFOTADL=”http://www.example.com:100/update.zip” OK
+QIND: “FOTA”,,”HTTPSTART” +QIND: “FOTA”,,”HTTPEND”,0 //Afslut download af firmwarepakken fra HTTP-serveren.
//Modulet genstarter automatisk, og USB-porten geninitialiseres. Hvis den aktuelle port er USB-port, bør MCU lukke og genåbne den. Efter at modulet er genstartet, skal den første URC rapporteres inden for 90 sekunder. Ellers betyder det, at der opstår en ukendt fejl. +QIND: “FOTA”,,”START” +QIND: “FOTA”,,”UPDATING”,1 +QIND: “FOTA”,,”UPDATING”,2 … +QIND: “FOTA”,,”UPDATING”,100 +QIND: “FOTA”,,”END”,0 //Modulet genstarter automatisk for at fuldføre FOTA-opgraderingen.

3.3.3. AT+QFOTADL=file_name> Opgrader firmware over lokal File System

Hvis firmwarepakken allerede er gemt i modulets file system, kør AT+QFOTADL=file_name> for at starte automatisk firmwareopgradering via FOTA. Så vil modulet indlæse pakken fra den lokale file system, og genstart og opgrader derefter firmwaren automatisk.

AT+QFOTADL=file_name> Opgrader firmware over lokal File System

Skriv kommando AT+QFOTADL=file_navn>

Svar OK

+QIND: "FOTA","START" +QIND: "FOTA","OPDATERING", +QIND: "FOTA","OPDATERING", …

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

13/20

Karakteristika for maksimal responstid

LTE-A-modulserien
+QIND: "FOTA","END",
Hvis der er nogen fejl: FEJL 300 ms –

Parameter

<file_navn>

String type. Stien til firmwarepakke gemmer på den lokale file system.

Den maksimale længde er 512; Enhed: byte. Det skal startes med "/cache/ufs/" i

UFS.

Heltalstype. Opgraderingen fremskridt i procenttage. Rækkevidde: 0.

Heltalstype. Fejlkode ved opgradering.

0

Opgraderet firmwaren med succes

Andre Kunne ikke opgradere firmwaren. Se kapitel 5 for flere detaljer.

NOTE
1. Før du bruger denne kommando, skal du sørge for, at firmwarepakken er gemt i modulet. Du kan uploade pakken til modulet gennem AT+QFUPL. For detaljer om AT+QFUPL, se dokument [1].
2. Afbryd venligst dataopkaldet for værten først, før du fortsætter med FOTA-opgraderingen, for når værten udfører dataopkald med modulet, forårsager det, at modulets interne FOTA-opgraderingsprogram ikke kan udføre dataopkald.
3. Det første APN bruges som standard til dataopkald under FOTA-opgradering. Hvis dataopkaldet med det første APN er optaget af et hvilket som helst program i modulet, kan modulet ikke bruge dette APN til at udføre andre dataopkald på samme tid. Derfor bør modulet udføre FOTA-opgradering, efter at programmet har afbrudt dataopkaldet med denne APN, eller efter at du har udført AT+QFOTAPID for at skifte kanal.
4. Hvis Verizon-certificering bruger det første APN til at udføre dataopkald, foreslås det at bruge AT+QFOTAPID til at skifte kanal til FOTA-opgradering.
5. For detaljer om AT+QFOTAPID, kontakt venligst Quectels tekniske support.

Example
//Opgrader firmware, når firmwarepakken er gemt på den lokale file system. AT+QFOTADL="/cache/ufs/update-v12-to-v13.zip" OK
//Modulet genstarter automatisk, og USB-porten geninitialiseres. Hvis den aktuelle port er USB-port, bør MCU lukke og genåbne den. Efter at modulet er genstartet, skal den første URC rapporteres inden for 90 sekunder. Ellers betyder det, at der opstår en ukendt fejl. +QIND: "FOTA","START"

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

14/20

LTE-A-modulserien

+QIND: “FOTA”,,”OPDATERING”,1

+QIND: “FOTA”,,”OPDATERING”,2

…

+QIND: “FOTA”,,”OPDATERING”,100

+QIND: “FOTA”,,”END”,0

//Modulet genstarter automatisk for at fuldføre FOTA-opgraderingen.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

15/20

LTE-A-modulserien
4 Undtagelseshåndtering og forholdsregler
4.1. Undtagelseshåndtering
For at forbedre succesraten for opgradering, vil modulet indstille opgraderingsflaget, før opgraderingen startes. Når der rapporteres en fejl under opgraderingen, genstartes modulet automatisk. Når opgraderingsflaget er fundet, vil modulet fortsætte med at opgradere. Hvis opgraderingen mislykkes i fem på hinanden følgende gange, er opgraderingen en komplet fejl, og modulet vil slette flaget, afslutte og forsøge at starte modulet normalt. Opgraderingsgrænsefladen er som følger:
+QIND: "FOTA","START" +QIND: "FOTA","UPDATING",20 +QIND: "FOTA","END", … //Modulet genstarter automatisk … +QIND: “FOTA”,,”START” +QIND: “FOTA”,,”UPDATING”,20 +QIND: “FOTA”,,”UPDATING”,30 … +QIND: “FOTA”,,”END”,0
BEMÆRK De fortløbende opgraderingstider er kun gyldige, når der rapporteres en opgraderingsfejl, mens der ikke er nogen grænse for antallet af opgraderinger i tilfælde af et unormalt strømsvigt. Hvis der opstår et unormalt strømsvigt under modulopgraderingsprocessen, kan opgraderingen også fortsætte, efter at modulet er genstartet. Når opgraderingen er vellykket, slettes opgraderingsflaget også.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

16/20

LTE-A-modulserien
4.2. Forholdsregler
1. Efter at AT+QFOTADL er udført, modtager værten URC +QIND: "FOTA","START", hvilket betyder, at opgraderingen begynder, og URC +QIND: "FOTA","END",0 betyder, at opgraderingen er fuldført. Efter opgraderingen genstarter modulet automatisk og går i normal tilstand. Sluk ikke for modulet under opgraderingen.
2. Hvis værten ikke modtager nogen URC inden for 4 minutter under opgraderingsprocessen, kan du genstarte modulet.
3. Det anbefales at konfigurere et flag for at markere firmwareopgraderingsopgaven og fjerne det, efter at opgraderingen er gennemført.
NOTE
Det anbefales ikke at slukke for modulet under FOTA-opgraderingsprocessen.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

17/20

LTE-A-modulserien

5 Oversigt over fejlkoder
Dette kapitel introducerer fejlkoderne relateret til Quectel-moduler eller netværk. Detaljerne vedr , og er beskrevet i de følgende tabeller.

Tabel 2: Sammenfatning af Koder

Numerisk 0 601

Karakter Downloadede firmwarepakken fra FTP-serveren med succes FTP Ukendt fejl

Tabel 3: Sammenfatning af Koder

Numerisk 0 701

Karakter Downloadede firmwarepakken fra HTTP(S)-serveren. Det lykkedes ikke at downloade firmwarepakken fra HTTP(S)-serveren

Tabel 4: Sammenfatning af Koder

Numerisk 0 502 504 505 510 511

Karakter
Opgraderet firmwaren med succes Opgraderingsprocessen afsluttes på grund af nogle ukendte fejl eller undtagelser. Systemet vil prøve igen fem gange. Forkert zip-format
Projektet eller versionen af ​​pakken matcher ikke Firmwarepakken file matcher ikke kildepakken file af modulet, og skal kontrolleres, hvis det er forkert. De file systemet har ikke plads nok til opgradering.

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

18/20

520 530
550

LTE-A-modulserien
Firmwareopgradering mislykkedes. Modulet genstarter og prøver at opgradere firmwaren igen, indtil opgraderingen er vellykket. Firmwarepakken er for stor

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

19/20

LTE-A-modulserien

6 Bilag Referencer

Tabel 5: Relaterede dokumenter Dokumentnavn [1] Quectel_EM12&EG12&EG18_Series_FILE_Ansøgning_Bemærk

Tabel 6: Begreber og forkortelser

Forkortelse FOTA FTP GPRS GSM HTTP(S) IP LTE MCU TA UFS URC URL USB WCDMA

Beskrivelse Firmware Over-The-Air File Overførselsprotokol General Packet Radio Service Globalt system til mobilkommunikation Hypertekstoverførselsprotokol (Secure/over Secure Socket Layer) Internetprotokol (Long-Term Evolution) en 4G mobilkommunikationsstandard Microcontroller Unit Terminal Adapter Bruger File System Uopfordret resultatkode Uniform/Universal Ressource Locator Universal Serial Bus Wideband Code Division Multiple Access

EM12&EG12&EG18_Series_FOTA_Upgrade_Guide

20/20

Dokumenter/ressourcer

QUECTEL EM12 mobilmodul [pdfBrugervejledning EM12, EG12, EG18, EM12 Cellular Module, Cellular Module, Module

Referencer

• Brugermanual