QDownloadProj Linux
Notendahandbók
LTE Standard Module Series
Útgáfa: 1.0
Dagsetning: 2024-03-25
Staða: Gefin út
LTE Standard Module Series
Hjá Quectel er markmið okkar að veita viðskiptavinum okkar tímanlega og alhliða þjónustu. Ef þú þarft einhverja aðstoð, vinsamlegast hafðu samband við höfuðstöðvar okkar:
Quectel Wireless Solutions Co., Ltd.
Bygging 5, Shanghai Business Park Phase III (svæði B), No.1016 Tianlin Road, Minhang District, Shanghai 200233, Kína
Sími: +86 21 5108 6236
Netfang: info@quectel.com
Eða skrifstofur okkar á staðnum. Fyrir frekari upplýsingar, vinsamlegast farðu á:
http://www.quectel.com/support/sales.htm.
Fyrir tæknilega aðstoð, eða til að tilkynna villur í skjölum, vinsamlegast farðu á:
http://www.quectel.com/support/technical.htm.
Eða sendu okkur tölvupóst á: support@quectel.com.
Lagalegar tilkynningar
Við bjóðum þér upplýsingar sem þjónustu. Upplýsingarnar sem gefnar eru eru byggðar á kröfum þínum og við leggjum okkur fram við að tryggja gæði þeirra. Þú samþykkir að þú ert ábyrgur fyrir því að nota óháða greiningu og mat við hönnun á fyrirhuguðum vörum og við útvegum tilvísunarhönnun eingöngu til skýringar. Áður en vélbúnaður, hugbúnaður eða þjónusta er notuð samkvæmt þessu skjali skaltu lesa þessa tilkynningu vandlega. Jafnvel þó að við gerum viðskiptalega sanngjarna viðleitni til að veita bestu mögulegu upplifun,
þú viðurkennir hér með og samþykkir að þetta skjal og tengd þjónusta hér að neðan er veitt þér á „eftir því sem við á“. Við kunnum að endurskoða eða endurrita þetta skjal af og til að eigin geðþótta án nokkurrar fyrirvara til þín.
Notkunar- og upplýsingatakmarkanir
Leyfissamningar
Farið skal með skjöl og upplýsingar sem okkur eru veittar sem trúnaðarmál, nema sérstakt leyfi sé veitt.
Ekki er hægt að nálgast þær eða nota þær í neinum tilgangi nema sérstaklega sé kveðið á um hér.
Höfundarréttur
Vörur okkar og þriðju aðila hér að neðan kunna að innihalda höfundarréttarvarið efni. Slíkt höfundarréttarvarið efni skal ekki afrita, afrita, dreifa, sameina, birta, þýða eða breyta án fyrirfram skriflegs samþykkis. Við og þriðji aðilinn höfum einkarétt á höfundarréttarvörðu efni. Ekkert leyfi skal veitt eða afhent samkvæmt neinum einkaleyfum, höfundarrétti, vörumerkjum eða þjónustumerkjarétti. Til að koma í veg fyrir tvískinnung er ekki hægt að líta á kaup í hvaða formi sem það veitir annað leyfi en venjulegt leyfi án einkaréttar til að nota efnið. Við áskiljum okkur rétt til að grípa til lagalegra aðgerða vegna vanefnda við ofangreindar kröfur, óleyfilegrar notkunar eða annarrar ólöglegrar eða illgjarnrar notkunar á efninu.
Vörumerki
Nema annað sé tekið fram hér, skal ekkert í þessu skjali túlkað þannig að það veiti réttindi til að nota vörumerki, vöruheiti eða nafn, skammstöfun eða falsaða vöru í eigu Quectel eða þriðja aðila í auglýsingum, kynningarmálum eða öðrum þáttum.
Réttindi þriðja aðila
Þetta skjal getur átt við vélbúnað, hugbúnað og/eða skjöl í eigu eins eða fleiri þriðja aðila („efni þriðju aðila“). Notkun slíks efnis frá þriðja aðila skal falla undir allar takmarkanir og skyldur sem um það gilda.
Við tökum enga ábyrgð eða yfirlýsingu, hvorki bein né óbein, varðandi efni þriðja aðila, þar með talið en ekki takmarkað við nein óbein eða lögbundin, ábyrgðir á söluhæfni eða hæfni í ákveðnum tilgangi, rólegri ánægju, kerfissamþættingu, nákvæmni upplýsinga og ekki -brot á hugverkaréttindum þriðja aðila að því er varðar tækni sem leyfir leyfið eða notkun hennar. Ekkert hér felur í sér framsetningu eða ábyrgð af okkar hálfu til að þróa, bæta, breyta, dreifa, markaðssetja, selja, bjóða til sölu eða á annan hátt viðhalda framleiðslu á vörum okkar eða öðrum vélbúnaði, hugbúnaði, tæki, tóli, upplýsingum eða vöru. . Við afsalum okkur ennfremur öllum ábyrgðum sem stafa af viðskiptum eða notkun viðskipta.
Persónuverndarstefna
Til að innleiða virkni eininga er ákveðnum gögnum tækisins hlaðið upp á netþjóna Quectel eða þriðja aðila, þar á meðal flutningsaðila, birgja kubba eða netþjóna sem eru tilnefndir af viðskiptavinum. Quectel, sem fer nákvæmlega eftir viðeigandi lögum og reglugerðum, skal varðveita, nota, birta eða á annan hátt vinna úr viðeigandi gögnum í þeim tilgangi að sinna þjónustunni eingöngu eða eins og heimilt er samkvæmt gildandi lögum. Áður en gagnasamskipti við þriðja aðila eru upplýst, vinsamlegast upplýstu um persónuverndarstefnu þeirra og gagnaöryggisstefnu.
Fyrirvari
a) Við viðurkennum enga ábyrgð á meiðslum eða tjóni sem stafar af því að treysta á upplýsingarnar.
b) Við berum enga ábyrgð sem stafar af ónákvæmni eða aðgerðaleysi, eða vegna notkunar upplýsinganna sem hér er að finna.
c) Þó að við höfum lagt allt kapp á að tryggja að aðgerðir og eiginleikar sem eru í þróun séu lausir við villur, er mögulegt að þær gætu innihaldið villur, ónákvæmni og aðgerðaleysi. Nema annað sé kveðið á um í gildum samningi, gerum við engar ábyrgðir af neinu tagi, hvorki óbeina né berum orðum, og útilokum alla ábyrgð á tjóni eða skemmdum sem verða fyrir í tengslum við notkun á eiginleikum og aðgerðum í þróun, að því marki sem lög leyfa, óháð því hvort slíkt tjón eða tjón kunni að hafa verið fyrirsjáanlegt.
d) Við berum ekki ábyrgð á aðgengi, öryggi, nákvæmni, aðgengi, lögmæti eða heilleika upplýsinga, auglýsinga, viðskiptatilboða, vara, þjónustu og efnis á þriðja aðila. websíður og tilföng þriðja aðila.
Höfundarréttur © Quectel Wireless Solutions Co., Ltd. 2024. Allur réttur áskilinn.
Um skjalið
Endurskoðunarsaga
| Útgáfa | Dagsetning | Höfundur | Lýsing |
| – | 3/6/2024 | Aron LIU | Gerð skjalsins |
| 1.0 | 3/25/2024 | Aron LIU | Fyrsta opinbera útgáfan |
Inngangur
Þetta skjal útlistar hvernig á að nota QDownloadProj verkfærakistuna til að uppfæra fastbúnað Quectel EG800Q röð, EG915Q röð og EG916Q-GL eininga á Linux kerfi.
Verkfærakista
QDownloadProj verkfærasett inniheldur stillingar files, executable file, haus files, frumkóði files, notkunarsýningar, safnsýningar og útgáfuskýrslu tólsins, eins og lýst er hér að neðan.
Tafla 1: File Listi
| Mappa/File | Lýsing |
| kynningu | Stillingar files og JSON files notað til að eyða skiptingum. |
| gccout | Keyranleg file búin til með samantekt. |
| hf | Haus files. |
| src | Upprunakóði files. |
| cli_demo.txt | Notkunarsýni. |
| compile_cmd.txt | Safn kynningar. |
| Útgáfuathugið | Útgáfuskýrsla. |
Færibreytur
QDownloadProj styður margar breytur fyrir mismunandi skipanir, og þú getur stillt tilgreindar breytur eftir þörfum. Þessi kafli veitir nákvæma lýsingu á notkun og uppsetningu hverrar færibreytu.
Tafla 2: Lýsing á færibreytum
| Skipun | Lýsing |
| -bls | Stillir UART eða USB tenginúmerið til að hlaða niður fastbúnaði. : UART eða USB tenginúmer. Strengur án tvöfaldra gæsalappa. Áskilin færibreyta. |
| -cfile> | Stillir slóð stillingarinnar file krafist fyrir uppfærslu á fastbúnaði. <cfgfile>: Stillingar file slóð, ákvörðuð af einingarlíkaninu. Strengur án tvöfaldra gæsalappa. Áskilin færibreyta. |
| -S | Skiptir FullFOTA uppfærslupakkanum í þrjá sjálfstæða files (BL, AP og CP tegundir) notaðar fyrir uppfærsluna. |
| -b | Sækja óháð file, eins og -b BL. : Tegund sjálfstæðra file. Strengur án tvöfaldra gæsalappa. Áskilin færibreyta. BL Bin file nafnið sem byrjar á ap_bootloader AP Bin file nafnið sem byrjar á ap_at_command CP Bin file nafnið sem byrjar á cp-demo-flash |
| -B … | Niðurhal margar óháðar files og aðskilja tvo files með bili, eins og -B “BL AP CP”. : Tegund sjálfstæðra file. Strengur með tvöföldum gæsalappir. Áskilin færibreyta. BL Bin file nafnið sem byrjar á ap_bootloader AP Bin file nafnið sem byrjar á ap_at_command CP Bin file nafnið sem byrjar á cp-demo-flash |
| -e | Eyðir skipting, eins og -e "0x800000 0x400000 0". : Skipting sem á að eyða. Strengur með tvöföldum gæsalappir. Snið: . Áskilin færibreyta. : Heiltölugerð. Upphafsfang til að eyða. Áskilin færibreyta. : Heiltölugerð. Lengd gagna sem á að eyða af skiptingunni. Áskilin færibreyta. : Heiltölugerð. Tegund eyðingar. Fast á 0 (eyðir blokk). Áskilið |
| breytu. | |
| -E | Eyðir mörgum skiptingum, eins og -E "allt". : Skiptaauðkenni. Strengur með tvöföldum gæsalappir. Áskilin færibreyta. öll skipting önnur en cal. nvm NVM skipting. cal Kvörðun skipting. |
| -r | Endurræsir eininguna eftir FullFOTA uppfærsluna. |
| -s | Hleður niður uppfærslupakkanum með agentboot skiptingunni sleppt. |
| -v | Sýnir útgáfu QDownloadProj verkfærasettsins. |
| -h | Sýnir hjálparupplýsingar. |
Notkun
Þessi kafli útskýrir hvernig á að setja saman og nota QDownloadProj verkfærakistuna til að uppfæra vélbúnaðar einingarinnar á Linux kerfi með því að nota EG800Q röð eininguna sem fyrrverandiample.
4.1. Safna saman frumkóða
Framkvæmdu eftirfarandi skipun til að setja saman frumkóðann og búa til keyranlegt forrit (tól), td DownloadCLI (Þú getur sérsniðið nafn tólsins) og geymdu tólið í gccout möppunni.
gcc -D_LINUX -g -o gccout/DownloadCLI -I inc src/download_cli.c src/action.c src/linux_comm.c src/utils.c src/package.c src/crc.c src/sha256.c src/shaXNUMX.c ini.c src/cJSON.c
4.2. Breyta stillingum File
Skref 1: Opnaðu QDownloadProj verkfærakistuna, sláðu inn \demo\config möppuna og opnaðu samsvarandi stillingar file fer eftir módelinu og uppfærsluaðferðinni.
- Stillingar file fyrir fastbúnaðaruppfærslu í gegnum UART: cfg_ec618_uart.ini
- Stillingar file fyrir fastbúnaðaruppfærslu í gegnum USB: cfg_ec618_usb.ini
Skref 2: Breyttu tilgreindum breytum í uppsetningunni file eins og sýnt er hér að neðan.
- Stilltu pkgpath undir [package_info] til að breyta geymsluslóð fyrir FullFOTA uppfærslupakkann.
EG800QEULCR01A03M04 í ofangreindri leið er aðeins example og ætti að skipta út fyrir raunverulega vélbúnaðarútgáfu einingarinnar sem notuð er.
- Stilltu agpath undir [agentboot] til að breyta slóðinni fyrir agentboot file.
Fyrir fastbúnaðaruppfærslu í gegnum UART:
[agentboot] agpath = ./demo/image_ec618/agentboot_uart/agentboot.binFyrir fastbúnaðaruppfærslu í gegnum USB: [agentboot] agpath = ./demo/image_ec618/agentboot_usb/agentboot.bin
- Stilltu blpath, syspath og cp_syspath undir [bootloader], [system] og [cp_system] til að breyta geymsluslóðum hverrar tegundar fastbúnaðar files (BL, AP og CP gerðir) myndaðar eftir skiptingu FullFOTA uppfærslupakkans.
[kerfi] syspath = ./root/EG800QEULCR01A03M04/ap_at_command.bin burnaddr = 0×24000
[cp_system] cp_syspath = ./root/EG800QEULCR01A03M04/cp-demo-flash.bin burnaddr = 0×0
EG800QEULCR01A03M04 í ofangreindri leið er aðeins example og ætti að skipta út fyrir raunverulega vélbúnaðarútgáfu sem notuð er.
- Stilla [annaðfile] (Valfrjálst)
Sjálfgefin stilling á [annaðfile] birtist hér að neðan. Þú getur sérsniðið filepath, burnaddr og storage_type færibreytur eftir þörfum.
[annaðfile1] fileslóð = ap_application.binburnaddr = 0×200000
storage_type=ap_flash
4.3. Skiptu uppfærslupakka
Samkvæmt eðlislægri rökfræði QDownloadProj verkfærakistunnar er FullFOTA uppfærslupakki skipt í þrjá sjálfstæða files fyrir fastbúnaðaruppfærslu sem hér segir:
Skref 1: Afritaðu bæði FullFOTA uppfærslupakkann og QDownloadProj verkfærakistuna sem inniheldur DownloadCLI tólið sem er búið til í kafla 4.1 yfir á Linux tækið.
Skref 2: Framkvæmdu eftirfarandi skipun í QDownloadProj/gccout möppu Linux tækisins til að keyra DownloadCLI tólið og skiptu FullFOTA uppfærslupakkanum.
Fyrir fastbúnaðaruppfærslu í gegnum UART:
./DownloadCLI -c ../demo/config/cfg_ec618_uart.ini -S
Fyrir uppfærslu á fastbúnaði í gegnum USB:
./DownloadCLI -c ../demo/config/cfg_ec618_usb.ini -S
Skref 3: Þegar uppfærslupakkanum hefur verið skipt, hættir DownloadCLI tólinu sjálfkrafa. Til að staðfesta hvort skiptingin hafi tekist, athugaðu útgöngukóðann með því að nota eftirfarandi skipun. 0 gefur til kynna árangursríka skiptingu en önnur gildi gefa til kynna misheppnaða skiptingu.
# echo $?
4.4. Uppfærðu fastbúnað
Fastbúnaðaruppfærslu er hægt að framkvæma með UART eða USB.
4.4.1. Fastbúnaðaruppfærsla í gegnum UART
Skref 1: Tengdu eininguna við tækið í gegnum USB í raðsnúru.
Skref 2: Framkvæmdu eftirfarandi skipun í QDownloadProj/gccout möppu tækisins til að keyra DownloadCLI tólið fyrir fastbúnaðaruppfærsluna. Þrír óháðir files (BL, AP og CP gerðir) eru sjálfgefið niðurhalaðar.
./DownloadCLI -c ../demo/config/cfg_ec618_uart.ini -p /dev/ttyUSB0 -B “BL AP CP” -r
Til að sækja sérsniðið file við eininguna, bætið OTHER1 við eftir BL AP CP eins og sýnt er hér að neðan:
./DownloadCLI -c ../demo/config/cfg_ec618_uart.ini -p /dev/ttyUSB0 -B “BL AP CP OTHER1” -r
Skref 3: Þegar uppfærslunni er lokið hættir DownloadCLI tólinu sjálfkrafa. Til að sannreyna að uppfærsla vélbúnaðar hafi tekist, athugaðu annað hvort útgöngukóðann fyrir DownloadCLI tólinu eða skilaboðin sem birtast í síðustu línunni í skránni sem prentuð er á flugstöðinni þar sem DownloadCLI tólið var keyrt í uppfærsluferlinu.
Framkvæmdu eftirfarandi skipun til að fá útgöngukóða DownloadCLI tólsins. 0 gefur til kynna vel heppnaða uppfærslu, en önnur gildi gefa til kynna að uppfærsla hafi mistekist.
# echo $?
Ef fastbúnaðurinn hefur verið uppfærður með góðum árangri birtist „Brunlist velgengni“ í síðustu línunni í skránni, eins og sýnt er hér að neðan. Aðrar upplýsingar sem birtar eru gefa til kynna bilun í uppfærslu vélbúnaðar.
# ./DownloadCLI -c ../demo/config/cfg_ec618_uart.ini -p /dev/ttyUSB0 -B “BL AP CP OTHER1” -r
[2024-0-24 16:35:22:445][INFO][src/action.c-125]:Brunlist = BL AP CP ANNAÐ1
[2024-0-24 16:35:22:445][INFO][src/action.c-128]:Burn 4 files
[2024-0-24 16:35:22:445][INFO][src/action.c-24]:Brunaaðgerð byrja, gerð = BL
…
[2024-0-24 16:36:10:431][INFO][src/package.c-310]:Current progress: 67%
[2024-0-24 16:36:10:432][INFO][src/package.c-36]:Ab handshake
[2024-0-24 16:36:11:015][INFO][src/package.c-310]:Current progress: 100%
[2024-0-24 16:36:11:140][INFO][src/action.c-101]:Burn action success
[2024-0-24 16:36:11:140][INFO][src/package.c-40]:Lpc handshake
[2024-0-24 16:36:11:148][INFO][src/action.c-109]:System reset success
[2024-0-24 16:36:11:251][INFO][src/action.c-144]:Burnlist success
Ef uppfærsla á fastbúnaði bilar, vinsamlegast hafðu samband við Quectel tæknilega aðstoð til að fá aðstoð og lausn.
4.4.2. Fastbúnaðaruppfærsla í gegnum USB
Skref 1: Styttu USB_BOOT pinna handvirkt og kveiktu á einingunni.
Skref 2: Framkvæmdu eftirfarandi skipun í QDownloadProj/gccout möppu tækisins til að keyra DownloadCLI tólið fyrir fastbúnaðaruppfærsluna. Þrír óháðir files (BL, AP og CP gerðir) eru sjálfgefið niðurhalaðar.
./DownloadCLI -c ../demo/config/cfg_ec618_usb.ini -p /dev/ttyACM0 -B “BL AP CP” -r
Til að sækja sérsniðið file við eininguna, bætið OTHER1 við á eftir BL AP CP eins og sýnt er hér að neðan.
./DownloadCLI -c ../demo/config/cfg_ec618_usb.ini -p /dev/ttyACM0 -B “BL AP CP OTHER1” -r
Skref 3: Þegar uppfærslunni er lokið hættir DownloadCLI tólinu sjálfkrafa. Til að ganga úr skugga um að uppfærsla fastbúnaðar hafi tekist, athugaðu annaðhvort útgöngukóðann á DownloadCLI tólinu eða skilaboðin sem birtast í síðustu línunni í skránni sem prentuð er á flugstöðinni þar sem DownloadCLI tólið var keyrt í uppfærsluferlinu.
Framkvæmdu eftirfarandi skipun til að fá útgöngukóða DownloadCLI tólsins. 0 gefur til kynna vel heppnaða uppfærslu, en önnur gildi gefa til kynna að uppfærsla hafi mistekist.
# echo $?
Ef fastbúnaðurinn hefur verið uppfærður með góðum árangri birtist „Brunlist velgengni“ í síðustu línunni í skránni, eins og sýnt er hér að neðan. Aðrar upplýsingar sem birtar eru gefa til kynna bilun í uppfærslu vélbúnaðar.
# ./DownloadCLI -c ../demo/config/cfg_ec618_usb.ini -p /dev/ttyACM0 -B “BL AP CP” -r
[2024-0-24 16:46:18:411][INFO][src/action.c-125]:Brunlist = BL AP CP
[2024-0-24 16:46:18:411][INFO][src/action.c-128]:Burn 3 files
[2024-0-24 16:46:18:411][INFO][src/action.c-24]:Brunaaðgerð byrja, gerð = BL
…
[2024-0-24 16:46:58:474][INFO][src/package.c-310]:Current progress: 88%
[2024-0-24 16:46:58:474][INFO][src/package.c-36]:Ab handshake
[2024-0-24 16:46:58:933][INFO][src/package.c-310]:Current progress: 100%
[2024-0-24 16:46:59:057][INFO][src/action.c-101]:Burn action success
[2024-0-24 16:46:59:057][INFO][src/package.c-40]:Lpc handshake
[2024-0-24 16:46:59:065][INFO][src/action.c-109]:System reset success
[2024-0-24 16:46:59:066][INFO][src/action.c-144]:Burnlist success
Ef uppfærsla á fastbúnaði bilar, vinsamlegast hafðu samband við Quectel tæknilega aðstoð til að fá aðstoð og lausn.
Viðauki Tilvísun
Tafla 3: Hugtök og skammstafanir
| Skammstöfun | Lýsing |
| JSON | JavaScript hlutur |
| LTE | Langtímaþróun |
| NVM | Ófleygt minni |
| UART | Alhliða ósamstilltur móttakari/sendi |
| USB | Universal Serial Bus |
QDownloadProj_Linux_User_Guide
Skjöl / auðlindir
 |
QUECTEL LTE Standard Module Series [pdfNotendahandbók LTE Standard Module Series, Standard Module Series, Module Series, Series |
