An evented serialport
Ruby
Switch branches/tags
Nothing to show
Latest commit 7a59405 May 28, 2013 @railsbob Update readme.md
Permalink
Failed to load latest commit information.
bin
lib
spec
.gitignore
Gemfile
Rakefile
em-serialport.gemspec
readme.md

readme.md

em-serialport

Eventmachine compatible asynchronous, ruby-serialport library.

Installation

gem install em-serialport

Usage

If you are on Mac, you need to set up a virtual USB serial port by installing a driver from http://www.ftdichip.com/Drivers/VCP.htm. Identify your serial port device. For ex: /dev/tty.usbserial-xxxxxxxx

EM.run do
  serial = EventMachine.open_serial('/dev/tty.usbserial-xxxxxxxx', 9600, 8, 1, 0)
  serial.send_data "foo"

  serial.on_data do |data|
    # do something with data
  end
end

Serial Monitor

The gem comes with a simple command line Serial Monitor. Launch it as:

bundle exec serial-monitor /dev/tty.usbserial-xxxxxxxx

Here is a working example, tested with arduino echo server. It simply reads and writes data to serial port from command line.

Serial monitor initialized. Enter data followed by a newline character.
Ctrl-C to stop
hello
received: hello
A very long sentence
received: A v
received: ery long
received:  sentence