KY040 Rotary Encoder MakeCode Package

This is the MakeCode package for the KY-040 rotary encoder.

Hardware Setup

1. Connect the appropriate pins (CLK, DT, SW, GND) to the micro:bit.

Blocks

Initialise rotary encoder

Initialises the rotary encoder.

Sets up the micro:bit to use the rotary encoder.

YFRotaryEncoder.init(P0, P1, P2)

This block must be placed before any of the other blocks in this list.

On button pressed

Button push event.

Called whenever the button is pushed down.

YFRotaryEncoder.onPressEvent(() => {
    basic.showString("Button pressed!")
})

On rotate (left/right)

Rotation event.

Called whenever the encoder detects rotation.

YFRotaryEncoder.onRotateEvent(YFRotationDirection.Left, () => {
    basic.showString("<")
})

YFRotaryEncoder.onRotateEvent(YFRotationDirection.Right, () => {
    basic.showString(">")
})

Example: Number input

The follow code creates a number input that can be adjusted by turning the encoder.

YFRotaryEncoder.init(P0, P1, P2)
let item = 0
basic.showNumber(item)
YFRotaryEncoder.onRotateEvent(RotationDirection.Left, () => {
    item -= 1
    basic.showNumber(item)
})
YFRotaryEncoder.onRotateEvent(RotationDirection.Right, () => {
    item += 1
    basic.showNumber(item)
})
YFRotaryEncoder.onPressEvent(() => {
    basic.showString("selected!")
})

Supported targets

• for PXT/microbit