cutedriver-driver 2.0.0.20210120164037

data/lib/tdriver/env.rb

@@ -0,0 +1,21 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of Testability Driver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+ENV['TDRIVER_PATH'] = File.expand_path( File.join( File.dirname( __FILE__ ), '..', '..' ) )
+

data/lib/tdriver/loader.rb

@@ -0,0 +1,57 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of Testability Driver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+# load globally used external modules
+require 'singleton'
+
+#require 'set'
+
+begin
+
+  # load native extensions if available
+  require File.expand_path( File.join( File.dirname( __FILE__ ), 'native_extensions' ) )
+
+rescue LoadError
+
+  # do nothing
+
+end
+
+# utility modules
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'util/loader.rb' ) )
+
+# base modules
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'base/loader.rb' ) )
+
+# verify module
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'verify/verify.rb' ) )
+
+# reporting modules
+if $parameters[ :enable_reporter, true ].true?
+
+  require File.expand_path( File.join( File.dirname( __FILE__ ), 'report/report.rb' ) ) 
+  
+end
+
+# load report api for continuous verification reporting purposes
+if $parameters[ :report_attach_continuous_verification_to_reporter, false ].true?
+
+  require File.expand_path( File.join( File.dirname( __FILE__ ), 'report/report_api' ) ) 
+
+end

data/lib/tdriver/matti.rb

@@ -0,0 +1,35 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of Testability Driver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'tdriver' ) )
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'loader' ) )
+
+class MATTI
+
+	def self.method_missing( method_id, *args )
+
+		file, line = caller.first.split(":")
+
+		$stderr.puts "#{ file }:#{ line } warning: deprecated class #{ self.name }, use TDriver##{ method_id.to_s } instead"
+
+		TDriver.respond_to?( method_id ) ? TDriver.method( method_id ).call( *args ) : super
+
+	end
+
+end

data/lib/tdriver/report/error_recovery/tdriver_custom_error_recovery.rb

@@ -0,0 +1,83 @@
+############################################################################
+##
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+## All rights reserved.
+## Contact: Nokia Corporation (testabilitydriver@nokia.com)
+##
+## This file is part of Testability Driver.
+##
+## If you have questions regarding the use of this file, please contact
+## Nokia at testabilitydriver@nokia.com .
+##
+## This library is free software; you can redistribute it and/or
+## modify it under the terms of the GNU Lesser General Public
+## License version 2.1 as published by the Free Software Foundation
+## and appearing in the file LICENSE.LGPL included in the packaging
+## of this file.
+##
+############################################################################
+
+module TDriverCustomErrorRecovery
+
+  # This method is called by TDriver Reporter when error is detected in connection
+  # === params
+  # === returns
+  # === raises
+  def error_in_connection()
+
+  end
+
+  # This method is called by TDriver Reporter when test set execution is starting
+  # === params
+  # === returns
+  # === raises
+  def starting_test_set_run()
+
+  end
+
+  # This method is called by TDriver Reporter when test case execution is starting
+  # === params
+  # test_case: the test case name
+  # connected_suts: All the connected TDriver suts
+  # === returns
+  # === raises
+  def starting_test_case(test_case,connected_suts)
+
+  end
+
+  # This method is called by TDriver Reporter when a error is detected in test case execution
+  # === params
+  # connected_suts: All the connected TDriver suts
+  # === returns
+  # === raises
+  def error_in_test_case(connected_suts)
+
+  end
+
+  # This method is called by TDriver Reporter when test case details are updated
+  # === params
+  # details: Execution details recived from the current test case
+  # === returns
+  # === raises
+  def updating_test_case_details(details)
+
+  end
+
+  # This method is called by TDriver Reporter when test case execution is ended
+  # === params
+  # connected_suts: All the connected TDriver suts
+  # === returns
+  # === raises
+  def ending_test_case(status,connected_suts)
+
+  end
+
+  # This method is called by TDriver Reporter when test set execution is ending
+  # === params
+  # === returns
+  # === raises
+  def ending_test_set_run()
+
+  end
+    
+end

data/lib/tdriver/report/error_recovery/tdriver_error_recovery.rb

@@ -0,0 +1,168 @@
+############################################################################
+##
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+## All rights reserved.
+## Contact: Nokia Corporation (testabilitydriver@nokia.com)
+##
+## This file is part of Testability Driver.
+##
+## If you have questions regarding the use of this file, please contact
+## Nokia at testabilitydriver@nokia.com .
+##
+## This library is free software; you can redistribute it and/or
+## modify it under the terms of the GNU Lesser General Public
+## License version 2.1 as published by the Free Software Foundation
+## and appearing in the file LICENSE.LGPL included in the packaging
+## of this file.
+##
+############################################################################
+
+
+module TDriverErrorRecovery
+
+  # Initializes error recovery settings
+  # === params
+  # === returns
+  # === raises
+  def initialize_error_recovery
+    @recovery_settings=TDriverErrorRecoverySettings.new
+    if @recovery_settings.get_ats4_error_recovery_enabled=='true'
+      eval('module TDriver_Error_Recovery_ATS4
+        require \'dl/import\'
+        extend DL::Importable
+        dlload "callbackif"
+        extern "void restartDatagateway(const char*)"
+        extern "void restartHardware(const char*)"
+        extern "int getBootTimeout(const char*)"
+        extern "int error()"
+      end')
+    end
+
+  end
+
+  # Starts the error recovery for SUTs
+  # === params
+  # === returns
+  # === raises
+  def start_error_recovery()
+    resetted=false
+    initialize_error_recovery if @recovery_settings==nil
+    if @recovery_settings.get_error_recovery_enabled=='true'
+      MobyUtil::Logger.instance.log "behaviour" , "PASS;Starting error recovery"
+      if @recovery_settings.get_reconnect_device=='true'
+        if @recovery_settings.get_ping_connection=='true'
+          resetted=ping_devices_and_reconnect()
+        else
+          reconnect_devices()
+          resetted=true
+        end
+      end
+      MobyUtil::Logger.instance.log "behaviour" , "PASS;Error recovery complete"
+    end
+    resetted
+  end
+
+  # attempts a reconnect for the current SUT
+  # === params
+  # current_sut
+  # === returns
+  # === raises
+  def attempt_reconnect(current_sut)
+    MobyUtil::Logger.instance.log "behaviour" , "WARNING;Connection lost attempting to reconnect"
+    attempt_reconnects=@recovery_settings.get_reconnect_attempts
+    current_reconnect_attempt=0
+    b_error_recovery_succesful=false
+    while current_reconnect_attempt.to_i<attempt_reconnects.to_i
+      if @recovery_settings.get_ats4_error_recovery_enabled=='true'
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;ATS4 Restarting Device #{current_sut.id}"
+        #TDriver_Error_Recovery_ATS4.restartDatagateway(current_sut.id.to_s);
+        current_sut.disconnect
+        TDriver_Error_Recovery_ATS4.restartHardware(current_sut.id.to_s);
+        ats_timeout=TDriver_Error_Recovery_ATS4.getBootTimeout(current_sut.id.to_s);
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;Waiting for ATS4 error recovery #{ats_timeout}s"
+        if ats_timeout.to_i > 0
+          sleep ats_timeout.to_i
+        else
+          MobyUtil::Logger.instance.log "behaviour" , "WARNING;Waiting ATS4 boot timeout is 0 using wait_time_for_ats4_error_recovery parameter timeout #{@recovery_settings.wait_time_for_ats4_error_recovery}s"
+          sleep @recovery_settings.wait_time_for_ats4_error_recovery.to_i
+        end
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;ATS4 Restarted Device #{current_sut.id}"
+      else
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;Resetting sut: #{current_sut.id.to_s}"
+        current_sut.reset
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;Sut resetted"
+      end
+      if ping_device(current_sut)==true
+        b_error_recovery_succesful=true
+        MobyUtil::Logger.instance.log "behaviour" , "PASS;Device reconnected"
+        current_reconnect_attempt=attempt_reconnects.to_i
+      else
+        current_reconnect_attempt+=1
+      end
+    end
+    raise MobyBase::BehaviourError.new("Error Recovery", "Error recovery failed after #{attempt_reconnects} recovery attempts") if b_error_recovery_succesful==false
+  end
+
+  # Reconnects the devices without ping
+  # === params
+  # === returns
+  # === raises
+  def reconnect_devices()
+
+      TDriver::SUTFactory.connected_suts.each do |sut_id, sut_attributes|
+        suts=@recovery_settings.get_monitored_sut
+        suts.each do |monitored_sut|
+          if sut_id.to_s==monitored_sut.to_s
+            attempt_reconnect(sut_attributes[:sut])
+          end
+        end
+      end
+
+  end
+
+  # Ping the current SUT by querying xml state
+  # === params
+  # current sut
+  # === returns
+  # true for succesful ping
+  # false for failed ping
+  # === raises
+  def ping_device(current_sut)
+    begin
+      ui_xml=current_sut.get_ui_dump
+      if !ui_xml
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;Device ping failed"
+        false
+      else
+        MobyUtil::Logger.instance.log "behaviour" , "PASS;Device ping succesful"
+        true
+      end
+    rescue Exception => e
+      puts e.message
+      puts e.backtrace
+      MobyUtil::Logger.instance.log "behaviour" , "WARNING;Device ping failed"
+      false
+    end
+  end
+
+  # Ping the devices and reconnect if ping fails
+  # === params
+  # === returns
+  # === raises
+  def ping_devices_and_reconnect()
+    resetted=false
+    TDriver::SUTFactory.connected_suts.each do |sut_id, sut_attributes|
+        suts=@recovery_settings.get_monitored_sut
+        suts.each do |monitored_sut|
+          if sut_id.to_s==monitored_sut.to_s
+            if ping_device(sut_attributes[:sut])==false
+              resetted=true
+              attempt_reconnect(sut_attributes[:sut])
+            end
+          end
+        end
+    end
+    resetted
+  end
+
+end

data/lib/tdriver/report/error_recovery/tdriver_error_recovery_settings.rb

@@ -0,0 +1,106 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of Testability Driver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+
+
+
+
+class TDriverErrorRecoverySettings
+  def initialize
+
+    @error_recovery_enabled=nil
+
+    @ping_connection=nil
+
+    @ping_interval=nil
+
+    @reconnect_device=nil
+
+    @reconnect_attempts=nil
+
+    @monitored_suts=[]
+
+    @ats4_error_recovery_enabled=false
+
+    @wait_time_for_ats4_error_recovery=60
+
+    read_settings
+  end
+  # Read error recovery settings
+  # === params
+  # === returns
+  # === raises
+  def read_settings()
+    @error_recovery_enabled= $parameters[ :error_recovery_enabled ]
+    raise MobyBase::BehaviourError.new("error recovery", "error recovery enabled parameter not defined in tdriver_parameters.xml") if @error_recovery_enabled == nil
+
+    @ats4_error_recovery_enabled= $parameters[ :ats4_error_recovery_enabled ]
+    raise MobyBase::BehaviourError.new("error recovery", "ats4 error recovery enabled parameter not defined in tdriver_parameters.xml") if @ats4_error_recovery_enabled == nil
+
+    @wait_time_for_ats4_error_recovery= $parameters[ :wait_time_for_ats4_error_recovery ]
+    raise MobyBase::BehaviourError.new("error recovery", "ats4 error recovery wait time parameter not defined in tdriver_parameters.xml") if @wait_time_for_ats4_error_recovery == nil
+
+    @ping_connection= $parameters[ :ping_connection ]
+    raise MobyBase::BehaviourError.new("error recovery", "ping connection parameter not defined in tdriver_parameters.xml") if @ping_connection == nil
+
+    @reconnect_device= $parameters[ :reconnect_device ]
+    raise MobyBase::BehaviourError.new("error recovery", "reconnect device patameter not defined in tdriver_parameters.xml") if @reconnect_device == nil
+
+    @reconnect_attempts= $parameters[ :reconnect_attempts ]
+    raise MobyBase::BehaviourError.new("error recovery", "reconnect attempts patameter not defined in tdriver_parameters.xml") if @reconnect_attempts == nil
+
+    str_parameter= $parameters[ :error_recovery_monitored_sut_ids ]
+    raise MobyBase::BehaviourError.new("error recovery", "error_recovery_monitored_sut_ids patameter not defined in tdriver_parameters.xml") if str_parameter == nil
+    @monitored_suts=str_parameter.split('|')
+
+
+  end
+  def get_ats4_error_recovery_enabled
+     $parameters[ :ats4_error_recovery_enabled ]
+  end
+  def get_wait_time_for_ats4_error_recovery
+     $parameters[ :wait_time_for_ats4_error_recovery ]
+  end
+  def get_error_recovery_enabled
+     $parameters[ :error_recovery_enabled ]
+  end
+  def get_ping_connection
+     $parameters[ :ping_connection ]
+  end
+  def get_reconnect_device
+     $parameters[ :reconnect_device ]
+  end
+  def get_reconnect_attempts
+     $parameters[ :reconnect_attempts ]
+  end
+  def get_monitored_sut
+    str_parameter= $parameters[ :error_recovery_monitored_sut_ids ]
+
+    if str_parameter.include?('|')
+      @monitored_suts=str_parameter.split('|')
+    elsif str_parameter.include?(',')
+      @monitored_suts=str_parameter.split(',')
+    else
+      @monitored_suts=str_parameter
+    end
+    
+    @monitored_suts
+  end
+
+end