kiss-tnc 1.0.2 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 99d6c50a0bf885718135a8dc1cb68981f3687e4c
-  data.tar.gz: 537b7c2326b4178c298a95b2ceb914847f3b89c2
+SHA256:
+  metadata.gz: de2de9bab4531fa71c87064c557b99545191a14ca86d094c46be3969f7d326a9
+  data.tar.gz: d6623ac8144ac07a344262577aec994a4841ef5cd1e47a2b84c0ea398a8d3e2a
 SHA512:
-  metadata.gz: 98e0c08a289ff4e3a2c7dc3b16d7447ba0ca7a4199d17b0f06c88c16d209723517e61080172b3aaaa493756c529e28fce8a9a2592a9b540f1d5c024f7683bfbd
-  data.tar.gz: 1f45a81b214692a2e64e1749190bcea353efd8c93ef9599d8c97640dd0e75ca6e169abd3da79f01dc3769ccf0a35010818dbba47628377c1a13e7484891fecc5
+  metadata.gz: 56e1500ab363d8382e9d4f5324cdb9df36f9516974c01edf4c93e985e31a0597d50ff812853e101146f61838f563a832487309298a6c9427c3221a48d964463e
+  data.tar.gz: cfe67d7786440d421a7b676407c9efc102b1b6e568805b9992995d762eebf4758fc3b0110804cd115b319ecc42e04caa08fa7854fb10f2141e1c5e5c853961fe

data/.gitignore

@@ -5,3 +5,4 @@ html
 Gemfile.lock
 .idea/
 *.gem
+/public/

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2.0.0
+
+* Moved abstraction over to abstractify library.
+* Added more parsing methods so entry points now take strings rather than KISS encoded data.
+* Added errors where appropriate, for example writing invalid frames now throw an IOError.
+
+## 1.0.3
+
+* Changed KissSerial so its methods can accept any arguments, used for abstraction purposes.
+
 ## 1.0.2
 
 * Fixed a bug where bytes were not written to the serial stream correctly.
@@ -12,4 +22,4 @@
 
 ## 1.0.0
 
-* Initial release
+* Initial release

data/CONTRIBUTORS.md

@@ -0,0 +1,19 @@
+## Current Project Lead
+
+* Jeffrey Phillips Freeman (WI2ARD) - http://JeffreyFreeman.me
+
+## Past Contributors
+
+* Greg Albrecht W2GMD <oss@undef.net>
+* Martin Murray (KD8LVZ)
+* Paul McMillan - https://github.com/PaulMcMillan
+* Russ Innes
+* John Hogenmiller (KB3DFZ) - https://github.com/ytjohn
+* Phil Gagnon N1HHG
+* Ben Benesh - https://github.com/bbene
+* Joe Goforth
+* Rick Eason
+* Jay Nugent
+* Pete Loveall (AE5PL)
+* darksidelemm - https://github.com/darksidelemm
+* agmuino - https://github.com/agmuino

data/Rakefile

@@ -24,44 +24,43 @@ def dump_load_path
     end
 end
 
-gem 'json', '~> 1.8.3'
-
-gem 'bundler', '~> 1.7'
+# gem 'json', '~> 1.8.3'
+#
+# gem 'bundler', '~> 1.7'
 require 'bundler'
 
-gem 'rake', '~> 11.3.0'
+# gem 'rake', '~> 11.3.0'
 require 'rake/clean'
 require 'rake/testtask'
 
 
-require 'cucumber'
-require 'cucumber/rake/task'
-gem 'rdoc' # we need the installed RDoc gem, not the system one
-require 'rdoc/task'
+# require 'cucumber'
+# require 'cucumber/rake/task'
+# gem 'rdoc' # we need the installed RDoc gem, not the system one
+# require 'rdoc/task'
 
 include Rake::DSL
 
 Bundler::GemHelper.install_tasks
 
 
-Rake::TestTask.new do |t|
-    t.pattern = 'test/tc_*.rb'
-end
-
-
-CUKE_RESULTS = 'results.html'
-CLEAN << CUKE_RESULTS
-Cucumber::Rake::Task.new(:features) do |t|
-    t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format pretty --no-source -x"
-    t.fork = false
-end
-
-Rake::RDocTask.new do |rd|
+# Rake::TestTask.new do |t|
+#     t.pattern = 'test/tc_*.rb'
+# end
 
-    rd.main = "README.rdoc"
-
-    rd.rdoc_files.include("README.rdoc", "lib/**/*.rb", "bin/**/*")
-end
 
-task :default => [:test, :features]
+# CUKE_RESULTS = 'results.html'
+# CLEAN << CUKE_RESULTS
+# Cucumber::Rake::Task.new(:features) do |t|
+#     t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format pretty --no-source -x"
+#     t.fork = false
+# end
 
+# Rake::RDocTask.new do |rd|
+#
+#     rd.main = "README.rdoc"
+#
+#     rd.rdoc_files.include("README.rdoc", "lib/**/*.rb", "bin/**/*")
+# end
+#
+# task :default => [:test, :features]

data/kiss-tnc.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
 
     spec.summary = %q{Library for KISS communication with TNCs.}
     spec.description = %q{Ruby library for KISS communication with Terminal Node Controllers.}
-    spec.homepage = 'https://github.com/Syncleus/aprs'
+    spec.homepage = 'https://git.qoto.org/digipex/kiss-tnc'
 
     # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
     # to allow pushing to a single host or delete this section to allow pushing to any host.
@@ -29,10 +29,12 @@ Gem::Specification.new do |spec|
     spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
     spec.require_paths = ['lib']
 
-    spec.add_dependency 'abstraction', '~> 0.0.4'
+    spec.add_dependency 'abstractify', '~> 1.1'
     spec.add_dependency 'serialport', '~> 1.3'
-    spec.add_development_dependency 'bundler', '~> 1.7'
-    spec.add_development_dependency 'rake', '~> 11.3'
-    spec.add_development_dependency 'rdoc', '~> 4.2'
-    spec.add_development_dependency 'aruba', '~> 0.14'
+    spec.add_development_dependency 'bundler', '~> 2.3'
+    spec.add_development_dependency 'rake', '~> 13.0'
+    spec.add_development_dependency 'rspec', '~> 3.12'
+    spec.add_development_dependency 'simplecov', '~> 0.22'
+    spec.add_development_dependency 'simplecov-console', '~> 0.9'
+    #spec.add_development_dependency 'rdoc', '~> 6.5'
 end

data/lib/kiss/app_info.rb

@@ -1,3 +1,3 @@
 module Kiss
-    VERSION = "1.0.2"
+    VERSION = "2.0.0"
 end

data/lib/kiss/kiss_abstract.rb

@@ -1,10 +1,12 @@
 require 'thread'
-require 'abstraction'
+require 'abstractify'
 require 'kiss/constants'
 
 module Kiss
     class KissAbstract
-        abstract
+        include Abstractify::Abstract
+
+        abstract :write_interface, :read_interface, :connect, :close
 
         protected
         def initialize(strip_df_start=true)
@@ -52,9 +54,132 @@ module Kiss
             (port << 4) & command_code
         end
 
-        protected
-        def write_setting(command, value)
-            write_interface([FEND] + [command] + escape_special_codes(value) + [FEND])
+        private
+        def self.extract_path(start, raw_frame)
+            full_path = []
+
+            (2...start).each do |i|
+                path = identity_as_string(extract_callsign(raw_frame[i * 7..-1]))
+                if path and path.length > 0
+                    if raw_frame[i * 7 + 6] & 0x80 != 0
+                        full_path << [path, '*'].join
+                    else
+                        full_path << path
+                    end
+                end
+            end
+            return full_path
+        end
+
+        private
+        def self.parse_identity_string(identity_string)
+            # If we are parsing a spent token then first lets get rid of the astresick suffix.
+            if identity_string[-1] == '*'
+                identity_string = identity_string[0..-1]
+            end
+
+            if identity_string.include? '-'
+                call_sign, ssid = identity_string.split('-')
+            else
+                call_sign = identity_string
+                ssid = 0
+            end
+
+            return {:callsign => call_sign, :ssid => ssid.to_i}
+        end
+
+        private
+        def self.identity_as_string(identity)
+            if identity[:ssid] and identity[:ssid] > 0
+                return [identity[:callsign], identity[:ssid].to_s].join('-')
+            else
+                return identity[:callsign]
+            end
+        end
+
+        private
+        def self.extract_callsign(raw_frame)
+            callsign_as_array = raw_frame[0...6].map { |x| (x >> 1).chr }
+            callsign = callsign_as_array.join.strip
+            ssid = (raw_frame[6] >> 1) & 0x0f
+            ssid = (ssid == nil or ssid == 0 ? nil : ssid)
+            return {:callsign => callsign, :ssid => ssid}
+        end
+
+        private
+        def self.encode_callsign(callsign)
+            call_sign = callsign[:callsign]
+
+            enc_ssid = (callsign[:ssid] << 1) | 0x60
+
+            if call_sign.include? '*'
+                call_sign.gsub!(/\*/, '')
+                enc_ssid |= 0x80
+            end
+
+            while call_sign.length < 6
+                call_sign = [call_sign, ' '].join
+            end
+
+            return call_sign.chars.map { |p| p.ord << 1 } + [enc_ssid]
+        end
+
+        private
+        def self.encode_frame(frame)
+            enc_frame = encode_callsign(parse_identity_string(frame[:destination].to_s)) + encode_callsign(parse_identity_string(frame[:source].to_s))
+
+            frame[:path].each do |hop|
+                enc_frame += encode_callsign(parse_identity_string(hop.to_s))
+            end
+
+            return enc_frame[0...-1] + [enc_frame[-1] | 0x01] + [Kiss::SLOT_TIME] + [0xf0] + frame[:payload].chars.map { |c| c.ord }
+        end
+
+        private
+        def self.decode_frame(raw_frame)
+            frame_len = raw_frame.length
+
+            if frame_len > 16
+                (0...frame_len - 2).each do |raw_slice|
+                    # Is address field length correct?
+                    if raw_frame[raw_slice] & 0x01 != 0 and ((raw_slice + 1) % 7) == 0
+                        i = (raw_slice.to_f + 1.0) / 7.0
+                        # Less than 2 callsigns?
+                        if 1.0 < i and i < 11.0
+                            if raw_frame[raw_slice + 1] & 0x03 == 0x03 and [0xf0, 0xcf].include? raw_frame[raw_slice + 2]
+                                payload_as_array = raw_frame[raw_slice + 3..-1].map { |b| b.chr }
+                                payload = payload_as_array.join
+                                destination = identity_as_string(extract_callsign(raw_frame))
+                                source = identity_as_string(extract_callsign(raw_frame[7..-1]))
+                                path = extract_path(i.to_i, raw_frame)
+                                return {:source => source, :destination => destination, :path => path, :payload => payload}
+                            end
+                        end
+                    end
+                end
+            end
+            return nil
+        end
+
+        private
+        def self.valid_frame(raw_frame)
+            frame_len = raw_frame.length
+
+            if frame_len > 16
+                (0...frame_len - 2).each do |raw_slice|
+                    # Is address field length correct?
+                    if raw_frame[raw_slice] & 0x01 != 0 and ((raw_slice + 1) % 7) == 0
+                        i = (raw_slice.to_f + 1.0) / 7.0
+                        # Less than 2 callsigns?
+                        if 1.0 < i and i < 11.0
+                            if raw_frame[raw_slice + 1] & 0x03 == 0x03 and [0xf0, 0xcf].include? raw_frame[raw_slice + 2]
+                                return true
+                            end
+                        end
+                    end
+                end
+            end
+            return false
         end
 
         private
@@ -115,39 +240,64 @@ module Kiss
             end
         end
 
+        private
+        def read_bytes(*args, **kwargs)
+              if @frame_buffer.length == 0
+                  fill_buffer
+              end
+
+              if @frame_buffer.length > 0
+                  return_frame = @frame_buffer[0]
+                  @frame_buffer.shift
+                  return return_frame
+              else
+                  return nil
+              end
+        end
+
+        private
+        def write_bytes(frame_bytes, port=0, *args, **kwargs)
+              kiss_packet = [FEND] + [KissAbstract.command_byte_combine(port, DATA_FRAME)] +
+                  KissAbstract.escape_special_codes(frame_bytes) + [FEND]
+
+              write_interface(kiss_packet)
+        end
+
+        protected
+        def write_setting(command, value)
+            write_interface([FEND] + [command] + KissAbstract.escape_special_codes(value) + [FEND])
+        end
+
         public
         def connect(mode_init=nil, *args, **kwargs)
         end
 
         public
-        def close
+        def close(*args, **kwargs)
         end
 
         public
         def read(*args, **kwargs)
-            @lock.synchronize do
-                if @frame_buffer.length == 0
-                    fill_buffer
-                end
-
-                if @frame_buffer.length > 0
-                    return_frame = @frame_buffer[0]
-                    @frame_buffer.shift
-                    return return_frame
-                else
-                    return nil
-                end
-            end
+          @lock.synchronize do
+              frame = self.read_bytes(*args, **kwargs)
+              if frame and frame.length > 0
+                  return KissAbstract.decode_frame(frame)
+              else
+                  return nil
+              end
+          end
         end
 
         public
-        def write(frame_bytes, port=0, *args, **kwargs)
-            @lock.synchronize do
-                kiss_packet = [FEND] + [KissAbstract.command_byte_combine(port, DATA_FRAME)] +
-                    KissAbstract.escape_special_codes(frame_bytes) + [FEND]
-
-                write_interface(kiss_packet)
-            end
+        def write(frame, port=0, *args, **kwargs)
+          @lock.synchronize do
+              encoded_frame = KissAbstract.encode_frame(frame)
+              if KissAbstract.valid_frame(encoded_frame)
+                self.write_bytes(encoded_frame, *args, **kwargs)
+              else
+                raise IOError.new("frame was able to be encoded but was determined not to be valid")
+              end
+          end
         end
     end
-end
+end

data/lib/kiss/kiss_serial.rb

@@ -46,7 +46,7 @@ module Kiss
         end
 
         public
-        def connect(mode_init=nil, **kwargs)
+        def connect(mode_init=nil, *args, **kwargs)
             super
 
             @serial = SerialPort.new(@com_port, @baud, @byte_size, @stop_bits, @parity)
@@ -69,7 +69,7 @@ module Kiss
         end
 
         public
-        def close
+        def close(*args, **kwargs)
             super
 
             if @exit_kiss
@@ -77,10 +77,10 @@ module Kiss
             end
 
             if @serial == nil or @serial.closed?
-                raise 'Attempting to close before the class has been started.'
+                raise IOError.new('Attempting to close before the class has been started.')
             else
                 @serial.close
             end
         end
     end
-end
+end

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: kiss-tnc
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 2.0.0
 platform: ruby
 authors:
 - Jeffrey Phillips Freeman
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2016-10-04 00:00:00.000000000 Z
+date: 2023-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: abstraction
+  name: abstractify
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.4
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.4
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: serialport
   requirement: !ruby/object:Gem::Requirement
@@ -44,56 +44,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '2.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.3'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.3'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: rdoc
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.2'
+        version: '3.12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.2'
+        version: '3.12'
 - !ruby/object:Gem::Dependency
-  name: aruba
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
 description: Ruby library for KISS communication with Terminal Node Controllers.
 email:
 - jeffrey.freeman@syncleus.com
@@ -102,7 +116,9 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rspec"
 - CHANGELOG.md
+- CONTRIBUTORS.md
 - Gemfile
 - LICENSE
 - README.md
@@ -114,14 +130,12 @@ files:
 - lib/kiss/constants.rb
 - lib/kiss/kiss_abstract.rb
 - lib/kiss/kiss_serial.rb
-- lib/kiss/test.rb
-- lib/kiss/test/kiss_mock.rb
-homepage: https://github.com/Syncleus/aprs
+homepage: https://git.qoto.org/digipex/kiss-tnc
 licenses:
 - Apache-2.0
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -136,9 +150,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
-signing_key: 
+rubygems_version: 3.4.17
+signing_key:
 specification_version: 4
 summary: Library for KISS communication with TNCs.
 test_files: []

data/lib/kiss/test/kiss_mock.rb

@@ -1,41 +0,0 @@
-require 'kiss/kiss_abstract'
-
-module Kiss
-    class KissMock < KissAbstract
-
-        def initialize(strip_df_start=true)
-            super(strip_df_start)
-            @read_from_interface = []
-            @sent_to_interface = []
-        end
-
-        protected
-        def read_interface
-            if @read_from_interface.length == 0
-                return nil
-            end
-            return @read_from_interface.shift
-        end
-
-        protected
-        def write_interface(data)
-            @sent_to_interface << data
-        end
-
-        public
-        def clear_interface
-            @read_from_interface = []
-            @sent_to_interface = []
-        end
-
-        public
-        def add_read_from_interface(raw_frame)
-            @read_from_interface << raw_frame
-        end
-
-        public
-        def get_sent_to_interface
-            return @sent_to_interface
-        end
-    end
-end

data/lib/kiss/test.rb

@@ -1 +0,0 @@
-require 'kiss/test/kiss_mock'