KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #codex #ai-agents #claude-code #dsh #dsh-plugin #cli #macos #ai-agent #deepseek-harness #open-source

lego-spikeprime-mindstorms-vscode

★ 81 Open GitHub ↗

Helps you connect and work with Lego's SPIKE Prime/MINDSTORMS Robot Inventor hubs

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# LEGO SPIKE Prime / MINDSTORMS Robot Inventor Extension

This extension helps you connect to the SPIKE Prime or MINDSTORMS Robot Inventor brick and perform various operations on it.

> [!IMPORTANT]  
> Starting with version 2.x of the extension it will work ONLY with HubOS3. If you are running on the legacy HubOS2, please use the 1.x version and disable auto-updates for the extension.

## Features

Shows the connections status right in the status bar
![status](https://raw.githubusercontent.com/PeterStaev/lego-spikeprime-mindstorms-vscode/master/images/status.png)

\
Clicking on the status will either connect or disconnect (if already connected).

\
Once connected you can start a running program by choosing its slot.
![slot-selection](https://raw.githubusercontent.com/PeterStaev/lego-spikeprime-mindstorms-vscode/master/images/slot-selection.png)

Also once you are connected in any python file you can execute commands conveniently by using the appropriate button at the top right of the editor file:

![file-actions](https://raw.githubusercontent.com/PeterStaev/lego-spikeprime-mindstorms-vscode/master/images/file-actions.png)

### Preprocessor

To support multi files before the compilation (or upload if not compiled) imported files will be inserted in the current python script.
At the moment only

```python
from file_name import *
```

is supported. Files not found are skipped (in the hope they exist on the hub). Nevertheless an error will inform you.

> [!NOTE]  
> This is not supported for web extension usage.

### Custom Preprocessor

The plugin has a settings where you can specify an external program/script that should be executed before uploading the program
to the hub. This will receive the contents of the file as stdin. It should output the resulting file contents to stdout and exit the process with `0`.

> [!NOTE]  
> This will be executed AFTER the builtin preprocessor for combining the files and right before compiling and uploading the program to the hub!

> [!NOTE]  
> This is not supported for web extension usage.

### Compilation

The extension supports compiling Python files to binary (MPY) before uploading. This is controlled by a setting:
![compile-option](https://raw.githubusercontent.com/PeterStaev/lego-spikeprime-mindstorms-vscode/master/images/compile-option.png)

## Automatic upload/start of a python file

During active development you will be uploading a program over and over again so going through all the prompts for type and slot is not very convenient. You can skip those prompts and automatically start the program after uploading by adding a specific comment line as first in your program.

```python
# LEGO  slot:<0-19> [autostart]
```

For example, if I want the program to be uploaded to slot 5 and autostart it once the upload is finished the comment should be the following

```python
# LEGO slot:5 autostart
```

## Credits

Thanks to LEGO Group to publish [extensive docs](https://lego.github.io/spike-prime-docs/index.html) on how to work with the HubOS protocol.

## Disclaimer

_LEGO and MINDSTORMS are registered trademarks of the LEGO Group. SPIKE is trademark of LEGO Group._

lego-spikeprime-mindstorms-vscode

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README