rubyserial, 用于 RS 232串口通信的FFI ruby 库

分享于 

3分钟阅读

GitHub

  繁體 雙語
FFI Ruby library for RS-232 serial port communication
  • 源代码名称:rubyserial
  • 源代码网址:http://www.github.com/hybridgroup/rubyserial
  • rubyserial源代码文档
  • rubyserial源代码下载
  • Git URL:
    git://www.github.com/hybridgroup/rubyserial.git
    Git Clone代码到本地:
    git clone http://www.github.com/hybridgroup/rubyserial
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/hybridgroup/rubyserial
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    rubyserial

    RubySerial是一个简单的ruby gem,用于读取和写入串行端口。

    其他 ruby 串行端口实现不同,它支持最流行的操作系统(。OSX,Linux,& Windows ) 上最流行的ruby 实现(。x,&,Rubinius )。 而且它不需要任何本机编译感谢使用 RubyFFI https://github.com/ffi/ffi。

    到RubySerial的接口应该与其他 serialport Gems 兼容,因此你应该能够在新的gem 中拖放,更改 require 并使用它作为替换。 如果没有,请让我们知道,以便我们能够解决任何问题。

    Build StatusBuild statusTest Coverage

    安装

    
    $ gem install rubyserial
    
    
    
    

    用法

    require'rubyserial'serialport =Serial.new'/dev/ttyACM0'# Defaults to 9600 baud, 8 data bits, and no parityserialport =Serial.new'/dev/ttyACM0', 57600serialport =Serial.new'/dev/ttyACM0', 19200, 8, :even

    方法

    写( 数据:字符串) -> Int

    返回写入的字节数。 错误时发出 RubySerial::Error

    读取( 长度:Int ) -> 字符串

    返回到 length long的字符串。 不保证返回指定的全部长度,如果没有可用数据,则返回空字符串。 错误时发出 RubySerial::Error

    -> Fixnum或者 nil

    如果没有可用数据,则返回 8位字节或者零。 错误时发出 RubySerial::Error

    RubySerial::Error

    返回基础系统错误代码并继承从rtc的包装错误类型。

    运行测试

    测试套件是使用rspec编写的,只需使用 rspec 命令。

    但是,要运行测试,还必须安装 socat 实用程序程序。

    在 OS X 上安装 socat

    
    brew install socat
    
    
    
    

    在Linux上安装 socat

    
    sudo apt-get install socat
    
    
    
    

    在 Windows 上安装 socat

    你可能需要从源代码生成。 Windows的最新版本socat非常旧。 从这里获取来源:

    http://www.dest-unreach.org/socat/download/

    许可证

    Apache 2.0有关详细信息,请参阅 LICENSE


    COM  COMM  通讯  FFI  串口  
    相关文章