quelink-mg 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f8b5e9cc7cba93f6d85db7ed831019cabfb02abf090fecc44e01e237f8d2414
-  data.tar.gz: caa4cf0d144da3a5874ca953e29de208ad5a20076c954024c627568dd82b9d76
+  metadata.gz: da1518d252576d756cd72b6f4e4a6a0d3e8a0b6966036d83aad656c15de06480
+  data.tar.gz: 3485cf01a3a011efcf5463c8f0104359697cbbe5f6d9834b7d11280a0e25f12b
 SHA512:
-  metadata.gz: 027f0b07013d19f9be4302d9697c25348d1e9de222e72abd486b4103c5b79a17324ea8b54b1d7201e08606bbbf4c4850d4a393fc9978e6ff78b876a88944a39e
-  data.tar.gz: 2d759ab9190dd886d9aca5770af7b17a9c3f1c0e0a23498631b869a7897ffca35687299c5554dab6c6d77d1c774ec5264d080da9a06b04c67063a773a0b75753
+  metadata.gz: d9e5aa060f4a3eccbf2898341f7af0b94f845c2ed94b33b020da629be386a81617b4a4b5501fee2791c42cac9ded0d40e60239cea596c7bead7d6076207c6717
+  data.tar.gz: 79bc01b361e07608279ed119adefd87fc59da0e38afbd2270dabdaea76c1f557f0eff254a977c9ef5b1c1c3f1dc5efd4d9541cb02a14a721e3a2ba77a4e61378

data/.rubocop.yml

@@ -6,6 +6,10 @@ AllCops:
   TargetRubyVersion: 3.1
 Style/Documentation:
   Enabled: false
+Style/EndOfLine:
+  Enabled: false
+Style/OptionalBooleanParameter:
+  Enabled: false
 Metrics/MethodLength:
   Max: 18
 Metrics/BlockLength:
@@ -19,3 +23,5 @@ RSpec/ExampleLength:
 Layout/LineLength:
   Exclude: 
     - spec/quelink_mg/resp/*_spec.rb
+    - spec/quelink_mg/gl30meu/**/*_spec.rb
+    - spec/quelink_mg/**.rb

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    quelink-mg (0.6.1)
+    quelink-mg (0.7.0)
       activesupport
 
 GEM
@@ -72,6 +72,7 @@ GEM
     unicode-display_width (2.4.2)
 
 PLATFORMS
+  arm64-darwin-25
   x86_64-linux
 
 DEPENDENCIES

data/README.md

@@ -1,26 +1,237 @@
 # quelink-mg
-Management of commands sent or received from QUELINK-300 device serie. Tested with MG-310 and MG-320
 
-## Instalation
+Management of commands sent or received from Queclink GPS tracker devices. Supports **GL320M** and **GL30MEU** (GL30MEUR01).
+
+## Installation
 
 The quelink-mg gem is available at rubygems.org. You can install with:
 
-`gem install quelink-mg`
+```
+gem install quelink-mg
+```
 
 Alternatively, you can install the gem with bundler:
 
-\# Gemfile
-
-`gem 'quelink-mg'`
+```ruby
+# Gemfile
+gem 'quelink-mg'
+```
 
 After doing bundle install, you should have the gem installed in your bundle.
 
+## Configuration
+
+```ruby
+QuelinkMg.configure do |config|
+	config.time_zone = ActiveSupport::TimeZone.new('Europe/Warsaw') # default
+end
+```
+
+## Supported devices
+
+| Feature | GL320M | GL30MEU |
+|---------|--------|---------|
+| Protocol prefix | `C3` | `97` |
+| Default password | `gl320m` | `gl30` |
+| Namespace | `QuelinkMg::At`, `QuelinkMg::Resp`, etc. | `QuelinkMg::Gl30meu::At`, `QuelinkMg::Gl30meu::Resp`, etc. |
+
+## Usage
+
+### Device type detection
+
+Detect the device model from any raw message using the protocol version prefix:
+
+```ruby
+response = 'C30204,860201061504521,,0,0,1,...'
+device_type = QuelinkMg::DeviceType.detect(response.split(',').first)
+# => :gl320m
+
+response = '970101,861106059716756,GL30MEU,0,0,1,...'
+device_type = QuelinkMg::DeviceType.detect(response.split(',').first)
+# => :gl30meu
+```
+
+### Building AT commands
+
+AT commands are sent from the server to the device. Build them by passing a params hash:
+
+```ruby
+# GL320M — set report intervals (GTFRI)
+command = QuelinkMg::At::Gtfri.new(params: {
+	password: 'gl320m',
+	mode: 2,
+	check_interval: 30,
+	send_interval: 60,
+	serial_number: 'FFFF'
+})
+command.message
+# => "AT+GTFRI=gl320m,,,,,,30,60,,,,,,,,,,,,FFFF$"
+
+# GL320M — remote control / query firmware version (GTRTO)
+command = QuelinkMg::At::Gtrto.new(params: {
+	password: 'gl320m',
+	sub_command: 8,
+	serial_number: 'FFFF'
+})
+command.message
+# => "AT+GTRTO=gl320m,8,,,,,,FFFF$"
+
+# GL30MEU — configure device (GTCFG)
+command = QuelinkMg::Gl30meu::At::Gtcfg.new(params: {
+	password: 'gl30',
+	continuous_send_interval: 30,
+	gnss_enable: 1,
+	led_on: 1,
+	serial_number: 'FFFF'
+})
+command.message
+# => "AT+GTCFG=gl30,,,,,,,30,,,,,,,,1,,,,,,,,,1,FFFF$"
+
+# GL30MEU — set APN (GTBSI)
+command = QuelinkMg::Gl30meu::At::Gtbsi.new(params: {
+	password: 'gl30',
+	lte_apn: 'iot.1nce.net',
+	network_mode: 2,
+	lte_mode: 2,
+	serial_number: 'FFFF'
+})
+command.message
+# => "AT+GTBSI=gl30,,iot.1nce.net,,,2,2,,,FFFF$"
+```
+
+Invalid parameters raise specific exceptions:
+
+```ruby
+QuelinkMg::At::Gtfri.new(params: {
+	password: 'gl320m',
+	mode: 99, # invalid — must be 0..5
+	serial_number: 'FFFF'
+}).message
+# => raises InvalidATGTFRIException
+```
+
+### Parsing device responses (RESP)
+
+Parse real-time messages sent from device to server. Values are automatically type-cast (integers, floats, timezone-aware timestamps):
+
+```ruby
+# GL320M — position report (GTFRI)
+response = 'C30204,860201061504521,,0,0,1,1,0.0,0,96.2,21.012847,52.200338,20230813061232,0260,0003,E31F,0447020D,,34,20230813061231,3E94'
+parsed = QuelinkMg::Resp::Gtfri.new(response:).hash
+# => {
+#   "protocol_version" => "C30204",
+#   "unique_id" => 860201061504521,
+#   "longitude" => 21.012847,
+#   "latitude" => 52.200338,
+#   "speed" => 0.0,
+#   "battery_percentage" => 34,
+#   "gps_utc_time" => 2023-08-13 08:12:32 +0200,
+#   ...
+# }
+
+# GL30MEU — position report (GTFRI) — different fields
+response = '970101,861106059716756,GL30MEU,0,0,1,1,0.0,70,17.8,121.348554,31.163204,20231011084221,0460,0000,5B63,0867349C,21,0,3552,2,1,0,,20231011084241,1A0C'
+parsed = QuelinkMg::Gl30meu::Resp::Gtfri.new(response:).hash
+# => {
+#   "protocol_version" => 970101,
+#   "unique_id" => 861106059716756,
+#   "device_name" => "GL30MEU",
+#   "longitude" => 121.348554,
+#   "latitude" => 31.163204,
+#   "csq_rssi" => 21,
+#   "battery_voltage" => 3552,
+#   "movement_status" => 1,
+#   ...
+# }
+
+# GL30MEU — device info (GTINF)
+response = '970101,867963069921253,,89882280666211671601,24,0,,1,,62,,20251220005654,,,,,,,,20260224104605,1182'
+parsed = QuelinkMg::Gl30meu::Resp::Gtinf.new(response:).hash
+# => {
+#   "unique_id" => 867963069921253,
+#   "iccid" => "89882280666211671601",
+#   "csq_rssi" => 24,
+#   "battery_percentage" => 62,
+#   ...
+# }
+```
+
+### Parsing command acknowledgments (ACK)
+
+Parse ACK messages the device sends after receiving an AT command:
+
+```ruby
+# GL320M
+response = 'D40102,868239051011356,,READ,0040,20210816045509,004F'
+parsed = QuelinkMg::Ack::Gtrto.new(response:).hash
+# => {
+#   "protocol_version" => "D40102",
+#   "unique_id" => 868239051011356,
+#   "sub_command" => "READ",
+#   "serial_number" => "0040",
+#   ...
+# }
+
+# GL30MEU
+response = '970101,861106059716756,GL30MEU,5,FFFF,20231011084300,0A01'
+parsed = QuelinkMg::Gl30meu::Ack::Gtrto.new(response:).hash
+# => {
+#   "unique_id" => 861106059716756,
+#   "device_name" => "GL30MEU",
+#   "sub_command" => 5,
+#   ...
+# }
+```
+
+### Parsing buffered messages (BUFF)
+
+Buffered messages were stored on the device while it was offline. Same interface as RESP:
+
+```ruby
+# GL320M
+parsed = QuelinkMg::Buff::Gtfri.new(response:).hash
+
+# GL30MEU
+parsed = QuelinkMg::Gl30meu::Buff::Gtfri.new(response:).hash
+```
+
+## Available classes
+
+### GL320M
+
+| Type | Classes |
+|------|---------|
+| AT commands | `Gtbsi`, `Gtcfg`, `Gtcmd`, `Gtfri`, `Gtqss`, `Gtrto`, `Gtsri`, `Gtudf`, `Gtupd` |
+| Response parsers | `Gtfri`, `Gtgsv`, `Gtinf`, `Gtsos`, `Gtstt`, `Gtupc`, `Gtupd`, `Gtver` |
+| ACK parsers | `Gtbsi`, `Gtcfg`, `Gtcmd`, `Gtfri`, `Gtqss`, `Gtrto`, `Gtsri`, `Gtudf` |
+| Buff parsers | `Gtfri` |
+
+### GL30MEU
+
+| Type | Classes |
+|------|---------|
+| AT commands | `Gtbsi`, `Gtcfg`, `Gtrto`, `Gtsri`, `Gtupd` |
+| Response parsers | `Gtati`, `Gtfri`, `Gtinf`, `Gtupc`, `Gtupd` |
+| ACK parsers | `Gtbsi`, `Gtcfg`, `Gtrto`, `Gtsri` |
+| Buff parsers | `Gtfri` |
+
 ## Development
 
-Building gem locally (you can change file name, ofc):
+Building gem locally:
+
+```
 gem build *.gemspec -o pkg/quelink-mg.gem
+```
 
 Installing:
+
+```
 gem install pkg/quelink-mg.gem
+```
+
+Running tests:
 
+```
+bundle exec rspec
+```
 

data/lib/quelink-mg/at/gtupd.rb

@@ -11,7 +11,8 @@ module QuelinkMg
 
       private
 
-      GTUPD_VALID_PARAMS = %i[password subcommand max_download_retry download_timeout download_protocol download_username download_password 
+      GTUPD_VALID_PARAMS = %i[password subcommand max_download_retry download_timeout download_protocol
+                              download_username download_password
                               download_url reserved update_type reserved reserved serial_number].freeze
 
       def joined_params
@@ -21,7 +22,7 @@ module QuelinkMg
       def validate_values
         acceptable_values = {
           download_retry: (0..3),
-          download_timeout: (10..30),
+          download_timeout: (10..30)
         }
 
         verify_params(acceptable_values, InvalidATGTUPDException)

data/lib/quelink-mg/device_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module DeviceType
+    def self.detect(protocol_version)
+      case protocol_version[0..1]
+      when 'C3' then :gl320m
+      when '97' then :gl30meu
+      else :unknown
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/ack/gtbsi.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Ack
+      class Gtbsi < ::QuelinkMg::Ack::Base
+        GTBSI_ACK_KEYS = %w[protocol_version unique_id device_name serial_number send_time count_number].freeze
+
+        def hash
+          unify_keys(GTBSI_ACK_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/ack/gtcfg.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Ack
+      class Gtcfg < ::QuelinkMg::Ack::Base
+        GTCFG_ACK_KEYS = %w[protocol_version unique_id device_name serial_number send_time count_number].freeze
+
+        def hash
+          unify_keys(GTCFG_ACK_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/ack/gtrto.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Ack
+      class Gtrto < ::QuelinkMg::Ack::Base
+        GTRTO_ACK_KEYS = %w[protocol_version unique_id device_name sub_command serial_number send_time
+                            count_number].freeze
+
+        def hash
+          unify_keys(GTRTO_ACK_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/ack/gtsri.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Ack
+      class Gtsri < ::QuelinkMg::Ack::Base
+        GTSRI_ACK_KEYS = %w[protocol_version unique_id device_name serial_number send_time count_number].freeze
+
+        def hash
+          unify_keys(GTSRI_ACK_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/at/gtbsi.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module At
+      class Gtbsi < ::QuelinkMg::At::Base
+        def message
+          validate_values
+
+          "AT+GTBSI=#{joined_params}$"
+        end
+
+        private
+
+        GTBSI_VALID_PARAMS = %i[password lte_apn lte_apn_user_name ltn_apn_password gprs_apn gprs_apn_user_name
+                                gprs_apn_password network_mode lte_mode apn_authentication_methods
+                                edrx_periodic edrx_m1_pagings edrx_nb2_pagings
+                                reserved reserved reserved serial_number].freeze
+
+        def joined_params
+          GTBSI_VALID_PARAMS.map { |method| @params.fetch(method, nil) }.join(',')
+        end
+
+        def validate_values
+          acceptable_values = {
+            network_mode: (0..3),
+            lte_mode: (0..5),
+            apn_authentication_methods: (0..3)
+          }
+
+          verify_params(acceptable_values, InvalidATGTBSIException)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/at/gtcfg.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module At
+      class Gtcfg < ::QuelinkMg::At::Base
+        def message
+          validate_values
+
+          "AT+GTCFG=#{joined_params}$"
+        end
+
+        private
+
+        GTCFG_VALID_PARAMS = %i[password new_password device_name gnss_timeout event_mask report_item_mask
+                                mode_selection continuous_send_interval reserved start_mode specified_time_of_day
+                                reserved wakeup_interval reserved reserved reserved gnss_enable agps_mode
+                                gsm_report reserved reserved battery_low_percentage function_button_mode
+                                reserved sos_report_mode wifi_report led_on serial_number].freeze
+
+        def joined_params
+          GTCFG_VALID_PARAMS.map { |method| @params.fetch(method, nil) }.join(',')
+        end
+
+        def validate_values
+          acceptable_values = {
+            gnss_timeout: (5..300),
+            mode_selection: (0..5),
+            continuous_send_interval: (30..86_400),
+            start_mode: (0..3),
+            wakeup_interval: (60..86_400),
+            gnss_enable: (0..1),
+            agps_mode: (0..1),
+            battery_low_percentage: (0..30),
+            function_button_mode: (0..3),
+            sos_report_mode: (0..2),
+            wifi_report: (0..1),
+            led_on: (0..2)
+          }
+
+          verify_params(acceptable_values, InvalidATGTCFGException)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/at/gtrto.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module At
+      class Gtrto < ::QuelinkMg::At::Base
+        def message
+          validate_values
+
+          "AT+GTRTO=#{joined_params}$"
+        end
+
+        private
+
+        GTRTO_VALID_PARAMS = %i[password sub_command single_command_configuration reserved
+                                reserved reserved sub_command_parameter serial_number].freeze
+
+        def joined_params
+          GTRTO_VALID_PARAMS.map { |method| @params.fetch(method, nil) }.join(',')
+        end
+
+        def validate_values
+          acceptable_values = {
+            sub_command: (1..7).to_a + [0xB, 0xD, 0x1C, 0x31, 0x33, 0x34]
+          }
+
+          verify_params(acceptable_values, InvalidATGTRTOException)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/at/gtsri.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module At
+      class Gtsri < ::QuelinkMg::At::Base
+        def message
+          validate_values
+
+          "AT+GTSRI=#{joined_params}$"
+        end
+
+        private
+
+        GTSRI_VALID_PARAMS = %i[password report_mode reserved buffer_mode main_server_ip main_server_port
+                                backup_server_ip backup_server_port sms_gateway heartbit_interval sack_enable
+                                sms_ack_enable reserved reserved reserved serial_number].freeze
+
+        def joined_params
+          GTSRI_VALID_PARAMS.map { |method| @params.fetch(method, nil) }.join(',')
+        end
+
+        def validate_values
+          acceptable_values = {
+            report_mode: (0..7),
+            buffer_mode: (0..2),
+            main_server_port: (0..65_535),
+            backup_server_port: (0..65_535),
+            heartbit_interval: [0] + (5..360).to_a,
+            sack_enable: (0..2),
+            sms_ack_enable: (0..1)
+          }
+
+          verify_params(acceptable_values, InvalidATGTSRIException)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/at/gtupd.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module At
+      class Gtupd < ::QuelinkMg::At::Base
+        def message
+          validate_values
+
+          "AT+GTUPD=#{joined_params}$"
+        end
+
+        private
+
+        GTUPD_VALID_PARAMS = %i[password subcommand max_download_retry download_timeout download_protocol
+                                download_username download_password download_url reserved update_type
+                                reserved reserved serial_number].freeze
+
+        def joined_params
+          GTUPD_VALID_PARAMS.map { |method| @params.fetch(method, nil) }.join(',')
+        end
+
+        def validate_values
+          acceptable_values = {
+            download_retry: (0..3),
+            download_timeout: (10..30),
+            update_type: [0, 1, 7]
+          }
+
+          verify_params(acceptable_values, InvalidATGTUPDException)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/buff/gtfri.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Buff
+      class Gtfri < ::QuelinkMg::Buff::Base
+        GTFRI_RESP_KEYS = %w[protocol_version unique_id device_name report_id report_type number
+                             gps_accuracy speed azimuth elevation longitude latitude gps_utc_time
+                             mcc mnc lac cell_id csq_rssi csq_ber battery_voltage current_mode_status
+                             movement_status reserved reserved send_time count_number].freeze
+
+        def hash
+          unify_keys(GTFRI_RESP_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/resp/gtati.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Resp
+      class Gtati < ::QuelinkMg::Resp::Base
+        GTATI_RESP_KEYS = %w[protocol_version unique_id device_name device_type ati_mask
+                             firmware_version ble_firmware_version modem_firmware_version
+                             wifi_firmware_version hardware_version modem_hardware_version
+                             sensor_id send_time count_number].freeze
+
+        def hash
+          unify_keys(GTATI_RESP_KEYS.zip(@response.split(',')).to_h, true)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/resp/gtfri.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Resp
+      class Gtfri < ::QuelinkMg::Resp::Base
+        GTFRI_RESP_KEYS = %w[protocol_version unique_id device_name report_id report_type number
+                             gps_accuracy speed azimuth elevation longitude latitude gps_utc_time
+                             mcc mnc lac cell_id csq_rssi csq_ber battery_voltage current_mode_status
+                             movement_status reserved reserved send_time count_number].freeze
+
+        def hash
+          unify_keys(GTFRI_RESP_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/resp/gtinf.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Resp
+      class Gtinf < ::QuelinkMg::Resp::Base
+        GTINF_RESP_KEYS = %w[protocol_version unique_id device_name iccid csq_rssi csq_ber
+                             reserved mode_selection reserved battery_percentage reserved
+                             last_gnss_fix_utc_time movement_status
+                             reserved reserved reserved reserved reserved reserved
+                             send_time count_number].freeze
+
+        def hash
+          unify_keys(GTINF_RESP_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/resp/gtupc.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Resp
+      class Gtupc < ::QuelinkMg::Resp::Base
+        GTUPC_RESP_KEYS = %w[protocol_version unique_id device_name command_id result download_url send_time
+                             count_number].freeze
+
+        def hash
+          unify_keys(GTUPC_RESP_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/gl30meu/resp/gtupd.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module QuelinkMg
+  module Gl30meu
+    module Resp
+      class Gtupd < ::QuelinkMg::Resp::Base
+        GTUPD_RESP_KEYS = %w[protocol_version unique_id device_name code reserved send_time count_number].freeze
+
+        def hash
+          unify_keys(GTUPD_RESP_KEYS.zip(@response.split(',')).to_h)
+        end
+      end
+    end
+  end
+end

data/lib/quelink-mg/resp/base.rb

@@ -31,7 +31,7 @@ module QuelinkMg
         Time.use_zone('UTC') { Time.zone.parse(value) }.in_time_zone
       end
 
-      def unify_keys(hash, skip_number_change=false)
+      def unify_keys(hash, skip_number_change = false)
         hash.transform_values do |v|
           if date?(v)
             transform_with_timezone(v)

data/lib/quelink_mg.rb

@@ -40,6 +40,27 @@ require File.expand_path('quelink-mg/ack/gtudf.rb', __dir__)
 require File.expand_path('quelink-mg/buff/base.rb', __dir__)
 require File.expand_path('quelink-mg/buff/gtfri.rb', __dir__)
 
+require File.expand_path('quelink-mg/device_type.rb', __dir__)
+
+require File.expand_path('quelink-mg/gl30meu/at/gtrto.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/at/gtcfg.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/at/gtbsi.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/at/gtsri.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/at/gtupd.rb', __dir__)
+
+require File.expand_path('quelink-mg/gl30meu/resp/gtfri.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/resp/gtati.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/resp/gtinf.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/resp/gtupc.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/resp/gtupd.rb', __dir__)
+
+require File.expand_path('quelink-mg/gl30meu/ack/gtrto.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/ack/gtcfg.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/ack/gtbsi.rb', __dir__)
+require File.expand_path('quelink-mg/gl30meu/ack/gtsri.rb', __dir__)
+
+require File.expand_path('quelink-mg/gl30meu/buff/gtfri.rb', __dir__)
+
 require File.expand_path('quelink-mg/configuration.rb', __dir__)
 
 module QuelinkMg

data/quelink-mg.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = 'quelink-mg'
-  s.version     = '0.6.2'
+  s.version     = '0.7.0'
   s.summary     = 'Quelink devices command reader and writer'
   s.description = 'Quelink devices command reader and writer'
   s.authors     = ['Stanislaw Zawadzki']

data/spec/quelink_mg/at/gtupd_spec.rb

@@ -20,6 +20,6 @@ RSpec.describe QuelinkMg::At::Gtupd do
   end
 
   it 'raises error on wrong params' do
-    expect { described_class.new(params: { download_timeout: 666}).message }.to raise_error(InvalidATGTUPDException)
+    expect { described_class.new(params: { download_timeout: 666 }).message }.to raise_error(InvalidATGTUPDException)
   end
 end

data/spec/quelink_mg/device_type_spec.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::DeviceType do
+  describe '.detect' do
+    it 'detects GL320M from C3 prefix' do
+      expect(described_class.detect('C30204')).to eq :gl320m
+    end
+
+    it 'detects GL30MEU from 97 prefix' do
+      expect(described_class.detect('970101')).to eq :gl30meu
+    end
+
+    it 'returns unknown for unrecognized prefix' do
+      expect(described_class.detect('XX0101')).to eq :unknown
+    end
+
+    it 'detects GL320M from full GTFRI response' do
+      response = 'C30204,860201061504521,,0,0,1,1,0.0,0,96.2,21.012847,52.200338,20230813061232,0260,0003,E31F,0447020D,,34,20230813061231,3E94'
+      expect(described_class.detect(response.split(',').first)).to eq :gl320m
+    end
+
+    it 'detects GL30MEU from full GTFRI response' do
+      response = '970101,861106059716756,GL30MEU,0,0,1,1,0.0,70,17.8,121.348554,31.163204,20231011084221,0460,0000,5B63,0867349C,21,0,3552,2,1,0,,20231011084241,1A0C'
+      expect(described_class.detect(response.split(',').first)).to eq :gl30meu
+    end
+  end
+end

data/spec/quelink_mg/gl30meu/ack/gtcfg_spec.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::Ack::Gtcfg do
+  it 'parses valid GL30MEU GTCFG ACK' do
+    response = '970101,861106059716756,GL30MEU,FFFF,20231011084300,0A01'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response['protocol_version']).to eq 970_101
+    expect(parsed_response['unique_id']).to eq 861_106_059_716_756
+    expect(parsed_response['device_name']).to eq 'GL30MEU'
+    expect(parsed_response['serial_number']).to eq 'FFFF'
+    expect(parsed_response['send_time']).to eq Time.use_zone('UTC') { Time.zone.parse('20231011084300') }.in_time_zone
+  end
+end

data/spec/quelink_mg/gl30meu/ack/gtrto_spec.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::Ack::Gtrto do
+  it 'parses valid GL30MEU GTRTO ACK' do
+    response = '970101,861106059716756,GL30MEU,5,FFFF,20231011084300,0A01'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response['protocol_version']).to eq 970_101
+    expect(parsed_response['unique_id']).to eq 861_106_059_716_756
+    expect(parsed_response['device_name']).to eq 'GL30MEU'
+    expect(parsed_response['sub_command']).to eq 5
+    expect(parsed_response['serial_number']).to eq 'FFFF'
+    expect(parsed_response['send_time']).to eq Time.use_zone('UTC') { Time.zone.parse('20231011084300') }.in_time_zone
+  end
+end

data/spec/quelink_mg/gl30meu/at/gtbsi_spec.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::At::Gtbsi do
+  it 'creates command with eDRX params' do
+    params = {
+      password: 'gl30',
+      lte_apn: 'iot.1nce.net',
+      network_mode: 2,
+      lte_mode: 2,
+      apn_authentication_methods: 0,
+      edrx_periodic: '0101',
+      edrx_m1_pagings: '0101',
+      edrx_nb2_pagings: '0010',
+      serial_number: 'FFFF'
+    }
+
+    expect(described_class.new(params:).message).to eq 'AT+GTBSI=gl30,iot.1nce.net,,,,,,2,2,0,0101,0101,0010,,,,FFFF$'
+  end
+
+  it 'creates basic network command' do
+    params = {
+      password: 'gl30',
+      lte_apn: 'iot.1nce.net',
+      network_mode: 2,
+      lte_mode: 2,
+      serial_number: 'FFFF'
+    }
+
+    expect(described_class.new(params:).message).to eq 'AT+GTBSI=gl30,iot.1nce.net,,,,,,2,2,,,,,,,,FFFF$'
+  end
+
+  it 'raises error on missing params' do
+    expect { described_class.new(params: {}).message }.to raise_error(InvalidATGTBSIException)
+  end
+
+  it 'raises error on invalid network_mode' do
+    params = {
+      password: 'gl30',
+      network_mode: 5,
+      serial_number: 'FFFF'
+    }
+
+    expect { described_class.new(params:).message }.to raise_error(InvalidATGTBSIException)
+  end
+end

data/spec/quelink_mg/gl30meu/at/gtcfg_spec.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::At::Gtcfg do
+  it 'creates command with continuous_send_interval' do
+    params = {
+      password: 'gl30',
+      continuous_send_interval: 30,
+      led_on: 1,
+      serial_number: 'FFFF'
+    }
+
+    expect(described_class.new(params:).message).to eq 'AT+GTCFG=gl30,,,,,,,30,,,,,,,,,,,,,,,,,,,1,FFFF$'
+  end
+
+  it 'creates full configuration command' do
+    params = {
+      password: 'gl30',
+      new_password: 'gl30',
+      device_name: 'GL30MEU',
+      gnss_timeout: 60,
+      event_mask: '0FFF',
+      report_item_mask: '001F',
+      mode_selection: 1,
+      continuous_send_interval: 30,
+      start_mode: 0,
+      wakeup_interval: 300,
+      gnss_enable: 1,
+      agps_mode: 1,
+      gsm_report: '0000',
+      battery_low_percentage: 10,
+      function_button_mode: 0,
+      sos_report_mode: 0,
+      wifi_report: 0,
+      led_on: 1,
+      serial_number: 'FFFF'
+    }
+
+    expect(described_class.new(params:).message).to eq 'AT+GTCFG=gl30,gl30,GL30MEU,60,0FFF,001F,1,30,,0,,,300,,,,1,1,0000,,,10,0,,0,0,1,FFFF$'
+  end
+
+  it 'creates minimal command' do
+    params = {
+      password: 'gl30',
+      gnss_enable: 1,
+      serial_number: 'FFFF'
+    }
+
+    expect(described_class.new(params:).message).to eq 'AT+GTCFG=gl30,,,,,,,,,,,,,,,,1,,,,,,,,,,,FFFF$'
+  end
+
+  it 'raises error on missing params' do
+    expect { described_class.new(params: {}).message }.to raise_error(InvalidATGTCFGException)
+  end
+
+  it 'raises error on invalid led_on' do
+    params = {
+      password: 'gl30',
+      led_on: 3,
+      serial_number: 'FFFF'
+    }
+
+    expect { described_class.new(params:).message }.to raise_error(InvalidATGTCFGException)
+  end
+
+  it 'raises error on continuous_send_interval below minimum' do
+    params = {
+      password: 'gl30',
+      continuous_send_interval: 5,
+      serial_number: 'FFFF'
+    }
+
+    expect { described_class.new(params:).message }.to raise_error(InvalidATGTCFGException)
+  end
+end

data/spec/quelink_mg/gl30meu/at/gtrto_spec.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::At::Gtrto do
+  it 'creates power off command' do
+    params = {
+      password: 'gl30',
+      sub_command: 5,
+      serial_number: 'FFFF'
+    }
+
+    expect(described_class.new(params:).message).to eq 'AT+GTRTO=gl30,5,,,,,,FFFF$'
+  end
+
+  it 'creates reboot command' do
+    params = {
+      password: 'gl30',
+      sub_command: 3,
+      serial_number: 'FFFF'
+    }
+
+    expect(described_class.new(params:).message).to eq 'AT+GTRTO=gl30,3,,,,,,FFFF$'
+  end
+
+  it 'creates device info request (0x33)' do
+    params = {
+      password: 'gl30',
+      sub_command: 0x33,
+      serial_number: 'FFFF'
+    }
+
+    expect(described_class.new(params:).message).to eq 'AT+GTRTO=gl30,51,,,,,,FFFF$'
+  end
+
+  it 'raises error on missing params' do
+    expect { described_class.new(params: {}).message }.to raise_error(InvalidATGTRTOException)
+  end
+
+  it 'raises error on GL320M-only sub_command 0' do
+    params = {
+      password: 'gl30',
+      sub_command: 0,
+      serial_number: 'FFFF'
+    }
+
+    expect { described_class.new(params:).message }.to raise_error(InvalidATGTRTOException)
+  end
+
+  it 'raises error on invalid sub_command 0xFF' do
+    params = {
+      password: 'gl30',
+      sub_command: 0xFF,
+      serial_number: 'FFFF'
+    }
+
+    expect { described_class.new(params:).message }.to raise_error(InvalidATGTRTOException)
+  end
+end

data/spec/quelink_mg/gl30meu/buff/gtfri_spec.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::Buff::Gtfri do
+  it 'parses valid GL30MEU buffered GTFRI response' do
+    response = '970101,861106059716756,GL30MEU,0,0,1,1,0.0,70,17.8,121.348554,31.163204,20231011084221,0460,0000,5B63,0867349C,21,0,3552,2,1,0,,20231011084241,1A0C'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response).not_to eq({})
+    expect(parsed_response['longitude']).to eq 121.348554
+    expect(parsed_response['latitude']).to eq 31.163204
+    expect(parsed_response['battery_voltage']).to eq 3552
+    expect(parsed_response['csq_rssi']).to eq 21
+    expect(parsed_response['movement_status']).to eq 1
+  end
+end

data/spec/quelink_mg/gl30meu/resp/gtati_spec.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::Resp::Gtati do
+  it 'parses valid GL30MEU GTATI response' do
+    response = '970101,861106059717499,GL30MEU,88,00043483,0118,0111,0227,0102,0101,0103,33,20231011002150,0AB7'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response).not_to eq({})
+    expect(parsed_response['protocol_version']).to eq '970101'
+    expect(parsed_response['unique_id']).to eq '861106059717499'
+    expect(parsed_response['device_name']).to eq 'GL30MEU'
+    expect(parsed_response['device_type']).to eq '88'
+    expect(parsed_response['ati_mask']).to eq '00043483'
+    expect(parsed_response['firmware_version']).to eq '0118'
+    expect(parsed_response['ble_firmware_version']).to eq '0111'
+    expect(parsed_response['modem_firmware_version']).to eq '0227'
+    expect(parsed_response['wifi_firmware_version']).to eq '0102'
+    expect(parsed_response['hardware_version']).to eq '0101'
+    expect(parsed_response['modem_hardware_version']).to eq '0103'
+    expect(parsed_response['sensor_id']).to eq '33'
+    expect(parsed_response['send_time']).to eq Time.use_zone('UTC') { Time.zone.parse('20231011002150') }.in_time_zone
+    expect(parsed_response['count_number']).to eq '0AB7'
+  end
+
+  it 'keeps version fields as strings (skip_number_change)' do
+    response = '970101,861106059717499,GL30MEU,88,00043483,0118,0111,0227,0102,0101,0103,33,20231011002150,0AB7'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response['firmware_version']).to be_a(String)
+    expect(parsed_response['hardware_version']).to be_a(String)
+    expect(parsed_response['ble_firmware_version']).to be_a(String)
+    expect(parsed_response['modem_firmware_version']).to be_a(String)
+  end
+end

data/spec/quelink_mg/gl30meu/resp/gtfri_spec.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::Resp::Gtfri do
+  it 'parses valid GL30MEU GTFRI response' do
+    response = '970101,861106059716756,GL30MEU,0,0,1,1,0.0,70,17.8,121.348554,31.163204,20231011084221,0460,0000,5B63,0867349C,21,0,3552,2,1,0,,20231011084241,1A0C'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response).not_to eq({})
+    expect(parsed_response['protocol_version']).to eq 970_101
+    expect(parsed_response['unique_id']).to eq 861_106_059_716_756
+    expect(parsed_response['device_name']).to eq 'GL30MEU'
+    expect(parsed_response['longitude']).to eq 121.348554
+    expect(parsed_response['latitude']).to eq 31.163204
+    expect(parsed_response['speed']).to eq 0.0
+    expect(parsed_response['azimuth']).to eq 70
+    expect(parsed_response['elevation']).to eq 17.8
+    expect(parsed_response['gps_utc_time']).to eq Time.use_zone('UTC') {
+      Time.zone.parse('20231011084221')
+    }.in_time_zone
+    expect(parsed_response['send_time']).to eq Time.use_zone('UTC') { Time.zone.parse('20231011084241') }.in_time_zone
+    expect(parsed_response['csq_rssi']).to eq 21
+    expect(parsed_response['csq_ber']).to eq 0
+    expect(parsed_response['battery_voltage']).to eq 3552
+    expect(parsed_response['current_mode_status']).to eq 2
+    expect(parsed_response['movement_status']).to eq 1
+  end
+
+  it 'has 25 keys' do
+    response = '970101,861106059716756,GL30MEU,0,0,1,1,0.0,70,17.8,121.348554,31.163204,20231011084221,0460,0000,5B63,0867349C,21,0,3552,2,1,0,,20231011084241,1A0C'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response.keys.length).to eq 25
+  end
+end

data/spec/quelink_mg/gl30meu/resp/gtinf_spec.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe QuelinkMg::Gl30meu::Resp::Gtinf do
+  it 'parses real GL30MEU GTINF response (21 fields)' do
+    response = '970101,867963069921253,,89882280666211671601,24,0,,1,,62,,20251220005654,,,,,,,,20260224104605,1182'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response).not_to eq({})
+    expect(parsed_response['protocol_version']).to eq 970_101
+    expect(parsed_response['unique_id']).to eq 867_963_069_921_253
+    expect(parsed_response['device_name']).to eq ''
+    expect(parsed_response['iccid']).to eq 89_882_280_666_211_671_601
+    expect(parsed_response['csq_rssi']).to eq 24
+    expect(parsed_response['csq_ber']).to eq 0
+    expect(parsed_response['mode_selection']).to eq 1
+    expect(parsed_response['battery_percentage']).to eq 62
+    expect(parsed_response['last_gnss_fix_utc_time']).to eq Time.use_zone('UTC') {
+      Time.zone.parse('20251220005654')
+    }.in_time_zone
+    expect(parsed_response['movement_status']).to eq ''
+    expect(parsed_response['send_time']).to eq Time.use_zone('UTC') { Time.zone.parse('20260224104605') }.in_time_zone
+    expect(parsed_response['count_number']).to eq 1182
+  end
+
+  it 'has 13 unique keys (reserved fields collapse)' do
+    response = '970101,867963069921253,,89882280666211671601,24,0,,1,,62,,20251220005654,,,,,,,,20260224104605,1182'
+
+    parsed_response = described_class.new(response:).hash
+    expect(parsed_response.keys.length).to eq 13
+  end
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: quelink-mg
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.0
 platform: ruby
 authors:
 - Stanislaw Zawadzki
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-08-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -113,6 +112,22 @@ files:
 - lib/quelink-mg/buff/base.rb
 - lib/quelink-mg/buff/gtfri.rb
 - lib/quelink-mg/configuration.rb
+- lib/quelink-mg/device_type.rb
+- lib/quelink-mg/gl30meu/ack/gtbsi.rb
+- lib/quelink-mg/gl30meu/ack/gtcfg.rb
+- lib/quelink-mg/gl30meu/ack/gtrto.rb
+- lib/quelink-mg/gl30meu/ack/gtsri.rb
+- lib/quelink-mg/gl30meu/at/gtbsi.rb
+- lib/quelink-mg/gl30meu/at/gtcfg.rb
+- lib/quelink-mg/gl30meu/at/gtrto.rb
+- lib/quelink-mg/gl30meu/at/gtsri.rb
+- lib/quelink-mg/gl30meu/at/gtupd.rb
+- lib/quelink-mg/gl30meu/buff/gtfri.rb
+- lib/quelink-mg/gl30meu/resp/gtati.rb
+- lib/quelink-mg/gl30meu/resp/gtfri.rb
+- lib/quelink-mg/gl30meu/resp/gtinf.rb
+- lib/quelink-mg/gl30meu/resp/gtupc.rb
+- lib/quelink-mg/gl30meu/resp/gtupd.rb
 - lib/quelink-mg/resp/base.rb
 - lib/quelink-mg/resp/gtfri.rb
 - lib/quelink-mg/resp/gtgsv.rb
@@ -142,6 +157,16 @@ files:
 - spec/quelink_mg/at/gtudf_spec.rb
 - spec/quelink_mg/at/gtupd_spec.rb
 - spec/quelink_mg/buff/gtfri_spec.rb
+- spec/quelink_mg/device_type_spec.rb
+- spec/quelink_mg/gl30meu/ack/gtcfg_spec.rb
+- spec/quelink_mg/gl30meu/ack/gtrto_spec.rb
+- spec/quelink_mg/gl30meu/at/gtbsi_spec.rb
+- spec/quelink_mg/gl30meu/at/gtcfg_spec.rb
+- spec/quelink_mg/gl30meu/at/gtrto_spec.rb
+- spec/quelink_mg/gl30meu/buff/gtfri_spec.rb
+- spec/quelink_mg/gl30meu/resp/gtati_spec.rb
+- spec/quelink_mg/gl30meu/resp/gtfri_spec.rb
+- spec/quelink_mg/gl30meu/resp/gtinf_spec.rb
 - spec/quelink_mg/resp/gtfri_spec.rb
 - spec/quelink_mg/resp/gtgsv_spec.rb
 - spec/quelink_mg/resp/gtinf_spec.rb
@@ -151,12 +176,10 @@ files:
 - spec/quelink_mg/resp/gtupd_spec.rb
 - spec/quelink_mg/resp/gtver_spec.rb
 - spec/spec_helper.rb
-homepage: 
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'false'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -171,8 +194,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.18
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Quelink devices command reader and writer
 test_files: []