Atomic Stepmotor Base

Support the following products:

UiFlow2 Example:

Direction control

Open the atoms3r_stepmotor_direction_control_example.m5f2 project in UiFlow2.

The example demonstrates motor direction control. Pressing the screen button toggles the rotation direction.

UiFlow2 Code Block:

Example output:

None

Rotate control

Open the atoms3r_stepmotor_rotate_control_example.m5f2 project in UiFlow2.

The example demonstrates the motor continuously rotating for multiple turns, then reversing for multiple turns, and repeating the cycle after a 2-second pause.

UiFlow2 Code Block:

Example output:

None

MicroPython Example:

Direction control

The example demonstrates motor direction control. Pressing the screen button toggles the rotation direction.

MicroPython Code Block:

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
from base import AtomicStepmotorBase
import time


title0 = None
label0 = None
label_vol = None
base_stepmotor = None
direction = None


def btn_was_clicked_event(state):
    global title0, label0, label_vol, base_stepmotor, direction
    direction = not direction
    base_stepmotor.set_direction(direction)


def setup():
    global title0, label0, label_vol, base_stepmotor, direction
    M5.begin()
    title0 = Widgets.Title("Steps Ctrl", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu18)
    label0 = Widgets.Label("vol:", 5, 35, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)
    label_vol = Widgets.Label("12.0V", 43, 35, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)
    BtnA.setCallback(type=BtnA.CB_TYPE.WAS_CLICKED, cb=btn_was_clicked_event)
    base_stepmotor = AtomicStepmotorBase(5, 7, 6, 38, 39)
    label_vol.setText(str((str((base_stepmotor.get_voltage())) + str("V"))))
    direction = True


def loop():
    global title0, label0, label_vol, base_stepmotor, direction
    M5.update()
    base_stepmotor.step()
    time.sleep_ms(1)


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

Example output:

None

Rotate control

The example demonstrates the motor continuously rotating for multiple turns, then reversing for multiple turns, and repeating the cycle after a 2-second pause.

MicroPython Code Block:

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
from base import AtomicStepmotorBase
import time


title0 = None
label0 = None
label_vol = None
base_stepmotor = None
step_per_rev = None
microstep = None
total_steps = None
rotate_circle = None


def setup():
    global \
        title0, \
        label0, \
        label_vol, \
        base_stepmotor, \
        step_per_rev, \
        microstep, \
        total_steps, \
        rotate_circle

    M5.begin()
    title0 = Widgets.Title("Steps Ctrl", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu18)
    label0 = Widgets.Label("vol:", 5, 35, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)
    label_vol = Widgets.Label("12.0V", 43, 35, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)
    base_stepmotor = AtomicStepmotorBase(5, 7, 6, 38, 39)
    step_per_rev = 200
    microstep = 1 / 2
    rotate_circle = 5
    total_steps = (step_per_rev / microstep) * rotate_circle
    label_vol.setText(str((str((base_stepmotor.get_voltage())) + str("V"))))


def loop():
    global \
        title0, \
        label0, \
        label_vol, \
        base_stepmotor, \
        step_per_rev, \
        microstep, \
        total_steps, \
        rotate_circle
    M5.update()
    print(base_stepmotor.get_voltage())
    base_stepmotor.rotate(total_steps, 1, True)
    time.sleep_ms(100)
    base_stepmotor.rotate(total_steps, 1, False)
    time.sleep_ms(100)
    label_vol.setText(str((str((base_stepmotor.get_voltage())) + str("V"))))
    time.sleep_ms(2000)


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

Example output:

None

API