DEV Community: QuecPython

QuecPython + Qrcode: Generate QR Codes Quickly

QuecPython — Fri, 22 May 2026 11:02:27 +0000

Overview

QuecPython provides a concise and efficient QR code generation and display solution. Developers only need to call one line of code to present a QR code on the device screen, significantly lowering the development threshold for information interaction in IoT devices. This feature is perfectly compatible with various screen-equipped modules, supports standard formats such as text, URLs, and WiFi configurations, and allows customization of size and colors. It can be quickly applied to scenarios like device provisioning and information display. Through highly encapsulated API design, QuecPython makes QR code function development unprecedentedly simple and efficient, helping developers easily implement convenient interaction between devices and mobile phones.

Core Advantages

Minimalist Invocation: No need for complex graphics libraries, display QR codes directly
Intelligent Adaptation: Automatically matches screen resolution
Multi-content Support: Supports formats such as URLs, text, and contact information

Typical Application Scenarios

Device Provisioning: Display WiFi connection QR codes for one-click network configuration
Information Exchange: Share device serial numbers, configuration information, and other key data
Webpage Redirection: Display links to product official websites and technical documents

Feature Introduction

### QR Code Display

This method is used to display a QR code on the LCD.

qrcode.show(qrcode_str, magnification, start_x, start_y, Background_color, Foreground_color)

Parameter Description:

qrcode_str - string type, QR code content (required)
magnification - int type, magnification factor 1, 6
start_x - int type, starting X coordinate for QR code display (required)
start_y - int type, starting Y coordinate for QR code display (required)
Background_color - int type, background color (hexadecimal), default: 0xffffff (white)
Foreground_color - int type, foreground color (hexadecimal), default: 0x000000 (black)

Application Example

Note: Before using the QR code function, you must initialize the LCD first.

LCD initialization program reference: https://github.com/QuecPython/QuecPython_lib_bundles/tree/master/libraries/LCD

Use QuecPython series development boards and LCD screens to implement QR code display.

import qrcode

qrcode.show("python.quectel.com", 6, 45, 45, 0xffffff, 0x00ff00)

After entering the above code in the QPYcom interactive tool, the QR code will be successfully generated

Scan the generated QR code with a mobile phone to quickly access the QuecPython official website

QuecPython + Alibaba Cloud IoT: Quick Connection to Alibaba Cloud IoT Platform

QuecPython — Fri, 22 May 2026 10:55:44 +0000

Overview

With the rapid development of IoT technology, cloud platforms have become the core hub connecting the physical and digital worlds. QuecPython deeply integrates with the Alibaba Cloud IoT Platform (aLiYun) to launch an integrated "device + cloud" development solution, providing IoT developers with out-of-the-box cloud connectivity capabilities.

Core Advantages

Minimalist Development Interface: Through Pythonic API design, complex underlying operations such as MQTT protocol stacks, security authentication, and data encoding/decoding are encapsulated into concise method calls, eliminating the need for complex low-level driver writing.
Comprehensive Documentation: Each API interface comes with detailed usage instructions, allowing developers to easily design and implement projects by following the documentation.

Feature Overview

This article mainly introduces how to use QuecPython series modules to connect to the Alibaba Cloud IoT Platform and perform data subscription and publishing. The general connection process is as follows:

Initialize the Alibaba Cloud IoT Platform
Configure related functions and callbacks
Implement subscription and publishing functions
Start and stop connections

Initialize Alibaba Cloud IoT Platform

This method is used to configure product and device information for the Alibaba IoT Platform IoT Suite and returns an aLiYun connection object.

aLiYun(productKey, productSecret, DeviceName, DeviceSecret, MqttServer)

Run

For detailed API information, please refer to aLiYun.

Configure Related Functions and Callbacks

MQTT Parameter Configuration

This method is used to set MQTT data channel parameters.

aLiYun.setMqtt(clientID, clean_session, keepAlive=300, reconn=True)

Run

For detailed API information, please refer to aLiYun.setMqtt.

Callback Registration

This method is used to register callback functions.

aLiYun.setCallback(callback)

Run

For detailed API information, please refer to aLiYun.setCallback.

Subscription and Publishing

This method is used to subscribe to MQTT topics.

aLiYun.subscribe(topic, qos)

Run

For detailed API information, please refer to aLiYun.subscribe.

Publish

This method is used to publish messages.

aLiYun.publish(topic, msg, qos=0)

Run

For detailed API information, please refer to aLiYun.publish.

Start and Stop Functions

Start Connection

This method is used to initiate the connection.

aLiYun.start()

Run

For detailed API information, please refer to aLiYun.start.

Close Connection

This method is used to terminate the connection.

aLiYun.disconnect()

Run

For detailed API information, please refer to aLiYun.disconnect.

Application Example

import log

import utime

import checkNet

from aLiYun import aLiYun

'''

The following two global variables are required. Users can modify their values according to their actual project needs

'''

PROJECT_NAME = "QuecPython_AliYun_example"

PROJECT_VERSION = "1.0.0"

checknet = checkNet.CheckNetwork(PROJECT_NAME, PROJECT_VERSION)

Set log output level

log.basicConfig(level=log.INFO)

aliYun_log = log.getLogger("ALiYun")

productKey = "" # Product identifier (refer to Alibaba IoT Platform application development guide)

productSecret = None # Product secret (pass None when using one-device-one-secret authentication, refer to Alibaba IoT Platform application development guide)

DeviceName = "" # Device name (refer to Alibaba IoT Platform application development guide)

DeviceSecret = "" # Device secret (pass None when using one-product-one-secret authentication. Pre-registration-free is not supported yet. Devices must be created on the IoT Platform first. Refer to Alibaba IoT Platform application development guide)

state = 5

Callback function

def sub_cb(topic, msg):

global state

aliYun_log.info("Subscribe Recv: Topic={}, Msg={}".format(topic.decode(), msg.decode()))

state -= 1

if name == 'main':

stagecode, subcode = checknet.wait_network_connected(30)

if stagecode == 3 and subcode == 1:

aliYun_log.info('Network connection successful!')

# Create Alibaba Cloud connection object

ali = aLiYun(productKey, productSecret, DeviceName, DeviceSecret)

# Set MQTT connection properties

clientID = "" # Custom string (no more than 64 characters)

ali.setMqtt(clientID, clean_session=False, keepAlive=300)

# Set callback function

ali.setCallback(sub_cb)

topic = "" # Custom or owned topic on the IoT Platform

# Subscribe to topic

ali.subscribe(topic)

# Publish message

ali.publish(topic, "hello world")

# Start connection

ali.start()

while 1:

if state:

pass

else:

ali.disconnect()

break

else:

aliYun_log.info('Network connection failed! stagecode = {}, subcode = {}'.format(stagecode, subcode))

Call.md

QuecPython — Fri, 22 May 2026 10:49:13 +0000

## Overview
With the high-level API encapsulation of QuecPython modules, developers can quickly implement voice call functionality without delving into underlying protocols. In the REPL interactive environment, only one line of code is required to control the device to dial a specified mobile phone number, which significantly lowers the development threshold for IoT voice capabilities!

## Core Advantages
Ultra-simple invocation: voiceCall.callStart("xxxxxxxxxxx") triggers a call directly with no complex configuration needed
Instant verification: Real-time debugging in the REPL environment for quick validation of call functions
Full-feature support: Comprehensive coverage of communication processes including dialing, answering, and hanging up calls
Multi-network compatibility: Supports cellular networks such as 4G/CAT1 to ensure call quality

## Feature Introduction

### Making a Call
This method is used to actively initiate a phone call.

voiceCall.callStart(phonenum)

Get the complete project code with one click

API reference

voiceCall.callStart(phonenum)

For detailed API information, please refer to voiceCall.callStart.

## Answering a Call
This method is used to answer an incoming phone call.

voiceCall.callAnswer()

Get the complete project code with one click

API reference

voiceCall.callAnswer()

For detailed API information, please refer to voiceCall.callAnswer.

## Hanging Up a Call
This method is used to end an ongoing phone call.

voiceCall.callEnd()

Get the complete project code with one click.

API reference

voiceCall.callEnd()

For detailed API information, please refer to voiceCall.callEnd.

## Volume Configuration

Getting Volume

This method is used to retrieve the current call volume level.

voiceCall.getVolume()

Get the complete project code with one click.

API reference

voiceCall.getVolume()

For detailed API information, please refer to voiceCall.getVolume.

### Setting Volume

This method is used to set the call volume level.

voiceCall.setVolume(volume)

Get the complete project code with one click.

API reference

voiceCall.setVolume(volume)

For detailed API information, please refer to voiceCall.setVolume.

## Application Example

Implement making and answering calls between QuecPython series development boards and mobile phones using the voiceCall feature.

import voiceCall

Make a call

voiceCall.callStart("xxxxxxxxxxx")

Hang up the call:

voiceCall.callEnd()

Answer a call

voiceCall.callAnswer()

Key Notes on Translation

Maintained technical accuracy (e.g., "REPL" retained as the standard technical term, "CAT1" unchanged as a cellular network specification)
Ensured natural expression of technical documentation (e.g., "一键获取完整项目代码" translated to "Get the complete project code with one click" for readability)
Kept code block formatting consistent with the original
Standardized terminology (e.g., "拨打电话 / 接听电话 / 挂断电话" translated to "Making a Call/Answering a Call/Hanging Up a Call" for consistency)
Adjusted minor formatting (e.g., added code block markers for Python snippets) to conform to English technical documentation conventions while preserving the original content structure.

QuecPython + sms: SMS Functionality

QuecPython — Fri, 24 Apr 2026 12:35:41 +0000

Overview

With the encapsulation capability of QuecPython, developers can quickly implement SMS sending and receiving functions without dealing with complex AT commands. In the REPL interactive environment, SMS sending can be completed with just one line of code, making IoT communication development more efficient!

Core Advantages

Minimalist Call: Send SMS directly with sms.sendTextMsg("xxxxxxxxxxx", "HelloQuecPython!")
Instant Send and Test: Real-time execution in the REPL environment for quick verification of SMS functions
Full Support: Easily implement SMS sending, receiving, deletion and other operations

Function Introduction

Send SMS

TEXT Message

This method is used to send TEXT type messages (empty SMS is not supported).

sms.sendTextMsg(phoneNumber, msg, codeMode)

For API details, please refer to sms.sendTextMsg.

PDU Message

This method is used to send PDU type messages (empty SMS is not supported).

sms.sendPduMsg(phoneNumber, msg, codeMode)

For API details, please refer to sms.sendPduMsg.

Delete SMS

This method is used to delete the message at the specified index.

sms.deleteMsg(index [, delmode])

For API details, please refer to sms.deleteMsg.

Get SMS Quantity

This method is used to get the number of SMS messages.

sms.getMsgNums()

For API details, please refer to sms.getMsgNums.

Get SMS Content

TEXT Mode

This method is used to get SMS content in TEXT mode.

sms.searchTextMsg(index)

For API details, please refer to sms.searchTextMsg.

PDU Mode

This method is used to get SMS content in PDU mode.

sms.searchPduMsg(index)

For API details, please refer to sms.searchPduMsg.

SMS Decoding

Length Decoding

This method is used to get the length of the specified PDU SMS.

sms.getPduLength(pduMsg)

For API details, please refer to sms.getPduLength.

Content Decoding

This method is used for PDU decoding, which parses the PDU data read by the sms.searchPduMsg() interface.

sms.decodePdu(pduMsg, pduLen)

For API details, please refer to sms.decodePdu.

## Application Example
Use the SMS function of the QuecPython series development board to send and receive SMS with a mobile phone.

import sms

sms.deleteMsg(1,4) # Delete all SMS messages

Fill in the correct phone number

sms.sendTextMsg('xxxxxxxxxxx', 'Hello, world.', 'GSM') # Send SMS to the mobile phone

Get SMS content in TEXT mode

sms.searchTextMsg(0) # Receive SMS sent by the mobile phone

QuecPython + GNSS: Implement Fast Positioning

QuecPython — Fri, 24 Apr 2026 12:32:32 +0000

Overview

QuecPython, combined with a GNSS (Global Navigation Satellite System) module, provides an out-of-the-box positioning capability solution for IoT devices. This solution supports multi-constellation joint positioning including GPS, BeiDou, GLONASS and Galileo, and delivers a full-stack positioning solution from hardware access to cloud services for IoT developers.

Advantages and Features

Multi-mode Positioning: Supports GNSS, LBS and Wi-Fi positioning functions
Minimalist Development: Highly encapsulated API interfaces, no need to write underlying drivers

Functional Overview

This article mainly describes how to use the built-in GNSS function of the QuecPython development board to obtain positioning information. The typical programming workflow is divided into the following parts:

GNSS Initialization
Positioning Data Acquisition

GNSS Initialization

This method is used to initialize the function of the module's built-in GNSS module.

quecgnss.init()

For API details, please refer to quecgnss.init.

Positioning Data Acquisition

This method is used to read GNSS positioning data.

quecgnss.read(size)

For API details, please refer to quecgnss.read.

Parameter Configuration

This method is used to set GNSS parameters, including satellite constellation, NMEA sentence type, whether to enable AGNSS and APFLASH, etc.

quecgnss.configSet(config_type, config_value)

For API details, please refer to quecgnss.configSet.

Sample Code

import quecgnss

Initialization

quecgnss.init()

Read data

data = quecgnss.read(4096)

Print data

print(data[1].decode())

Operation Result

The following is an example of the operation result, which mainly introduces the content of the positioning data.

Operation Result

167,169,170,,,,,,,,1.773,1.013,1.455*15

$GPGSV,2,1,8,3,23,303,34,16,32,219,28,22,74,98,26,25,16,43,25*77

$GPGSV,2,2,8,26,70,236,28,31,59,12,38,32,55,127,34,4,5,,21*49

$BDGSV,2,1,8,163,51,192,32,166,70,11,31,167,52,197,32,169,59,334,31*61

$BDGSV,2,2,8,170,40,205,31,161,5,,31,164,5,,27,165,5,,29*59

$GNRMC,022326.000,A,3149.324624,N,11706.921702,E,0.000,261.541,180222,,E,A*38

$GNGGA,022326.000,3149.324624,N,11706.921702,E,1,12,1.013,-8.580,M,0,M,,*47

$GNGLL,3149.324624,N,11706.921702,E,022326.000,A,A*44

$GNGSA,A,3,31,32,3,16,22,25,26,,,,,,1.773,1.013,1.455*1C

$GNGSA,A,3,163,166,167,169,170,,,,,,,,1.773,1.013,1.455*15

$GPGSV,2,1,8,3,23,303,34,16,32,219,27,22,74,98,26,25,16,43,25*78

$GPGSV,2,2,8,26,70,236,28,31,59,12,37,32,55,127,34,4,5,,20*47

$BDGSV,2,1,8,163,51,192,32,166,70,11,31,167,52,197,32,169,59,334,31*61

$BDGSV,2,2,8,170,40,205,31,161,5,,31,164,5,,27,165,5,,29*59

$GNRMC,022327.000,A,3149.324611,N,11706.921713,E,0.000,261.541,180222,,E,A*3F

$GNGGA,022327.000,3149.324611,N,11706.921713,E,1,12,1.013,-8.577,M,0,M,,*48

$GNGLL,3149.324611,N,11706.921713,E,022327.000,A,A*43

...... # More data omitted

$GNGSA,A,3,31,32,3,16,22,25,26,,,,,,1.837,1.120,1.456*11

$GNGSA,A,3,163,166,167,169,170,,,,,,,,1.837,1.120,1.456*18

$GPGSV,2,1,8,3,23,302,27,16,32,220,26,22,73,101,27,25,16,43,27*45

$GPGSV,2,2,8,26,70,237,28,31,59,13,33,32,54,128,28,4,5,,24*44

$BDGSV,2,1,8,163,51,192,33,166,71,11,35,167,52,198,33,169,59,334,34*6E

$BDGSV,2,2,8,170,40,205,32,161,5,,33,164,5,,28,165,5,,30*5F

$GNRMC,022507.000,A,3149.324768,N,11706.922344,E,0.000,261.541,180222,,E,A*31

$GNGGA,022507.000,3149.324768,N,11706.922344,E,1,12,1.120,-8.794,M,0,M,,*48

$GNGLL,3149.324768,N,11706.922344,E,022507.000,A,A*4D

$GNGSA,A,3,31,32,3,16,22,25,26,,,,,,1.837,1.120,1.455*12

$GNGSA,A,3,163,166,167,169,170,,,,,,,,1.837,1.120,1.455*1B

$GPGSV,2,1,8,3,23,302,26,16,32,220,26,22,73,101,27,25,16,43,26*45

$GPGSV,2,2,8,26,70,237,28,31,59,13,32,32,54,128,28,4,5,,24*45

$BDGSV,2,1,8,163,51,192,24,166,71,11,35,167,52,198,33,169,59,334,34*68

$BDGSV,2,2,8,170,40,205,31,161,5,,33,164,5,,28,165,5,,30*5C

$GNRMC,022508.000,A,3149.324754,N,11706.922338,E,0.002,261.541,180222,,E,A*38

$GNGGA,022508.000,3149.324754,N,11706.922338,E,1,12,1.120,-8.750,M,0,M,,*4B

$GNGLL,3149.324754,N,11706.922338,E,022508.000,A,A*46

$GNGSA,A,3,31,3

Data Introduction

NMEA Port Data Classification:

$GPGGA Global Positioning System Fix Data

$GPGSA GNSS DOP and Active Satellites

$GPGSV GNSS Satellites in View

$GPRMC Recommended Minimum Specific GNSS Data

$GPVTG Course Over Ground and Ground Speed

$GPDTM Datum Reference

$GPGNS GNSS Fix Data

NMEA Sentence Parsing:

Basic format of the GSV sentence:

$GPGSV,(1),(2),(3),(4),(5),(6),(7),...,(4),(5),(6),(7)*hh(CR)(LF)

Field 1: Total number of GSV sentences

Field 2: Sequence number of this GSV sentence

Field 3: Total number of visible satellites (00~12, leading 0 will be transmitted)

Field 4: Satellite PRN number (01~32, leading 0 will be transmitted)

Field 5: Satellite elevation (00~90 degrees, leading 0 will be transmitted)

Field 6: Satellite azimuth (000~359 degrees, leading 0 will be transmitted)

Field 7: Signal-to-Noise Ratio (00~99dB, empty when no satellite is tracked) (commonly known as CN value)

Basic format of the GGA sentence:

$GPGGA,(1),(2),(3),(4),(5),(6),(7),(8),(9),(10),(11),(12)*hh(CR)(LF)

Field 1: UTC time, in hhmmss.sss format (hours, minutes and seconds)

Field 2: Latitude, in ddmm.mmmm format (degrees and minutes, padded with 0 if leading digits are insufficient)

Field 3: Latitude hemisphere, N (North) or S (South)

Field 4: Longitude, in dddmm.mmmm format (degrees and minutes, padded with 0 if leading digits are insufficient)

Field 5: Longitude hemisphere, E (East) or W (West)

Field 6: GPS status, 0=No fix, 1=Non-differential fix, 2=Differential fix, 3=Invalid PPS, 6=Estimating

Field 7: Number of satellites in use (00 - 12, padded with 0 if leading digits are insufficient)

Field 8: HDOP (Horizontal Dilution of Precision) (0.5 - 99.9)

Field 9: Altitude above mean sea level (-9999.9 - 99999.9)

Field 10: Unit of altitude, meters

Field 11: Geoidal separation (Height of the geoid above the WGS84 ellipsoid)

Field 12: Unit of geoidal separation, meters

Basic format of the GSA sentence:

$GPGSA,(1),(2),(3),(3),,,,,,,,,,(3),(4),(5),(6),(7)*hh(CR)(LF)

Field 1: Positioning mode, A=Automatic 2D/3D, M=Manual 2D/3D

Field 2: Fix type, 1=No fix, 2=2D fix, 3=3D fix

Field 3: PRN (Pseudo Random Noise) code of the satellite in use (up to 12 entries, padded with 0 if leading digits are insufficient)

Field 4: PDOP (Position Dilution of Precision) (0.0 - 500.0)

Field 5: HDOP (Horizontal Dilution of Precision) (0.0 - 500.0)

Field 6: VDOP (Vertical Dilution of Precision) (0.0 - 500.0)

Field 7: Satellite system ID

Basic format of the VTG sentence:

$GPVTG,(1),(2),(3),(4),(5),(6),(7),(8),(9)*hh(CR)(LF)

Field 1: Course over ground (000 - 359 degrees, padded with 0 if leading digits are insufficient)

Field 2: T=True north reference

Field 3: Course over ground (000 - 359 degrees, padded with 0 if leading digits are insufficient)

Field 4: M=Magnetic north reference

Field 5: Ground speed (0.00, padded with 0 if leading digits are insufficient)

Field 6: N=Knots

Field 7: Ground speed (0.00, padded with 0 if leading digits are insufficient)

Field 8: K=Kilometers per hour (km/h)

Field 9: Status indicator, E(Dead reckoning), A(Non-DGPS fix)

Basic format of the RMC sentence:

$GPRMC,(1),(2),(3),(4),(5),(6),(7),(8),(9),(10),(11),(12),(13)*hh(CR)(LF)

Field 1: UTC time, in hhmmss.sss format

Field 2: Status, A=Valid fix, V=Invalid fix

Field 3: Latitude, in ddmm.mmmm format (padded with 0 if leading digits are insufficient)

Field 4: Latitude hemisphere, N (North) or S (South)

Field 5: Longitude, in dddmm.mmmm format (padded with 0 if leading digits are insufficient)

Field 6: Longitude hemisphere, E (East) or W (West)

Field 7: Speed over ground, in Knots

Field 8: Course over ground, in degrees

Field 9: UTC date, in DDMMYY format

Field 10: Magnetic variation (000 - 180 degrees, padded with 0 if leading digits are insufficient)

Field 11: Magnetic variation direction, E=East, W=West

Field 12: Status indicator, E(Dead reckoning), A(Non-DGPS fix)

Field 13: Navigation status, V=Navigation status not available

Basic format of the DTM sentence:

$GNDTM,<1>,<2>,<3>,<4>,<5>,<6>,<7>,<8>*<9>(CR)(LF)

<1> Local datum code (e.g. W84, P90)

<2> Datum subcode (empty)

<3> Latitude offset

<4> Latitude hemisphere, N (North) or S (South)

<5> Longitude offset

<6> Longitude hemisphere, E (East) or W (West)

<7> Altitude offset

<8> Reference datum code (W84)

<9> Checksum

Basic format of the GNS sentence:

$GNGNS,<1>,<2>,<3>,<4>,<5>,<6>,<7>,<8>.<9>,<10>,<11>,<12>,<13>,*<14>(CR)(LF)

<1> UTC time: Fix time in hhmmss.ss format (000000.00~235959.99)

<2> Latitude: in ddmm.mmmmm format (0000.00000~8959.9999)

<3> Latitude hemisphere: N for North, S for South

<4> Longitude: in dddmm.mmmmm format (0000.00000~17959.99999)

<5> Longitude hemisphere: E for East, W for West

<6> Positioning mode: N=No fix; A=Autonomous fix; D=Differential fix; P=Precise point positioning; R=RTK fixed; F=RTK float; E=Estimated; M=Manual input; S=Simulated

<7> Number of satellites used in positioning (00-99)

<8> HDOP (Horizontal Dilution of Precision) (0.5-99.9)

<9> Altitude above mean sea level, unit: meters

<10> Geoidal separation: Height of the geoid above the WGS84 ellipsoid

<11> Age of differential data: Empty for GN-prefixed sentences

<12> Base station ID: Empty for GN-prefixed sentences

<13> Navigation status: C=Caution, S=Safe, U=Unsafe, V=Invalid

<14> Checksum

QuecPython + audio: Implement Audio Recording and Playback

QuecPython — Fri, 24 Apr 2026 12:29:57 +0000

Overview

As a development framework designed specifically for the Internet of Things, QuecPython provides complete audio processing capabilities for embedded devices through highly encapsulated Python interfaces. This article mainly describes how to quickly implement audio function development with QuecPython.

Core Advantages

• Minimalist Development: Complete basic audio recording and playback with just 3 lines of code.

• Quick Start: Get started rapidly without professional audio knowledge.

• Complete Documentation: Supported by full technical documentation and sample code.

Main Functions

TTS - Text to Speech Playback

Create TTS Object

class audio.TTS(device)

For parameter details, please refer to audio.TTS.

Speech Playback

This method is used to start speech playback.

TTS.play(priority, breakin, mode, str)

For API details, please refer to TTS.play.

Volume Setting

This method is used to set the playback volume. The volume value must be in the range [0 ~ 9], where 0 means mute.

TTS.setVolume(vol)

For API details, please refer to TTS.setVolume.

Playback Speed Setting

This method is used to set the TTS playback speed. The speed value must be in the range [0 ~ 9].

TTS.setSpeed(speed)

For API details, please refer to TTS.setSpeed.

Sample Code

import audio tts = audio.TTS(1) # Case: Task A is playing and allows interruption. When Task B with a higher priority arrives, Task A will be interrupted and Task B will be played directly tts.play(1, 1, 2, '111') # Task A tts.play(2, 0, 2, '222') # Task B

Audio - Audio Playback

Create Audio Object

class audio.Audio(device)

For parameter details, please refer to audio.Audio.

Set PA Pin

This method is used to configure the GPIO of the output PA. Refer to the schematic of the corresponding development board to set the PA pin, so that the SPK interface of the development board can output sound.

Audio.set_pa(gpio,num)

For API details, please refer to Audio.set_pa.

Audio Playback

This method is used to play audio files, supporting playback of files in mp3, amr and wav formats.

Audio.play(priority, breakin, filename)

For API details, please refer to Audio.play.

Volume Setting

This method is used to set the playback volume. The volume value must be in the range [0 ~ 11], where 0 means mute.

Audio.setVolume(vol)

For API details, please refer to Audio.setVolume.

Audio Stream Playback

This method is used for audio stream playback, supporting playback of audio streams in mp3, amr and wav formats.

Audio.playStream(format, buf)

For API details, please refer to Audio.playStream.

Sample Code

import audio from machine import Pin aud = audio.Audio(0) # Set PA pin aud.set_pa(Pin.GPIO15,2) # Play MP3 file aud.play(2, 1, 'U:/music.mp3')

Record - Audio Recording

Create Record Object

class audio.Record(device)

For parameter details, please refer to audio.Record.

Start Recording

This method is used to start audio recording.

Record.start(file_name,seconds)

For API details, please refer to Record.start.

Audio Stream Recording

This method is used to start audio stream recording.

Note: While recording the audio stream, you must read the audio stream in a timely manner. A circular buffer is currently used, and failure to read in time will result in data loss.

Record.stream_start(format, samplerate, time)

For API details, please refer to Record.stream_start.

Sample Code

import audio record = audio.Record() record.start('recordfile.wav', 10)

QuecPython + camera: Implement QR Code/Barcode Scanning and Photo Capture

QuecPython — Fri, 24 Apr 2026 12:22:56 +0000

Overview

With a QuecPython development board paired with a camera module, developers can easily implement code scanning (QR code/barcode recognition) and photo capture functions, which are applicable to scenarios such as smart access control, industrial inspection, and mobile payment.

Core Features

Minimalist Development Experience: No need to write underlying drivers, complete photo capture with just 3 lines of code.

Plug and Play: Supports common camera modules (such as GC032A).

Cross-platform Compatibility: Code can be ported to other QuecPython development boards that support camera functions.

Working Mode

Note: The LCD must be initialized before using the camera function.

For the LCD initialization program, please refer to: https://github.com/QuecPython/QuecPython_lib_bundles/tree/master/libraries/LCD

Camera Preview

Create Camera Preview Object

For parameter details, please refer to camera.camPreview.

Enable Camera Preview Function

This method is used to turn on the preview function of the camera.

Disable Camera Preview Function

This method is used to turn off the preview function of the camera.

For API details, please refer to camPreview.close.

Sample Code

Camera Code Scanning

Create Camera Code Scanning Object

For parameter details, please refer to camera.camScandecode.

Enable Camera Code Scanning Function

This method is used to enable the code scanning function of the camera.

For API details, please refer to camScandecode.start.

Sample Code

Camera Photo Capture

Create Camera Photo Capture Object

For parameter details, please refer to camera.camCapture.

Enable Camera Photo Capture Function

This method is used to enable the photo capture function of the camera.

Start Photo Capture

This method is used to start photo capture and save the image file.

Note: There is a typo camCapture in the original text, the standard API name is camCapture.

Sample Code

QuecPython + USBNET: Implement USB Network Adapter Functionality

QuecPython — Fri, 24 Apr 2026 12:14:42 +0000

USBNET Overview

USBNET (USB Networking) is a technology that enables network communication via a USB interface. It allows devices to emulate Ethernet over a USB connection (Ethernet over USB) or directly transmit network data through USB links. It is widely used in scenarios such as embedded devices, industrial control, virtual machines, and portable devices.

Core Features of USBNET

USB Interface Based: Implements network communication using the USB physical layer, eliminating the need for traditional network cables (such as RJ45).

High-Speed Transmission: Supports USB 2.0 (480 Mbps), USB 3.0 (5 Gbps), and even USB4 (40 Gbps).

Low Latency: Delivers lower latency than wireless networks (Wi-Fi), making it suitable for real-time data transmission.

Plug and Play: Supports hot swapping, with automatic device recognition and network configuration upon connection.

Common Working Types of USBNET

ECM Mode (Ethernet Control Model)

Protocol: Standard USB protocol with strong compatibility (natively supported by Linux/Android/macOS).

Applicable Scenarios: Embedded Linux devices, industrial controllers.

RNDIS Mode (Remote NDIS)

Protocol: Microsoft-led USB network protocol, natively supported by Windows by default.

Applicable Scenarios: Windows device debugging (e.g., Android USB network tethering).

NCM Mode (Network Control Model)

Protocol: USB-IF standard protocol, more efficient than ECM.

Applicable Scenarios: 5G modules, high-performance embedded devices.

Functional Overview

This article mainly describes how to implement the USBNET function with a QuecPython development board and provide network access for connected devices. The typical programming workflow is divided into the following parts:

Import the USBNET package
Set the working type of the USB network adapter
Enable the USB network adapter

Import the USBNET Package

First, import the USBNET package from misc.

Set the Working Type

This method is used to set the working type of the USB network adapter.

For API details, please refer to USBNET.set_worktype.

Enable the USB Network Adapter

This method is used to turn on the USB network adapter function.

For API details, please refer to USBNET.open.

Application Example

Taking the EC600MCNLE QuecPython development board as an example, this example creates a USB network adapter to provide network access for a PC. The sample code is as follows:

After entering the above code via QPYcom, the USB network adapter is enabled. When you check the network connection interface on the PC, you will see an additional available network.

Open Command Prompt (cmd) and enter ipconfig, you can see that the basic network information has been obtained. At this point, if you disable all other network interfaces and only keep the USB network adapter interface, the computer can still access the Internet normally.

You can then access web pages through your computer's browser. For example, enter https://python.quectel.com in the browser address bar to access the site normally.

QuecPython + WLAN: Wireless Network Control

QuecPython — Fri, 24 Apr 2026 12:07:54 +0000

WLAN Overview

WLAN (Wireless Local Area Network) is a network technology that enables interconnection between devices through wireless signals (such as Wi-Fi). It allows computers, smartphones, IoT devices and other terminals to access a local area network or the Internet without using physical cables.

Core Features of WLAN

• Wireless Transmission: Uses radio waves (2.4GHz/5GHz/6GHz frequency bands) instead of network cables, supporting device mobility.

• Standardized Protocols: Based on the IEEE 802.11 series of standards (such as 802.11ac, 802.11ax).

• Flexible Deployment: No wiring required, suitable for scenarios including homes, enterprises, and public places.

• Shared Bandwidth: All devices share the same wireless channel, and the available bandwidth is affected by the access point (AP) and environmental interference.

• Security Mechanisms: Supports WPA3 and WPA2 encryption to prevent unauthorized access.

Functional Overview

This article mainly describes how to use the QuecPython development board to connect to a Wi-Fi hotspot and create a Wi-Fi hotspot. The typical programming workflow is divided into the following parts:

Station Mode: Connect to a Wi-Fi hotspot

Create a Wi-Fi network interface object
Connect to the target hotspot

AP Mode: Create a Wi-Fi hotspot

Create a Wi-Fi network interface object
Set the hotspot name and password
Activate the network interface

Station Mode

Create a Wi-Fi Network Interface Object

Initialize the Wi-Fi network interface information and return the Wi-Fi network interface object.

class network.WLAN(mode)

For parameter details, please refer to the constructor.

Connect to a Hotspot

This method is used to connect to the specified wireless network. It only supports Station mode, and supports both blocking and non-blocking connection modes, with a default blocking connection and a 15s timeout period.

If the ssid and password are not specified, the device will automatically connect to the last successfully connected AP.

WLAN.connect([ssid, password, bssid, timeout])

For API details, please refer to WLAN.connect.

AP Mode

Create a Wi-Fi Network Interface Object

Initialize the Wi-Fi network interface information and return the Wi-Fi network interface object.

class network.WLAN(mode)

For parameter details, please refer to the constructor.

Set Configuration Parameters

This method is used to set the name and password of the hotspot.

WLAN.config(ap_ssid = "SSID", ap_password = "PASSWD")

For API details, please refer to WLAN.config.

Activate the Network Interface

This method is used to activate the network interface and trigger the startup of the hotspot.

WLAN.active(enable)

For API details, please refer to WLAN.active.

Application Example

This example uses the FCM360W QuecPython development board to connect to a hotspot, the sample code is as follows:

import network

Create a Wi-Fi network interface and set it to STATION modenic = network.WLAN(network.STA_MODE)

Define Wi-Fi event callback functiondef wifi_event_cb(event):

Print event informationprint("- Event:\r\n ", event)

When the IP address is obtained, print IP address related informationif event['id'] == 3305:print("- Got IP:\r\n ", nic.ifconfig())

Set the event callback
functionnic.config(event_callback = wifi_event_cb)

Connect to the hotspotnic.connect(ssid = "QuecPython", password = "12345678")

The code execution result is as follows:

Connecting to QuecPython
Event: {'msg': None, 'type': 3300, 'id': 3301}
Event: {'msg': {'password': '12345678', 'ssid': 'QuecPython', 'rssi': -62, 'channel': 1, 'bssid': 'a4:00:e2:ef:f7:80', 'auth': 4, 'cipher': 4}, 'type': 3300, 'id': 3302}
Event: {'msg': ('10.66.117.73', '255.255.252.0', '10.66.116.1', '0.0.0.0', '0.0.0.0'), 'type': 3300, 'id': 3305}
Got IP: ('10.66.117.73', '255.255.252.0', '10.66.116.1', '211.138.180.2', '114.114.114.114')

QuecPython + 1-Wire: IoT Device Communication Guide + Application Examples

QuecPython — Fri, 24 Apr 2026 12:02:30 +0000

1-Wire Overview

1-Wire is a master-slave serial communication protocol developed by Dallas Semiconductor (USA), primarily designed to enable communication between microcontrollers and 1-Wire devices. Unlike SPI and I2C serial data communication methods, 1-Wire uses a single signal line to achieve bidirectional data transmission. This design greatly simplifies hardware connections and reduces system cost and complexity.

Introduction to 1-Wire Communication Timing

The basic time slots of 1-Wire are divided into three phases: initialization, write 0 & 1, and read 0 & 1(this article uses the time slots of the DS18B20 temperature sensor as an example).

Initialization

All communication with the DS18B20 starts with an initialization sequence, which consists of a reset pulse issued by the host, followed by a presence pulse sent by the DS18B20. When the DS18B20 responds to the reset and sends a presence pulse, it signals to the host that it is connected to the bus and ready for operation.

Specific Process: The bus master transmits (TX) a reset pulse by pulling the 1-Wire bus low for a minimum of 480μs. The bus master then releases the bus and enters receive mode (RX). After the bus is released, the pull-up resistor pulls the 1-Wire bus high. When the DS18B20 detects this rising edge, it waits 15μs to 60μs, then sends a presence pulse by pulling the 1-Wire bus low for 60μs to 240μs.

Write 0 & 1

All write time slots must have a minimum duration of 60μs, with a minimum recovery time of 1μs between each write slot. Both types of write slots are initiated by the host pulling the 1-Wire bus low.

Write 0: To generate a "write 0" slot, after pulling the 1-Wire bus low, the bus master must continue to hold the bus low for the entire duration of the slot (a minimum of 60μs).

Write 1: To generate a "write 1" slot, after pulling the 1-Wire bus low, the bus master must release the 1-Wire bus within 15μs. After the bus is released, the pull-up resistor pulls the bus high.

Specific Process: The DS18B20 samples the 1-Wire bus within a 15μs to 60μs window after the host initiates the write slot. If the bus is high during the sampling window, a 1 is written to the DS18B20. If the bus is low, a 0 is written to the DS18B20.

Read 0 & 1

All read time slots must have a minimum duration of 60μs, with a minimum recovery time of 1μs between slots. A read slot is initiated by the host pulling the 1-Wire bus low for a minimum of 1μs and then releasing the bus. After the host initiates the read slot, the DS18B20 will start transmitting 1 or 0 on the bus. The DS18B20 can only send data to the host when the host issues a read slot.

Read 0: The DS18B20 will release the bus at the end of the read slot, and the bus will be pulled back to the high-level idle state by the pull-up resistor.

Read 1: The DS18B20 keeps the bus at a high level.

Specific Process: The output data from the DS18B20 is valid within 15μs after the falling edge that initiates the read slot. Therefore, the host must release the bus and then sample the bus status within 15μs after the start of the slot.

Functional Overview

This section mainly describes how to use the functions and data types of the 1-Wire driver to establish communication between QuecPython series modules and the DS18B20 sensor. The typical programming workflow is divided into the following parts:

Object Creation
Reset
Data Transmission
Data Reading

Object Creation

When creating a 1-Wire object, you need to set the GPIO connected to the DQ pin.

class machine.OneWire(GPIO)

For parameter details, please refer to the constructor.

Reset
This method is used to reset the bus and detect whether the device responds. This interface must be called first before calling the read and write interfaces.

OneWire.reset()

For API details, please refer to machine.OneWire.reset.

Data Transmission
This method is used for the host to write data to the slave, and the data to be written is of bytes type.

OneWire.write(data)

For API details, please refer to machine.OneWire.write.

Data Reading
The data read by this method is the raw data of the DS18B20, which needs to be converted into the actual temperature according to the data format of the DS18B20.

OneWire.read(len)

For API details, please refer to machine.OneWire.read.

Application Example: DS18B20 Temperature Sensor

The DS18B20 is a widely used digital temperature sensor produced by Dallas Semiconductor. It internally integrates modules including a temperature sensor, temperature conversion circuit, non-volatile memory, configuration register, and 1-Wire interface circuit. Through the 1-Wire interface circuit, the DS18B20 communicates with the external host to realize data transmission and command reception.

Basic Commands:

CCh: Skip ROM (when only one DS18B20 sensor is connected, 0xCC can be sent to skip ROM matching)
44h: Start temperature conversion
4Eh: Write scratchpad register
BEh: Read scratchpad register (a total of 9 registers can be read, the first 2 are temperature values)

The temperature value obtained by the DS18B20 is in the following format and requires conversion:

Complete Communication Flow

Reset and initialization
Host sends [0xcc, 0x44] to start DS18B20 temperature conversion
Reset again
Host sends [0xcc, 0xbe] to read the temperature value from the scratchpad register

Sample Code for Obtaining DS18B20 Temperature Value

FAQ

Reset Initialization Failure

This may be caused by a hardware connection issue. Check the hardware connections to ensure that the GPIO used to create the object is consistent with the pin on the development board connected to the DQ pin of the DS18B20, and that the ground (GND) is also correctly connected. The DS18B20 sensor is damaged, resulting in communication failure.

Normal Transceiving but Erroneous Data

This may be caused by an inconsistent level between the host GPIO and the slave DQ pin. For example, if the host level is 3.3V and the slave level is 1.8V, the high level of the slaveis 1.8V. The host generally recognizes a level higher than 1.65V as high level, which is prone to misjudgment.

VSCode Plugin User Guide

QuecPython — Fri, 24 Apr 2026 11:53:06 +0000

To facilitate developers using VSCode for QuecPython development, the QuecPython team has introduced a VSCode plugin called QuecPython.

The plugin currently supports the following features:

• Firmware flashing

• REPL command interaction

• File transfer

• Filesystem directory tree

• Run specific script files

It currently all QuecPython series modules.

Plugin Installation

Click on the Extensions icon in the primary sidebar .
Type QuecPython in the plugin search box.
Find the QuecPython plugin in the search list, click the install button to complete the plugin installation.

Plugin Usage Guide

Before you start, make sure you have downloaded the appropriate QuecPython firmware package for your module. Click here to view how to download firmware packages.

The following steps are demonstrated based on the U-235 development board.

Firmware Flashing

Access the Firmware Flashing Interface on the Primary Sidebar

There are two methods:

– Click on the QuecPython plugin icon on the primary sidebar .

– Use the shortcut Ctrl+Shift+P to open the command palette, type > QuecPython in it, and select QuecPython: Focus on Firmware Manager View from the options, as shown below:

The firmware flashing interface on the primary sidebar is shown in the following image:

Select Firmware

Click the Select Firmware button on the firmware flashing interface, and choose the firmware package for the U-235 development board module.

The path to the firmware package will be displayed on the interface:

Flash Firmware

i. Click the Flash button on the firmware flashing interface.

ii. In the pop-up confirmation window, click the Yes button

Now you can see the firmware flashing progress bar in the lower right corner of the VSCode interface:

When the progress bar shows Flashing Firmware: 8/8 100%, the firmware flashing is complete, and the module will restart.

REPL Command Interaction

Before starting the REPL command interaction for QuecPython, it is necessary to flash the firmware that supports QuecPython functionality.

Find the command to connect to the terminal in the command palette

Use the shortcut Ctrl+Shift+P to open the command palette. Enter > QuecPython in the palette and select QuecPython: Connect to COM Port from the options, as shown below:

connect to Terminal

Follow the instructions in the image below:

Once the operation is completed, the module will be connected to the terminal in VSCode.

At the same time, the terminal window will pop up with the content as shown in the image below:

REPL Command Interaction

After pressing Enter in the terminal, you will see the QuecPython command prompt >>>.

Enter the following code in the terminal:

print("Hello, QuecPython!")

After pressing Enter, you can see the execution result as shown in the following image:

Now, we have completed the simplest QuecPython REPL interaction.

File Transfer

The edited script file test.py needs to be imported into the module’s file system to run.

In the editor page of the file to be transferred (i.e., test.py), right-click the mouse.
Click on the QPY: Download File command to start file transfer.

During the file transfer process, a pop-up window appears in the bottom right corner of the VSCode interface, as shown below:

File System Directory Tree

After the file transfer is complete, click on the Explorer button on the primary sidebar.
Once the Explorer interface is open, look at the bottom and find QPY: FILE SYSTEM (USR). It shows the directory tree of the module’s file system /usr.

The imported file test.py is shown in the following image:

Run Script File

Select the script file test.py in the directory tree.
Right-click on the script file test.py and choose Run Script to execute the script file.

In the terminal window, you can see the script periodically outputting the string "Hello, QuecPython!".

Package Manager

From QuecPython menu -> Quick Access -> Quectel -> Projects + Components

List of Projects + Components will show in the panel

ADC- Analog-to-Digital Converter

QuecPython — Fri, 17 Apr 2026 10:37:48 +0000

ADC Principles and Common Applications

Analog signals are signals that have a continuous mathematical form in the time domain, with signal values continuously varying at different time points. They convey information about continuously changing physical quantities such as temperature, humidity, pressure, length, current, and more. Different types of data need to be converted into corresponding analog signals for transmission.

Digital signals, on the other hand, are signals where both the independent and dependent variables are discrete. They can be understood as signals that are discrete both in the time domain and in amplitude, meaning they are not continuous. Digital signals are stored and processed in computers using binary representation.

Using a processor with a working voltage of 3.3V as an example, it generates rectangular wave electrical signals during its operation, which are either 0V (logic 0) or 3.3V (logic 1). In the physical world, a voltage signal of 1V cannot be directly recognized by the CPU; it must be converted into a digital signal by a device called an ADC before it can be recognized by the CPU.

ADC, short for Analog-to-Digital Converter, plays the role of transforming analog signals that computers cannot directly recognize in the physical world into binary digital signals that can be recognized by the CPU.

The basic working principle of ADC involves sampling and quantization. First, ADC samples the analog signal, which means it measures the value of the analog signal at regular time intervals. Then, the sampled analog signal is quantized, which means it is discretized into a series of discrete numerical values. These numerical values are typically represented in binary.

The resolution of an ADC represents its ability to quantify analog signals with precision. It refers to the number of discrete values that the ADC can represent. Resolution is typically measured in bits, such as 8-bit, 10-bit, 12-bit, and so on. For example, an 8-bit ADC can divide the input range into 2^8 (256) different discrete levels, while a 12-bit ADC can divide it into 2^12 (4096) discrete levels. Higher resolution means that the ADC can more accurately quantify analog signals.

The sampling rate of an ADC is the number of times it samples per second. A higher sampling rate results in a more faithful representation of the original analog signal. According to the Nyquist Sampling Theorem, the sampling rate must be at least twice the maximum frequency of the signal being measured to avoid distortion in the sampled waveform. In practical applications, the sampling frequency is often much higher, sometimes even up to 10 times or more the maximum frequency of the signal being sampled.

The input voltage range of an ADC (Analog-to-Digital Converter) refers to the range of analog signal voltages it can accept. It is typically expressed in voltage units, such as 0V to 5V or -5V to +5V. Ensuring that the input signal does not exceed the ADC’s input range is crucial to avoid signal distortion or damage.

ADCs can be triggered in two main ways: software-triggered and hardware-triggered. In software triggering, the ADC starts the conversion immediately when a conversion command is issued in software. In hardware triggering, the ADC waits for a specified external event to occur before starting the conversion. The choice of triggering method depends on the specific application and requirements.

ADCs find wide-ranging applications in various fields, including data acquisition, sensor interfacing, audio processing, communication systems, and more. They are essential components for converting analog signals into digital format, allowing analog signals to interact with and be processed by digital systems.

ADC Descriptions for Various Platforms

ADCs are typically located on the PMU (Power Management Unit) and are part of the Analog IP. A typical structure diagram of the PMU is shown below:

Application Scenarios

Light Sensor

Materials Needed: EC600U module, light-dependent resistor (e.g., GL5528)

Principle:

The resistance of a light-dependent resistor (LDR) changes with varying light intensity.

When the LDR is exposed to light, its resistance decreases.

When the light intensity decreases or there is no light, the resistance of the LDR increases, which affects the voltage at the test point.

By reading the ADC voltage values, you can calculate the resistance value of the LDR. Based on the relationship between the light intensity and the resistance of the LDR, you can determine the intensity of the light.

The hardware circuit is as shown in the diagram below: R2 is the LDR, R1 is 10K (you can choose the value of R1 based on the specific parameters of the LDR), and the ADC port is the test point connected to the module’s ADC pin.

In this example, you can observe the impact of different light levels on the LDR by printing the ADC-measured voltage values and the resistance values of the LDR.

FAQ

ADC Voltage Range

The input voltage for each ADC interface pin must not exceed its allowed voltage range. When the measured voltage is greater than the input voltage range, it should be first reduced by resistor division before connecting it to the module’s ADC pin.
In cases where the module’s VBAT is not powered, to avoid damaging the module, ADC interfaces should not be directly connected to any input voltage.

ADC Bit Width

ADC bit width refers to how many bits are used to represent the ADC conversion result. A larger bit width results in higher resolution and more precise measurements. For example, if a 1V voltage is converted by a 10-bit ADC, each bit represents 1/1024V. The module’s ADC returns the processed voltage value.