Official Ubilite Extension for CMake-based projects. This extension provides an integrated UI for building, flashing, debugging, and managing Ubilite hardware.
Overview
This extension streamlines your workflow by:
Providing UI panels to manage project settings, build actions, and debug configurations.
Managing device connections (remote and local) for flashing and debugging.
Integrating directly with riscv32-unknown-elf-gdb for a seamless debugging experience.
Offering advanced tools for Vivado integration, build analysis, and core component (sudo) builds.
Features
🔒 Secure Authentication: Requires sign-in to activate, keeping your tools secure.
🛠️ Project Building: Build your CMake project with one click.
⚡ One-Click Flashing: Flash your Application, XIP, Bootloader, or Partition Table using JTAG, UART, or OTA methods.
🗑️ Flash Utilities: Erase flash, read partition info, and refresh the hardware eFuse profile.
🐛 Integrated Debugging: Launch or Attach the riscv32-unknown-elf-gdb debugger directly from the UI.
⚙️ Kconfig Integration: Open menuconfig for your selected application directly within the VS Code terminal.
📊 Build Analyzer: Right-click an app in the sidebar to analyze its build size and memory footprint.
📡 Vivado Tools: Start a Vivado server, program bitfiles, connect to targets, and toggle VIO probes for hardware resets.
🚀 Advanced Modes: Enable "Developer" or "Sudo" modes to unlock advanced developer tools and core build commands.
Installation
Open Visual Studio Code.
Go to the Extensions view (or press Ctrl+Shift+X).
Search for "Ubilite".
Click Install on the "Ubilite VS Code Extension".
Reload VS Code if prompted.
Getting Started
After installing, open your Ubilite CMake-based project folder in VS Code.
Click the new Ubilite icon in the VS Code Activity Bar (the sidebar on the left).
The extension may require you to sign in for authentication.
Once authenticated, the Ubilite side panels will populate with your project's applications and tools.
You can now use the UI buttons to build, flash, and debug your project.
Requirements
For Using the Extension
Visual Studio Code (v1.85.0 or newer recommended).
Python 3 (for running internal helper scripts).
RISC-V Toolchain: Must be installed and available in your system's PATH (including riscv32-unknown-elf-gcc, g++, and gdb).
For Specific Features
JTAG: A J-Link or compatible debug probe for JTAG-based flashing and debugging.
UART: Serial port access (e.g., /dev/ttyUSB0) for UART-based flows.
Vivado Features: Vivado or Vivado Lab installation. Ensure VIVADO_HOST_PATH is set or the installation is mapped into your runtime environment (if using containers).
For Developing the Extension
Node.js and npm: For building and developing the extension itself.
