Quickstart

The two user-facing MicroPython modules are:

• hub — on-board peripherals (ports A–D, hub LED, IMU, buttons, LCD, power).

• lpf2 — the LEGO Powered-Up (LPF2) protocol primitives: ports, devices, hub emulation, remote-hub client, enumerations.

Minimal program

Programs are plain Python scripts. The C firmware polls every port’s update() for you each tick — device detection and value parsing happen in the background, so scripts just read state. See Automatic polling for details.

import hub
import time

port = hub.ports.A
while True:
    if port.isDeviceConnected():
        print("device:", port.getDeviceType())
    time.sleep_ms(10)

Use hub.exit() to exit cleanly from anywhere, or hold the centre button for 2 s to stop the running script.

What the modules do

Module	Purpose
hub	Board singletons: hub._ports_module, hub._imu_module, hub._buttons_module, hub._lcd_module, hub._i2c, hub._board_module, hub.powerOff().
lpf2	lpf2.port API, lpf2.hub (BLE client), lpf2.hub_emulation (BLE server), lpf2.battery.
lpf2.local	Concrete lpf2.local.port for on-hub UART sockets.
lpf2.virtual	lpf2.virtual.port and lpf2.virtual.device for Python-implemented emulated devices.
lpf2.devices	Typed device wrappers (lpf2.devices.encoder_motor, lpf2.devices.color_sensor, …).
lpf2.port_expander	Sub-port helpers for the LPF2 port expander accessory.
Enum modules	lpf2.color, lpf2.device_type, lpf2.hub_type, lpf2.alerts, lpf2.battery_type, lpf2.button_state, lpf2.hub_property, lpf2.port_num.