What is prime-connect?

This repository documents a trick for using Bluetooth Low Energy, or BLE, directly on a LEGO SPIKE Prime robot hub, without needing to install Pybricks or modify the hub's official firmware. LEGO's SPIKE Prime kit normally runs its own operating system that controls Bluetooth internally, leaving little room for custom Bluetooth code. The author found this method by watching the USB traffic between the SPIKE Prime app and the hub using a tool called USBPcap. They discovered that the hub's USB connection exposes a MicroPython REPL, an interactive command line built into the hub. Through that REPL, it is possible to change two internal configuration values that normally control how the hub's built in operating system manages Bluetooth. By turning those two settings off, control over Bluetooth is handed over from the hub's operating system to MicroPython itself. This means code written in MicroPython running on the hub can then manage Bluetooth communication directly, opening the door to custom BLE behavior while leaving the hub's original firmware untouched. The README is short and reads like a discovery note rather than a full guide, describing what was found rather than walking through step by step instructions. It does not include ready made example code, so anyone trying this would need to write their own MicroPython program to take advantage of the direct Bluetooth access once it is unlocked, based on the two configuration values described. Because it works by changing internal hub settings rather than replacing the hub's software entirely, it sits between the two more common approaches people use with SPIKE Prime: installing an alternative firmware like Pybricks, or staying entirely within LEGO's official app and its limitations. This middle path keeps the original firmware intact while still opening up lower level control. It is aimed at hobbyists and robotics enthusiasts who already own a SPIKE Prime hub and want more control over its Bluetooth capabilities than LEGO's official software allows, particularly people comfortable writing MicroPython and inspecting USB traffic themselves.