Labs / MicroPython module projects

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

Author: Li Zisheng · Source: FreakStudio open documentation · License: CC BY 4.0

Contents
UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

Project Description

1. Introduction

1.1 Project Background

Traditional environmental monitoring devices mostly feature fixed displays or single functions, and lack the capabilities of real-time data display and wireless transmission.This project is based on the GraftPort-RP2040 development board, and integrates the UV ultraviolet sensor module based on GUVA-S12SD, the master-slave integrated BLE Bluetooth module based on HC-08 and the 0.96-inch SSD1306-OLED module to realize an integrated system of "ultraviolet index detection - display - wireless transmission", which solves the problem of single function of traditional environmental monitoring equipment. Meanwhile, it incorporates MicroPython 's lightweight task scheduling and exception handling mechanism to ensure the stable operation of the system.

1.2 Overview of the Main Functions of the Project

This project is developed based on MicroPython, whose core function is to use the UV ultraviolet sensor module based on GUVA-S12SD to detect ultraviolet intensity in real time and convert it into the ultraviolet index (UVI), display it in real time on the OLED display screen, and transmit data wirelessly via the master-slave integrated BLE Bluetooth module based on HC-08; it supports on-board key interrupt to switch task start and stop, has built-in automatic garbage collection (GC) to avoid memory leaks, and is equipped with exception capture and rate-limited printing to facilitate problem locating.

1.3 Applicable Scenarios or Application Area

2. Main Functions

3. Hardware Requirements

3.1 Hardware Required

The project is based on the GraftPort-RP2040 development board as the main controller:

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

The other required modules include:

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

3.2 Hardware Connection

UV ultraviolet sensor module based on GUVA-S12SD: connected via PH2.0 connecting cable to ADC0 interface;

HC-08-based master-slave integrated BLE Bluetooth module: connected via PH2.0 connecting cable to UART0 interface;

0.96-inch SSD1306-OLED module: connected via PH2.0 connecting cable to the I2C0 interface

Lithium battery charge-discharge module: BAT interface connects to the lithium battery, and the OUT interface supplies power to the main control board via a PH2.0-2P connection cable.

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)
UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)
UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

3.3 Structural Assembly

First, use M3 plastic pillars to fix each module and the main control board to the bottom plate of the housing (M3 screw holes are pre-drilled on both the main control board and the housing):

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)
UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

Next, secure the periphery of the housing with M3 plastic pillars, then screw in M3 screws at the corresponding positions to complete the assembly:

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

3.4 Notes

When the main control board is not connected to an external watchdog module, the RUN DIP switch 2 must be turned on:

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

The lithium battery charge-discharge module supports power level display, and can be charged via the Type-C interface below:

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

4. Software Environment

5. File Structure

uv_Intensity_bluetooth
├── .flake8                     # Python code style check configuration file (PEP8 standard)
├── LICENSE                     # License file (CC BY-NC 4.0) 
├── README.md                   # Project documentation (this document)
├── tools/                      # Development helper tool scripts
│   ├── dependency_analyzer.py  # Project dependency analysis tool (checks reference relationships between modules)
│   ├── mpy_compiler.py         # Tool for batch compiling .py files to .mpy (reduces memory usage)
│   ├── mpy_uploader.py         # Script that uploads .mpy files to the development board via mpremote
│   └── README.md               # Tool usage documentation
├── firmware/                   # Firmware code directory (files to be uploaded to the development board)
│   ├── board.py                # Board-level pin mapping file (defines the hardware interfaces of the GraftPort-RP2040)
│   ├── boot.py                 # MicroPython boot script (empty by default, initialization logic can be customized)
│   ├── conf.py                 # System configuration file (debug switch, GC threshold, and other parameters)
│   ├── main.py                 # Project entry file (hardware initialization, task creation, scheduler startup)
│   ├── tasks/                  # Task logic module
│   │   ├── maintenance.py      # System maintenance tasks (automatic GC, exception handling callbacks)
│   │   ├── sensor_task.py      # Core tasks (UV acquisition, OLED display, Bluetooth transmission)
│   │   └── __init__.py         # Package initialization file
│   ├── libs/                   # Common utility library
│   │   ├── __init__.py         # Package initialization file
│   │   └── scheduler/          # Task scheduler
│   │       ├── scheduler.py    # Scheduler core implementation (adding/pausing/resuming tasks, periodic scheduling)
│   │       └── __init__.py     # Package initialization file
│   └── drivers/                # Hardware driver modules (classified by device)
│       ├── __init__.py         # Package initialization file
│       ├── ssd1306_driver/     # SSD1306 OLED driver
│       ├── hc08_driver/        # Master-slave integrated BLE Bluetooth module driver based on HC-08
│       └── gUVa_s12sd_driver/  # GUVA-S12SD UV sensor driver
├── examples/                   # Example code directory (reserved for extension)
│   └── README.md               # Example documentation
└── docs/                       # Project documentation directory
    # Holds documents such as hardware wiring diagrams, design notes, module datasheets, and development board pin tables

If you want to add other sensor modules to the main control board, it is recommended that you check docs the file under the folder graftport_pinout_table.md to view the pin mapping.

6. Description of Key Documents

7. Core Ideas of Software Design

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)
UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

8. Instructions for Use

8.1 Hardware Connection

Connect the main control board, each sensor module and the battery according to the connection method specified in the "hardware requirements";

8.2 Run the Project (Using PyCharm + MicroPython Plugin)

Open PyCharm and install the corresponding MicroPython plugin.

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

In the plugin, select Target Device as RP2040, and enable Auto-detect device path.

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

Set Project/firmware as the project root directory.

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

Modify runtime configuration:

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

Click the IDE green triangle button in the upper right corner to run, and you can start uploading the firmware and executing the project.

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

8.3 Modification of Running Configuration

You can configure conf.py and modify or add parameters as needed, for example:

# conf.py example configuration
I2C_INIT_MAX_ATTEMPTS = 3      # Maximum number of sensor initialization retries
I2C_INIT_RETRY_DELAY_S = 0.5   # Interval between retries (seconds)
ENABLE_DEBUG = True            # Whether to enable debug printing
AUTO_START = True              # Whether to run tasks automatically at startup

8.4 Functional Testing

Access the Bluetooth debugging information interface:

UV Ultraviolet Data Wireless Monitoring and Transmission Device (Based on GraftPort-RP2040 Development Board)(Open Version)

8.5 Debugging and Troubleshooting

9. Sample Program

There are no other reference sample codes for this project, you can directly make modifications in the firmware folder.

10. Notes

11. Version Record

12. Contact the Developer

If you have any questions or need assistance, please contact the developer via the following channels:
📧 Email: 10696531183@qq.com
💻 GitHub: https://github.com/FreakStudioCN

13. Licensing Agreement

In this project, except for machine and other MicroPython official modules (MIT License), all driver and extension codes written by the author are released under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) Licensing Agreement.

You are free to:

Only the following conditions shall be complied with:

Copyright © FreakStudio. All rights reserved.

Appendix 1: Project Source Code Download

https://github.com/FreakStudioCN/GraftPort_MicroPython_Labs/tree/main/uv_Intensity_bluetooth

Appendix II: Reference Materials for hardware Modules

GraftSense: An Open-Source UV Ultraviolet Sensor Module Based on GUVA-S12SD

GraftSense - HC-08 Based Master-Slave Integrated BLE Bluetooth Module (Open Version)

GraftSense 0.96-inch SSD1306 OLED Module (Open Version)

GraftPort - Raspberry Pi Pico Expansion Board (Internal Edition Template Files)

Version Record

Document Version

Date of Revision

Modifier

Revised Content

V1.0.0

2025-11-03

Hou Junhan

Draft the document. Upload the source code

V1.0.1

2025-12-31

Li Zisheng

Modify module document link