Rain8net Ruby Library

The Rain8net device is an RS232 controlled sprinkler controller. The "net" in Rain8net refers to the device's ability to be expanded with with several networked modules.

More information about the Rain8 series of products can be found at WGL Designs. This library can be used to control any number of devices from your ruby app.

NOTE: You must install ruby-serialport in order to use this library:
http://ruby-serialport.rubyforge.org

Installation

  gem install rain8net

Or, download it from rubyforge.

Usage

  require "rubygems"
  require "rain8net"
  
  r8 = Rain8net.new(:tty => 0, :addresses => ['01', '02'])
  r8.turn_on_zone(1)
  sleep(30) # run for 30 seconds...
  puts r8.zone_status(1) # => true
  puts r8.zone_status(2) # => false
  r8.turn_off_zone(1)
  r8.turn_all_of

Documentation

View online

Tips

• Be sure the user running your rails application has R/W access to the serial port. (try: chmod 777 /dev/ttyS0)
• If you've installed the gem, be sure to require "rubygems" first.
• If you have more than 1 module in your setup, be sure to configure the address of each device using the manufacturer's configuration program.

Adam's Blog post describing the background behind the project