28. PM2.5 Module

28.1. Introduction

PM2.5 module is able to test the PM2.5 concentration in the current environment. Based on ZH03 laser dust sensors, it is able to test the dust particle in the air.


28.2. Characteristic

  • Designed in RJ11 connections, easy to plug.

28.3. Specification

Item Parameter
SKU EF05028
Connection RJ11
Type of Connection Digital output
Working Voltage 3.3V

28.4. Outlook


28.5. Quick to Start

Materials Required and Diagram

  • Connect the PM2.5 sensor to J1 port and the OLED to the IIC port in the Nezha expansion board as the picture shows.


28.6. MakeCode Programming

Step 1

Click “Advanced” in the MakeCode drawer to see more choices.


We need to add a package for programming, . Click “Extensions” in the bottom of the drawer and search with “PlanetX” in the dialogue box to download it.


Note: If you met a tip indicating that the codebase will be deleted due to incompatibility, you may continue as the tips say or build a new project in the menu.

Step 2

Code as below:



  • The value detected from the PM2.5 module display on the OLED screen.

28.7. Python Programming

Step 1

Download the package and unzip it: PlanetX_MicroPython

Go to Python editor


We need to add enum.py and PM25.py for programming. Click “Load/Save” and then click “Show Files (1)” to see more choices, click “Add file” to add enum.py and PM25.py from the unzipped package of PlanetX_MicroPython.

../_images/05001_081.png ../_images/05001_091.png ../_images/05028_10.png

Step 2


from microbit import *
from enum import *
from pm25 import *

pm2_5 = PM25(J1)
while True:


  • The value detected from the PM2.5 module display on the micro:bit.

28.8. Relevant File

28.9. Technique File