lib/firmware/ap_firmware_config/__template.py

# -*- coding: utf-8 -*-
# Copyright 2020 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.

# TODO: Name the build target.
"""{Build Target} configs."""

from __future__ import print_function

# BUILD CONFIGS.

# TODO: Fill out BUILD_WORKON_PACKAGES.
# The packages that need to be `cros_workon`ed.
BUILD_WORKON_PACKAGES = (
    '',
)

# TODO: Fill out BUILD_PACKAGES.
# All packages that need to be built.
BUILD_PACKAGES = BUILD_WORKON_PACKAGES + (
    '',
)

# End BUILD CONFIGS.

# FLASH CONFIGS.

# TODO: Set any required force command constants with explanation.
# TODO: Delete this comment block.
# Force flash command constants: DEPLOY_{SSH,SERVO}_FORCE_{FLASHROM,FUTILITY}.
# Any of the constants may be used, simply set to True to enable.

def is_fast_required(use_futility, servo):
  """Returns true if --fast is necessary to flash successfully.

  TODO: Document the bug/reason for the force if this function is required,
    otherwise delete it all together.

  Args:
    use_futility (bool): True if futility is to be used, False if flashrom.
    servo (servo_lib.Servo): The servo connected to the target DUT.

  Returns:
    bool: True if fast is necessary, False otherwise.
  """
  return False


def get_commands(servo):
  """Get specific flash commands for the build target.

  Each board needs specific commands including the voltage for Vref, to turn
  on and turn off the SPI flash. The get_*_commands() functions provide a
  board-specific set of commands for these tasks. The voltage for this board
  needs to be set to 1.8 V.

  Args:
    servo (servo_lib.Servo): The servo connected to the target DUT.

  Returns:
    list: [dut_control_on, dut_control_off, flashrom_cmd, futility_cmd]
      dut_control*=2d arrays formmated like [["cmd1", "arg1", "arg2"],
                                             ["cmd2", "arg3", "arg4"]]
                     where cmd1 will be run before cmd2
      flashrom_cmd=command to flash via flashrom
      futility_cmd=command to flash via futility
  """
  dut_control_on = []
  dut_control_off = []
  # TODO: Add the supported servo cases and their commands.
  if servo:
    programmer = ''
  else:
    raise Exception('%s not supported' % servo.version)

  flashrom_cmd = ['flashrom', '-p', programmer, '-w']
  futility_cmd = ['futility', 'update', '-p', programmer, '-i']

  return [dut_control_on, dut_control_off, flashrom_cmd, futility_cmd]

# End FLASH CONFIGS.