plc_access 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab5af068754de94a85c011c2649a60b913bf7d5767f19b6c7acccddf95dc13ad
-  data.tar.gz: 8f0750599d28cceff1c12816236ce7766f29120e0ed985f56e05a7cee4c4c1e9
+  metadata.gz: c7944febc355a406f20d64952237fb1cb58d718c079d9b1743535ce495d5a153
+  data.tar.gz: d76735035b4e7749ef4beb234b5cad4392090fe892ae6321a3ae24e14a54cc25
 SHA512:
-  metadata.gz: f4723143d4b6f0ffaf4eb56925b04dbb9eb14fe61bbab1ee216383876bbd187969761af2237120d415fc496cb16e3e8f24312b612ac4e28cae9f3816af62f0ba
-  data.tar.gz: 584140d65859c52ec474286a53e1ec551b84c9c401bf3613d57457151d730ecc23c472458bbfa35bf83ca073fb3f93fd6ac117d1e348b64e8f7938497c731ba2
+  metadata.gz: a8a256b8f7e4cf5d3a7e1cbf6d7d21168ceaccb0927279c1427f293bb603622b648ae1d660649262d10204f8146f926d9f7ec6cf8ec38a2ae6089c475b0f4d39
+  data.tar.gz: 7d5e7fc1ca634bb9397f4f752b91efa4eecdc3535db7915e01f3e3a0f9b06b57ec250f8d69c4eafba5afbc313d30d17b2f1db629eaef66b15348dbf3da9ea6fa

data/CHANGES.md

@@ -1,5 +1,12 @@
 # CHANGES
 
+## 0.2.1
+
+- Add byte order support for string/ushort conversion per PLC type (Mitsubishi: little-endian, Keyence/Omron: big-endian)
+- Accept plc object in as_ushort/to_string to auto-detect byte order
+- Allow Protocol#[]= to pad with zeros or truncate when array size differs from count
+- Allow Protocol#[]= to accept arrays without specifying count
+
 ## 0.1.3
 
 - Rename Array#as_string to Array#to_string

data/Gemfile.lock

@@ -1,14 +1,14 @@
 PATH
   remote: .
   specs:
-    plc_access (0.1.3)
+    plc_access (0.2.1)
       serialport (~> 1.3, >= 1.3.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
-    json (2.10.1)
+    json (2.18.1)
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
     parallel (1.26.3)

data/README.md

@@ -73,10 +73,17 @@ plc["DM0", 10] = [0, 1, 2, 3, 4].as_int  # => [0, 0, 1, 0, 2, 0, 3, 0, 4, 0]
 
 plc["MR0", 10].to_int # => [0, 1, 2, 3, 4]
 
-# Set string to data memory (ten wors from DM0) as ushort values.
-plc["DM0", 10] = "PLC Access".as_ushort()
-# Get string from data memory (ten wors from DM0).
-plc["DM0", 10].to_string()
+# Set string to data memory (ten words from DM0) as ushort values.
+# The byte order for string conversion differs by PLC type
+# (e.g., Mitsubishi uses little-endian, Keyence/Omron use big-endian).
+# Pass plc to automatically use the correct byte order.
+plc["DM0", 10] = "PLC Access".as_ushort(plc)
+# Get string from data memory (ten words from DM0).
+plc["DM0", 10].to_string(plc)
+
+# You can also specify the length and plc together.
+plc["DM0", 5] = "PLC Access".as_ushort(10, plc)
+plc["DM0", 5].to_string(10, plc)
 
 ```
 

data/lib/plc_access/act_as_type.rb

@@ -43,8 +43,17 @@ module ActAsType
       pack("f*").unpack("S*")
     end
 
-    def to_string length=nil, encoding=Encoding::UTF_8
-      s = pack("v*")
+    def to_string length=nil, encoding=Encoding::UTF_8, endian: :little
+      if length.respond_to?(:string_endian)
+        endian = length.string_endian
+        length = nil
+      end
+      if encoding.respond_to?(:string_endian)
+        endian = encoding.string_endian
+        encoding = Encoding::UTF_8
+      end
+      format = endian == :big ? "n*" : "v*"
+      s = pack(format)
       if length
         s = s[0, length].delete("\000")
       end
@@ -55,10 +64,19 @@ module ActAsType
 
   refine String do
 
-    def as_ushort length=nil, encoding=Encoding::UTF_8
-      a = self.encode(encoding).unpack("v*")
+    def as_ushort length=nil, encoding=Encoding::UTF_8, endian: :little
+      if length.respond_to?(:string_endian)
+        endian = length.string_endian
+        length = nil
+      end
+      if encoding.respond_to?(:string_endian)
+        endian = encoding.string_endian
+        encoding = Encoding::UTF_8
+      end
+      format = endian == :big ? "n*" : "v*"
+      a = self.encode(encoding).unpack(format)
       return a unless length
-      
+
       s = (length + 1) / 2
       a += [0] * [s - a.length, 0].max
       a[0, s]

data/lib/plc_access/protocol/mitsubishi/fx_protocol.rb

@@ -170,6 +170,10 @@ module PlcAccess
           raise "ERROR: return #{res} for set_bits_to_device(#{words}, #{device.name})" unless res == ack_packet
         end
 
+        def string_endian
+          :little
+        end
+
         def device_by_name(name)
           case name
           when String

data/lib/plc_access/protocol/mitsubishi/mc_protocol.rb

@@ -160,6 +160,10 @@ module PlcAccess
           end
         end
 
+        def string_endian
+          :little
+        end
+
         def device_by_name(name)
           case name
           when String

data/lib/plc_access/protocol/mitsubishi/qdevice.rb

@@ -107,6 +107,10 @@ module PlcAccess
         def -(other)
           self.class.new suffix, [number - other, 0].max
         end
+
+        def string_endian
+          :little
+        end
       end
     end
   end

data/lib/plc_access/protocol/plc_device.rb

@@ -147,6 +147,10 @@ module PlcAccess
     alias word value
     alias word= value=
 
+    def string_endian
+      :big
+    end
+
     def text(len = 8)
       n = (len + 1) / 2
       d = self
@@ -155,14 +159,16 @@ module PlcAccess
         a << d.value
         d = d.next_device
       end
-      s = a.pack('n*').split("\x00").first
+      format = string_endian == :big ? 'n*' : 'v*'
+      s = a.pack(format).split("\x00").first
       s ? s[0, len] : ''
     end
 
     def set_text(value, len = 8)
       value = value[0, len]
       value << "\00" unless value.length.even?
-      a = value.unpack('n*')
+      format = string_endian == :big ? 'n*' : 'v*'
+      a = value.unpack(format)
       d = self
       a.each do |v|
         d.value = v

data/lib/plc_access/protocol/plc_share/plc_share_protocol.rb

@@ -46,6 +46,15 @@ module PlcAccess
           @device_type = type
         end
 
+        def string_endian
+          case @device_type
+          when :fx, :q
+            :little
+          else
+            :big
+          end
+        end
+
         private
 
         def device_class

data/lib/plc_access/protocol/protocol.rb

@@ -58,6 +58,10 @@ module PlcAccess
 
       TIMEOUT = 1.0
 
+      def string_endian
+        :big
+      end
+
       # abstract methods
 
       def open; end
@@ -169,7 +173,7 @@ module PlcAccess
           v = [v] unless v.is_a? Array
           case args[0]
           when String
-            self[args[0], 1] = v
+            self[args[0], v.size] = v
           when Range
             self[args[0].first, args[0].count] = v
           else
@@ -181,7 +185,8 @@ module PlcAccess
           c = args[1]
           values = args[2]
           values = [values] unless values.is_a? Array
-          raise ArgumentError, "Count #{c} is not match #{args[2].size}." unless c == values.size
+          values += [0] * (c - values.size) if values.size < c
+          values = values[0, c] if values.size > c
 
           a = []
           if d.bit_device?

data/lib/plc_access/version.rb

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

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: plc_access
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Katsuyoshi Ito
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-22 00:00:00.000000000 Z
+date: 2026-02-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: serialport
@@ -78,7 +77,6 @@ metadata:
   homepage_uri: https://github.com/ito-soft-design/plc_access
   source_code_uri: https://github.com/ito-soft-design/plc_access
   changelog_uri: https://github.com/ito-soft-design/plc_access/CHANGES.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -93,8 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.5
 specification_version: 4
 summary: The PlcAccess communicates with PLCs.
 test_files: []