Contents

module PrologixGpib::Usb
  require 'timeout'

  class Error < StandardError
  end

  EOL = "\r\n".freeze

  attr_reader :serial_port

  def initialize(path, mode: :controller, address: 9)
    open_serial_port(path)
    flush
    self.mode = mode
    self.address = address
    self.auto = :disable
    self.eos = 0

    yield self if block_given?
  end

  def close
    return unless connected?

    @serial_port.close
    @serial_port = nil
    @serial_port.nil?
  end

  def write(string)
    return unless connected?

    @serial_port.write("#{string}#{EOL}")
  end

  def read(bytes)
    return unless connected?

    @serial_port.read(bytes)
  end

  def readline
    return unless connected?

    t = Timeout.timeout(1, Timeout::Error, 'No response from device') { getline }
  end

  def sr(register = nil)
    write 'SR'
    write '++read eoi'
    array = []
    24.times { array << readline }
    array.map! { |byte| '%08b' % byte.to_i }
    register.nil? ? array : array[register - 1]
  end

  private

  def open_serial_port(path)
    @serial_port = Serial.new(path)
    write('++ver')
    return if getline.include? 'Prologix'

    raise Error, 'No Prologix USB controllers found.'
  end

  def connected?
    raise Error, 'ConnectionError: No open Prologix device connections.' if @serial_port.nil?

    true
  end

  def flush
    return unless connected?

    loop until serial_port.getbyte.nil?
  end

  # This method will block until the EOL terminator is received
  # The lower level gets method is pure ruby, so can be safely used with Timeout.
  def getline
    return unless connected?

    @serial_port.gets(EOL).chomp
  end

  def device_query(command)
    flush
    write(command)
    readline
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
prologix_gpib-0.5.3	lib/prologix_gpib/usb.rb
prologix_gpib-0.5.2	lib/prologix_gpib/usb.rb