Skip to content

v0.1.0 - Initial Release

Choose a tag to compare

@kirisaki kirisaki released this 01 Nov 18:10
· 49 commits to main since this release

πŸŽ‰ v0.1.0 - Initial Release

First stable release of v4 CLI tool for V4 VM bytecode deployment over V4-link protocol.

✨ Features

  • v4 push - Deploy bytecode to devices with progress bar
  • v4 ping - Check device connection
  • v4 reset - Reset VM state
  • Configurable timeout (default: 5 seconds)
  • --detach flag for fire-and-forget mode
  • 8 LED example files (.v4b) for testing

πŸ”§ Technical Details

  • V4-link protocol implementation (CRC-8, frame encoding/decoding)
  • Support for ESP32-C6, CH32V203, and other V4-enabled devices
  • Binary size: 733KB (stripped)
  • Default baud rate: 115200
  • Maximum payload: 512 bytes
  • 13 unit tests (all passing)

πŸ“¦ Installation

cargo install --git https://github.com/V4-project/v4_cli.git

Or build from source:

git clone https://github.com/V4-project/v4_cli.git
cd v4_cli
cargo build --release

πŸš€ Quick Start

# Check device connection
v4 ping --port /dev/ttyACM0

# Deploy bytecode
v4 push examples/led_blink.v4b --port /dev/ttyACM0

# Reset VM
v4 reset --port /dev/ttyACM0

πŸ“ Examples

The repository includes 8 LED examples:

  • led_on.v4b / led_off.v4b - Basic control
  • led_blink.v4b - Basic blinking
  • led_fast/medium/slow.v4b - Speed variations
  • led_sos.v4b - Morse code pattern
  • led_toggle.v4b - Toggle state

See examples/README.md for details.