compute_unit 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ce131c209f99ed5bd86a2439e56b2fcd8e0d7b85120db149d3c4427e6ea8ef0
-  data.tar.gz: 478ef837c6b68adecfc84bb6adc4f6120a8f8e119e371ce13f3503808e92788f
+  metadata.gz: 82032a2c2110769430dd7b1a3f4b624227275eb5a3a3e62f6e0e42bdb41790c3
+  data.tar.gz: 7e45e2b1cd11b5cb0cfb40b00fee99a20ecc6e125064a2251372c4e14f22e1ca
 SHA512:
-  metadata.gz: 9f1f22c7a80b053fb7612bb0e40bd7f2ea609b4c747dcdf486875289d2edab9090d590ca333d33be763cc3cec55faa6ca3a8568dc8f8f212eea3adf3e629120b
-  data.tar.gz: 11b96609eec70c967865ecb476367210a356dfdec6a9b833929c4992e937ad8f568cdf5a01e4f1a7fa77cdcf941a245d20a55a5704385b7de1c4efc11855605d
+  metadata.gz: 8c818aa6ba28c5af8d57e8e99e4deb81a3eb4cc19532ce68d4888e6f644d780360c5568272667a9c5edc4807da90b49ee7c454c86164d925eab409c0332385c2
+  data.tar.gz: 2898757c00752709b8cfec4a4137f3bc65310d0e1af2a68637a1b3eba385f7e0188acb2790538b40e1fd2a650f65152175bfd99947cdd2d023baee3fa321aa64

data/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Compute Unit Changelog
 
 ## Unrleased
+
+## 0.2.1
+Released 6/6/2020
+
+* update rake and other gems
+
 ## 0.2.0
 Released 6/5/2020
 * Added more cpu methods for various POI.

data/Gemfile

@@ -2,17 +2,11 @@
 
 source 'https://rubygems.org'
 
-
-gem 'opencl_ruby_ffi', '~> 1.3.4'
-gem 'compute_unit', path: '.'
-
 group :test do
   gem 'pry'
   gem 'rubocop'
   gem 'rubocop-rspec'
   gem 'ruby-prof'
   gem 'simplecov'
-  gem 'rake', '~> 10.0'
-  gem 'rspec', '~> 3.0'
-  gem 'bundler', '~> 2.0'
 end
+gemspec

data/README.md

@@ -1,9 +1,9 @@
 # Compute Unit Ruby Library
-The compute unit library helps you write future abstractions and tooling for crypto mining, machine learning or just general purpose usage.  This library was extracted out of the crypto mining tool [Crossbelt](https://crossbelt.blockops.party) to help spur more tooling to ruby. 
+The compute unit library helps you write future abstractions and tooling for crypto mining, machine learning or just general purpose.  This library was extracted out of the crypto mining tool [Crossbelt](https://crossbelt.blockops.party) to help spur more tooling for ruby. 
 
 Uses the sysfs filesystem to quickly read and write compute unit data. More information about sysfs can be found [here](https://www.kernel.org/doc/Documentation/filesystems/sysfs-pci.txt)
 
-This library will:
+This library has the ability to:
 
  * Detect all compute devices such as cpu, gpu, and anything else we add to this library. 
  * Provide the ability to control GPU fans.
@@ -11,6 +11,7 @@ This library will:
  * Change or view voltage, core clock, memory clock and other tunning parameters used for overclocking.
  * Provide inventory data of all the devices with make, model and other important information. 
  * Provide realtime status information of various data points. Useful for real-time tunning. 
+ * Interact with the compute device via ruby.
 
 This library was open sourced to allow further refinement and usage throughout the ruby community. 
 Since machine learning is not popular on ruby due to device and program support, I hope this gem will 
@@ -34,17 +35,110 @@ Or install it yourself as:
 
 ## Usage
 
+Find all compute devices
 ```
 require 'compute_unit'
 devices = ComputeUnit.find_all
 
 ```
 
+Find just GPU devices and list the voltage table
+
+```ruby
+require 'compute_unit/gpu'
+
+gpu = ComputeUnit::Gpu.find_all.first
+gpu.voltage_table
+=> [{:pstate=>0, :clk=>852, :volt=>800, :type=>:sclk},
+ {:pstate=>1, :clk=>997, :volt=>860, :type=>:sclk},
+ {:pstate=>2, :clk=>1084, :volt=>860, :type=>:sclk},
+ {:pstate=>3, :clk=>1138, :volt=>860, :type=>:sclk},
+ {:pstate=>4, :clk=>1200, :volt=>860, :type=>:sclk},
+ {:pstate=>5, :clk=>1401, :volt=>860, :type=>:sclk},
+ {:pstate=>6, :clk=>1536, :volt=>860, :type=>:sclk},
+ {:pstate=>7, :clk=>1630, :volt=>1200, :type=>:sclk}]
+
+gpu.amdgpu_pm_info
+=> {:mclk=>{:value=>"1020", :unit=>"MHz"},
+ :sclk=>{:value=>"994", :unit=>"MHz"},
+ :pstate_sclk=>{:value=>"1138", :unit=>"MHz"},
+ :pstate_mclk=>{:value=>"800", :unit=>"MHz"},
+ :vddgfx=>{:value=>"862", :unit=>"mV"},
+ :average_gpu=>{:value=>"121.0", :unit=>"W"},
+ :temperature=>{:value=>"57", :unit=>"C"},
+ :load=>{:value=>"100", :unit=>"%"}} 
+
+```
+
+## Example CLI command
+There is a `list_computes` command that will enumerate all the compute devices found on the system.
+
+```ruby
+list_computes
+[
+  {
+    "uuid": "GPU0",
+    "gpuId": "GPU0",
+    "syspath": "/sys/bus/pci/devices/0000:03:00.0",
+    "pciLoc": "0000:03:00.0",
+    "name": "RX Vega56",
+    "bios": "113-D0500100-102",
+    "subType": "amdgpu",
+    "make": "AMD",
+    "model": "RX Vega56",
+    "vendor": "AMD",
+    "power": 121,
+    "utilization": 100,
+    "temperature": 57,
+    "status": 0,
+    "pstate": -1,
+    "fanSpeed": 2946,
+    "type": "GPU",
+    "maxTemp": null,
+    "mem": 1020,
+    "cor": 997,
+    "vlt": 862,
+    "mem_temp": 75,
+    "maxFan": null,
+    "dpm": null,
+    "vddci": null,
+    "maxPower": null,
+    "ocProfile": null,
+    "opencl_enabled": false
+  },
+  {
+    "chip_make": "GenuineIntel",
+    "make": "GenuineIntel",
+    "model": "Intel(R) Core(TM) i3-7100 CPU @ 3.90GHz",
+    "device_id": "590f",
+    "vendor_id": "8086",
+    "subsystem_device_id": "7a59",
+    "subsystem_vendor_id": "1462",
+    "device_class": "060000",
+    "temp": 33,
+    "minFreqMhz": 800,
+    "maxFreqMhz": 3900,
+    "currentFreqMhz": 3600,
+    "numCores": 2,
+    "numThreads": 2,
+    "nproc": 4,
+    "temps": {
+      "package_id_0": 33,
+      "core_0": 26,
+      "core_1": 33
+    }
+  }
+]
+```
+
 ### Subclassing a compute object
-Instead of monkey patching this code you can simply subclass the objects.  The find_all methods are intelligent enough to locate your subclass by searching the Objectspace for all decendants of `ComputeUnit::ComputeBase`.  This makes it dead simple to add new functionality without having to wrap any code.  This gives you the ability to include new modules or override existing methods.
+Instead of monkey patching this code you can simply subclass the objects.  The find_all methods are intelligent enough to locate your subclass by searching the Objectspace for all decendants of `ComputeUnit::ComputeBase`.  This makes it dead simple to add new functionality without having to wrap any code.  This gives you the ability to include new modules or override existing methods.  Just make sure you load your class before using the find_all method.
+
+
 
 ```ruby
 # coolproject/vegagpu.rb
+require 'cool_project/vega_gpu'
 module CoolProject
   class VegaGpu < ::ComputeUnit::Gpu::AmdGpu
     include CoolProject::Metrics
@@ -60,7 +154,7 @@ end
 
 Once you have your new class created all you need to do is load the class before running find all.
 
-```
+```ruby
 require 'compute_unit'
 require 'coolproject/vegagpu'
 require 'yaml'
@@ -84,6 +178,21 @@ There will likely be changes with reading and writing information to sysfs as ne
 * 4.15 - 4.20
 * 5.x 
 
+## OpenCL Usage
+The opencl_ruby_ffi gem is optionally used to gather additional info about the GPU.  This can sometimes result in better model info.  
+
+There is some caution when using OpenCL.  If a GPU is dead, OpenCL tends to hang/freeze thus forcing a reboot.  This is not a bug in the compute_unit or opencl_ruby_ffi gem but in the OpenCL library instead.
+
+Getting data from OpenCL also takes a long time!  So if you have multiple GPUs in your system this could takes multiple seconds to return data.  Because of this we cache the responses for the next query.  This response is cached until the system checksum changes.  This checksum is a special calculate of all the devices present in the system.  So if you ever added or changed the equipment in the system, a new OpenCL query would ensue. 
+
+To enable OpenCL you just need to pass a boolean value to any of the find_all methods:
+
+```ruby
+require 'compute_unit'
+devices = ComputeUnit.find_all(true)
+
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -96,7 +205,7 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/logicm
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT.
 
 ## Code of Conduct
 

data/compute_unit.gemspec

@@ -13,9 +13,9 @@ Gem::Specification.new do |spec|
   spec.summary       = 'A ruby library for compute unit devices'
   spec.description   = <<~EOF
 
-    A ruby library that searches uses the linux sysfs file system for compute unit devices such as
-    CPUS, GPUs and other ASIC compute devices. Allows programmatic access collect real time metrics from the kernel or relatated driver toolchain.
-    Is meant to be used as a toolchain to future build tooling on. This library also makes use of opencl toolchain and requires
+    A ruby library that searches the linux sysfs file system for compute unit devices such as
+    CPUS, GPUs and other ASIC compute devices. Allows programmatic access to collect real time metrics from the kernel or relatated driver toolchain.
+    Is meant to be used as a toolchain for future tools. This library also makes use of opencl library and requires
     the opencl_ruby_ffi gem.
 
   EOF
@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
 
   spec.metadata['homepage_uri'] = spec.homepage
   spec.metadata['source_code_uri'] = spec.homepage
-  spec.metadata['changelog_uri'] = "#{spec.homepage}/CHANGELOG"
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/CHANGELOG.md"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -36,8 +36,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'opencl_ruby_ffi', '~> 1.3.0'
-  spec.add_development_dependency 'bundler', '~> 2.0'
-  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_dependency 'opencl_ruby_ffi', '~> 1.3.4'
+  spec.add_development_dependency 'bundler', '~> 2.1'
+  spec.add_development_dependency 'rake', '~> 13'
   spec.add_development_dependency 'rspec', '~> 3.0'
 end

data/lib/compute_unit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ComputeUnit
-  VERSION = '0.2.0'
+  VERSION = '0.2.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: compute_unit
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Corey Osman
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-05 00:00:00.000000000 Z
+date: 2020-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opencl_ruby_ffi
@@ -16,42 +16,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.3.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.3.4
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -68,9 +68,9 @@ dependencies:
         version: '3.0'
 description: |2+
 
-  A ruby library that searches uses the linux sysfs file system for compute unit devices such as
-  CPUS, GPUs and other ASIC compute devices. Allows programmatic access collect real time metrics from the kernel or relatated driver toolchain.
-  Is meant to be used as a toolchain to future build tooling on. This library also makes use of opencl toolchain and requires
+  A ruby library that searches the linux sysfs file system for compute unit devices such as
+  CPUS, GPUs and other ASIC compute devices. Allows programmatic access to collect real time metrics from the kernel or relatated driver toolchain.
+  Is meant to be used as a toolchain for future tools. This library also makes use of opencl library and requires
   the opencl_ruby_ffi gem.
 
 email:
@@ -119,7 +119,7 @@ licenses:
 metadata:
   homepage_uri: https://gitlab.com/blockops/compute_unit
   source_code_uri: https://gitlab.com/blockops/compute_unit
-  changelog_uri: https://gitlab.com/blockops/compute_unit/CHANGELOG
+  changelog_uri: https://gitlab.com/blockops/compute_unit/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths: