QDownloadProj Linux
Uživatelská příručka
Řada standardních modulů LTE
Verze: 1.0
Datum: 2024-03-25
Stav: Vydáno
Řada standardních modulů LTE
Ve společnosti Quectel je naším cílem poskytovat našim zákazníkům včasné a komplexní služby. Pokud potřebujete pomoc, kontaktujte prosím naši centrálu:
Quectel Wireless Solutions Co., Ltd.
Budova 5, Shanghai Business Park Phase III (oblast B), č. 1016 Tianlin Road, Minhang District, Shanghai 200233, Čína
Tel: +86 21 5108 6236
E-mail: info@quectel.com
Nebo naše místní kanceláře. Další informace naleznete na adrese:
http://www.quectel.com/support/sales.htm.
Pro technickou podporu nebo pro nahlášení chyb v dokumentaci navštivte:
http://www.quectel.com/support/technical.htm.
Nebo nám napište na adresu: podpora@quectel.com.
Právní upozornění
Informace nabízíme jako službu pro vás. Poskytované informace vycházejí z vašich požadavků a snažíme se zajistit jejich kvalitu. Souhlasíte s tím, že jste odpovědní za použití nezávislé analýzy a hodnocení při navrhování zamýšlených produktů a referenční návrhy poskytujeme pouze pro ilustrativní účely. Před použitím jakéhokoli hardwaru, softwaru nebo služby podle tohoto dokumentu si prosím pozorně přečtěte toto upozornění. I když vynakládáme komerčně přiměřené úsilí, abychom poskytli nejlepší možný zážitek,
tímto berete na vědomí a souhlasíte s tím, že tento dokument a související služby zde uvedené jsou vám poskytovány „jak jsou dostupné“. Tento dokument můžeme čas od času revidovat nebo přeformulovat podle vlastního uvážení bez předchozího upozornění.
Omezení použití a zveřejnění
Licenční smlouvy
Námi poskytnuté dokumenty a informace budou považovány za důvěrné, pokud nebude uděleno zvláštní povolení.
Nesmí se k nim přistupovat ani je používat pro žádný účel, s výjimkou případů výslovně uvedených v tomto dokumentu.
Copyright
Naše produkty a produkty třetích stran uvedené v této smlouvě mohou obsahovat materiál chráněný autorskými právy. Takový materiál chráněný autorskými právy nesmí být kopírován, reprodukován, distribuován, slučován, publikován, překládán ani upravován bez předchozího písemného souhlasu. My a třetí strana máme výhradní práva k materiálu chráněnému autorskými právy. Žádná licence nesmí být udělena ani převedena na základě žádných patentů, autorských práv, ochranných známek ani práv k servisním známkám. Aby se předešlo nejasnostem, zakupteasinUdělení jakékoli licence „g“ v jakékoli formě nelze považovat za udělení jiné než běžné nevýhradní, bezplatné licence k použití materiálu. Vyhrazujeme si právo podniknout právní kroky v případě nedodržení výše uvedených požadavků, neoprávněného použití nebo jiného nezákonného či zneužívajícího použití materiálu.
ochranné známky
Není-li zde uvedeno jinak, nic v tomto dokumentu nelze vykládat tak, že uděluje jakákoli práva k použití jakékoli ochranné známky, obchodního názvu nebo názvu, zkratky nebo jejich padělaného produktu vlastněné společností Quectel nebo jakoukoli třetí stranou v reklamě, propagaci nebo jiných aspektech.
Práva třetích stran
Tento dokument může odkazovat na hardware, software a/nebo dokumentaci vlastněnou jednou nebo více třetími stranami („materiály třetích stran“). Použití takových materiálů třetích stran se bude řídit všemi omezeními a povinnostmi, které se na ně vztahují.
Neposkytujeme žádnou záruku ani prohlášení, ať už výslovné nebo předpokládané, týkající se materiálů třetích stran, včetně, ale bez omezení na jakékoli předpokládané nebo zákonné záruky prodejnosti nebo vhodnosti pro konkrétní účel, tiché užívání, integraci systému, přesnost informací a -porušení jakýchkoli práv duševního vlastnictví třetích stran s ohledem na licencovanou technologii nebo její použití. Nic v tomto dokumentu nepředstavuje prohlášení ani záruku z naší strany za vývoj, vylepšení, úpravu, distribuci, marketing, prodej, nabídku k prodeji nebo jinou údržbu výroby jakýchkoli našich produktů nebo jakéhokoli jiného hardwaru, softwaru, zařízení, nástroje, informací nebo produktu. . Kromě toho odmítáme veškeré záruky vyplývající z průběhu obchodování nebo používání obchodu.
Zásady ochrany osobních údajů
Pro implementaci funkčnosti modulu jsou určitá data zařízení nahrána na servery Quectel nebo třetích stran, včetně operátorů, dodavatelů čipových sad nebo serverů určených zákazníkem. Společnost Quectel, přísně dodržující příslušné zákony a předpisy, bude uchovávat, používat, zveřejňovat nebo jinak zpracovávat relevantní údaje pouze za účelem poskytování služby nebo v souladu s platnými zákony. Před interakcí s údaji se třetími stranami se prosím informujte o jejich zásadách ochrany osobních údajů a zabezpečení údajů.
Zřeknutí se odpovědnosti
a) Nepřijímáme žádnou odpovědnost za jakékoli zranění nebo škody vyplývající ze spoléhání se na informace.
b) Neneseme žádnou odpovědnost vyplývající z jakýchkoli nepřesností nebo opomenutí nebo z použití zde obsažených informací.
c) I když jsme vynaložili veškeré úsilí, abychom zajistili, že funkce a funkce ve vývoji neobsahují chyby, je možné, že mohou obsahovat chyby, nepřesnosti a opomenutí. Pokud platná dohoda nestanoví jinak, neposkytujeme žádné záruky jakéhokoli druhu, ať už předpokládané nebo výslovné, a vylučujeme veškerou odpovědnost za jakoukoli ztrátu nebo škodu způsobenou v souvislosti s používáním funkcí a funkcí ve vývoji, v maximálním rozsahu povoleném zákonem, bez ohledu na to, zda byla taková ztráta nebo škoda předvídatelná.
d) Neneseme odpovědnost za dostupnost, bezpečnost, přesnost, dostupnost, zákonnost nebo úplnost informací, reklam, obchodních nabídek, produktů, služeb a materiálů na třetích stranách. webweby a zdroje třetích stran.
Copyright © Quectel Wireless Solutions Co., Ltd. 2024. Všechna práva vyhrazena.
O dokumentu
Historie revizí
| Verze | Datum | Autor | Popis |
| – | 3. 6. 2024 | Aaron LIU | Vytvoření dokumentu |
| 1.0 | 3. 25. 2024 | Aaron LIU | První oficiální vydání |
Zavedení
Tento dokument popisuje, jak používat sadu nástrojů QDownloadProj k upgradu firmwaru modulů Quectel řady EG800Q, EG915Q a EG916Q-GL v systému Linux.
Toolkit
Sada nástrojů QDownloadProj obsahuje konfiguraci files, spustitelný soubor file, záhlaví files, zdrojový kód files, ukázky použití, ukázky kompilací a poznámka k vydání nástroje, jak je uvedeno níže.
Tabulka 1: File Seznam
| Složka/File | Popis |
| demo | Konfigurace files a JSON filepoužívá se pro erasing oddíly. |
| gccout | Spustitelný file generované kompilací. |
| vč | Záhlaví files. |
| src | Zdrojový kód files. |
| cli_demo.txt | Ukázky použití. |
| kompilovat_cmd.txt | Ukázky kompilací. |
| ReleaseNote | Poznámka k vydání. |
Parametry
QDownloadProj podporuje více parametrů pro různé příkazy a zadané parametry můžete nakonfigurovat podle potřeby. Tato kapitola poskytuje podrobný popis použití a konfigurace každého parametru.
Tabulka 2: Popis parametru
| Příkaz | Popis |
| -p | Konfiguruje číslo portu UART nebo USB pro stahování firmwaru. : Číslo portu UART nebo USB. Řetězec bez uvozovek. Požadovaný parametr. |
| -Cfile> | Konfiguruje cestu konfigurace file nutné pro upgrade firmwaru. <cfgfile>: Konfigurace file cesta, určená modelem modulu. Řetězec bez uvozovek. Požadovaný parametr. |
| -S | Rozděluje balíček aktualizace FullFOTA na tři nezávislé files (typy BL, AP a CP) použité pro upgrade. |
| -b | Stáhne nezávislý file, jako je -b BL. : Typ nezávislého file. Řetězec bez uvozovek. Požadovaný parametr. BL Bin file jehož jméno začíná ap_bootloader AP Bin file jehož jméno začíná ap_at_command Zásobník CP file jehož jméno začíná cp-demo-flash |
| -B … | Stahuje více nezávislých files a oddělit dvě files mezerou, například -B “BL AP CP”. : Typ nezávislého file. Řetězec s dvojitými uvozovkami. Požadovaný parametr. BL Bin file jehož jméno začíná ap_bootloader AP Bin file jehož jméno začíná ap_at_command Zásobník CP file jehož jméno začíná cp-demo-flash |
| -E | Vymaže oddíl, například -e „0x800000 0x400000 0“. : Oddíl k vymazání. Řetězec s dvojitými uvozovkami. Formát: . Požadovaný parametr. : Typ celého čísla. Počáteční adresa pro vymazání. Požadovaný parametr. : Typ celého čísla. Délka dat, která mají být z oddílu vymazána. Požadovaný parametr. Celočíselný typ. Typ mazání. Pevně nastaveno na 0 (Erasin(blok ga). Povinné |
| parametr. | |
| -E | Vymaže více oddílů, například -E „vše“. : Identifikátor oddílu. Řetězec s dvojitými uvozovkami. Požadovaný parametr. všechny příčky jiné než kal. oddíl nvm NVM. cal Kalibrační oddíl. |
| -r | Restartuje modul po upgradu FullFOTA. |
| -s | Stáhne balíček upgradu s vynechaným oddílem agentboot. |
| -v | Zobrazuje verzi sady nástrojů QDownloadProj. |
| -h | Zobrazí informace nápovědy. |
Používání
Tato kapitola vysvětluje, jak zkompilovat a používat sadu nástrojů QDownloadProj k upgradu firmwaru modulu v systému Linux pomocí modulu řady EG800Q jako ex.ample.
4.1. Kompilace zdrojového kódu
Provedením následujícího příkazu zkompilujte zdrojový kód a vygenerujte spustitelný program (nástroj), např. DownloadCLI (název nástroje můžete upravit) a uložte nástroj do složky gccout.
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/ ini.c src/cJSON.c
4.2. Upravit konfiguraci File
Krok 1: Otevřete sadu nástrojů QDownloadProj, vstupte do adresáře \demo\config a otevřete odpovídající konfiguraci file v závislosti na modelu modulu a způsobu aktualizace.
- Konfigurace file pro upgrade firmwaru přes UART: cfg_ec618_uart.ini
- Konfigurace file pro upgrade firmwaru přes USB: cfg_ec618_usb.ini
Krok 2: Upravte zadané parametry v konfiguraci file jak je uvedeno níže.
- Nakonfigurujte cestu pkgpath pod [package_info] a změňte cestu úložiště pro balíček upgradu FullFOTA.
EG800QEULCR01A03M04 ve výše uvedené cestě je pouze example a měla by být nahrazena aktuální používanou verzí firmwaru modulu.
- Nakonfigurujte agpath pod [agentboot] a změňte cestu pro agentboot file.
Pro upgrade firmwaru přes UART:
[agentboot] agpath = ./demo/image_ec618/agentboot_uart/agentboot.binPro upgrade firmwaru přes USB: [agentboot] agpath = ./demo/image_ec618/agentboot_usb/agentboot.bin
- Nakonfigurujte blpath, syspath a cp_syspath pod [bootloader], [system] a [cp_system] a změňte cesty úložiště každého typu firmwaru files (typy BL, AP a CP) generované po rozdělení aktualizačního balíčku FullFOTA.
[system] syspath = ./root/EG800QEULCR01A03M04/ap_at_command.bin burnaddr = 0×24000
[cp_system] cp_syspath = ./root/EG800QEULCR01A03M04/cp-demo-flash.bin burnaddr = 0×0
EG800QEULCR01A03M04 ve výše uvedené cestě je pouze example a měla by být nahrazena aktuální používanou verzí firmwaru.
- Konfigurovat [ostatnífile] (Volitelné)
Výchozí konfigurace [otherfile] se zobrazí níže. Můžete si přizpůsobit fileparametry path, burnaddr a storage_type podle potřeby.
[jinýfile1] filecesta = app_application.binburnaddr = 0×200000
storage_type=ap_flash
4.3. Rozdělte balíček upgradu
Podle inherentní logiky sady nástrojů QDownloadProj je balíček aktualizace FullFOTA rozdělen do tří nezávislých files pro upgrade firmwaru takto:
Krok 1: Zkopírujte jak aktualizační balíček FullFOTA, tak sadu nástrojů QDownloadProj obsahující nástroj DownloadCLI vygenerovaný v kapitole 4.1 do zařízení se systémem Linux.
Krok 2: Provedením následujícího příkazu v adresáři QDownloadProj/gccout zařízení se systémem Linux spusťte nástroj DownloadCLI a rozdělte balíček aktualizace FullFOTA.
Pro upgrade firmwaru přes UART:
./DownloadCLI -c ../demo/config/cfg_ec618_uart.ini -S
Pro upgrade firmwaru přes USB:
./DownloadCLI -c ../demo/config/cfg_ec618_usb.ini -S
Krok 3: Jakmile je aktualizační balíček rozdělen, nástroj DownloadCLI se automaticky ukončí. Chcete-li ověřit, zda je rozdělení úspěšné, zkontrolujte výstupní kód pomocí následujícího příkazu. 0 označuje úspěšné dělení, zatímco ostatní hodnoty označují neúspěšné dělení.
# echo $?
4.4. Upgradujte firmware
Upgrade firmwaru lze provést přes UART nebo USB.
4.4.1. Upgrade firmwaru přes UART
Krok 1: Připojte modul k zařízení pomocí USB do sériového kabelu.
Krok 2: Provedením následujícího příkazu v adresáři QDownloadProj/gccout zařízení spusťte nástroj DownloadCLI pro upgrade firmwaru. Tři nezávislé files (typy BL, AP a CP) se stahují standardně.
./DownloadCLI -c ../demo/config/cfg_ec618_uart.ini -p /dev/ttyUSB0 -B “BL AP CP” -r
Chcete-li stáhnout vlastní file do modulu přidejte OTHER1 za BL AP CP, jak je znázorněno níže:
./DownloadCLI -c ../demo/config/cfg_ec618_uart.ini -p /dev/ttyUSB0 -B “BL AP CP OTHER1” -r
Krok 3: Jakmile je aktualizace dokončena, nástroj DownloadCLI se automaticky ukončí. Chcete-li ověřit úspěšnost aktualizace firmwaru, zkontrolujte buď kód ukončení nástroje DownloadCLI, nebo zprávu zobrazenou v posledním řádku protokolu vytištěného na terminálu, kde byl nástroj DownloadCLI během procesu aktualizace spuštěn.
Provedením následujícího příkazu získáte ukončovací kód nástroje DownloadCLI. 0 značí úspěšný upgrade, zatímco ostatní hodnoty znamenají selhání upgradu.
# echo $?
Pokud je aktualizace firmwaru úspěšná, na posledním řádku protokolu se zobrazí „Burnlist success“, jak je znázorněno níže. Další zobrazené informace indikují selhání aktualizace firmwaru.
# ./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]:Burnlist = BL AP CP OTHER1
[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]:Začátek akce vypalování, typ = 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
V případě selhání upgradu firmwaru se prosím obraťte na technickou podporu Quectel se žádostí o pomoc a řešení.
4.4.2. Upgrade firmwaru přes USB
Krok 1: Ručně zkratujte pin USB_BOOT a zapněte modul.
Krok 2: Provedením následujícího příkazu v adresáři QDownloadProj/gccout zařízení spusťte nástroj DownloadCLI pro upgrade firmwaru. Tři nezávislé files (typy BL, AP a CP) se stahují standardně.
./DownloadCLI -c ../demo/config/cfg_ec618_usb.ini -p /dev/ttyACM0 -B “BL AP CP” -r
Chcete-li stáhnout vlastní file k modulu přidejte OTHER1 za BL AP CP, jak je znázorněno níže.
./DownloadCLI -c ../demo/config/cfg_ec618_usb.ini -p /dev/ttyACM0 -B “BL AP CP OTHER1” -r
Krok 3: Po dokončení upgradu se nástroj DownloadCLI automaticky ukončí. Chcete-li ověřit úspěšnost aktualizace firmwaru, zkontrolujte buď kód ukončení nástroje DownloadCLI, nebo zprávu zobrazenou v posledním řádku protokolu vytištěného na terminálu, kde byl nástroj DownloadCLI během procesu aktualizace spuštěn.
Provedením následujícího příkazu získáte ukončovací kód nástroje DownloadCLI. 0 značí úspěšný upgrade, zatímco ostatní hodnoty znamenají selhání upgradu.
# echo $?
Pokud je aktualizace firmwaru úspěšná, na posledním řádku protokolu se zobrazí „Burnlist success“, jak je znázorněno níže. Další zobrazené informace indikují selhání aktualizace firmwaru.
# ./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]:Burnlist = 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]:Začátek akce vypalování, typ = 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
V případě selhání upgradu firmwaru se prosím obraťte na technickou podporu Quectel se žádostí o pomoc a řešení.
Odkaz na přílohu
Tabulka 3: Termíny a zkratky
| Zkratka | Popis |
| JSON | Zápis objektů JavaScript |
| LTE | Dlouhodobá evoluce |
| NVM | Nevolatilní paměť |
| UART | Univerzální asynchronní přijímač/vysílač |
| USB | Univerzální sériová sběrnice |
QDownloadProj_Linux_User_Guide
Dokumenty / zdroje
 |
Standardní řada modulů QUECTEL LTE [pdfUživatelská příručka Řada standardních modulů LTE, řada standardních modulů, řada modulů, řada |
