meshtastic 0.0.178 → 0.0.180

data/spec/lib/meshtastic/tcp_spec.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'socket'
+
+describe Meshtastic::TCP do
+  def with_tcp_link(opts = {})
+    local, remote = UNIXSocket.pair
+    tcp_obj = described_class.connect({ socket: local, host: '127.0.0.1', port: 4403, want_config: false }.merge(opts))
+    begin
+      yield tcp_obj, remote
+    ensure
+      described_class.disconnect(tcp_obj: tcp_obj)
+      remote.close unless remote.closed?
+    end
+  end
+
+  def radio_frame(message)
+    body = message.to_proto
+    [Meshtastic::START1, Meshtastic::START2, body.bytesize].pack('CCn') + body
+  end
+
+  it 'writes a decoded ToRadio mesh packet over TCP without MQTT encryption' do
+    with_tcp_link do |tcp_obj, remote|
+      described_class.send_text(tcp_obj: tcp_obj, text: 'ping', to: '!ffffffff', channel: 0)
+      expect(remote.read(32)).to eq(([Meshtastic::START2] * 32).pack('C*'))
+      header = remote.read(4)
+      packet = Meshtastic::ToRadio.decode(remote.read(header.unpack('CCn').last)).packet
+      expect(packet.decoded.payload).to eq('ping')
+      expect(packet.encrypted.to_s).to eq('')
+    end
+  end
+
+  it 'receives a framed FromRadio over TCP' do
+    with_tcp_link do |tcp_obj, remote|
+      remote.read(32)
+      message = Meshtastic::FromRadio.new(packet: Meshtastic::MeshPacket.new(
+        from: 123, decoded: Meshtastic::Data.new(portnum: :TEXT_MESSAGE_APP, payload: 'hello')
+      ))
+      remote.write(radio_frame(message))
+      expect(described_class.recv_from_radio(tcp_obj: tcp_obj, timeout: 1)).to eq(message)
+    end
+  end
+
+  it 'prints usage without raising' do
+    expect { described_class.help }.to output(/USAGE/).to_stdout
+  end
+end

data/spec/lib/meshtastic/telemetry_pb_spec.rb

@@ -2,5 +2,5 @@
 
 require 'spec_helper'
 
-describe Meshtastic::TelemetryPB do
+describe Meshtastic::Telemetry do
 end

data/spec/lib/meshtastic/telemetry_spec.rb

@@ -3,4 +3,25 @@
 require 'spec_helper'
 
 describe Meshtastic::Telemetry do
+  def fake_serial_obj
+    written = +''.b
+    serial_conn = Object.new
+    serial_conn.define_singleton_method(:write) do |b|
+      written << b
+      b.bytesize
+    end
+    serial_conn.define_singleton_method(:flush) { true }
+    serial_conn.define_singleton_method(:closed?) { false }
+    serial_conn.define_singleton_method(:close) { true }
+    { serial_conn: serial_conn, written: written, my_node_num: 0xb0b }
+  end
+
+  it 'requests TELEMETRY_APP with want_response' do
+    serial_obj = fake_serial_obj
+    described_class.request(serial_obj: serial_obj, to: '!aabbccdd')
+    frame = serial_obj[:written]
+    packet = Meshtastic::ToRadio.decode(frame.byteslice(4, (frame.getbyte(2) << 8) + frame.getbyte(3))).packet
+    expect(packet.decoded.portnum).to eq(:TELEMETRY_APP)
+    expect(packet.decoded.want_response).to be true
+  end
 end

data/spec/lib/meshtastic/traceroute_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Meshtastic::Traceroute do
+  def fake_serial_obj
+    written = +''.b
+    serial_conn = Object.new
+    serial_conn.define_singleton_method(:write) do |b|
+      written << b
+      b.bytesize
+    end
+    serial_conn.define_singleton_method(:flush) { true }
+    serial_conn.define_singleton_method(:closed?) { false }
+    serial_conn.define_singleton_method(:close) { true }
+    { serial_conn: serial_conn, written: written, my_node_num: 0xb0b }
+  end
+
+  it 'sends an empty RouteDiscovery on TRACEROUTE_APP' do
+    serial_obj = fake_serial_obj
+    described_class.send(serial_obj: serial_obj, to: '!aabbccdd')
+    frame = serial_obj[:written]
+    packet = Meshtastic::ToRadio.decode(frame.byteslice(4, (frame.getbyte(2) << 8) + frame.getbyte(3))).packet
+    expect(packet.decoded.portnum).to eq(:TRACEROUTE_APP)
+    expect(Meshtastic::RouteDiscovery.decode(packet.decoded.payload)).to be_a(Meshtastic::RouteDiscovery)
+  end
+end

data/spec/lib/meshtastic/xmodem_pb_spec.rb

@@ -2,5 +2,5 @@
 
 require 'spec_helper'
 
-describe Meshtastic::XModemPB do
+describe Meshtastic::XModem do
 end

data/spec/lib/meshtastic/xmodem_spec.rb

@@ -2,5 +2,10 @@
 
 require 'spec_helper'
 
-describe Meshtastic::XModem do
+describe Meshtastic::Xmodem do
+  it 'encodes an XModem SOH packet' do
+    packet = described_class.encode(control: :SOH, seq: 1, buffer: 'A')
+    expect(packet.control).to eq(:SOH)
+    expect(packet.seq).to eq(1)
+  end
 end

data/spec/lib/meshtastic_spec.rb

@@ -3,4 +3,7 @@
 require 'spec_helper'
 
 describe Meshtastic do
+  it 'requires a transport for deliver_data' do
+    expect { described_class.deliver_data(data: Meshtastic::Data.new) }.to raise_error(ArgumentError, /serial_obj/)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: meshtastic
 version: !ruby/object:Gem::Version
-  version: 0.0.178
+  version: 0.0.180
 platform: ruby
 authors:
 - 0day Inc.
@@ -284,9 +284,46 @@ files:
 - Rakefile
 - bin/meshtastic_autoinc_version
 - build_gem.sh
+- documentation/README.md
+- documentation/admin-channel.md
+- documentation/admin-config.md
+- documentation/admin-firmware.md
+- documentation/admin.md
+- documentation/apponly.md
+- documentation/atak.md
+- documentation/bluetooth-bluez.md
+- documentation/bluetooth.md
+- documentation/cannedmessages.md
+- documentation/channel.md
+- documentation/clientonly.md
+- documentation/config.md
+- documentation/connection-status.md
+- documentation/deviceonly.md
+- documentation/localonly.md
+- documentation/mesh-interface.md
+- documentation/meshtastic.md
+- documentation/module-config.md
+- documentation/mqtt.md
+- documentation/paxcount.md
+- documentation/portnums.md
+- documentation/position.md
+- documentation/protobufs.md
+- documentation/remote-hardware.md
+- documentation/rtttl.md
+- documentation/serial.md
+- documentation/storeforward.md
+- documentation/stream-interface.md
+- documentation/tcp.md
+- documentation/telemetry.md
+- documentation/traceroute.md
+- documentation/util.md
+- documentation/xmodem.md
 - git_commit.sh
 - lib/meshtastic.rb
 - lib/meshtastic/admin.rb
+- lib/meshtastic/admin/channel.rb
+- lib/meshtastic/admin/config.rb
+- lib/meshtastic/admin/firmware.rb
 - lib/meshtastic/admin_pb.rb
 - lib/meshtastic/apponly.rb
 - lib/meshtastic/apponly_pb.rb
@@ -323,6 +360,7 @@ files:
 - lib/meshtastic/paxcount_pb.rb
 - lib/meshtastic/portnums.rb
 - lib/meshtastic/portnums_pb.rb
+- lib/meshtastic/position.rb
 - lib/meshtastic/powermon_pb.rb
 - lib/meshtastic/remote_hardware.rb
 - lib/meshtastic/remote_hardware_pb.rb
@@ -333,8 +371,10 @@ files:
 - lib/meshtastic/storeforward.rb
 - lib/meshtastic/storeforward_pb.rb
 - lib/meshtastic/stream_interface.rb
+- lib/meshtastic/tcp.rb
 - lib/meshtastic/telemetry.rb
 - lib/meshtastic/telemetry_pb.rb
+- lib/meshtastic/traceroute.rb
 - lib/meshtastic/util.rb
 - lib/meshtastic/version.rb
 - lib/meshtastic/xmodem.rb
@@ -343,6 +383,10 @@ files:
 - meshtastic.gemspec
 - reinstall_gemset.sh
 - sig/meshtastic.rbs
+- spec/conventions_spec.rb
+- spec/lib/meshtastic/admin/channel_spec.rb
+- spec/lib/meshtastic/admin/config_spec.rb
+- spec/lib/meshtastic/admin/firmware_spec.rb
 - spec/lib/meshtastic/admin_pb_spec.rb
 - spec/lib/meshtastic/admin_spec.rb
 - spec/lib/meshtastic/apponly_pb_spec.rb
@@ -380,6 +424,7 @@ files:
 - spec/lib/meshtastic/paxcount_spec.rb
 - spec/lib/meshtastic/portnums_pb_spec.rb
 - spec/lib/meshtastic/portnums_spec.rb
+- spec/lib/meshtastic/position_spec.rb
 - spec/lib/meshtastic/powermon_pb_spec.rb
 - spec/lib/meshtastic/remote_hardware_pb_spec.rb
 - spec/lib/meshtastic/remote_hardware_spec.rb
@@ -390,8 +435,10 @@ files:
 - spec/lib/meshtastic/storeforward_pb_spec.rb
 - spec/lib/meshtastic/storeforward_spec.rb
 - spec/lib/meshtastic/stream_interface_spec.rb
+- spec/lib/meshtastic/tcp_spec.rb
 - spec/lib/meshtastic/telemetry_pb_spec.rb
 - spec/lib/meshtastic/telemetry_spec.rb
+- spec/lib/meshtastic/traceroute_spec.rb
 - spec/lib/meshtastic/util_spec.rb
 - spec/lib/meshtastic/version_spec.rb
 - spec/lib/meshtastic/xmodem_pb_spec.rb