EG800Z QuecDuino EVB Introduction

Supported Modules

• EG800Z

Features

Overview

The EG800Z QuecDuino EVB is equipped with the Quectel EG800Z LTE wireless communication module. It is the upgraded revision of the EC800X QuecDuino development board, designed specifically for QuecDuino entry-level sensor experiment scenarios.

Key Changes (not compatible with previous generation): An external codec (audio codec) has been added. Audio-related functionality is incompatible with the previous generation board.

Board Layout

The main components and interface layout of the development board are shown below:

Downloads

• EG800Z-QuecDuino-EVB-Datasheet

EVB Resources

EVB Interface

Pin Definitions

The main pin layout of the development board is shown below:

Tip
For more information about the EVB, please visit https://developer.quectel.com/en/resource-download

EVB Configuration

The EVB is equipped with various sensors and other peripherals. The pin assignments of peripherals are shown in the table below:

Quick Start Guide

Hardware Preparation

Follow the steps below to prepare the hardware before getting started:

• Step 1: Required Items
  Items required before getting started:

  1. Development Board
  2. USB Cable (USB-A to USB Type-C)
  3. PC (Windows 10)
  4. SIM Card
  5. 4G Antenna

• Step 2: Antenna & SIM Installation
  Attach the provided antenna to the LTE antenna port and insert the SIM card into the SIM card slot on the board.

• Step 3: Connect the Board
  Use a USB Type-C cable to connect the board's Type-C port to a USB port on your computer for power supply. Before powering on, ensure the VUBS EN, VDD_EXT EN, and VBAT EN jumper pins are shorted with jumper caps.

• Step 4: Power On
  Press and hold S1 until the power indicator light on the main board illuminates (the LED labeled D1 on the board). If PWK_ON has been shorted in the previous step, there is no need to long-press PWRKEY — the board will power on automatically.

For detailed information regarding the board's indicator lights and power settings, please refer to the datasheet.

Driver Installation

• Go to the QuecPython Official Driver Download page.

• Select the driver that matches your module model. This EVB is equipped with the EG800Z module. Taking EG800Z as an example, select the corresponding USB driver QuecPython_USB Driver Win10_U_G on the right side of the download page and click download. If your EVB is equipped with a different module model, follow the same steps accordingly.

• After downloading, extract the driver archive, locate "setup.exe" or "setup.bat", and double-click to run. Once installation is complete, open Device Manager — the yellow exclamation mark on the port in Device Manager will disappear, indicating successful installation and normal communication.

Devices such as Mobile ECM Network Adapter or CDC Ethernet Control Model (ECM) appearing as unrecognized are normal phenomena and do not affect firmware burning or subsequent development. No action is required.

• Right-click on My Computer → select Manage → select Device Manager, then in Device Manager select Ports. After following these steps, if a serial port starting with Quectel USB appears as shown, the USB driver has been installed successfully.

Tool Installation

• QPYcom

  QuecPython development requires a dedicated debugging tool — QPYcom, which supports code debugging, log analysis, file transfer, firmware burning, and firmware merging, among other functions.

  Go to the QuecPython Tools Download page and select the appropriate tool for your operating system.

  Note: This tool does not require installation — simply extract and use.

• VSCode Plugin

  For editing Python code, an IDE dedicated to Python or compatible with multiple languages is generally recommended to effectively improve development efficiency. VSCode is recommended here.

  QuecPython provides a dedicated VSCode plugin that enables code hints, code completion, and serial debugging. Installation steps are shown below:

  Click the Extensions sidebar in VSCode, search for "QuecPython" in the marketplace, and download the plugin from the search results.

  

Firmware Burning

Firmware Download

Modules are typically shipped with standard AT firmware or QuecOpen firmware. If you need to develop based on QuecPython, you must manually re-burn dedicated QuecPython firmware onto the module.

Official Firmware Download

With the wide variety of firmware available on the official website, how do you choose the right firmware package? First, you need to know the model of the module you are using. The module model can be obtained from the module's laser engraving or by sending AT commands.

Once you have the module model, go to the official website and download the corresponding firmware for that model. The firmware file name generally follows the pattern QPY_OCPU_<version>_<module_model>_FW. Unless you have special requirements, it is recommended to download the latest version by default.

Click the download button in the download column to download. After a successful download, you will get a compressed package file (zip) named after the firmware.

The firmware package downloaded from the official website is in compressed format. After downloading to your local machine, you need to extract it. After extraction, you will obtain two files: the .bin file is the QuecPython firmware itself, and the .md file is the changelog.

Please make sure to extract the contents of the compressed package to a path that does not contain Chinese characters, spaces, or other special characters, otherwise the download tool may not be able to recognize the firmware properly. Similarly, the download tool path must not contain Chinese characters, spaces, or special characters.

Burning Steps

• Step 1: Create a Project

  First, ensure the module is properly connected and powered on. Open the QPYcom tool and go to the download page. Click "Create" to create a new firmware project. The project name can be customized, and the configuration will persist after completion.

• Step 2: Select Firmware

  Select the firmware to be downloaded to the module (choose the corresponding firmware based on the module model to be downloaded. For new-format firmware, simply select the .bin file for all module models).

• Step 3: Set Download Mode

  Click the dropdown arrow to the right of "Download script" and select "Download FW".

• Step 4: Start Burning Firmware

  After clicking "Download FW", firmware burning will begin. The download process will show a progress bar and percentage. Wait for the download to complete — a popup dialog will confirm successful download.

  

REPL Debugging

REPL stands for Read-Eval-Print-Loop (Interactive Interpreter). You can debug QuecPython programs in the REPL.

After running the QPYcom tool, select the correct serial port (baud rate does not need to be specified) and open it to start Python command-line interaction.

• Step 1: Enter the Interactive Page

  Open the QPYcom tool, select the port connected to Quectel USB REPL Port, and switch to the "Interactive" tab.

• Step 2: Open the Serial Port

  Click the "Open Serial Port" button, then enter print('hello world') in the interactive interface and press Enter to see the execution result.

  >>> print('hello world')
  hello world
  

  

Note: When using the interactive interface, ensure you type in English characters — Chinese characters will be filtered.

First Script Development

Writing Your First Script

Create a helloworld.py file to output "hello world". Write the script as follows:

print("hello world")

Download the edited file to the module using QPYcom and run it.

File Transfer Between PC and Module

Download Method 1:

• Step 1: Open the Serial Port

  First select the module's interactive port and click the "Open Serial Port" button.

• Step 2: Download via Tool Buttons

  Use the "+" and "-" buttons on the right side of the file page to upload and delete files.

• Step 3: Download via Drag and Drop

  You can also drag and drop local files displayed on the left side of the file page directly onto the module on the right side (folders can also be dragged).

• Step 4: Download Progress and Results

  During the download process, the file name and download progress will be displayed in the status bar.

Download Method 2:

• Step 1: Create a Project

  Create a user project as needed (click the "Create" button). The steps are the same as for firmware burning above.

• Step 2: Configure Files to Download

  Select the user scripts to be downloaded to the module (add them via the right-click menu in the "User Scripts" area).

• Step 3: Set Download Mode

  Click the dropdown arrow and select "Download Script".

• Step 4: Start Downloading Scripts

  Click "Download Script" to start downloading scripts. The download process will show a progress bar.

Running Script Files

• Step 1: Download Scripts

  Download the script files to be executed to the module. Refer to the steps above for details.

• Step 2: Execute Scripts via REPL

  After opening the serial port, enter the following code in the QPYcom interactive page to execute the script file:

  import example
  example.exec("/usr/helloworld.py") # filePath is the path of the script file to be executed
  

• Step 3: Execute Scripts via GUI Tool

  Alternatively, execute script files using the Run button on the QPYcom file page. On the tool's file page, select the script file to be executed and click the "▶" button.

  The execution result is shown below:

  

Stopping Program Execution

How to stop a running program. The following methods are provided according to the type of the running script file: