PUPRemote

PUPRemote lets microcontrollers present themselves as LEGO Powered Up sensors. It includes a low-level LPF2 emulator and a higher-level remote-procedure-style API for quick sensor prototypes.

Table of Contents

• PUPRemote
  • Table of Contents
  • Features
  • Supported Platforms
  • Installation
    • LMS-ESP32 firmware
    • OpenMV
    • Pybricks hubs
  • Quick Start
    • LMS-ESP32 demo
    • OpenMV demo
    • Pybricks demo
  • Compatibility Notes
  • Project Structure
  • Development Notes (MicroPython first)
  • Contributing
  • License

Features

• Emulate LEGO LPF2 sensors from MicroPython boards
• Higher-level RPC-style API (PUPRemoteSensor, PUPRemoteHub)
• Supports both synchronous (process()) and asynchronous (process_async()) modes
• Works with Pybricks, SPIKE 2, and Robot Inventor hubs
• Example scripts for LMS-ESP32, OpenMV, and Pybricks
• Optional lightweight pupremote_hub.py for Pybricks-only deployments

Supported Platforms

• LMS-ESP32 firmware (bundles pupremote.py and lpf2.py)
• OpenMV (copy pupremote.py and lpf2.py onto the board)
• Pybricks hubs (use the smaller pupremote_hub.py when space matters)
• Other MicroPython-capable boards with LPF2 physical connection

Installation

LMS-ESP32 firmware

1. The firmware already contains pupremote.py and lpf2.py.
2. Copy an example (for instance examples/esp32_dummy_data/pup_demo_esp32.py) to the board as main.py.
3. Connect the LMS-ESP32 to your hub (e.g., SPIKE Prime port A) and reboot.

OpenMV

1. Copy src/pupremote.py and src/lpf2.py to the OpenMV board.
2. Deploy an example such as examples/openmv_simple/main.py.
3. Run from the OpenMV IDE or reboot to start.

Pybricks hubs

1. Copy src/pupremote_hub.py to the hub (use this smaller file instead of the full pupremote.py).
2. Upload an example such as examples/openmv_simple/pybricks_spike.py and adjust imports to from pupremote_hub import PUPRemoteHub if needed.
3. Run the program from the Pybricks app.

Quick Start

LMS-ESP32 demo

Copy to the LMS-ESP32 as main.py and reboot:

# examples/esp32_dummy_data/pup_demo_esp32.py
from pupremote import PUPRemoteSensor, SPIKE_ULTRASONIC

def msg(*argv):
    return "demo"

p = PUPRemoteSensor(sensor_id=SPIKE_ULTRASONIC, power=True)
p.add_command('msg', "repr", "repr")

while True:
    p.process()

OpenMV demo

Copy src/pupremote.py and src/lpf2.py to the board, then run:

# examples/openmv_simple/main.py
from pupremote import PUPRemoteSensor, ESP32, SPIKE_ULTRASONIC
from time import sleep_ms

p = PUPRemoteSensor(sensor_id=SPIKE_ULTRASONIC, platform=ESP32)
p.add_channel('cntr', to_hub_fmt="b")

while True:
    p.process()
    p.update_channel('cntr', 1)
    sleep_ms(20)

Pybricks demo

Place src/pupremote_hub.py on the hub and reference it:

from pybricks.parameters import Port
from pybricks.tools import wait
from pupremote_hub import PUPRemoteHub

pr = PUPRemoteHub(Port.A)  # 'A' or 1 also work
pr.add_channel('cntr', to_hub_fmt="b")  # Same as on the sensor side

while True:
    print(pr.call('cntr'))
    wait(100)

Compatibility Notes

• Async/Sync modes: Use process() for synchronous polling in loops, or process_async() + call_multitask() for concurrent async operations with callback queues.
• Pybricks has a known 32-byte packet limitation. Pass max_packet_size=16 when constructing PUPRemoteHub or PUPRemoteSensor to avoid checksum errors.
• For Pybricks, prefer pupremote_hub.py to save space (it only contains PUPRemoteHub).
• LMS-ESP32 firmware already includes dependencies; do not re-upload pupremote.py or lpf2.py there.

Project Structure

• src/ core implementation (pupremote.py, pupremote_hub.py, lpf2.py)
• examples/ runnable demos for LMS-ESP32, OpenMV, and Pybricks
• docs/ Sphinx docs with API references
• img/ project assets (logo)

Development Notes (MicroPython first)

• Target runtime is MicroPython; verify every proposed import exists there (e.g., inspect is unavailable—avoid it).
• Prefer ustruct, uasyncio, and micropython.const; gate CPython-only helpers behind try/except ImportError.
• Keep memory and dependency footprint small; avoid modules that pull in large transitive imports.

Contributing

Contributions and protocol refinements are welcome. Please open an issue or PR with your ideas or projects built on PUPRemote.

License

GPL-3.0. See the LICENSE file for details.