Home | History | Annotate | Download | only in firmware_LockedME
      1 # Copyright (c) 2013 The Chromium OS Authors. All rights reserved.
      2 # Use of this source code is governed by a BSD-style license that can be
      3 # found in the LICENSE file.
      4 
      5 AUTHOR = "ChromeOS Team"
      6 NAME = "firmware_LockedME"
      7 PURPOSE = "Ensure the ME region is locked."
      8 CRITERIA = "Fail if any part of the BIOS ME region is mutable from userspace"
      9 TIME = "SHORT"
     10 TEST_CATEGORY = "Security"
     11 TEST_CLASS = "firmware"
     12 TEST_TYPE = "client"
     13 
     14 DOC = """
     15 Intel x86 CPUs (Sandybridge and later) reserve a portion of the BIOS
     16 firmware image for use by the Intel Management Engine (ME). Intel
     17 requires that section of the BIOS flash to be mutable. The ME firmware
     18 itself determines whether or not the CPU can modify the ME region. During
     19 development, we often use an ME image that allows CPU updates. For
     20 production, we need to ensure that we do NOT allow CPU updates.
     21 
     22 This test PASSES if the CPU is unable to modify the ME region.
     23 
     24 This test FAILS if the CPU can modify the ME region, which means it should
     25 *always* fail on any pre-production image.
     26 
     27 Because the only way to be sure that the ME is locked is to try to change
     28 it, if the test fails and is interrupted before it can restore the original
     29 content, the DUT may stop functioning and will require reimaging via servo
     30 or Dediprog to restore it.
     31 
     32 This test is only meaningful to systems using Intel x86 CPUs, and then only
     33 Sandybrige models or later (not Pinetrail, for example)
     34 
     35 """
     36 
     37 job.run_test('firmware_LockedME')
     38