| # Copyright 2017 The Chromium OS Authors. All rights reserved. |
| # Use of this source code is governed by a BSD-style license that can be |
| # found in the LICENSE file. |
| |
| """This is a FAFT test for TCPC firmware updates. |
| |
| This test forces TCPC firmware updates for the specified TCPCs. |
| |
| The test is invoked with additional arguments to specify alternate |
| TCPC firmware blobs. These are "edited" into the DUT's bios.bin |
| normally extracted from the system shellball. Then, the bios.bin is |
| flashed into the DUT and the DUT is rebooted. |
| |
| Under normal conditions, the TCPC firmware blobs will be updated as |
| part of software sync when the DUT reboots. Software sync checks that |
| the new firmware is actually running on the TCPCs, however it can also |
| be audited after the fact using the firmware_CompareChipFwToShellBall |
| FAFT test for independent verification. |
| |
| This test should be invoked twice: the 1st time to "downgrade" the |
| TCPC firmware, then a 2nd time to restore the production TCPC |
| firmware. Alternatively, the system can be reflashed with a |
| production bios.bin (and rebooted) to restore the TCPC firmware. |
| |
| The parade ps8751 (and similar) parts can be re-flashed indefinitely. |
| However, the analogix parts can only be updated about 100 times which |
| means it is not feasible to include them in continuous automated |
| testing. |
| |
| This test will only replace existing TCPC firmware blobs in bios.bin. |
| If the corresponding binary blobs are not found in cbfs, it is assumed |
| that the release does not support the requested TCPCs. Alternatively, |
| a bios.bin can be specified when invoking the test that will be used |
| insteade of the bios.bin normally extracted from the DUT's system |
| shellball. |
| """ |
| |
| import logging |
| import os |
| import tempfile |
| |
| from autotest_lib.client.common_lib import error |
| from autotest_lib.client.common_lib import utils |
| from autotest_lib.client.common_lib.cros import chip_utils |
| from autotest_lib.server.cros import vboot_constants as vboot |
| from autotest_lib.server.cros.faft.firmware_test import FirmwareTest |
| |
| |
| class firmware_ChipFwUpdate(FirmwareTest): |
| |
| """Updates DUT firmware image with specified firmware blobs. |
| |
| If a new bios.bin is offered, it replaces the |
| existing bios.bin. |
| Then, if new chip firmware blobs are offered, they |
| replace existing firmware blobs in bios.bin. |
| Finally the system shellball is repacked. |
| |
| A reboot must be issued for the new firmware to be applied |
| during software sync. |
| |
| Use the firmware_ChipFwUpdate test to verify that the new |
| firmware was applied. |
| """ |
| version = 1 |
| |
| BIOS = 'bios.bin' |
| HEXDUMP = 'hexdump -v -e \'1/1 "0x%02x\\n"\'' |
| |
| def initialize(self, host, cmdline_args): |
| dict_args = utils.args_to_dict(cmdline_args) |
| super(firmware_ChipFwUpdate, |
| self).initialize(host, cmdline_args) |
| |
| self.new_bios_path = dict_args['bios'] if 'bios' in dict_args else None |
| |
| self.clear_set_gbb_flags( |
| vboot.GBB_FLAG_DISABLE_EC_SOFTWARE_SYNC | |
| vboot.GBB_FLAG_DISABLE_PD_SOFTWARE_SYNC, 0) |
| |
| self.dut_bios_path = None |
| self.cbfs_work_dir = None |
| |
| # set of chip types found in CBFS |
| self.cbfs_chip_types = set() |
| # dict of chip FW updates from the cmd line |
| self.req_chip_updates = {} |
| |
| # see if comand line specified new firmware blobs |
| # for chips we know about |
| |
| for chip in chip_utils.chip_id_map.itervalues(): |
| chip_name = chip.chip_name |
| if chip_name not in dict_args: |
| continue |
| chip_file = dict_args[chip_name] |
| if not os.path.exists(chip_file): |
| raise error.TestError('file %s not found' % chip_file) |
| c = chip() |
| c.set_from_file(chip_file) |
| if chip_name in self.req_chip_updates: |
| raise error.TestError('multiple %s args' % chip_name) |
| logging.info('request chip %s fw 0x%02x from command line', |
| c.chip_name, c.fw_ver) |
| self.req_chip_updates[chip_name] = c |
| |
| def dut_setup_cbfs(self): |
| """Sets up a work dir for cbfstool. |
| |
| Creates a fresh temp. dir for cbfstool to manipulate bios.bin. |
| """ |
| |
| cbfs_path = self.faft_client.updater.cbfs_setup_work_dir() |
| bios_relative_path = self.faft_client.updater.get_bios_relative_path() |
| self.cbfs_work_dir = cbfs_path |
| self.dut_bios_path = os.path.join(cbfs_path, bios_relative_path) |
| |
| def cbfs_extract_chips(self): |
| """Extracts interesting firmware blobs from cbfs. |
| |
| Iterates over requested chip updates and looks for corresponding |
| firmware blobs in cbfs. Firmware blobs are then extracted into |
| cbfs_work_dir. |
| """ |
| |
| for chip in self.req_chip_updates.itervalues(): |
| logging.info('checking for %s firmware in %s', |
| chip.chip_name, self.BIOS) |
| |
| if not self.faft_client.updater.cbfs_extract_chip(chip.fw_name): |
| logging.warning('%s firmware not bundled in %s', |
| chip.chip_name, self.BIOS) |
| continue |
| |
| hashblob = self.faft_client.updater.cbfs_get_chip_hash( |
| chip.fw_name) |
| if not hashblob: |
| logging.warning('%s firmware hash not extracted from %s', |
| chip.chip_name, self.BIOS) |
| continue |
| |
| bundled_fw_ver = chip.fw_ver_from_hash(hashblob) |
| if not bundled_fw_ver: |
| raise error.TestFail( |
| 'could not decode %s firmware hash: %s' % ( |
| chip.chip_name, hashblob)) |
| |
| self.cbfs_chip_types.add(type(chip)) |
| logging.info('%s bundled firmware for %s is version %s', |
| self.BIOS, chip.chip_name, bundled_fw_ver) |
| |
| def cbfs_replace_chips(self, host): |
| """Iterates over known chips in cbfs. |
| |
| For each chip that has an update specified on the command line, |
| copies the firmware (bin, hash) to DUT and updates cbfs in |
| bios.bin. |
| |
| Args: |
| host: host handle to the DUT. |
| """ |
| |
| for chip in self.cbfs_chip_types: |
| chip_name = chip.chip_name |
| logging.info('replacing %s firmware in %s', chip_name, self.BIOS) |
| |
| fw_update = self.req_chip_updates[chip_name] |
| fw_hash = fw_update.compute_hash_bytes() |
| (fd, n) = tempfile.mkstemp() |
| with os.fdopen(fd, 'wb') as f: |
| f.write(fw_hash) |
| |
| try: |
| host.send_file(n, |
| os.path.join( |
| self.cbfs_work_dir, |
| fw_update.cbfs_hash_name)) |
| finally: |
| os.unlink(n) |
| |
| host.send_file(fw_update.fw_file_name, |
| os.path.join( |
| self.cbfs_work_dir, |
| fw_update.cbfs_bin_name)) |
| |
| if not self.faft_client.updater.cbfs_replace_chip( |
| fw_update.fw_name): |
| raise error.TestFail('could not replace %s blobs in cbfs' % |
| fw_update.chip_name) |
| |
| def dut_sign_and_flash_bios(self, host): |
| """Signs the BIOS and flashes the DUT with it. |
| |
| Args: |
| host: host handle to the DUT. |
| """ |
| |
| if not self.faft_client.updater.cbfs_sign_and_flash(): |
| raise error.TestFail('could not re-sign %s' % self.dut_bios_path) |
| host.reboot() |
| |
| def run_once(self, host): |
| """Runs a single iteration of the test.""" |
| # Make sure the client library is on the device so that the proxy |
| # code is there when we try to call it. |
| |
| if not self.req_chip_updates: |
| logging.info('no FW updates requested, skipping test') |
| return |
| |
| self.dut_setup_cbfs() |
| if self.new_bios_path: |
| host.send_file(self.new_bios_path, self.dut_bios_path) |
| |
| self.cbfs_extract_chips() |
| if not self.cbfs_chip_types: |
| logging.info('firmware does not support requested updates, ' |
| 'skipping test') |
| return |
| |
| self.cbfs_replace_chips(host) |
| self.dut_sign_and_flash_bios(host) |
