blob: 1edd185578e68a92122701e7cdfdd8fc1736534d [file] [log] [blame]
# Copyright 2016 The Chromium Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Utility functions for AFE-based interactions.
NOTE: This module should only be used in the context of a running test. Any
utilities that require accessing the AFE, should do so by creating
their own instance of the AFE client and interact with it directly.
import common
from autotest_lib.client.common_lib import global_config
from autotest_lib.server.cros import provision
from autotest_lib.server.cros.dynamic_suite import frontend_wrappers
AFE = frontend_wrappers.RetryingAFE(timeout_min=5, delay_sec=10)
_CROS_VERSION_MAP = AFE.get_stable_version_map(AFE.CROS_IMAGE_TYPE)
_FAFT_VERSION_MAP = AFE.get_stable_version_map(AFE.FAFT_IMAGE_TYPE)
_CONFIG = global_config.global_config
'CROS', 'enable_devserver_trigger_auto_update', type=bool,
def _host_in_lab(host):
"""Check if the host is in the lab and an object the AFE knows.
This check ensures that autoserv and the host's current job is running
inside a fully Autotest instance, aka a lab environment. If this is the
case it then verifies the host is registed with the configured AFE
@param host: Host object to verify.
@returns The host model object.
if not host.job or not host.job.in_lab:
return False
return host._afe_host
def get_stable_cros_image_name(board):
"""Retrieve the Chrome OS stable image name for a given board.
@param board: Board to lookup.
@returns Name of a Chrome OS image to be installed in order to
repair the given board.
return _CROS_VERSION_MAP.get_image_name(board)
def get_stable_firmware_version(model):
"""Retrieve the stable firmware version for a given model.
@param model: Model to lookup.
@returns A version of firmware to be installed via
`chromeos-firmwareupdate` from a repair build.
return _FIRMWARE_VERSION_MAP.get_version(model)
def get_stable_faft_version(board):
"""Retrieve the stable firmware version for FAFT DUTs.
@param board: Board to lookup.
@returns A version of firmware to be installed in order to
repair firmware on a DUT used for FAFT testing.
return _FAFT_VERSION_MAP.get_version(board)
def get_stable_android_version(board):
"""Retrieve the stable Android version a given board.
@param board: Board to lookup.
@returns Stable version of Android for the given board.
return _ANDROID_VERSION_MAP.get_version(board)
def _clear_host_attributes_before_provision(host, info):
"""Clear host attributes before provision, e.g., job_repo_url.
@param host: A Host object to clear attributes before provision.
@param info: A HostInfo to update the attributes in.
attributes = host.get_attributes_to_clear_before_provision()
if not attributes:
for key in attributes:
info.attributes.pop(key, None)
def machine_install_and_update_labels(host, update_url,
"""Calls machine_install and updates the version labels on a host.
@param host: Host object to run machine_install on.
@param update_url: URL of the build to install.
@param force_update: If true, force update even if the target is
already running the requested version.
@param with_cheets: If true, installation is for a specific, custom
version of Android for a target running ARC.
info = host.host_info_store.get()
_clear_host_attributes_before_provision(host, info)
# If ENABLE_DEVSERVER_TRIGGER_AUTO_UPDATE is enabled for this type
# of host, devserver will be used to trigger auto-update.
if host.support_devserver_provision:
image_name, host_attributes = host.machine_install_by_devserver(
update_url, force_full_update=force_full_update)
image_name, host_attributes = host.machine_install(
update_url, force_full_update=force_full_update)
info = host.host_info_store.get()
if with_cheets:
image_name += provision.CHEETS_SUFFIX
info.set_version_label(host.VERSION_PREFIX, image_name)