Návod k použití vývojové desky tekmodul BG95M3-QPython EVB

Vývojová deska tekmodul BG95M3-QPython EVB

Rozdíly od MicroPythonu

QuecPython je v podstatě MicroPython běžící na modulech Quectel. Vzhledem k absenci komplexní standardní specifikace v MicroPythonu se mohou vestavěné knihovny a použití různých funkcí lišit v závislosti na vývojářích a hardwarových platformách. Někteří uživatelé QuecPythonu mohou mít předchozí zkušenosti s vývojem MicroPythonu na modulech jako ESP32, ESP8266 a STM32. Pro usnadnění migrace pro tyto uživatele jsou níže uvedeny známé rozdíly mezi QuecPython a MicroPython:

• Některé standardní nebo vyhrazené knihovny MicroPythonu, jako je framebuf a network, nejsou implementovány nebo vestavěny v QuecPythonu.
• Některé standardní knihovny MicroPythonu, jako je utime, mohou mít různé implementace a úplnost funkcí v QuecPythonu ve srovnání s moduly jako ESP32, což má za následek rozdíly ve výkonu nebo jiných podrobných charakteristikách.
• Organizace určitých funkcí v QuecPythonu se může lišit od MicroPythonu. NapřampFunkce ADC je obecně zahrnuta v knihovně strojů v MicroPythonu, ale v QuecPythonu je zahrnuta v knihovně misc.
• Rozhraní API související se specifickými hardwarovými rozhraními, jako je UART, I2C a SPI, mají mezi MicroPythonem a QuecPythonem značné rozdíly a nelze je používat zaměnitelně.
• QuecPython v současnosti nezahrnuje funkci upip, takže rychlá online instalace knihoven není možná. Je vyžadováno ruční portování.
• Není zaručena kompatibilita s nástroji MicroPython IDE, jako jsou Thonny a uPyCraft.
• Stručně řečeno, kód MicroPythonu, který úspěšně běží na modulech jako ESP32, obvykle nelze přímo zkopírovat a spustit v prostředí QuecPython bez jakýchkoli úprav. Proto je vhodné vyhnout se přímé aplikaci dokumentace a vývojových zkušeností z jiných hardwarových modulů MicroPythonu na vývoj QuecPythonu.

Rozdíly od CPythonu (normální Python)

• Na rozdíl od tradičního vývoje CPythonu má QuecPython mnohem menší počet vestavěných knihoven (standardní knihovny). Ačkoli QuecPython obsahuje základní knihovny pro úkoly, jako je nastavení času a file managementu je množství výrazně nižší ve srovnání s CPythonem. Názvy a způsoby použití těchto standardních knihoven mají také mnoho rozdílů a nejsou plně kompatibilní.
• QuecPython nemá vestavěnou funkci pip, takže rychlá online instalace knihoven není možná. Je vyžadováno ruční portování.
• Vzhledem k rozdílům v syntaxi mezi QuecPython a CPython a také kvůli skutečnosti, že většina knihoven QuecPython nemůže běžet na stolních počítačích, lze nástroje jako VSCode a PyCharm na desktopu používat pouze pro jednoduché úpravy kódu. Dokončené skripty je třeba ručně stáhnout do modulu pro spuštění a ladění.
• Funkce zvýraznění syntaxe a dokončování kódu poskytované nástroji jako VSCode a PyCharm jsou založeny na CPythonu a nemusí být plně použitelné pro QuecPython. Pro začátečníky, kteří nemají žádné předchozí zkušenosti s jazykem Python, se proto nedoporučuje používat při psaní kódu příliš inteligentní nástroje IDE, protože vestavěné návrhy mohou být zavádějící.

Připojení EVB

• Krok 1: Připojte EVB
  Připojte port EVB Type-C k portu USB počítače pomocí kabelu USB Type-C pro napájení.
• Krok 2: Zapněte EVB
  Zkratte dva piny PWK_AUTO krytkou propojky pro napájení desky a deska se automaticky zapne, nebo po zapnutí dlouze stiskněte tlačítko PWK. Doporučuje se, aby časový interval mezi zapnutím a stisknutím tlačítka PWK byl alespoň 30 ms. Po provedení výše uvedených operací počkejte, až se rozsvítí indikátor napájení na hlavní desce (LED PWR se rozsvítí modře, PWM se rozsvítí zeleně, poté by mělo být ve Správci zařízení rozpoznáno EVB.).

Volba SIM karty
Pro BG95 EVB by měla být použita SIM karta NB-IoT. K testu jsme použili 1NCE SIM (měla by rozpoznat síť Telekomu, odesílat SMS a podporovat národní roaming).
Nástroje

QPYcom. Tento nástroj se používá pro ladění kódu, analýzu protokolů, nahrávání python skriptů do modulu, stahování firmwaru, slučování firmwaru a další. Nelze upravovat skripty Pythonu!

VSCode: Chcete-li psát skripty Python. Python skripty napsané VSCode musí být později importovány do QPYcom.

Firmware bliká
Standardní firmware AT nebo firmware QuecOpen se obvykle stáhne do modulu, když modul opustí továrnu. Pokud chcete vyvíjet modul založený na QuecPythonu, musíte do něj ručně znovu stáhnout vyhrazený firmware QuecPython. https://python.quectel.com/en/download
Poznámka: QuecPython vyžaduje speciální firmware! Je potřeba ji zvlášť probliknout. Po flashnutí tohoto firmwaru NELZE desku použít pro prostředí AT příkazů. Je-li požadován vývoj pomocí AT příkazů, musí být příslušný firmware znovu flashován.

Example: BG95_M3 QPython Firmware Flash:

Připojení portu BG95M3
REPL Port: REPL je zkratka pro Read-Eval-Print-Loop (interaktivní interpret). Programy QuecPython můžete ladit v REPL. Kann python Befehle eingeben (zB 5+3) REPL, zkratka pro Read-Eval-Print Loop, je jednoduché interaktivní programovací prostředí. REPL obvykle poskytuje rozhraní příkazového řádku (CLI), které přijímá uživatelský vstup, analyzuje jej a provádí jej a poté vrací výsledky uživateli. Z hlediska funkčnosti a použití je podobný příkazovému řádku (CMD) ve Windows nebo Shell v macOS/Linux.

DM Přístav: Port pro digitální média. Pro blikání firmwaru.

Spuštění funkcí a příkazů Qpythonu

Registrace sítě (v QPYcom, REPL port)

Import síť

• net.operatorName() získá informace o operátorovi aktuální registrace sítě.
• net.getModemFun() Tato metoda se používá k získání aktuálního funkčního režimu modulu.
• net.getState() získá informace o registraci sítě. AT+CREG=?

Založte DataCall

Importovat dataCall

dataCall.getInfo(profileID, ipType)

• #profileID – PDP ID, rozsah 1~3.
• # ipType – typ IP，0：IPV4 1：IPV6 2：IPV4&IPV6
• Pokud je výstup (1, 0, [0, 0, '0.0.0.0', '0.0.0.0', '0.0.0.0']), znamená to, že síť je již zaregistrována, ale datové volání není nastaveno nahoru. dataCall.setPDPContext(1,0,'iot.1nce.net',”,”,1) -> return: 0 = úspěšné
• Kontext PDP s příslušným APN musí být nastaven podle výrobce SIM karty. (V našem případě je výrobcem SIM karty 1NCE, takže je třeba hledat nastavení APN pro 1NCE).

Tabulka:

Nastavení hodnoty

• APN: iot.1nce.net
• Uživatelské jméno: Není vyžadováno, ponechte prázdné
• Heslo: Není vyžadováno, ponechte prázdné
• Autentizace Metoda: Password Authentication Protocol (PAP)
• Internet Protokol: Internetový protokol verze 4 (IPv4)

dataCall.getPDPContext(1) -> návrat: 0 = úspěšné
dataCall.activate(1) -> návrat: 0 = úspěšné
dataCall.getInfo(1,0) -> return: (1, 0, [1, 0, '100.69.60.50', '8.8.8.8', '8.8.4.4'])

importovat checkNet
checkNet.waitNetworkReady(60) -> návrat: (3,1) síť připravena

Reference
https://python.quectel.com/doc/Getting_started/en/index.html
https://python.quectel.com/doc/Application_guide/en/background/iot-and-low-code.html
https://python.quectel.com/doc/API_reference/en/iotlib/dataCall.html

www.tekmodul.de
quectel@tekmodul.de
089-904118290