M5Stack Rotary Encoder Unit

The M5Stack Rotary Encoder Unit adds a tactile knob, push action, and two programmable RGB indicators to control panels, instruments, audio interfaces, and menu-driven embedded projects. An onboard STM32 collects the encoder pulses and exposes the value over I2C, reducing the host's GPIO and interrupt workload. Users can rotate to adjust a setpoint, press to confirm it, and receive immediate color feedback for edit, saved, warning, or fault states.

Add a Rotary HMI Control to M5Stack

The encoder reports relative movement, making it practical for bounded values such as volume, speed, menu position, brightness, or calibration offsets. The push input adds a second interaction without another module, while the RGB LEDs can show the active mode or whether a value has been accepted.

Setpoint, Menu and Volume Adjustment

A benchtop controller can use slow rotation for fine changes and faster rotation for accelerated adjustment. Pressing the knob can commit the value, enter a submenu, or restore a default. In an audio or lighting interface, the LEDs can change color to identify which parameter is currently being edited.

Connect and Read the M5Stack Unit Encoder

I2C Count, Push Button and RGB Feedback

1. Connect the Grove cable to a compatible I2C port and confirm that address 0x40 is available.
2. Initialize the encoder count, button state, and both RGB LEDs before enabling the controlled equipment.
3. Verify which direction increases and decreases the value, then add button debounce.
4. Map the relative count to a bounded application value and apply optional acceleration for fast rotation.
5. Define a stale-data or I2C-fault state that leaves the controlled output safe.

Example Setpoint Editing Workflow

1. Read the encoder delta and push state at a fixed interval.
2. Apply direction, acceleration, and minimum/maximum limits before changing the pending setpoint.
3. Use one LED state while editing and another after the value is committed.
4. Accept the change only after a debounced press, then store or apply the confirmed value.
5. Restore a defined state after a host restart or communication timeout.

Relative Position and Input Handling Notes

• The encoder reports relative movement rather than an absolute shaft position.
• Rapid rotation can exceed a slow polling loop; read consistently and test at the fastest expected user input.
• The mechanical push input requires debounce and protection against unintended repeat actions.
• Long I2C wiring, bus capacitance, or an address conflict can cause inconsistent input.
• This control is not a safety-rated selector, emergency input, or absolute position sensor.

M5Stack Rotary Encoder Resources

• M5Stack Unit Encoder documentation
• UiFlow2 development environment
• Arduino IDE