Hyperlab Lua Extension

A Visual Studio Code extension for managing BLE devices with integrated Lua development support. This extension provides a seamless interface for connecting to BLE devices, sending Lua code, and monitoring device output directly from VS Code.

Hyperlab

Hyperlab

Features

• BLE Device Management

  • Easy device discovery and connection
  • Real-time connection status monitoring
  • Battery level indication (when supported by device)
  • Automatic reconnection attempts

• Lua Development Integration

  • Direct code execution from VS Code
  • Real-time device output in debug console
  • Syntax highlighting and code completion
  • Emergency stop functionality with cleanup routines

• User Interface

  • Status bar integration with connection indicators
  • Dedicated debug console for device output
  • Intuitive controls for device management
  • Battery status indication (when available)

Installation

1. Open Visual Studio Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "BLE Manager"
4. Click Install

Requirements

• Visual Studio Code ^1.96.0
• Chrome, Edge, or Opera browser (for Web Bluetooth support)
• BLE-capable device with UART service support

Usage

Connecting to a Device

1. Click the "BLE Connect" button in the status bar or use Alt+B
2. Select "Yes" to open the BLE Manager in your browser
3. Click "Scan for Devices" in the browser window
4. Select your device from the list

Running Lua Code

1. Open a .lua file in VS Code
2. Use one of the following methods to run your code:
   • Click the "Run Lua" button in the status bar
   • Use the keyboard shortcut Alt+R
   • Use the command palette and select "BLE Manager: Run Lua File"

Stopping Execution

1. Use one of the following methods to stop code execution:
   • Click the "Stop" button in the status bar
   • Use the keyboard shortcut Alt+S
   • Use the command palette and select "BLE Manager: Stop Lua Execution"

Keyboard Shortcuts

Extension Settings

No additional configuration required. The extension works out of the box with default settings.

Security Considerations

• The extension uses Web Bluetooth API which requires HTTPS or localhost
• All communication is local between VS Code and your browser
• No data is sent to external servers

Known Issues

• Web Bluetooth API is not supported in Firefox
• Some BLE devices may require multiple connection attempts
• Battery level indication only works with devices that support the Battery Service

Release Notes

0.0.1

• Initial release of BLE Manager
• Basic BLE device connection support
• Lua code execution and monitoring
• Status bar integration
• Keyboard shortcuts
• Debug console

For more information:

• Web Bluetooth API Documentation
• Lua Programming Language