huawei_solar 0.0.4 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce715fa01eb6dfe7474a49c55eaaca71480dce2bb686f2e575b28f5771844cd2
-  data.tar.gz: 4818ff44871c2da9d4b66f760dcd6936e0fd77678d9814960dd26cb3e3f1ce45
+  metadata.gz: 417416fd874e751c57d7029af2e35058d9f93f1f79ac3c1b9f2a8052b755a2d0
+  data.tar.gz: 42a65897b56bdc1111aee3001fab5f7f644b9305b11fa9e4f4beee9d2e091dd2
 SHA512:
-  metadata.gz: 3f133930aee9c75e2576db51802c881bde83ad422b539128d08736f36c30822f0f01a51f924b522fd1184734991f303865cd13564f6c04bd02ddcad449f78353
-  data.tar.gz: 4343da700721f7accee952eb7fed548c96e1e80d358b7be8419dd17db7d508c1d1e530ff8cd9affa510a16d021bbd0f2af7be2aa423f68436beef71da69c02e8
+  metadata.gz: 3f9c7c0d4f29d929b8e6ed7947d800d5810ce115933544b88bacaff933ac0c288f8c27ff36508e48b5149bd02f7d8987b4ca4d055270fe2a9bd0917f8fd99013
+  data.tar.gz: 55aef700e1ecdda36f117eb918a80beaa6ebcc7905f8487e99f1f63d7add9c37009a20a3317e91a396c53d0781c6329d47c01a6ab3393faef79ac75ab2d0b293

data/.irbrc

@@ -0,0 +1 @@
+IRB.conf[:IRB_NAME] = "[huawei_solar]"

data/.tool-versions

@@ -1 +1 @@
-ruby 3.1.2
+ruby 3.2.2

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [0.0.6] - 2023-08-09
+- Add inverter time and tz
+
+## [0.0.5] - 2023-08-05
+- Add `read_all` method
+- Change `with_unit` option to `units` or `unit` option.
+- Add `keys` option for return hash instead of array when retrieve multiple keys
+- Change development console from pry to irb
+
 ## [0.0.4] - 2023-01-25
 - Add more meter metrics
 

data/Gemfile

@@ -5,7 +5,6 @@ source "https://rubygems.org"
 gemspec
 
 gem "minitest", "~> 5.0"
-gem "pry", "~> 0.14"
 gem "rake", "~> 13.0"
 gem "rubocop", "~> 1.21"
 gem "rubocop-minitest", "~> 0.19"

data/Gemfile.lock

@@ -1,22 +1,17 @@
 PATH
   remote: .
   specs:
-    huawei_solar (0.0.4)
+    huawei_solar (0.0.5)
       rmodbus (~> 1.3.3)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
-    coderay (1.1.3)
-    method_source (1.0.0)
     minitest (5.15.0)
     parallel (1.22.1)
     parser (3.1.1.0)
       ast (~> 2.4.1)
-    pry (0.14.1)
-      coderay (~> 1.1)
-      method_source (~> 1.0)
     rainbow (3.1.1)
     rake (13.0.6)
     regexp_parser (2.2.1)
@@ -42,12 +37,12 @@ GEM
 
 PLATFORMS
   arm64-darwin-21
+  arm64-darwin-22
   x86_64-linux
 
 DEPENDENCIES
   huawei_solar!
   minitest (~> 5.0)
-  pry (~> 0.14)
   rake (~> 13.0)
   rubocop (~> 1.21)
   rubocop-minitest (~> 0.19)

data/README.md

@@ -1,7 +1,5 @@
 # Huawei Solar
 
-![CI](https://github.com/javierav/huawei_solar/workflows/CI/badge.svg)
-
 A Ruby library for connect to Huawei Solar inverters using Modbus TCP.
 
 ## Status
@@ -19,14 +17,26 @@ hs = HuaweiSolar.new("192.168.0.110", 502)
 
 hs.read(:inverter_model) # => "SUN2000-3.68KTL-L1"
 hs.read(:inverter_input_power) # => 234.0
-hs.read(:inverter_input_power, with_unit: true) # => "234.0 W"
+hs.read(:inverter_input_power, unit: true) # => "234.0 W"
 
 hs.read(%i[inverter_output_power inverter_daily_energy meter_grid_power])
 # => [225.0, 5.82, -339.0]
 
-hs.read(%i[inverter_output_power inverter_daily_energy meter_grid_power], with_unit: true)
+hs.read(%i[inverter_output_power inverter_daily_energy meter_grid_power], units: true)
 # => ["225.0 W", "5.82 kWh", "-339.0 W"]
 
+hs.read(%i[inverter_output_power inverter_daily_energy meter_grid_power], units: true, keys: true)
+# => {:inverter_output_power=>"606.0 W", :inverter_daily_energy=>"15.15 kWh", :meter_grid_power=>"353.0 W"}
+
+hs.read_all
+# => ["SUN2000-3.68KTL-L1", "XXXXXXXX", 2, 224.8, 3.08, ..]
+
+hs.read_all(units: true)
+# => ["SUN2000-3.68KTL-L1", "XXXXXXXX", 2, "224.8 V", "3.08 A", ..]
+
+hs.read_all(keys: true)
+# => { "inverter_model"=>"SUN2000-3.68KTL-L1", "inverter_serial_number"=>"XXXXXXXX", "inverter_pv_strings"=>2, ... }
+
 hs.close
 ```
 

data/data/registers.yml

@@ -123,6 +123,22 @@ inverter_grid_frequency:
   unit: Hz
   gain: 100
 
+# Hora del inversor
+inverter_time:
+  type: u32
+  address: 40000
+  quantity: 2
+  unit: epoch seconds
+  gain: 1
+
+# Zona horaria del inversor
+inverter_tz:
+  type: i16
+  address: 43006
+  quantity: 1
+  unit: minutes
+  gain: 1
+
 #
 ## METER
 #

data/lib/huawei_solar/version.rb

@@ -4,7 +4,7 @@ class HuaweiSolar
   module VERSION
     MAJOR = 0
     MINOR = 0
-    TINY  = 4
+    TINY  = 6
     PRE   = nil
 
     STRING = [MAJOR, MINOR, TINY, PRE].compact.join(".")

data/lib/huawei_solar.rb

@@ -12,8 +12,12 @@ class HuaweiSolar
     @registers = YAML.load_file(File.expand_path("../data/registers.yml", __dir__))
   end
 
-  def read(name, with_unit: false)
-    name.is_a?(Array) ? read_multiple(name, with_unit:) : read_single(name, with_unit:)
+  def read(name, **options)
+    name.is_a?(Array) ? read_multiple(name, **options) : read_single(name, **options)
+  end
+
+  def read_all(**options)
+    read_multiple(@registers.keys, **options)
   end
 
   def close
@@ -22,7 +26,7 @@ class HuaweiSolar
 
   private
 
-  def read_single(name, with_unit: false) # rubocop:disable Metrics/AbcSize
+  def read_single(name, **options) # rubocop:disable Metrics/AbcSize
     register = register_by_name(name)
     type = find_type(register["type"])
     gain = register["gain"]
@@ -35,11 +39,15 @@ class HuaweiSolar
     value = value.is_a?(Array) && value.size == 1 ? value.first : value
     value = gain ? value / (gain * 1.0) : value
 
-    with_unit && !unit.nil? ? "#{value} #{unit}" : value
+    (options[:units] || options[:unit]) && !unit.nil? ? "#{value} #{unit}" : value
   end
 
-  def read_multiple(names, with_unit: false)
-    names.map { |name| read_single(name, with_unit:) }
+  def read_multiple(names, **options)
+    if options[:keys]
+      names.to_h { |name| [name, read_single(name, **options)] }
+    else
+      names.map { |name| read_single(name, **options) }
+    end
   end
 
   def register_by_name(name)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: huawei_solar
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.6
 platform: ruby
 authors:
 - Javier Aranda
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-25 00:00:00.000000000 Z
+date: 2023-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rmodbus
@@ -26,7 +26,7 @@ dependencies:
         version: 1.3.3
 description:
 email:
-- javier.aranda.varo@gmail.com
+- aranda@hey.com
 executables: []
 extensions: []
 extra_rdoc_files:
@@ -35,7 +35,7 @@ extra_rdoc_files:
 files:
 - ".editorconfig"
 - ".envrc"
-- ".pryrc"
+- ".irbrc"
 - ".rubocop.yml"
 - ".tool-versions"
 - CHANGELOG.md
@@ -58,8 +58,8 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/javierav/huawei_solar
-  source_code_uri: https://github.com/javierav/huawei_solar/tree/v0.0.4
-  changelog_uri: https://github.com/javierav/huawei_solar/blob/v0.0.4/CHANGELOG.md
+  source_code_uri: https://github.com/javierav/huawei_solar/tree/v0.0.6
+  changelog_uri: https://github.com/javierav/huawei_solar/blob/v0.0.6/CHANGELOG.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options:
@@ -77,7 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: A library for connect to Huawei Solar inverters using Modbus TCP

data/.pryrc

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-Pry.config.prompt_name = "[huawei_solar]"