dji_mqtt_connect 0.1.36.1 → 0.1.36.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d8795d2fc7dba06b2dc45a0ca6c97c04b9dcbf43502fdf965b0873023a37f36
-  data.tar.gz: c6ca7ef8335f39614320b3a766065cca37c3f79a11c8d888183a898a2a627909
+  metadata.gz: 940329d2cd6cc1a579fda21b7d6325a9731ccf4b0834773fd47a5aab77653374
+  data.tar.gz: 1d7197e5354a9cfad990ec0a8c27fbf358ae6a8ed4def7327321363e20c0db27
 SHA512:
-  metadata.gz: a6e3690e2de4527b7f9ba70fd44d72250090a174fe35e8a1494d0630740c66fd3d626a172af598d4785e36e80d47d64bcb2548484500f63b41f75bf309105af3
-  data.tar.gz: b0bfeb93ab01bb042224ea76716c591954e64539c401a8b7f846998d329ccec8987f1c4a683f9b3775f811dc46c64accd6ea40b932f1727647a4fb06a9bc9a01
+  metadata.gz: 229a6017739b1c560fedca7f24bf7f6b4a4821d02a88c0f328a1b145dabeab8e084566d7cbba36ba1a4022b28c2f22c3cca3c8130f06c5e1f5de1f72ad29916c
+  data.tar.gz: 2480edeb9ed44f2b5c03c2f5db02532af5ccd8437da71c8d807120ebf8edf48dd5bd5416c907a0f076facd8b990c6d9d119c6358b38df49d76694e5370d6bcb4

data/CLAUDE.md

@@ -0,0 +1,13 @@
+# CLAUDE.md
+
+Notes for Claude Code and other agents working in this repository.
+
+## Versioning
+
+Do not bump the version in `lib/dji_mqtt_connect/version.rb`.
+
+Releases are cut by a maintainer: the version bump, the git tag, and the push to
+rubygems.org happen together (see the Development section of the README). A
+version bump in a feature branch either conflicts with that release commit or
+ships a version number that was never published, so leave `VERSION` alone and
+let the maintainer decide what the change is worth.

data/config/locales/thing_product_events.en.yml

@@ -11,6 +11,7 @@ en:
       device_exit_homing_notify: "Device is exiting return to home: %{action} (%{reason})"
       device_format: "Dock Data Formatting: %{status} (%{percent}%)"
       device_reboot: "Rebooting device: %{status} (%{current_step}/%{total_steps} %{percent}%)"
+      drc_status_notify: "Live Flight Controls: %{drc_state}"
       drone_close: "Aircraft shutdown: %{status} (%{percent}%)"
       drone_format: "Aircraft Data Formatting: %{status} (%{percent}%)"
       drone_open: "Aircraft Power-on: %{status}"
@@ -23,6 +24,7 @@ en:
       flighttask_progress_with_break_point: "Flight Halted: %{break_reason} [%{current_step}] (%{status} %{percent}%)"
       fly_to_point_progress: "Fly to Point: %{status} (%{way_point_index}/- | %{remaining_time} sec | %{remaining_distance} left)"
       highest_priority_upload_flighttask_media: "Highest priority flight task media upload"
+      joystick_invalid_notify: "Joystick control is invalid: %{reason}"
       offline_map_sync_progress: "Syncing offline maps: %{status} (%{reason})"
       rtk_calibration: "RTK Calibration: %{status} (%{percent}%)"
       takeoff_to_point_progress: "Takeoff to Point: %{status} (%{way_point_index}/- | %{remaining_time} sec | %{remaining_distance} left)"
@@ -46,6 +48,12 @@ en:
         :9: "Short-distance backtracking"
         :10: "Return triggered at close range"
 
+    thing_product_drc_status_notify_events_message:
+      humanized_drc_state:
+        :0: "Not connected"
+        :1: "Connecting"
+        :2: "Connected"
+
     thing_product_fileupload_progress_events_message:
       humanized_module:
         :0: Aircraft
@@ -74,3 +82,11 @@ en:
         :7: "Wayline interrupted. Triggered conditions are 1 for User actively pauses and 2 for Flight control abnormality"
         :8: "Wayline recovery"
         :9: "Wayline completed"
+
+    thing_product_joystick_invalid_notify_events_message:
+      humanized_reason:
+        :0: "Remote controller lost connection"
+        :1: "Low battery return"
+        :2: "Low battery landing"
+        :3: "Close to the flight restriction zone"
+        :4: "Remote controller took over control authority"

data/lib/dji_mqtt_connect/factories/events/drc_status_notify.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Factories::EventsMessages
+    ### DRC Status Notify ###
+
+    def build_thing_product_drc_status_notify_events_message
+      message_data = {
+        result: 0,
+        drc_state: 2
+      }
+
+      Thing::Product::DrcStatusNotifyEventsMessage.new(
+        bid: Message.generate_bid,
+        tid: Message.generate_tid,
+        timestamp: Message.current_timestamp,
+        _method: "drc_status_notify",
+        need_reply: 1,
+        gateway: "GATEWAYSN",
+        data: message_data,
+        _data: message_data
+      )
+    end
+  end
+end

data/lib/dji_mqtt_connect/factories/events/joystick_invalid_notify.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Factories::EventsMessages
+    def build_thing_product_joystick_invalid_notify_events_message
+      message_data = {
+        reason: 0
+      }
+
+      Thing::Product::JoystickInvalidNotifyEventsMessage.new(
+        bid: Message.generate_bid,
+        tid: Message.generate_tid,
+        timestamp: Message.current_timestamp,
+        _method: "joystick_invalid_notify",
+        need_reply: 1,
+        gateway: "GATEWAYSN",
+        data: message_data,
+        _data: message_data
+      )
+    end
+  end
+end

data/lib/dji_mqtt_connect/messages/thing/product/events/drc_status_notify.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Thing::Product
+    # Notification of the live flight controls (DRC) link state
+    # https://developer.dji.com/doc/cloud-api-tutorial/en/api-reference/dock-to-cloud/mqtt/dock/dock2/drc.html
+    class DrcStatusNotifyEventsMessage < EventsMessage
+      attribute :_method, Types::String.enum("drc_status_notify")
+
+      # NOTE: DJI sometimes omits the timestamp for a drc_status_notify events message
+      attribute? :timestamp, Types::TimestampMS
+
+      attribute :data do
+        attribute :result, Types::ResultCode
+        include Mixins::ResultCode
+
+        # {"0":"Not connected","1":"Connecting","2":"Connected"}
+        attribute :drc_state, Types::Coercible::Integer.enum(
+          DRC_STATE_NOT_CONNECTED = 0,
+          DRC_STATE_CONNECTING = 1,
+          DRC_STATE_CONNECTED = 2
+        )
+
+        def drc_connected?
+          drc_state == DRC_STATE_CONNECTED
+        end
+
+        def humanized_drc_state
+          I18n.t(drc_state, scope: "dji_mqtt_connect.thing_product_drc_status_notify_events_message.humanized_drc_state", default: "-")
+        end
+      end
+
+      def humanized_summary_interpolation
+        super.merge(drc_state: data.humanized_drc_state)
+      end
+    end
+  end
+end

data/lib/dji_mqtt_connect/messages/thing/product/events/joystick_invalid_notify.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Thing::Product
+    # Notification of joystick control invalidity reasons
+    # https://developer.dji.com/doc/cloud-api-tutorial/en/api-reference/dock-to-cloud/mqtt/dock/drc.html#notification-of-joystick-control-invalidity-reasons
+    # https://developer.dji.com/doc/cloud-api-tutorial/en/api-reference/dock-to-cloud/mqtt/dock/dock2/drc.html#notification-of-joystick-control-invalidity-reasons
+    class JoystickInvalidNotifyEventsMessage < EventsMessage
+      REMOTE_CONTROLLER_LOST_CONNECTION_REASON = 0
+      LOW_BATTERY_RETURN_REASON = 1
+      LOW_BATTERY_LANDING_REASON = 2
+      CLOSE_TO_THE_FLIGHT_RESTRICTION_ZONE_REASON = 3
+      REMOTE_CONTROLLER_TAKEOVER_CONTROL_AUTHORITY_REASON = 4
+
+      Reason = Types::Coercible::Integer.enum(
+        REMOTE_CONTROLLER_LOST_CONNECTION_REASON,
+        LOW_BATTERY_RETURN_REASON,
+        LOW_BATTERY_LANDING_REASON,
+        CLOSE_TO_THE_FLIGHT_RESTRICTION_ZONE_REASON,
+        REMOTE_CONTROLLER_TAKEOVER_CONTROL_AUTHORITY_REASON
+      )
+
+      attribute :_method, Types::String.enum("joystick_invalid_notify")
+
+      attribute :data do
+        # {"0":"Remote controller lost connection","1":"Low battery return","2":"Low battery landing","3":"Close to the flight restriction zone","4":"Remote controller takeover control authority (for example, triggered return, B control takeover)"}
+        attribute :reason, Reason | Types::Coercible::Integer
+
+        def reason?
+          Reason.valid?(reason)
+        end
+
+        def humanized_reason
+          if reason?
+            I18n.t(reason, scope: "dji_mqtt_connect.thing_product_joystick_invalid_notify_events_message.humanized_reason")
+          else
+            reason.to_s
+          end
+        end
+      end
+
+      def humanized_summary_interpolation
+        super.merge(reason: data.humanized_reason)
+      end
+    end
+  end
+end

data/lib/dji_mqtt_connect/mixins/timestamp_or_current.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Mixins
+    # Provides a fallback to the current timestamp for messages where DJI sometimes omits the timestamp field
+    module TimestampOrCurrent
+      def timestamp_or_current
+        timestamp || Message.current_timestamp
+      end
+    end
+  end
+end

data/lib/dji_mqtt_connect/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DjiMqttConnect
-  VERSION = "0.1.36.1"
+  VERSION = "0.1.36.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dji_mqtt_connect
 version: !ruby/object:Gem::Version
-  version: 0.1.36.1
+  version: 0.1.36.2
 platform: ruby
 authors:
 - Sphere Drones
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-13 00:00:00.000000000 Z
+date: 2026-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -113,6 +113,7 @@ files:
 - ".rubocop/strict.yml"
 - ".rubocop/style.yml"
 - CHANGELOG.md
+- CLAUDE.md
 - Gemfile
 - README.md
 - Rakefile
@@ -146,9 +147,11 @@ files:
 - lib/dji_mqtt_connect/factories/events/cover_force_close.rb
 - lib/dji_mqtt_connect/factories/events/cover_open.rb
 - lib/dji_mqtt_connect/factories/events/device_format.rb
+- lib/dji_mqtt_connect/factories/events/drc_status_notify.rb
 - lib/dji_mqtt_connect/factories/events/drone_format.rb
 - lib/dji_mqtt_connect/factories/events/esim_activate.rb
 - lib/dji_mqtt_connect/factories/events/esim_operator_switch.rb
+- lib/dji_mqtt_connect/factories/events/joystick_invalid_notify.rb
 - lib/dji_mqtt_connect/factories/events/obstacle_avoidance_notify.rb
 - lib/dji_mqtt_connect/factories/events/ota_progress.rb
 - lib/dji_mqtt_connect/factories/events/rtk_calibration.rb
@@ -230,6 +233,7 @@ files:
 - lib/dji_mqtt_connect/messages/thing/product/events/device_format.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/device_log.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/device_reboot.rb
+- lib/dji_mqtt_connect/messages/thing/product/events/drc_status_notify.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/drone_close.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/drone_format.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/drone_open.rb
@@ -244,6 +248,7 @@ files:
 - lib/dji_mqtt_connect/messages/thing/product/events/fly_to_point_progress.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/highest_priority_upload_flighttask_media.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/hms.rb
+- lib/dji_mqtt_connect/messages/thing/product/events/joystick_invalid_notify.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/obstacle_avoidance_notify.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/offline_map_sync_progress.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/ota_progress.rb
@@ -450,6 +455,7 @@ files:
 - lib/dji_mqtt_connect/mixins/services_output_status.rb
 - lib/dji_mqtt_connect/mixins/supplement_light_state.rb
 - lib/dji_mqtt_connect/mixins/temperature.rb
+- lib/dji_mqtt_connect/mixins/timestamp_or_current.rb
 - lib/dji_mqtt_connect/mixins/video_quality.rb
 - lib/dji_mqtt_connect/mixins/video_type.rb
 - lib/dji_mqtt_connect/railtie.rb