Manual Arahan Lembaga Pembangunan EVB tekmodul BG95M3-QPython

tekmodul BG95M3-QPython EVB Development Board

Perbezaan daripada MicroPython

QuecPython pada dasarnya adalah MicroPython yang dijalankan pada modul Quectel. Disebabkan kekurangan spesifikasi standard yang komprehensif dalam MicroPython, perpustakaan terbina dalam dan penggunaan pelbagai fungsi mungkin berbeza-beza bergantung pada pembangun dan platform perkakasan. Sesetengah pengguna QuecPython mungkin mempunyai pengalaman terdahulu membangunkan dengan MicroPython pada modul seperti ESP32, ESP8266 dan STM32. Untuk memudahkan pemindahan pengguna ini, perbezaan yang diketahui antara QuecPython dan MicroPython disenaraikan di bawah:

• Sesetengah pustaka standard atau khusus MicroPython, seperti framebuf dan rangkaian, tidak dilaksanakan atau terbina dalam QuecPython.
• Sesetengah perpustakaan standard MicroPython, seperti utime, mungkin mempunyai pelaksanaan dan kesempurnaan ciri yang berbeza dalam QuecPython berbanding modul seperti ESP32, yang mengakibatkan perbezaan dalam prestasi atau ciri terperinci lain.
• Organisasi ciri tertentu dalam QuecPython mungkin berbeza daripada MicroPython. Untuk exampOleh itu, fungsi ADC secara amnya disertakan dalam pustaka mesin dalam MicroPython, tetapi dalam QuecPython, ia disertakan dalam pustaka misc.
• API yang berkaitan dengan antara muka perkakasan tertentu seperti UART, I2C dan SPI mempunyai perbezaan yang ketara antara MicroPython dan QuecPython dan tidak boleh digunakan secara bergantian.
• Pada masa ini, QuecPython tidak menyertakan fungsi upip, jadi pemasangan perpustakaan dalam talian yang cepat tidak dapat dilakukan. Pengalihan manual diperlukan.
• Keserasian dengan alat IDE MicroPython seperti Thonny dan uPyCraft tidak dijamin.
• Ringkasnya, kod MicroPython yang berjalan dengan jayanya pada modul seperti ESP32 biasanya tidak boleh terus disalin dan dijalankan dalam persekitaran QuecPython tanpa sebarang pengubahsuaian. Oleh itu, adalah dinasihatkan untuk mengelakkan penggunaan dokumentasi dan pengalaman pembangunan secara langsung daripada modul perkakasan MicroPython yang lain kepada pembangunan QuecPython.

Perbezaan daripada CPython (Normal Python)

• Tidak seperti pembangunan CPython tradisional, QuecPython mempunyai bilangan perpustakaan terbina dalam yang jauh lebih kecil (perpustakaan standard). Walaupun QuecPython menyertakan perpustakaan asas untuk tugasan seperti penetapan masa dan file pengurusan, kuantitinya jauh lebih rendah berbanding CPython. Nama dan kaedah penggunaan perpustakaan standard ini juga mempunyai banyak perbezaan dan tidak serasi sepenuhnya.
• QuecPython tidak mempunyai kefungsian pip terbina dalam, jadi pemasangan perpustakaan dalam talian yang cepat tidak dapat dilakukan. Pengalihan manual diperlukan.
• Disebabkan oleh perbezaan sintaks antara QuecPython dan CPython, serta fakta bahawa kebanyakan perpustakaan QuecPython tidak boleh dijalankan pada komputer desktop, alatan seperti VSCode dan PyCharm pada desktop hanya boleh digunakan untuk penyuntingan kod mudah. Skrip yang lengkap perlu dimuat turun secara manual ke modul untuk pelaksanaan dan penyahpepijatan.
• Ciri penyerlahan sintaks dan pelengkapan kod yang disediakan oleh alatan seperti VSCode dan PyCharm adalah berdasarkan CPython dan mungkin tidak boleh digunakan sepenuhnya untuk QuecPython. Oleh itu, bagi pemula yang tidak mempunyai pengalaman sebelumnya dengan bahasa Python, tidak disyorkan untuk menggunakan alat IDE yang terlalu pintar semasa menulis kod, kerana cadangan terbina dalam mungkin mengelirukan.

Sambungan EVB

• Langkah 1: Sambungkan EVB
  Sambungkan port EVB Type-C ke port USB PC anda dengan kabel USB Type-C untuk bekalan kuasa.
• Langkah 2: Hidupkan EVB
  Pendekkan dua pin PWK_AUTO dengan penutup pelompat untuk menghidupkan papan dan ia akan dihidupkan secara automatik, atau tekan lama butang PWK selepas dihidupkan. Adalah disyorkan bahawa selang masa antara menghidupkan kuasa dan menekan butang PWK hendaklah sekurang-kurangnya 30 ms. Selepas melakukan operasi di atas, tunggu penunjuk kuasa pada papan utama menyala (PWR LED menyala biru, PWM menyala hijau, kemudian EVB harus dikenali dalam Pengurus Peranti.).

Pilihan SIM
Untuk BG95 EVB, kad SIM NB-IoT harus digunakan. Untuk ujian kami menggunakan SIM 1NCE (Ia sepatutnya mengenali rangkaian Telekom, menghantar SMS dan menyokong Perayauan Nasional).
Alatan

QPYcom. Alat ini digunakan untuk menyahpepijat kod, menganalisis log, memuat naik skrip python ke modul, memuat turun perisian tegar, menggabungkan perisian tegar dan banyak lagi. Tidak boleh mengubah suai skrip Python!

Kod VSC: Untuk menulis skrip Python. Skrip python yang ditulis oleh VSCode mesti diimport ke dalam QPYcom kemudian.

Perisian Tegar Berkelip
Perisian tegar AT standard atau perisian tegar QuecOpen biasanya dimuat turun ke dalam modul apabila modul meninggalkan kilang. Jika anda ingin membangunkan modul berdasarkan QuecPython, anda perlu memuat turun semula secara manual perisian tegar QuecPython khusus ke dalamnya. https://python.quectel.com/en/download
Nota: QuecPython memerlukan perisian tegar khas! Ia perlu dipancarkan secara berasingan. Selepas memancarkan perisian tegar ini, papan TIDAK BOLEH digunakan untuk persekitaran arahan AT. Jika pembangunan dengan arahan AT dikehendaki, perisian tegar yang sepadan mesti dipancarkan semula.

Example: BG95_M3 QPython Firmware Flash:

Sambungan Port BG95M3
Port REPL: REPL adalah singkatan kepada Read-Eval-Print-Loop (penterjemah interaktif). Anda boleh nyahpepijat program QuecPython dalam REPL. Kann python Befehle eingeben (zB 5+3) REPL, singkatan untuk Read-Eval-Print Loop, ialah persekitaran pengaturcaraan interaktif yang ringkas. REPL biasanya menyediakan Antara Muka Baris Perintah (CLI) yang menerima input pengguna, menghuraikan dan melaksanakannya, dan kemudian mengembalikan hasilnya kepada pengguna. Dari segi fungsi dan penggunaan, ia serupa dengan Command Prompt (CMD) dalam Windows atau Shell dalam macOS/Linux.

DM Pelabuhan: Pelabuhan Media Digital. Untuk Firmware Flashing.

Fungsi dan Perintah Qpython Permulaan

Pendaftaran Rangkaian (dalam QPYcom, port REPL)

Bersih import

• net.operatorName() mendapat maklumat pengendali pendaftaran rangkaian semasa.
• net.getModemFun() Kaedah ini digunakan untuk mendapatkan mod fungsi semasa modul.
• net.getState() mendapat maklumat pendaftaran rangkaian. AT+CREG=?

Wujudkan DataCall

Import dataCall

dataCall.getInfo(profileID, ipType)

• # profileID – ID PDP，julat 1~3。
• # ipType – IP type，0：IPV4 1：IPV6 2：IPV4&IPV6
• Jika output ialah (1, 0, [0, 0, '0.0.0.0', '0.0.0.0', '0.0.0.0']), ini bermakna rangkaian sudah didaftarkan, tetapi panggilan data tidak ditetapkan naik. dataCall.setPDPContext(1,0,'iot.1nce.net',”,”,1) -> return: 0 = berjaya
• Konteks PDP dengan APN yang sesuai mesti ditetapkan mengikut pengeluar kad SIM. (Dalam kes kami, pengeluar kad SIM ialah 1NCE, jadi anda perlu mencari tetapan APN untuk 1NCE).

Jadual:

Menetapkan Nilai

• APN: iot.1nce.net
• Nama pengguna: Tidak Diperlukan, Biarkan Kosong
• Kata laluan: Tidak Diperlukan, Biarkan Kosong
• Pengesahan Kaedah: Protokol Pengesahan Kata Laluan (PAP)
• Internet Protokol: Protokol Internet Versi 4 (IPv4)

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

import checkNet
checkNet.waitNetworkReady(60) -> pulangan: (3,1) rangkaian sedia

Rujukan
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