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