Lignite: Program LEGO Mindstorms EV3 in Ruby

Lignite is a set of Ruby tools to interact with LEGO Mindstorms EV3. It uses the original LMS2012 firmware, so ev3dev is not required.

At this point the tools are still rather a thin wrapper so it will be useful to have the EV3 Firmware Developer Kit and EV3 Communication Developer Kit documents at hand for reference: see the "Advanced Users – Developer Kits" section of the Mindstorms Downloads page.

Features

  • Connect via USB or Bluetooth
  • Execute Direct Commands
  • Execute System Commands, including
    • Upload RBF programs
    • Run RBF programs
  • Compile Ruby into RBF programs
  • Supported platforms: Linux (bug reports or pull requests for Windows or Mac are also welcome)

Getting Started

Running the built-in demo program: Connect the brick with a USB cable. Run

sudo ev3tool run ../prjs/BrkProg_SAVE/Demo.rpf

(The sudo is needed to access the USB device.)

To connect with Bluetooth, configure the address and pair the device (FIXME: how; troubleshooting?)

See also the included examples.

Hello World

require "lignite"
dc = Lignite::DirectCommands.new
dc.ui_draw_clean
dc.ui_draw_text(Lignite::FG_COLOR, 20, 40, "Hello, world!")
dc.ui_draw_update

Acknowledgements

Thanks to David Lechner of the ev3dev project for the ev3.yml bytecodes file.