ruby_it8951 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecdf21aaed59fa16a9c157e93770e02100155505b22b33abd1ff99428d9e9e1e
-  data.tar.gz: c00772e6514cc340174334947a2fd137758db645616af4092589f75cb653ae0f
+  metadata.gz: 91743fb55a8856ef261d171f5afd28b1139586c409ffc3479d983e4f4719f2c6
+  data.tar.gz: 15e1f7722cf925172ec4c53ec4b62a64668580d633e3cffd57948d85a5ecf80c
 SHA512:
-  metadata.gz: a04afc13b1451a89e19fdcf2fddea3d5574f69f812d2f1db988742eec88fd3ca0e2567724792835bcdff3efda85c16c9940497dcab3400ad9c6984480cd470db
-  data.tar.gz: b2fbe314d19a4c90142f60dbc441e486501aa42801c956a710dd6d6fcb540815d82f3720a6e11baaad69b372ca20c3b1eead922850ec3f9b63aba278e722cfbc
+  metadata.gz: 493f84f6d5e89fd8f5e7f632ca02e9e09ca778afec00432ac72541015643447699210fc9b4be13b80eb6996e076404f6889959753a33cbf9861cea4b8ce2368d
+  data.tar.gz: d064a08cad049bf4c460e9f1ed0a3ffe1f0a78563e0873e4fa2105bd7a6e89fe5537fdda9421dcd4a27e92e3d7d47d500ce2827c55fb6034e2cdf19ff8135094

data/README.md

@@ -1,35 +1,27 @@
 # RubyIt8951
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/ruby_it8951`. To experiment with that code, run `bin/console` for an interactive prompt.
+## About
 
-TODO: Delete this and the text above, and describe your gem
+This gem is for [Waveshare Electronics](https://www.waveshare.com "Waveshare website")' IT-8951 controller based EPD (e-paper device) with Raspberry Pi. 
 
-## Installation
+You can easily control EPD with simple code.
 
-Add this line to your application's Gemfile:
+## Requirement
 
-```ruby
-gem 'ruby_it8951'
-```
-
-And then execute:
-
-    $ bundle install
-
-Or install it yourself as:
+ - Native Library for Raspberry Pi [epd_it8950](https://github.com/yagshi/epd_it8951)
+ 
+ - [FFI](https://github.com/ffi/ffi)
 
-    $ gem install ruby_it8951
 
-## Usage
+## Example
 
-TODO: Write usage instructions here
+```Ruby
+require 'ruby_it8951'
 
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake ` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
+IT8951.init
+info = IT8951.get_device_info  # => [width, height, addr, "fw ver", "lut ver"]
+img = (0..15).inject([]){|a, i| a + [i * 16] * 100}
+IT8951.transfer_image(20, 10, 100, 16, img)
+IT8951.display_area(0, 0, info[0], info[1], 2)
+```
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/ruby_it8951.

data/lib/ruby_it8951.rb

@@ -3,10 +3,42 @@
 require_relative "ruby_it8951/version"
 require 'ffi'
 
-module RubyIt8951
+module IT8951
   class Error < StandardError; end
+
+  class DeviceInfo < FFI::Struct
+    layout(:panelW, :uint16, :panelH, :uint16,
+           :imgBufAddrL, :uint16, :imgBufAddrH, :uint16,
+           :fwVersion, [:uint8, 16],
+           :lutVersion, [:uint8, 16]
+          )
+  end
+  # private module
+  module IT8951_P
+    extend FFI::Library
+    ffi_lib :it8951
+    attach_function :get_device_info, :it8951_get_device_info, [], DeviceInfo.by_value
+    attach_function :transfer_image, :it8951_transfer_image, [:int, :int, :int, :int, :pointer], :void
+  end
+  
+
   extend FFI::Library
   ffi_lib :it8951
-  attach_function :it8951_init, [], :void
-  attach_function :it8951_display_area, [:int, :int, :int, :int, :int], :void
+  attach_function :init, :it8951_init, [], :int
+  attach_function :display_area, :it8951_display_area, [:int, :int, :int, :int, :int], :void
+
+  def get_device_info
+    d = IT8951_P.get_device_info
+    [d[:panelW], d[:panelH], d[:imgBufAddrL] + d[:imgBufAddrH] * 256, d[:fwVersion].to_s, d[:lutVersion].to_s]
+  end
+
+  def transfer_image(x, y, w, h, data)
+    FFI::MemoryPointer.new(:uint8, data.length) do |p|
+      p.write_array_of_uint8(data)
+      IT8951_P.transfer_image(x, y, w, h, p)
+    end
+  end
+  
+  module_function :get_device_info
+  module_function :transfer_image
 end

data/lib/ruby_it8951/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyIt8951
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_it8951
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - yagshi