src/com/android/tradefed/device/TestDeviceOptions.java - platform/tools/tradefederation - Git at Google

 /*
  * Copyright (C) 2011 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 package com.android.tradefed.device;

 import com.android.tradefed.config.Option;

 /**
  * Container for {@link ITestDevice} {@link Option}s
  */
 public class TestDeviceOptions {

     @Option(name = "enable-root", description = "enable adb root on boot.")
     private boolean mEnableAdbRoot = true;

     @Option(name = "disable-keyguard",
             description = "attempt to disable keyguard once boot is complete.")
     private boolean mDisableKeyguard = true;

     @Option(name = "disable-keyguard-cmd", description = "shell command to disable keyguard.")
     private String mDisableKeyguardCmd = "input keyevent 82";

     @Option(name = "enable-logcat", description =
             "Enable background logcat capture when invocation is running.")
     private boolean mEnableLogcat = true;

     @Option(name = "max-tmp-logcat-file", description =
         "The maximum size of tmp logcat data to retain, in bytes. " +
         "Only used if --enable-logcat is set")
     private long mMaxLogcatDataSize = 20 * 1024 * 1024;

     @Option(name = "fastboot-timeout", description =
             "time in ms to wait for a device to boot into fastboot.")
     private int mFastbootTimeout = 1 * 60 * 1000;

     @Option(name = "adb-recovery-timeout", description =
             "time in ms to wait for a device to boot into recovery.")
     private int mAdbRecoveryTimeout = 1 * 60 * 1000;

     @Option(name = "reboot-timeout", description =
             "time in ms to wait for a device to reboot to full system.")
     private int mRebootTimeout = 2 * 60 * 1000;

     @Option(name = "use-fastboot-erase", description =
             "use fastboot erase instead of fastboot format to wipe partitions")
     private boolean mUseFastbootErase = false;

     @Option(name = "unencrypt-reboot-timeout", description = "time in ms to wait for the device to "
             + "format the filesystem and reboot after unencryption")
     private int mUnencryptRebootTimeout = 0;

     @Option(name = "online-timeout", description = "default time in ms to wait for the device to "
             + "be visible on adb.")
     private long mOnlineTimeout = 1 * 60 * 1000;

     @Option(name = "available-timeout", description = "default time in ms to wait for the device "
             + "to be available aka fully boot.")
     private long mAvailableTimeout = 6 * 60 * 1000;

     @Deprecated
     @Option(name = "ping-ip-or-host", description = "default ip or host to ping during "
             + "connectivity checks; [deprecated] use --ping-url instead.")
     private String mPingIpOrHost = "www.google.com";

     @Option(name = "conn-check-url",
             description = "default URL to be used for connectivity checks.")
     private String mConnCheckUrl = "http://www.google.com";

     @Option(name = "wifi-attempts",
             description = "default number of attempts to connect to wifi network.")
     private int mWifiAttempts = 5;

     /**
      * Check whether adb root should be enabled on boot for this device
      */
     public boolean isEnableAdbRoot() {
         return mEnableAdbRoot;
     }

     /**
      * Set whether adb root should be enabled on boot for this device
      */
     public void setEnableAdbRoot(boolean enableAdbRoot) {
         mEnableAdbRoot = enableAdbRoot;
     }

     /**
      * Check whether or not we should attempt to disable the keyguard once boot has completed
      */
     public boolean isDisableKeyguard() {
         return mDisableKeyguard;
     }

     /**
      * Set whether or not we should attempt to disable the keyguard once boot has completed
      */
     public void setDisableKeyguard(boolean disableKeyguard) {
         mDisableKeyguard = disableKeyguard;
     }

     /**
      * Fetch the command to disable the keyguard
      */
     public String getDisableKeyguardCmd() {
         return mDisableKeyguardCmd;
     }

     /**
      * Set the command to be used to disable the keyguard
      */
     public void setDisableKeyguardCmd(String disableKeyguardCmd) {
         mDisableKeyguardCmd = disableKeyguardCmd;
     }

     /**
      * Get the approximate maximum size of a tmp logcat data to retain, in bytes.
      */
     public long getMaxLogcatDataSize() {
         return mMaxLogcatDataSize;
     }

     /**
      * Set the approximate maximum size of a tmp logcat to retain, in bytes
      */
     public void setMaxLogcatDataSize(long maxLogcatDataSize) {
         mMaxLogcatDataSize = maxLogcatDataSize;
     }

     /**
      * @return the timeout to boot into fastboot mode in msecs.
      */
     public int getFastbootTimeout() {
         return mFastbootTimeout;
     }

     /**
      * @param fastbootTimeout the timout in msecs to boot into fastboot mode.
      */
     public void setFastbootTimeout(int fastbootTimeout) {
         mFastbootTimeout = fastbootTimeout;
     }

     /**
      * @return the timeout in msecs to boot into recovery mode.
      */
     public int getAdbRecoveryTimeout() {
         return mAdbRecoveryTimeout;
     }

     /**
      * @param adbRecoveryTimeout the timeout in msecs to boot into recovery mode.
      */
     public void setAdbRecoveryTimeout(int adbRecoveryTimeout) {
         mAdbRecoveryTimeout = adbRecoveryTimeout;
     }

     /**
      * @return the timeout in msecs for the full system boot.
      */
     public int getRebootTimeout() {
         return mRebootTimeout;
     }

     /**
      * @param rebootTimeout the timeout in msecs for the system to fully boot.
      */
     public void setRebootTimeout(int rebootTimeout) {
         mRebootTimeout = rebootTimeout;
     }

     /**
      * @return whether to use fastboot erase instead of fastboot format to wipe partitions.
      */
     public boolean getUseFastbootErase() {
         return mUseFastbootErase;
     }

     /**
      * @param useFastbootErase whether to use fastboot erase instead of fastboot format to wipe
      * partitions.
      */
     public void setUseFastbootErase(boolean useFastbootErase) {
         mUseFastbootErase = useFastbootErase;
     }

     /**
      * @return the timeout in msecs for the filesystem to be formatted and the device to reboot
      * after unencryption.
      */
     public int getUnencryptRebootTimeout() {
         return mUnencryptRebootTimeout;
     }

     /**
      * @param unencryptRebootTimeout the timeout in msecs for the filesystem to be formatted and
      * the device to reboot after unencryption.
      */
     public void setUnencryptRebootTimeout(int unencryptRebootTimeout) {
         mUnencryptRebootTimeout = unencryptRebootTimeout;
     }

     /**
      * @return the default time in ms to to wait for a device to be online.
      */
     public long getOnlineTimeout() {
         return mOnlineTimeout;
     }

     public void setOnlineTimeout(long onlineTimeout) {
         mOnlineTimeout = onlineTimeout;
     }

     /**
      * @return the default time in ms to to wait for a device to be available.
      */
     public long getAvailableTimeout() {
         return mAvailableTimeout;
     }

     /**
      * @return the default ip or hostname to ping during connectivity tests.
      */
     public String getPingIpOrHost() {
         return mPingIpOrHost;
     }

     public void setPingIpOrHost(String ipOrHost) {
       mPingIpOrHost = ipOrHost;
     }

     /**
      * @return the default URL to be used for connectivity tests.
      */
     public String getConnCheckUrl() {
         return mConnCheckUrl;
     }

     public void setConnCheckUrl(String url) {
       mConnCheckUrl = url;
     }

     /**
      * @return true if background logcat capture is enabled
      */
     public boolean isLogcatCaptureEnabled() {
         return mEnableLogcat;
     }

     /**
      * @return the default number of attempts to connect to wifi network.
      */
     public int getWifiAttempts() {
         return mWifiAttempts;
     }

     public void setWifiAttempts(int wifiAttempts) {
         mWifiAttempts = wifiAttempts;
     }

 }
	/*
	* Copyright (C) 2011 The Android Open Source Project
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/
	package com.android.tradefed.device;

	import com.android.tradefed.config.Option;

	/**
	* Container for {@link ITestDevice} {@link Option}s
	*/
	public class TestDeviceOptions {

	@Option(name = "enable-root", description = "enable adb root on boot.")
	private boolean mEnableAdbRoot = true;

	@Option(name = "disable-keyguard",
	description = "attempt to disable keyguard once boot is complete.")
	private boolean mDisableKeyguard = true;

	@Option(name = "disable-keyguard-cmd", description = "shell command to disable keyguard.")
	private String mDisableKeyguardCmd = "input keyevent 82";

	@Option(name = "enable-logcat", description =
	"Enable background logcat capture when invocation is running.")
	private boolean mEnableLogcat = true;

	@Option(name = "max-tmp-logcat-file", description =
	"The maximum size of tmp logcat data to retain, in bytes. " +
	"Only used if --enable-logcat is set")
	private long mMaxLogcatDataSize = 20 * 1024 * 1024;

	@Option(name = "fastboot-timeout", description =
	"time in ms to wait for a device to boot into fastboot.")
	private int mFastbootTimeout = 1 * 60 * 1000;

	@Option(name = "adb-recovery-timeout", description =
	"time in ms to wait for a device to boot into recovery.")
	private int mAdbRecoveryTimeout = 1 * 60 * 1000;

	@Option(name = "reboot-timeout", description =
	"time in ms to wait for a device to reboot to full system.")
	private int mRebootTimeout = 2 * 60 * 1000;

	@Option(name = "use-fastboot-erase", description =
	"use fastboot erase instead of fastboot format to wipe partitions")
	private boolean mUseFastbootErase = false;

	@Option(name = "unencrypt-reboot-timeout", description = "time in ms to wait for the device to "
	+ "format the filesystem and reboot after unencryption")
	private int mUnencryptRebootTimeout = 0;

	@Option(name = "online-timeout", description = "default time in ms to wait for the device to "
	+ "be visible on adb.")
	private long mOnlineTimeout = 1 * 60 * 1000;

	@Option(name = "available-timeout", description = "default time in ms to wait for the device "
	+ "to be available aka fully boot.")
	private long mAvailableTimeout = 6 * 60 * 1000;

	@Deprecated
	@Option(name = "ping-ip-or-host", description = "default ip or host to ping during "
	+ "connectivity checks; [deprecated] use --ping-url instead.")
	private String mPingIpOrHost = "www.google.com";

	@Option(name = "conn-check-url",
	description = "default URL to be used for connectivity checks.")
	private String mConnCheckUrl = "http://www.google.com";

	@Option(name = "wifi-attempts",
	description = "default number of attempts to connect to wifi network.")
	private int mWifiAttempts = 5;

	/**
	* Check whether adb root should be enabled on boot for this device
	*/
	public boolean isEnableAdbRoot() {
	return mEnableAdbRoot;
	}

	/**
	* Set whether adb root should be enabled on boot for this device
	*/
	public void setEnableAdbRoot(boolean enableAdbRoot) {
	mEnableAdbRoot = enableAdbRoot;
	}

	/**
	* Check whether or not we should attempt to disable the keyguard once boot has completed
	*/
	public boolean isDisableKeyguard() {
	return mDisableKeyguard;
	}

	/**
	* Set whether or not we should attempt to disable the keyguard once boot has completed
	*/
	public void setDisableKeyguard(boolean disableKeyguard) {
	mDisableKeyguard = disableKeyguard;
	}

	/**
	* Fetch the command to disable the keyguard
	*/
	public String getDisableKeyguardCmd() {
	return mDisableKeyguardCmd;
	}

	/**
	* Set the command to be used to disable the keyguard
	*/
	public void setDisableKeyguardCmd(String disableKeyguardCmd) {
	mDisableKeyguardCmd = disableKeyguardCmd;
	}

	/**
	* Get the approximate maximum size of a tmp logcat data to retain, in bytes.
	*/
	public long getMaxLogcatDataSize() {
	return mMaxLogcatDataSize;
	}

	/**
	* Set the approximate maximum size of a tmp logcat to retain, in bytes
	*/
	public void setMaxLogcatDataSize(long maxLogcatDataSize) {
	mMaxLogcatDataSize = maxLogcatDataSize;
	}

	/**
	* @return the timeout to boot into fastboot mode in msecs.
	*/
	public int getFastbootTimeout() {
	return mFastbootTimeout;
	}

	/**
	* @param fastbootTimeout the timout in msecs to boot into fastboot mode.
	*/
	public void setFastbootTimeout(int fastbootTimeout) {
	mFastbootTimeout = fastbootTimeout;
	}

	/**
	* @return the timeout in msecs to boot into recovery mode.
	*/
	public int getAdbRecoveryTimeout() {
	return mAdbRecoveryTimeout;
	}

	/**
	* @param adbRecoveryTimeout the timeout in msecs to boot into recovery mode.
	*/
	public void setAdbRecoveryTimeout(int adbRecoveryTimeout) {
	mAdbRecoveryTimeout = adbRecoveryTimeout;
	}

	/**
	* @return the timeout in msecs for the full system boot.
	*/
	public int getRebootTimeout() {
	return mRebootTimeout;
	}

	/**
	* @param rebootTimeout the timeout in msecs for the system to fully boot.
	*/
	public void setRebootTimeout(int rebootTimeout) {
	mRebootTimeout = rebootTimeout;
	}

	/**
	* @return whether to use fastboot erase instead of fastboot format to wipe partitions.
	*/
	public boolean getUseFastbootErase() {
	return mUseFastbootErase;
	}

	/**
	* @param useFastbootErase whether to use fastboot erase instead of fastboot format to wipe
	* partitions.
	*/
	public void setUseFastbootErase(boolean useFastbootErase) {
	mUseFastbootErase = useFastbootErase;
	}

	/**
	* @return the timeout in msecs for the filesystem to be formatted and the device to reboot
	* after unencryption.
	*/
	public int getUnencryptRebootTimeout() {
	return mUnencryptRebootTimeout;
	}

	/**
	* @param unencryptRebootTimeout the timeout in msecs for the filesystem to be formatted and
	* the device to reboot after unencryption.
	*/
	public void setUnencryptRebootTimeout(int unencryptRebootTimeout) {
	mUnencryptRebootTimeout = unencryptRebootTimeout;
	}

	/**
	* @return the default time in ms to to wait for a device to be online.
	*/
	public long getOnlineTimeout() {
	return mOnlineTimeout;
	}

	public void setOnlineTimeout(long onlineTimeout) {
	mOnlineTimeout = onlineTimeout;
	}

	/**
	* @return the default time in ms to to wait for a device to be available.
	*/
	public long getAvailableTimeout() {
	return mAvailableTimeout;
	}

	/**
	* @return the default ip or hostname to ping during connectivity tests.
	*/
	public String getPingIpOrHost() {
	return mPingIpOrHost;
	}

	public void setPingIpOrHost(String ipOrHost) {
	mPingIpOrHost = ipOrHost;
	}

	/**
	* @return the default URL to be used for connectivity tests.
	*/
	public String getConnCheckUrl() {
	return mConnCheckUrl;
	}

	public void setConnCheckUrl(String url) {
	mConnCheckUrl = url;
	}

	/**
	* @return true if background logcat capture is enabled
	*/
	public boolean isLogcatCaptureEnabled() {
	return mEnableLogcat;
	}

	/**
	* @return the default number of attempts to connect to wifi network.
	*/
	public int getWifiAttempts() {
	return mWifiAttempts;
	}

	public void setWifiAttempts(int wifiAttempts) {
	mWifiAttempts = wifiAttempts;
	}

	}