Labs / MicroPython module projects

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)

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

Contents
Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)

1. Introduction

1.1 Project Background

Traditional infrared communication systems mostly adopt unidirectional transmission or have a single function, lacking intuitive data display and interactive feedback capabilities.This project is based on the GraftPort-RP2040 development board, and integrates an 8-bit IO port expansion module based on PCF8574 to connect 4 mechanical key modules, an infrared transmitting module based on IR333C, an infrared receiving module based on TSOP34138 and a 0.96-inch SSD1306-OLED module to realize an integrated system of "infrared data transmission - display - interactive feedback", which solves the problem of poor interactivity of traditional infrared communication systems. Meanwhile, it incorporates MicroPython 's efficient task scheduling and state management 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 PCF8574 IO expansion module, send corresponding letter data through the infrared transmitting module based on IR333C, receive data via the infrared receiving module based on TSOP34138, and display the real-time transceiving status on the OLED display screen. It supports automatic transmission interval control, has a built-in automatic display status clearing mechanism, and is equipped with exception capture and debug information output functions 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:

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)

The other required modules include:

#Figure (Photos of the modules used)

3.2 Hardware Connection

8-bit I/O Port Expansion Module Based on PCF8574: Connected via PH2.0 connecting cable to the I2C0 interface;

Mechanical Key Module: connect to the 8-bit I/O port expansion module based on PCF8574 for key expansion (all four mechanical keys need to be connected to the 8-bit I/O port expansion module)

Infrared transmitting module based on IR333C: connected via PH2.0 connecting cable to DIO0 interface;

Infrared receiving module based on TSOP34138: connected to PH2.0 cable to access DIO1 interface;

0.96-inch SSD1306-OLED module: connected via PH2.0 connector cable to I2C1 interface.

Lithium Battery Charge and 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.

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)
Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)
Infrared Wireless Key Data Transceiver (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):

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)
Infrared Wireless Key Data Transceiver (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:

Infrared Wireless Key Data Transceiver (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:

Infrared Wireless Key Data Transceiver (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:

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)

4. Software Environment

5. File Structure

infrared_transceiver
├─ LICENSE
├─ tools
│  ├─ dependency_analyzer.py
│  ├─ mpy_compiler.py
│  ├─ mpy_uploader.py
│  └─ README.md
├─ firmware
│  ├─ board.py
│  ├─ boot.py
│  ├─ conf.py
│  ├─ main.py
│  ├─ tasks
│  │  └─ tasks_here
│  ├─ libs
│  │  └─ libs_here
│  └─ drivers
│     ├─ __init__.py
│     ├─ ssd1306_driver
│     └─ irtranslation_driver
├─ examples
│  └─ README.md
├─ docs
└─ build

6. Document Description

7. Core Ideas of Software Design

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)
Infrared Wireless Key Data Transceiver (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.

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)

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

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)

Set Project/firmware as the project root directory.

Infrared Wireless Key Data Transceiver (Based on GraftPort-RP2040 Development Board)(Open Version)

Modify runtime configuration:

Infrared Wireless Key Data Transceiver (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.

Infrared Wireless Key Data Transceiver (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 device initialization retries
I2C_INIT_RETRY_DELAY_S = 0.5   # Interval between retries (seconds)
ENABLE_DEBUG = True            # Whether to enable debug printing

8.4 Functional Testing

Turn on the VBAT battery power switch located at the bottom of the main control board, and you will see the power indicator lights on both the main control board and the module light up:

When conf.py is configured unchanged and the hardware connection is normal, the program can run properly.

Pressing the keys produces the corresponding output or reception on RX and TX

The terminal output is as follows:

Infrared Wireless Key Data Transceiver (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/infrared_transceiver

Appendix II: Reference Materials for hardware Modules

GraftSense: 8-bit IO Port Expansion Module Based on PCF8574

GraftSense: An Infrared Transmitter Module Based on IR333C

GraftSense - An Infrared Receiving Module Based on TSOP34138

GraftSense 0.96-inch SSD1306 OLED Module

GraftSense-SY7656 Lithium Battery Charge-Discharge Module

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

Version Record

Document Version

Date of Revision

Modifier

Revised Content

V1.0.0

2025-11-03

Hou Junhan

Draft the initial version of the document.

V1.1.0

2026-01-04

Li Zisheng

Final version.