cosmos 4.2.4-java → 4.5.0-java

data/spec/interfaces/protocols/length_protocol_spec.rb

@@ -160,6 +160,45 @@ module Cosmos
         expect(packet.buffer.length).to eql 5
       end
 
+      it "raises an error with a packet length of 0" do
+        @interface.instance_variable_set(:@stream, LengthStream.new)
+        @interface.add_protocol(LengthProtocol, [
+          16, # bit offset
+          16, # bit size
+          0,  # length offset
+          1, # bytes per count
+          'BIG_ENDIAN'], :READ_WRITE)
+        $buffer = "\x00\x01\x00\x00\x03\x04\x05\x06\x07\x08\x09"
+        expect { @interface.read }.to raise_error(RuntimeError, /Calculated packet length of 0 bits/)
+      end
+
+      it "raises an error if packet length not enough to support offset and size" do
+        @interface.instance_variable_set(:@stream, LengthStream.new)
+        @interface.add_protocol(LengthProtocol, [
+          16, # bit offset
+          16, # bit size
+          3,  # length offset of 3 not enough to support 2 byte length field at offset 2 bytes
+          1, # bytes per count
+          'BIG_ENDIAN'], :READ_WRITE)
+        $buffer = "\x00\x01\x00\x00\x03\x04\x05\x06\x07\x08\x09"
+        expect { @interface.read }.to raise_error(RuntimeError, /Calculated packet length of 24 bits/)
+      end
+
+      it "processes a 0 length with a non-zero length offset" do
+        @interface.instance_variable_set(:@stream, LengthStream.new)
+        @interface.add_protocol(LengthProtocol, [
+          0, # bit offset
+          16, # bit size
+          4,  # length offset
+          1, # bytes per count
+          'BIG_ENDIAN'], :READ_WRITE)
+        $buffer = "\x00\x00\x01\x02\x00\x00\x03\x04"
+        packet = @interface.read
+        expect(packet.buffer).to eql "\x00\x00\x01\x02"
+        packet = @interface.read
+        expect(packet.buffer).to eql "\x00\x00\x03\x04"
+      end
+
       it "validates length against the maximum length" do
         @interface.instance_variable_set(:@stream, LengthStream.new)
         @interface.add_protocol(LengthProtocol, [

data/spec/interfaces/protocols/preidentified_protocol_spec.rb

@@ -56,6 +56,229 @@ module Cosmos
         time = Time.new(2020,1,31,12,15,30.5)
         pkt.received_time = time
         @interface.write(pkt)
+        expect($buffer[0..0].unpack('C')[0]).to eql 0
+        expect($buffer[1..4].unpack('N')[0]).to eql time.to_f.to_i
+        expect($buffer[5..8].unpack('N')[0]).to eql 500000
+        offset = 9
+        tgt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+tgt_name_length)]).to eql 'SYSTEM'
+        offset += tgt_name_length
+        pkt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+pkt_name_length)]).to eql 'META'
+        offset += pkt_name_length
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql pkt.buffer.length
+        offset += 4
+        expect($buffer[offset..-1]).to eql pkt.buffer
+      end
+
+      it "creates a packet header with stored" do
+        @interface.instance_variable_set(:@stream, PreStream.new)
+        @interface.add_protocol(PreidentifiedProtocol, [nil, 5], :READ_WRITE)
+        pkt = System.telemetry.packet("SYSTEM","META").clone
+        time = Time.new(2020,1,31,12,15,30.5)
+        pkt.received_time = time
+        pkt.stored = true
+        @interface.write(pkt)
+        expect($buffer[0..0].unpack('C')[0]).to eql 0x80
+        expect($buffer[1..4].unpack('N')[0]).to eql time.to_f.to_i
+        expect($buffer[5..8].unpack('N')[0]).to eql 500000
+        offset = 9
+        tgt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+tgt_name_length)]).to eql 'SYSTEM'
+        offset += tgt_name_length
+        pkt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+pkt_name_length)]).to eql 'META'
+        offset += pkt_name_length
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql pkt.buffer.length
+        offset += 4
+        expect($buffer[offset..-1]).to eql pkt.buffer
+      end
+
+      it "creates a packet header with extra" do
+        @interface.instance_variable_set(:@stream, PreStream.new)
+        @interface.add_protocol(PreidentifiedProtocol, [nil, 5], :READ_WRITE)
+        pkt = System.telemetry.packet("SYSTEM","META").clone
+        time = Time.new(2020,1,31,12,15,30.5)
+        pkt.received_time = time
+        pkt.stored = false
+        extra_data = {"vcid" => 2}
+        pkt.extra = extra_data
+        @interface.write(pkt)
+        offset = 0
+        expect($buffer[0..0].unpack('C')[0]).to eql 0x40
+        json_extra = extra_data.to_json
+        offset += 1
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql json_extra.length
+        offset += 4
+        expect($buffer[offset..(offset + json_extra.length - 1)]).to eql json_extra
+        offset += json_extra.length
+        expect($buffer[offset..(offset + 3)].unpack('N')[0]).to eql time.to_f.to_i
+        expect($buffer[(offset + 4)..(offset + 7)].unpack('N')[0]).to eql 500000
+        offset = offset += 8 # time fields
+        tgt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+tgt_name_length)]).to eql 'SYSTEM'
+        offset += tgt_name_length
+        pkt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+pkt_name_length)]).to eql 'META'
+        offset += pkt_name_length
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql pkt.buffer.length
+        offset += 4
+        expect($buffer[offset..-1]).to eql pkt.buffer
+      end
+
+      it "creates a packet header with stored and extra" do
+        @interface.instance_variable_set(:@stream, PreStream.new)
+        @interface.add_protocol(PreidentifiedProtocol, [nil, 5], :READ_WRITE)
+        pkt = System.telemetry.packet("SYSTEM","META").clone
+        time = Time.new(2020,1,31,12,15,30.5)
+        pkt.received_time = time
+        pkt.stored = true
+        extra_data = {"vcid" => 2}
+        pkt.extra = extra_data
+        @interface.write(pkt)
+        offset = 0
+        expect($buffer[0..0].unpack('C')[0]).to eql 0xC0
+        json_extra = extra_data.to_json
+        offset += 1
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql json_extra.length
+        offset += 4
+        expect($buffer[offset..(offset + json_extra.length - 1)]).to eql json_extra
+        offset += json_extra.length
+        expect($buffer[offset..(offset + 3)].unpack('N')[0]).to eql time.to_f.to_i
+        expect($buffer[(offset + 4)..(offset + 7)].unpack('N')[0]).to eql 500000
+        offset = offset += 8 # time fields
+        tgt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+tgt_name_length)]).to eql 'SYSTEM'
+        offset += tgt_name_length
+        pkt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+pkt_name_length)]).to eql 'META'
+        offset += pkt_name_length
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql pkt.buffer.length
+        offset += 4
+        expect($buffer[offset..-1]).to eql pkt.buffer
+      end
+
+      it "handles a sync pattern" do
+        @interface.instance_variable_set(:@stream, PreStream.new)
+        @interface.add_protocol(PreidentifiedProtocol, ["DEAD"], :READ_WRITE)
+        pkt = System.telemetry.packet("SYSTEM","META")
+        time = Time.new(2020,1,31,12,15,30.5)
+        pkt.received_time = time
+        @interface.write(pkt)
+        expect($buffer[0..1]).to eql("\xDE\xAD")
+        expect($buffer[2..2].unpack('C')[0]).to eql 0
+        expect($buffer[3..6].unpack('N')[0]).to eql time.to_f.to_i
+        expect($buffer[7..10].unpack('N')[0]).to eql 500000
+        offset = 11
+        tgt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+tgt_name_length)]).to eql 'SYSTEM'
+        offset += tgt_name_length
+        pkt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+pkt_name_length)]).to eql 'META'
+        offset += pkt_name_length
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql pkt.buffer.length
+        offset += 4
+        expect($buffer[offset..-1]).to eql pkt.buffer
+      end
+
+      it "handles a sync pattern with stored and extra" do
+        @interface.instance_variable_set(:@stream, PreStream.new)
+        @interface.add_protocol(PreidentifiedProtocol, ["DEAD", 5], :READ_WRITE)
+        pkt = System.telemetry.packet("SYSTEM","META").clone
+        time = Time.new(2020,1,31,12,15,30.5)
+        pkt.received_time = time
+        pkt.stored = true
+        extra_data = {"vcid" => 2}
+        pkt.extra = extra_data
+        @interface.write(pkt)
+        expect($buffer[0..1]).to eql("\xDE\xAD")
+        offset = 2
+        expect($buffer[2..2].unpack('C')[0]).to eql 0xC0
+        json_extra = extra_data.to_json
+        offset += 1
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql json_extra.length
+        offset += 4
+        expect($buffer[offset..(offset + json_extra.length - 1)]).to eql json_extra
+        offset += json_extra.length
+        expect($buffer[offset..(offset + 3)].unpack('N')[0]).to eql time.to_f.to_i
+        expect($buffer[(offset + 4)..(offset + 7)].unpack('N')[0]).to eql 500000
+        offset = offset += 8 # time fields
+        tgt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+tgt_name_length)]).to eql 'SYSTEM'
+        offset += tgt_name_length
+        pkt_name_length = $buffer[offset].unpack('C')[0]
+        offset += 1 # for the length field
+        expect($buffer[offset...(offset+pkt_name_length)]).to eql 'META'
+        offset += pkt_name_length
+        expect($buffer[offset..(offset+3)].unpack('N')[0]).to eql pkt.buffer.length
+        offset += 4
+        expect($buffer[offset..-1]).to eql pkt.buffer
+      end
+    end
+
+    describe "read" do
+      it "handles a sync pattern" do
+        @interface.instance_variable_set(:@stream, PreStream.new)
+        @interface.add_protocol(PreidentifiedProtocol, ["0x1234"], :READ_WRITE)
+        pkt = System.telemetry.packet("SYSTEM","META")
+        pkt.write("COSMOS_VERSION", "TEST")
+        time = Time.new(2020,1,31,12,15,30.5)
+        pkt.received_time = time
+        @interface.write(pkt)
+        expect($buffer[0]).to eql "\x12"
+        expect($buffer[1]).to eql "\x34"
+        packet = @interface.read
+        expect(packet.target_name).to eql 'SYSTEM'
+        expect(packet.packet_name).to eql 'META'
+        expect(packet.identified?).to be true
+        expect(packet.defined?).to be false
+
+        pkt2 = System.telemetry.update!("SYSTEM","META",packet.buffer)
+        expect(pkt2.read('COSMOS_VERSION')).to eql 'TEST'
+        expect(pkt2.identified?).to be true
+        expect(pkt2.defined?).to be true
+      end
+
+      it "returns a packet" do
+        @interface.instance_variable_set(:@stream, PreStream.new)
+        @interface.add_protocol(PreidentifiedProtocol, [], :READ_WRITE)
+        pkt = System.telemetry.packet("SYSTEM","META")
+        pkt.write("COSMOS_VERSION", "TEST")
+        time = Time.new(2020,1,31,12,15,30.5)
+        pkt.received_time = time
+        @interface.write(pkt)
+        packet = @interface.read
+        expect(packet.target_name).to eql 'SYSTEM'
+        expect(packet.packet_name).to eql 'META'
+        expect(packet.identified?).to be true
+        expect(packet.defined?).to be false
+
+        pkt2 = System.telemetry.update!("SYSTEM","META",packet.buffer)
+        expect(pkt2.read('COSMOS_VERSION')).to eql 'TEST'
+        expect(pkt2.identified?).to be true
+        expect(pkt2.defined?).to be true
+      end
+    end
+
+    describe "write in mode 2" do
+      it "creates a packet header" do
+        @interface.instance_variable_set(:@stream, PreStream.new)
+        @interface.add_protocol(PreidentifiedProtocol, [nil, 5, 2], :READ_WRITE)
+        pkt = System.telemetry.packet("SYSTEM","META")
+        time = Time.new(2020,1,31,12,15,30.5)
+        pkt.received_time = time
+        @interface.write(pkt)
         expect($buffer[0..3].unpack('N')[0]).to eql time.to_f.to_i
         expect($buffer[4..7].unpack('N')[0]).to eql 500000
         offset = 8
@@ -74,7 +297,7 @@ module Cosmos
 
       it "handles a sync pattern" do
         @interface.instance_variable_set(:@stream, PreStream.new)
-        @interface.add_protocol(PreidentifiedProtocol, ["DEAD"], :READ_WRITE)
+        @interface.add_protocol(PreidentifiedProtocol, ["DEAD", nil, 2], :READ_WRITE)
         pkt = System.telemetry.packet("SYSTEM","META")
         time = Time.new(2020,1,31,12,15,30.5)
         pkt.received_time = time
@@ -97,10 +320,10 @@ module Cosmos
       end
     end
 
-    describe "read" do
+    describe "read in mode 2" do
       it "handles a sync pattern" do
         @interface.instance_variable_set(:@stream, PreStream.new)
-        @interface.add_protocol(PreidentifiedProtocol, ["0x1234"], :READ_WRITE)
+        @interface.add_protocol(PreidentifiedProtocol, ["0x1234", nil, 2], :READ_WRITE)
         pkt = System.telemetry.packet("SYSTEM","META")
         pkt.write("COSMOS_VERSION", "TEST")
         time = Time.new(2020,1,31,12,15,30.5)
@@ -122,7 +345,7 @@ module Cosmos
 
       it "returns a packet" do
         @interface.instance_variable_set(:@stream, PreStream.new)
-        @interface.add_protocol(PreidentifiedProtocol, [], :READ_WRITE)
+        @interface.add_protocol(PreidentifiedProtocol, [nil, nil, 2], :READ_WRITE)
         pkt = System.telemetry.packet("SYSTEM","META")
         pkt.write("COSMOS_VERSION", "TEST")
         time = Time.new(2020,1,31,12,15,30.5)

data/spec/interfaces/protocols/template_protocol_spec.rb

@@ -28,6 +28,7 @@ module Cosmos
     before(:each) do
       @interface = StreamInterface.new
       allow(@interface).to receive(:connected?) { true }
+      $write_buffer = ''
       $read_buffer = ''
       $read_cnt = 0
     end
@@ -173,12 +174,20 @@ module Cosmos
       end
 
       it "processes responses with no ID fields" do
-        rsp_pkt = Packet.new('TGT', 'READ_VOLTAGE')
-        rsp_pkt.append_item("VOLTAGE", 16, :UINT)
-        allow(System).to receive_message_chain(:telemetry, :packet).and_return(rsp_pkt)
+        tf = Tempfile.new('unittest')
+        tf.puts 'TELEMETRY TGT READ_VOLTAGE BIG_ENDIAN'
+        tf.puts '  APPEND_ITEM VOLTAGE 16 UINT'
+        tf.close
+        pc = PacketConfig.new
+        pc.process_file(tf.path, "SYSTEM")
+        telemetry = Telemetry.new(pc)
+        tf.unlink
+
+        allow(System).to receive_message_chain(:telemetry).and_return(telemetry)
         @interface.instance_variable_set(:@stream, TemplateStream.new)
         @interface.add_protocol(TemplateProtocol, %w(0xABCD 0xABCD 0 nil 1 true 0 nil false nil nil), :READ_WRITE)
-        @interface.target_names = ['TGT']
+        # Add extra target names to the interface to ensure we grab the correct one
+        @interface.target_names = ['BLAH','TGT','OTHER']
         packet = Packet.new('TGT', 'CMD')
         packet.append_item("VOLTAGE", 16, :UINT)
         packet.get_item("VOLTAGE").default = 11
@@ -198,13 +207,21 @@ module Cosmos
         @interface.write(packet)
         sleep 0.55
         expect($write_buffer).to eql("SOUR:VOLT 11, (@1)\xAB\xCD")
+        expect(read_result.read("VOLTAGE")).to eql(10)
       end
 
       it "sets the response ID to the defined ID value" do
-        rsp_pkt = Packet.new('TGT', 'READ_VOLTAGE')
-        rsp_pkt.append_item("PKT_ID", 16, :UINT, nil, :BIG_ENDIAN, :ERROR, nil, nil, nil, 1) # ID == 1
-        rsp_pkt.append_item("VOLTAGE", 16, :UINT)
-        allow(System).to receive_message_chain(:telemetry, :packet).and_return(rsp_pkt)
+        tf = Tempfile.new('unittest')
+        tf.puts 'TELEMETRY TGT READ_VOLTAGE BIG_ENDIAN'
+        tf.puts '  APPEND_ID_ITEM PKT_ID 16 UINT 1'
+        tf.puts '  APPEND_ITEM VOLTAGE 16 UINT'
+        tf.close
+        pc = PacketConfig.new
+        pc.process_file(tf.path, "SYSTEM")
+        telemetry = Telemetry.new(pc)
+        tf.unlink
+
+        allow(System).to receive_message_chain(:telemetry).and_return(telemetry)
         @interface.instance_variable_set(:@stream, TemplateStream.new)
         @interface.add_protocol(TemplateProtocol, %w(0xABCD 0xABCD 0 nil 1 true 0 nil false nil nil), :READ_WRITE)
         @interface.target_names = ['TGT']
@@ -230,14 +247,22 @@ module Cosmos
         sleep 0.55
         expect($write_buffer).to eql("SOUR:VOLT 11, (@1)\xAB\xCD")
         expect(read_result.read("PKT_ID")).to eql(1) # Result ID set to the defined value
+        expect(read_result.read("VOLTAGE")).to eql(10)
       end
 
       it "handles multiple response IDs" do
-        rsp_pkt = Packet.new('TGT', 'READ_VOLTAGE')
-        rsp_pkt.append_item("APID", 16, :UINT, nil, :BIG_ENDIAN, :ERROR, nil, nil, nil, 10) # ID == 10
-        rsp_pkt.append_item("PKTID", 16, :UINT, nil, :BIG_ENDIAN, :ERROR, nil, nil, nil, 20) # ID == 20
-        rsp_pkt.append_item("VOLTAGE", 16, :UINT)
-        allow(System).to receive_message_chain(:telemetry, :packet).and_return(rsp_pkt)
+        tf = Tempfile.new('unittest')
+        tf.puts 'TELEMETRY TGT READ_VOLTAGE BIG_ENDIAN'
+        tf.puts '  APPEND_ID_ITEM APID 16 UINT 10'
+        tf.puts '  APPEND_ID_ITEM PKTID 16 UINT 20'
+        tf.puts '  APPEND_ITEM VOLTAGE 16 UINT'
+        tf.close
+        pc = PacketConfig.new
+        pc.process_file(tf.path, "SYSTEM")
+        telemetry = Telemetry.new(pc)
+        tf.unlink
+
+        allow(System).to receive_message_chain(:telemetry).and_return(telemetry)
         @interface.instance_variable_set(:@stream, TemplateStream.new)
         @interface.add_protocol(TemplateProtocol, %w(0xABCD 0xABCD 0 nil 1 true 0 nil false nil nil), :READ_WRITE)
         @interface.target_names = ['TGT']
@@ -272,9 +297,16 @@ module Cosmos
       end
 
       it "handles templates with more values than the response" do
-        rsp_pkt = Packet.new('TGT', 'READ_VOLTAGE')
-        rsp_pkt.append_item("VOLTAGE", 16, :UINT)
-        allow(System).to receive_message_chain(:telemetry, :packet).and_return(rsp_pkt)
+        tf = Tempfile.new('unittest')
+        tf.puts 'TELEMETRY TGT READ_VOLTAGE BIG_ENDIAN'
+        tf.puts '  APPEND_ITEM VOLTAGE 16 UINT'
+        tf.close
+        pc = PacketConfig.new
+        pc.process_file(tf.path, "SYSTEM")
+        telemetry = Telemetry.new(pc)
+        tf.unlink
+
+        allow(System).to receive_message_chain(:telemetry).and_return(telemetry)
         @interface.instance_variable_set(:@stream, TemplateStream.new)
         @interface.add_protocol(TemplateProtocol, %w(0xABCD 0xABCD 0 nil 1 true 0 nil false nil), :READ_WRITE)
         @interface.target_names = ['TGT']
@@ -304,9 +336,16 @@ module Cosmos
       end
 
       it "handles responses with more values than the template" do
-        rsp_pkt = Packet.new('TGT', 'READ_VOLTAGE')
-        rsp_pkt.append_item("VOLTAGE", 16, :UINT)
-        allow(System).to receive_message_chain(:telemetry, :packet).and_return(rsp_pkt)
+        tf = Tempfile.new('unittest')
+        tf.puts 'TELEMETRY TGT READ_VOLTAGE BIG_ENDIAN'
+        tf.puts '  APPEND_ITEM VOLTAGE 16 UINT'
+        tf.close
+        pc = PacketConfig.new
+        pc.process_file(tf.path, "SYSTEM")
+        telemetry = Telemetry.new(pc)
+        tf.unlink
+
+        allow(System).to receive_message_chain(:telemetry).and_return(telemetry)
         @interface.instance_variable_set(:@stream, TemplateStream.new)
         @interface.add_protocol(TemplateProtocol, %w(0xABCD 0xABCD 0 nil 1 true 0 nil false nil), :READ_WRITE)
         @interface.target_names = ['TGT']
@@ -336,9 +375,16 @@ module Cosmos
       end
 
       it "ignores response lines" do
-        rsp_pkt = Packet.new('TGT', 'READ_VOLTAGE')
-        rsp_pkt.append_item("VOLTAGE", 16, :UINT)
-        allow(System).to receive_message_chain(:telemetry, :packet).and_return(rsp_pkt)
+        tf = Tempfile.new('unittest')
+        tf.puts 'TELEMETRY TGT READ_VOLTAGE BIG_ENDIAN'
+        tf.puts '  APPEND_ITEM VOLTAGE 16 UINT'
+        tf.close
+        pc = PacketConfig.new
+        pc.process_file(tf.path, "SYSTEM")
+        telemetry = Telemetry.new(pc)
+        tf.unlink
+
+        allow(System).to receive_message_chain(:telemetry).and_return(telemetry)
         @interface.instance_variable_set(:@stream, TemplateStream.new)
         @interface.add_protocol(TemplateProtocol, %w(0xAD 0xA 1), :READ_WRITE)
         @interface.target_names = ['TGT']
@@ -365,9 +411,16 @@ module Cosmos
     end
 
     it "allows multiple response lines" do
-      rsp_pkt = Packet.new('TGT', 'DATA')
-      rsp_pkt.append_item("STRING", 512, :STRING)
-      allow(System).to receive_message_chain(:telemetry, :packet).and_return(rsp_pkt)
+      tf = Tempfile.new('unittest')
+      tf.puts 'TELEMETRY TGT DATA BIG_ENDIAN'
+      tf.puts '  APPEND_ITEM STRING 512 STRINg'
+      tf.close
+      pc = PacketConfig.new
+      pc.process_file(tf.path, "SYSTEM")
+      telemetry = Telemetry.new(pc)
+      tf.unlink
+
+      allow(System).to receive_message_chain(:telemetry).and_return(telemetry)
       @interface.instance_variable_set(:@stream, TemplateStream.new)
       @interface.add_protocol(TemplateProtocol, %w(0xAD 0xA 0 nil 2), :READ_WRITE)
       @interface.target_names = ['TGT']