Lpf2-micropython

MicroPython on an ESP32-S3 LEGO PoweredUp-compatible hub.

This documentation covers the Python programming API exposed to user scripts running on the hub — the hub and lpf2 modules and their sub-modules.

Getting started

• Quickstart
  • Minimal program
  • Event-driven form
  • What the modules do
• Examples
  • Distance sensor
  • Dumb-car (two motors + remote)
  • Port expander
  • IMU
  • LCD (LVGL)
  • BLE remote hub
  • Grove I2C (MPU-6050)
  • NeoPixel on a repurposed LPF2 port

Hub module

• The hub module
  • Top-level members
  • Reference
• Ports
  • Members
  • Lifecycle
  • Pausing a port
  • Reading sensor values
  • Wrapped built-in ports
• Hub LED
• IMU
  • Attitude
  • Raw samples
  • Calibration
  • Example loop
• Buttons
  • Level readers
  • Callbacks
  • Manual polling (bare scripts)
  • Exiting a program
  • Power-off
  • Callback registry snapshots
• LCD
  • Init
  • Rendering loop
  • Backlight
  • Raw panel access
  • Soft reset
• I2C (Grove connector)
  • Coexistence with the C++ side
  • Pins
  • Quickstart
  • Raw write / read
  • Register access
  • Full example — MPU-6050 accelerometer on Grove
  • API reference
• Board constants
  • SD card
  • Port pins
• Program lifecycle
  • The @hub.on decorator
  • Powering off
  • Log level
• Host protocol framing
  • Why the C-level hook
  • Transport fan-out
  • Typical usage
  • Notes

LPF2 module

• The lpf2 module
  • Layout
  • Design notes
• Ports
  • Lifecycle & polling
  • Detecting a device
  • Mode selection
  • Direct motor commands
  • Introspection
  • Raw I/O
• Devices
  • Common methods
  • Registering factories
• Motors
  • Conventions
  • Open-loop power
  • Continuous speed
  • Timed moves
  • Relative-degree moves
  • Absolute position
  • Ramp profiles
  • Motor tuning presets
• Sensors
  • Colour sensor
  • Distance sensor
  • Colour + distance (legacy)
  • Built-in inertial sensors
• Virtual devices
  • The pieces
  • Building a descriptor
  • Subclassing device
  • Attaching and running
  • GC pitfalls
• Hub emulation
  • Typical setup
  • Runtime updates
  • Stop
  • Lifetime
• Remote hub (BLE client)
  • Basic pattern
  • Ports on the remote hub
  • Manual port configuration
  • Hub properties
  • State flags
  • Shutdown
• Battery
  • Voltage window
  • Manual voltage updates
  • Custom percent mapping
  • Built-in ADC reader
• Enumerations
  • lpf2.color
  • lpf2.device_type
  • lpf2.hub_type
  • lpf2.alerts
  • lpf2.battery_type
  • lpf2.button_state
  • lpf2.hub_property
  • lpf2.port_num
• Port expander
  • Sub-port numbering
  • Client side
  • Server side

Reference

• hub
  • Attributes
  • Functions
  • Module Contents
• lpf2
  • Submodules
  • Classes
  • Package Contents

Indices

• Index

• Module Index

• Search Page