tekmodul BG95M3-QPython EVB Development Board Instruction Manual

tekmodul BG95M3-QPython EVB Ontwikkelingsraad

Verskille van MicroPython

QuecPython is in wese MicroPython wat op Quectel-modules loop. As gevolg van die gebrek aan 'n omvattende standaardspesifikasie in MicroPython, kan die ingeboude biblioteke en die gebruik van verskeie funksies verskil na gelang van die ontwikkelaars en hardeware-platforms. Sommige QuecPython-gebruikers het dalk vorige ondervinding om met MicroPython op modules soos ESP32, ESP8266 en STM32 te ontwikkel. Om die migrasie vir hierdie gebruikers te vergemaklik, word die bekende verskille tussen QuecPython en MicroPython hieronder gelys:

• Sommige MicroPython-standaard- of toegewyde biblioteke, soos framebuf en netwerk, is nie in QuecPython geïmplementeer of ingebou nie.
• Sommige MicroPython-standaardbiblioteke, soos utime, kan verskillende implementerings en kenmerk volledigheid in QuecPython hê in vergelyking met modules soos ESP32, wat lei tot verskille in werkverrigting of ander gedetailleerde kenmerke.
• Die organisasie van sekere kenmerke in QuecPython kan verskil van MicroPython. Byvoorbeeldample, ADC-funksionaliteit is oor die algemeen ingesluit in die masjienbiblioteek in MicroPython, maar in QuecPython is dit by die misc-biblioteek ingesluit.
• API's wat verband hou met spesifieke hardeware-koppelvlakke soos UART, I2C en SPI het beduidende verskille tussen MicroPython en QuecPython en kan nie uitruilbaar gebruik word nie.
• QuecPython sluit tans nie die upip-funksionaliteit in nie, so vinnige aanlyn installasie van biblioteke is nie moontlik nie. Handmatige oordrag word vereis.
• Verenigbaarheid met MicroPython IDE-instrumente soos Thonny en uPyCraft word nie gewaarborg nie.
• Ter opsomming, MicroPython-kode wat suksesvol op modules soos ESP32 loop, kan gewoonlik nie direk gekopieer en in die QuecPython-omgewing uitgevoer word sonder enige wysigings nie. Daarom is dit raadsaam om die direkte toepassing van dokumentasie en ontwikkelingservaring van ander MicroPython hardeware modules op QuecPython ontwikkeling te vermy.

Verskille van CPython (normale Python)

• Anders as tradisionele CPython-ontwikkeling, het QuecPython 'n baie kleiner aantal ingeboude biblioteke (standaardbiblioteke). Alhoewel QuecPython wel basiese biblioteke insluit vir take soos tydinstelling en file bestuur, is die hoeveelheid aansienlik laer in vergelyking met CPython. Die name en gebruiksmetodes van hierdie standaardbiblioteke het ook baie verskille en is nie ten volle versoenbaar nie.
• QuecPython het nie ingeboude pip-funksionaliteit nie, so vinnige aanlyn installasie van biblioteke is nie moontlik nie. Handmatige oordrag word vereis.
• As gevolg van die sintaksisverskille tussen QuecPython en CPython, sowel as die feit dat die meeste QuecPython-biblioteke nie op tafelrekenaars kan loop nie, kan nutsmiddels soos VSCode en PyCharm op die lessenaar slegs vir eenvoudige koderedigering gebruik word. Die voltooide skrifte moet met die hand na die module afgelaai word vir uitvoering en ontfouting.
• Die sintaksis-uitlig- en kode-voltooiingskenmerke wat deur nutsmiddels soos VSCode en PyCharm verskaf word, is gebaseer op CPython en is dalk nie ten volle van toepassing op QuecPython nie. Daarom, vir beginners wat geen vorige ondervinding met die Python-taal het nie, word dit nie aanbeveel om oormatige intelligente IDE-gereedskap te gebruik terwyl kode geskryf word nie, aangesien die ingeboude voorstelle misleidend kan wees.

EVB verbinding

• Stap 1: Koppel EVB
  Koppel die EVB Type-C-poort aan jou rekenaar se USB-poort met 'n USB Type-C-kabel vir kragtoevoer.
• Stap 2: Skakel EVB aan
  Kort die twee PWK_AUTO-pennetjies met 'n springdop om die bord aan te skakel en dit sal outomaties aanskakel, of druk die PWK-knoppie lank nadat dit aangeskakel is. Dit word aanbeveel dat die tydinterval tussen aanskakeling en die druk van die PWK-knoppie minstens 30 ms moet wees. Nadat u die bogenoemde bewerkings uitgevoer het, wag vir die kragaanwyser op die hoofbord om te verlig (LED PWR brand blou, PWM lig groen op, dan moet EVB in Toestelbestuurder herken word.).

SIM Keuse
Vir BG95 EVB moet 'n NB-IoT SIM-kaart gebruik word. Vir toets het ons 1NCE SIM gebruik (Dit moet die Telekom-netwerk herken, SMS stuur en Nasionale Roaming ondersteun).
Gereedskap

QPYcom. Hierdie instrument word gebruik vir ontfouting van kode, ontleding van logs, oplaai van python-skrifte na module, aflaai van firmware, samevoeging van firmware, en meer. Kan nie Python-skrifte verander nie!

VS-kode: Om Python-skrifte te skryf. Die python-skrifte wat deur VSCode geskryf is, moet later in QPYcom ingevoer word.

Firmware flits
Standaard AT-firmware of QuecOpen-firmware word gewoonlik in 'n module afgelaai wanneer die module die fabriek verlaat. As jy die module gebaseer op QuecPython wil ontwikkel, moet jy die toegewyde QuecPython-firmware met die hand weer daarin aflaai. https://python.quectel.com/en/download
Let wel: QuecPython vereis 'n spesiale firmware! Dit moet apart geflits word. Nadat hierdie firmware geflits is, kan die bord NIE vir die AT-opdragomgewing gebruik word nie. As ontwikkeling met AT-opdragte verlang word, moet die ooreenstemmende firmware weer geflits word.

Example: BG95_M3 QPython Firmware Flash:

Poortverbinding BG95M3
REPL Port: REPL staan ​​vir Read-Eval-Print-Loop (interaktiewe tolk). U kan QuecPython-programme in REPL ontfout. Kann python Befehle eingeben (zB 5+3) REPL, kort vir Read-Eval-Print Loop, is 'n eenvoudige interaktiewe programmeringsomgewing. REPL verskaf tipies 'n Command-Line Interface (CLI) wat gebruikersinvoer ontvang, dit ontleed en uitvoer, en dan die resultate aan die gebruiker terugstuur. Wat funksionaliteit en gebruik betref, is dit soortgelyk aan die Command Prompt (CMD) in Windows of die Shell in macOS/Linux.

DM Port: Digitale mediapoort. Vir firmware flits.

Begin Qpython-funksies en -opdragte

Netwerkregistrasie (in QPYcom, REPL-poort)

Invoer netto

• net.operatorName() kry die operateurinligting van die huidige netwerkregistrasie.
• net.getModemFun() Hierdie metode word gebruik om die huidige funksionele modus van die module te verkry.
• net.getState() kry die netwerkregistrasie-inligting. AT+CREG=?

Vestig DataCall

Voer dataoproep in

dataCall.getInfo(profileID, ipType)

• # profileID – PDP ID, reeks 1~3.
• # ipType – IP tipe，0：IPV4 1：IPV6 2：IPV4&IPV6
• As die uitset (1, 0, [0, 0, '0.0.0.0', '0.0.0.0', '0.0.0.0'] is), beteken dit dat die netwerk reeds geregistreer is, maar die data-oproep is nie gestel nie op. dataCall.setPDPContext(1,0,'iot.1nce.net',”,”,1) -> terugkeer: 0 = suksesvol
• Die PDP-konteks met die toepaslike APN moet volgens die SIM-kaartvervaardiger ingestel word. (In ons geval is die SIM-kaartvervaardiger 1NCE, dus moet jy die APN-instellings vir 1NCE soek).

Tabel:

Stel waarde

• APN: iot.1nce.net
• Gebruikersnaam: Nie nodig nie, laat leeg
• Wagwoord: Nie nodig nie, laat leeg
• Stawing Metode: Wagwoordverifikasieprotokol (PAP)
• Internet Protokol: Internetprotokol weergawe 4 (IPv4)

dataCall.getPDPContext(1) -> terugkeer: 0 = suksesvol
dataCall.activate(1) -> terugkeer: 0 = suksesvol
dataCall.getInfo(1,0) -> terugkeer: (1, 0, [1, 0, '100.69.60.50', '8.8.8.8', '8.8.4.4'])

invoer checkNet
checkNet.waitNetworkReady(60) -> terugkeer: (3,1) netwerk gereed

Verwysings
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