plc_access 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 508b6323047d55f073eb5d46d05919284b5d09c9c5cdf417df67a60642d1c097
-  data.tar.gz: '017940d773f256fec40e4fd0ac70a6efe491354401a20c9b23a99a47fe0b66c8'
+  metadata.gz: ab5af068754de94a85c011c2649a60b913bf7d5767f19b6c7acccddf95dc13ad
+  data.tar.gz: 8f0750599d28cceff1c12816236ce7766f29120e0ed985f56e05a7cee4c4c1e9
 SHA512:
-  metadata.gz: f73eca7c987f0ae58e02ff3e0b4526fce468c75d19cf16f45f0d80cff5655b5b7b6536a020fc69be177ac47e900df18737aef637d63a55a128b2b02ee63e7da0
-  data.tar.gz: 8595aa8ca039870ec747a1646a36923ee8558f98099ebc593dae70c9df435402fd749019a6b539e0017e4ed0d4879b3196aa38f1c384f55fc668cf10a09380e7
+  metadata.gz: f4723143d4b6f0ffaf4eb56925b04dbb9eb14fe61bbab1ee216383876bbd187969761af2237120d415fc496cb16e3e8f24312b612ac4e28cae9f3816af62f0ba
+  data.tar.gz: 584140d65859c52ec474286a53e1ec551b84c9c401bf3613d57457151d730ecc23c472458bbfa35bf83ca073fb3f93fd6ac117d1e348b64e8f7938497c731ba2

data/CHANGES.md

@@ -1,5 +1,10 @@
 # CHANGES
 
+## 0.1.3
+
+- Rename Array#as_string to Array#to_string
+- Rename String#to_ushort to String#as_ushort
+
 ## 0.1.2
 
 - Be able to access the type value that you want to get.

data/Gemfile.lock

@@ -1,43 +1,49 @@
 PATH
   remote: .
   specs:
-    plc_access (0.1.1)
+    plc_access (0.1.3)
       serialport (~> 1.3, >= 1.3.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
-    json (2.6.2)
-    parallel (1.22.1)
-    parser (3.1.2.1)
+    json (2.10.1)
+    language_server-protocol (3.17.0.4)
+    lint_roller (1.1.0)
+    parallel (1.26.3)
+    parser (3.3.7.1)
       ast (~> 2.4.1)
-    power_assert (2.0.1)
+      racc
+    power_assert (2.0.5)
+    racc (1.8.1)
     rainbow (3.1.1)
     rake (12.3.3)
-    regexp_parser (2.5.0)
-    rexml (3.2.5)
-    rr (3.1.0)
-    rubocop (1.36.0)
+    regexp_parser (2.10.0)
+    rr (3.1.1)
+    rubocop (1.72.2)
       json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
-      parser (>= 3.1.2.1)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.20.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.21.0)
-      parser (>= 3.1.1.0)
-    ruby-progressbar (1.11.0)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.38.0)
+      parser (>= 3.3.1.0)
+    ruby-progressbar (1.13.0)
     serialport (1.3.2)
-    test-unit (3.5.3)
+    test-unit (3.6.7)
       power_assert
     test-unit-rr (1.0.5)
       rr (>= 1.1.1)
       test-unit (>= 2.5.2)
-    unicode-display_width (2.3.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
 
 PLATFORMS
   ruby

data/README.md

@@ -80,6 +80,74 @@ plc["DM0", 10].to_string()
 
 ```
 
+## Supported PLCs
+
+### Keyence
+
+It supports Keyence PLCs with an Ethernet connection.
+
+```
+plc = PlcAccess::Protocol::Keyence::KvProtocol.new host: '192.168.0.10', port: 8501
+```
+
+### Mitsubishi
+
+It supports Mitsubishi PLCs with an Ethernet connection.
+
+```
+plc = PlcAccess::Protocol::Mitsubishi::McProtocol.new host: '192.168.0.10', port: 5010
+```
+
+It supports Mitsubishi Fx PLCs with a Serial connection.
+
+```
+plc = PlcAccess::Protocol::Mitsubishi::FxProtocol.new port: /dev/tty.usbxxxxx'
+```
+
+PLC configuration:
+- baudrate: 19200
+- bit: 7
+- parity: Odd
+- stop bit: 1
+
+![](images/fx_comm_setting.png)
+
+### Omron
+
+It supports Omron PLCs with an Ethernet connection.
+
+```
+plc = PlcAccess::Protocol::Omron::FinsTcpProtocol.new host: '192.168.0.10', port: 9600
+```
+
+It supports Omron PLCs with a C Mode serial connection.
+
+```
+plc = PlcAccess::Protocol::Omron::CModeProtocol.new port: /dev/tty.usbxxxxx'
+```
+
+### Plc Share
+
+Plc Share is a protocol conversion application. It runs on Windows and connects to various PLCs using a serial or Ethernet connection. You can then connect with the Plc Share Protocol, which extends Keyence’s protocol. You can specify a target PLC’s device.
+
+[Plc Share](http://iphone.itosoft.com/plcshare)
+
+![](images/plc_share.png)
+
+```
+plc = PlcAccess::Protocol::PlcShare::PlcShareProtocol.new host: '192.168.0.10', port: 10000, device_type: :fx
+```
+
+You can choose a target PLC by using the device type option.
+
+|device_type|Target PLCs|
+|:-:|:--|
+|:kv|Keyence PLCs|
+|:fx|Mitsubishi Fx PLCs|
+|:q|Mitsubishi Q/L/R PLCs|
+|:omron|Omron PLCs|
+
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/ito-soft-design/plc_access. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/ito-soft-design/plc_access/blob/master/CODE_OF_CONDUCT.md).

data/lib/plc_access/act_as_type.rb

@@ -43,7 +43,7 @@ module ActAsType
       pack("f*").unpack("S*")
     end
 
-    def as_string length=nil, encoding=Encoding::UTF_8
+    def to_string length=nil, encoding=Encoding::UTF_8
       s = pack("v*")
       if length
         s = s[0, length].delete("\000")
@@ -55,7 +55,7 @@ module ActAsType
 
   refine String do
 
-    def to_ushort length=nil, encoding=Encoding::UTF_8
+    def as_ushort length=nil, encoding=Encoding::UTF_8
       a = self.encode(encoding).unpack("v*")
       return a unless length
       

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# The MIT License (MIT)
+#
+# Copyright (c) 2025 ITO SOFT DESIGN Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+dir = __dir__
+$LOAD_PATH.unshift dir unless $LOAD_PATH.include? dir
+
+require 'socket'
+require 'logger'
+require 'timeout'
+require 'plc_share_protocol'

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

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# The MIT License (MIT)
+#
+# Copyright (c) 2025 ITO SOFT DESIGN Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+module PlcAccess
+  module Protocol
+    module PlcShare
+      class PlcShareProtocol < PlcAccess::Protocol::Keyence::KvProtocol
+        attr_accessor :device_type
+
+        def initialize(options = {})
+          super
+          @socket = nil
+          @host = options[:host] || '192.168.0.10'
+          @port = options[:port] || 10000
+          self.device_type = options[:device_type] if options[:device_type]
+        end
+
+        # Device type
+        #   :kv  Keyence device
+        #   :fx  Mitsubishi Fx device
+        #   :q   Mitsubishi Q/L device
+        #   :omron   Omron device
+        def device_type= type
+          @device_type = type
+        end
+
+        private
+
+        def device_class
+          case @device_type
+          when :kv
+            PlcAccess::Protocol::Keyence::KvDevice
+          when :fx
+            PlcAccess::Protocol::Mitsubishi::FxDevice
+          when :q
+            PlcAccess::Protocol::Mitsubishi::QDevice
+          when :omron
+            PlcAccess::Protocol::Omron::OmronDevice
+          else
+            PlcAccess::Protocol::Keyence::KvDevice
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/plc_access/protocol/protocol.rb

@@ -217,3 +217,4 @@ require 'plc_device'
 require 'keyence/keyence'
 require 'mitsubishi/mitsubishi'
 require 'omron/omron'
+require 'plc_share/plc_share'

data/lib/plc_access/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plc_access
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Katsuyoshi Ito
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-12-11 00:00:00.000000000 Z
+date: 2025-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: serialport
@@ -49,6 +49,8 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- images/fx_comm_setting.png
+- images/plc_share.png
 - lib/plc_access.rb
 - lib/plc_access/act_as_type.rb
 - lib/plc_access/protocol/keyence/keyence.rb
@@ -64,6 +66,8 @@ files:
 - lib/plc_access/protocol/omron/omron.rb
 - lib/plc_access/protocol/omron/omron_device.rb
 - lib/plc_access/protocol/plc_device.rb
+- lib/plc_access/protocol/plc_share/plc_share.rb
+- lib/plc_access/protocol/plc_share/plc_share_protocol.rb
 - lib/plc_access/protocol/protocol.rb
 - lib/plc_access/version.rb
 - plc_access.gemspec
@@ -89,7 +93,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: The PlcAccess communicates with PLCs.