CoreMP135 UiFlow2 Quick Start

1. Preparation

• CoreMP135 power supply (DC 12V power or Type-C 5V input)
• CoreMP135 connected to the network via Ethernet cable
• CoreMP135 device (flash the latest Debian image; see CoreMP135 Image Flashing Tutorial)
• Use the putty tool to access the device terminal via the serial port and enable Debian root SSH access (refer to CoreMP135 Development Tutorial)
• Repartition and expand the MicroSD card of the CoreMP135 device (refer to CoreMP135 Partition Expansion Tutorial)

2. Download System Dependencies

• Connect to the device via serial or SSH to access the terminal, then execute the following commands to download the system dependencies (this step requires network connectivity).

apt update
apt install -y python3-pip libportaudio2

3. Install UiFlow2 Python Library

• Download the UiFlow2 software package through the pip package manager. Since the pip in the Debian 12 system has enabled the system protection function, refer to the following instructions and add the --break-system-packages flag to install the software package (this step requires a network connection).

pip install uiflow2 --break-system-packages

• Test whether the installation was successful by checking that uiflow2 appears in the pip package list.

pip list

Package            Version
------------------ ---------
certifi            2025.1.31
charset-normalizer 3.4.1
distro             1.8.0
evdev              1.9.1
idna               3.10
paho-mqtt          2.1.0
pip                23.0.1
PyAudio            0.2.14
pyserial           3.5
requests           2.32.3
setuptools         66.1.1
smbus2             0.5.0
uiflow2            0.0.1
urllib3            2.3.0
wheel              0.38.4

4. Bind Device Account

Refer to the command below, and enter your M5Stack account's email address and password to bind the device to your account. If you do not have an account, you can click here to register a new account.

uiflow2 register
Please input your email: XXXXXXXXX@XXXX.com
Please input your password: 

5. Start UiFlow2 Service

# Start the UiFlow2 service
uiflow2

• Other common commands

# Run the default UiFlow menu program and start the UiFlow2 service
uiflow2 ui

# Stop the UiFlow2 service
uiflow2 stop

• Linux system service commands

# Enable uiflow2 systemd service; uiflow2 will start automatically when the system starts
uiflow2 enable

# Restart uiflow2 systemd service
systemctl restart uiflow2.service

# Check uiflow2 systemd service status
systemctl status uiflow2.service

# Stop uiflow2 systemd service
systemctl stop uiflow2.service

# Remove uiflow2 systemd service
uiflow2 disable

6. Program Push

• Visit the UiFlow2 Web IDE and log in with your M5Stack account. In the device list, you can see the currently online devices. Select a device to start programming.

7. Version

V0.0.1

• feature: support widgest(title, label, rect, circle, line, triangle, image) display.
• feature: support file operation write/read/HTTP download/delete.
• feature: support download program and run it when uiflow2 start.
• feature: support touch, power, button, sperker, i2c, uart api.
• feature: support unit envpro, tmos, gpsv1.1, imu.
• feature: support uiflow2 systemd service for auto start.
• feature: support bind accounts by email and password.

V0.0.2

• feature: support Unit IMU, IMU Pro, ENV, ENV II, ENV III, ENV IV, ENV Pro, COLOR, ToF, ADC, ADC V1.1, DAC, DAC2, EXT.IO, FINGER.
• fix: fix i2c readfrom cannot only read.
• fix: fix label cannot set background color.

8.Video